Atualizações sobre a API de MDFe

2024.02.10 - Novo campo "codigo_unico"

A emissão de MDFe agora permite o envio do campo “codigo_unico”, que em conjunto com o campo “numero” e “serie” permite que o próprio usuário defina a chave do documento.

2022.09.27 - Emissão em contingência offline

Está disponível a funcionalidade de envio de MDFe em contingência offline.

Para que o envio ocorra em contingência, é necessário adicionar o parâmetro contingencia=1 na URL.

No momento a contingência não é acionada de forma automática, porém sua aplicação poderá acionar a qualquer momento, por exemplo quando houver alguma manutenção no serviço de recepção da SEFAZ.

Documentação da emissão em contingência offline: https://focusnfe.com.br/doc/#mdf-e_envio

2022.05.16 - Novos campos para o modal rodoviário

Foram adicionados novos campos referente à contrato e antecipações para o modal rodoviário seguindo a NT 2022.001:

Seção “contratantes”:

  • numero_contrato: Número do contrato do transportador com o contratante quando este existir para prestações continuadas
  • valor_global_contrato: Valor Global do Contrato

Seção “pagamentos”:

  • indicador_adiantamento: Indicador de declaração de concordância em antecipar o adiantamento
  • tipo_permissao_antecipacao: Tipo de Permissão em relação a antecipação das parcelas

Documentação completa dos campos: https://focusnfe.com.br/doc/#mdf-e_campos-de-um-mdf-e

2021.10.15 - Implementação de gatilhos (webhooks) para MDFe

A API de MDFe agora também suporta o envio de gatilhos após o processamento de uma MDFe. Utilize o evento “mdfe” na criação do gatilho.

Documentação do uso de gatilhos: https://focusnfe.com.br/doc/#gatilhos-webhooks_gatilhos-webhooks 

2021.08.25 - Implementação do evento de Inclusão de DFe

  • Foi efetuada a implementação do evento que permite a inclusão de documentos fiscais indicados como ‘carregamento posterior’ e que conforme documentação, só é possível se a MDFe constar como autorizada e com a tag <indCarregaPosterior> possuindo o valor 1.
    • Para isso, o cliente deve informar o campo 'carregamento_posterior' com o valor igual a 1 na requisição de autorização da MDFe.
  • Agora, através do método HTTP POST para URL.: /v2/mdfe/REFERENCIA/inclusao_dfe é possível incluir novos documentos fiscais informando o protocolo da MDFe autorizada, o código do município de carregamento e um ou mais conjuntos de informações referente a DFes.
    • Um conjunto de informação referente a DFe consiste no código do município de descarregamento e na chave da nota fiscal a ser inclusa.

Referência.: https://focusnfe.com.br/doc/#mdf-e_inclusao-de-dfe

2021.08.20 - Implementação Nota Técnica 2021.002

  • Inclusão da TAG <vAdiant> referente ao Valor do Adiantamento, que deve ser informada apenas quando indicado o pagamento a prazo. Essa tag é mapeada no campo 'valor_adiantamento' da API dentro do grupo de 'pagamentos'.
  • Ajustes na documentação referentes a obrigatoriedade das TAGs <nParcela> e <dVenc> referentes respectivamente ao Número da Parcela e a Data de vencimento da Parcela, quando indicado o pagamento a prazo.
  • Ajustes na documentação referentes a desobrigatoriedade da TAG <UF> no contexto de ‘UF em que veículo está licenciado’.

Referência.: https://dfe-portal.svrs.rs.gov.br/Mdfe/Documentos