O MDF-e (Manifesto Eletrônico de Documentos Fiscais, modelo 58) é o documento fiscal digital utilizado para unificar, registrar e acompanhar o transporte de cargas no Brasil. Ele consolida diversos documentos fiscais - como NF-e e CT-e - em um único manifesto, facilitando o controle do transporte pelos órgãos fiscais e reduzindo a necessidade de documentos impressos.
Quem emite
O MDF-e é obrigatório para a maioria das operações de transporte de cargas interestaduais e para empresas que atuam como:
- Transportadoras – no transporte de cargas de terceiros.
- Embarcadores ou proprietárias de frotas – no transporte de cargas próprias.
Ciclo de vida do MDF-e
- Transmissão – envio e autorização do manifesto pela SEFAZ.
- Cancelamento – possível apenas se o transporte ainda não foi iniciado e dentro de 24 horas da autorização.
- Encerramento – obrigatório ao final da viagem para registrar a conclusão do percurso, liberando emissão de novos MDF-e para o mesmo veículo/UF.
Nota: Cancelamento e encerramento são operações distintas. Use cancelamento apenas quando a viagem não ocorreu e está dentro do prazo legal; use encerramento quando o transporte foi concluído.
Transmitir MDF-e
Transmite um MDF-e ao ambiente autorizador da SEFAZ, registrando oficialmente o início do transporte rodoviário ou multimodal de cargas.
Como funciona na API
O endpoint recebe o objeto completo do MDF-e e processa internamente:
- Validação do layout e das regras obrigatórias.
- Assinatura digital com o certificado do emitente.
- Transmissão ao ambiente autorizador da SEFAZ.
- Retorno com o protocolo de autorização, o status e informações complementares.
Quando usar
Use este endpoint sempre que for necessário emitir um novo MDF-e em homologação ou produção.
Importante: certifique-se de que os documentos vinculados (NF-e, CT-e ou ambos) estejam válidos e autorizados, pois inconsistências podem resultar em rejeições durante a transmissão.
Headers
TokenToken de identificação da empresa. Obrigatório em todas as operações fiscais (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, Consultas, Escriturações, Energia e Comunicação) e nos métodos da seção Empresas que atuam sobre uma empresa específica (Buscar, Editar, Alterar Certificado, Verificar Certificado, Gerar Link de Ativação, Deletar, Consultar Numeração, Atualizar Numeração). Não é exigido em Adicionar nem em Buscar Todas.
Transmitir MDF-e › Request Body
serieSérie do MDF-e. Se não informado, será controlado pelo painel.
Preencha este campo apenas se desejar controlar o valor manualmente. Se estiver vazio, o Brasil NFe assumirá o controle automático conforme configurado no painel.
numeroNúmero do MDF-e. Se não informado, será controlado pelo painel.
Preencha este campo apenas se desejar controlar o valor manualmente. Se estiver vazio, o Brasil NFe assumirá o controle automático conforme configurado no painel.
codigoCódigo numérico que compõe a Chave de Acesso. Número gerado pelo emitente para cada MDF-e.
Preencha este campo apenas se desejar controlar o valor manualmente. Se estiver vazio, o Brasil NFe assumirá a geração do código.
loteLote do MDF-e.
Preencha este campo apenas se desejar controlar o valor manualmente. Se estiver vazio, o Brasil NFe assumirá o controle automático conforme configurado no painel.
identificadorInternoIdentificador interno para seu controle.
tipoAmbienteTipo de ambiente.
Valores Possíveis:
1: Produção
2: Homologação
tipoEmitenteTipo de emitente.
Valores Possíveis:
1: Prestador de Serviço de Transporte
2: Transportador de carga própria
DataEmissaoData de emissão do manifesto.
Default automático
Se não enviada, a API usa a data/hora atual do servidor (timezone -03:00 Brasília). Envie apenas para backdating autorizado (ajuste, complementar) - a SEFAZ aceita até 30 dias antes da transmissão.
ufCarregamentoSigla da UF onde a carga foi carregada.
ufDescarregamentoSigla da UF de descarregamento.
observacaoObservações gerais do manifesto.
observacaoFiscoObservações para o fisco.
modalidadeModalidade de Transporte (Padrão 1).
Valores Possíveis:
1: Rodoviário
2: Aéreo
3: Aquaviário
4: Ferroviário
valorValor total da carga / mercadorias transportadas.
pesoPeso Bruto Total da Carga / Mercadorias transportadas em KG.
Informações específicas para modalidade Rodoviária.
Informações específicas para modalidade Aérea.
Informações específicas para modalidade Aquaviária.
Informações específicas para modalidade Ferroviária.
Lista de informações de seguro.
Lista de informações de carregamento (Município/UF de Carregamento).
Lista de informações de descarregamento (Município/UF de Descarregamento e Documentos Fiscais).
percursoUfsLista com as siglas das UFs de percurso (Estados por onde o transporte passará).
Produto predominante transportado. Opcional.
Transmitir MDF-e › Responses
Successful operation
numeroNúmero do MDF-e autorizado.
chaveChave de acesso do MDF-e.
tipoAmbienteDescrição do ambiente de processamento.
Valores Possíveis:
1: Produção
2: Homologação
codRespostaSefazCódigo de status da resposta da SEFAZ.
statusStatus do processamento.
Valores Possíveis:
1: Lote processado
2: Aguardando processamento
3: Ocorreu um erro ao processar o lote
base64XmlArquivo XML do MDF-e autorizado, em Base64.
base64DAMDFeArquivo PDF do DAMDFE, em Base64.
ErrorDescrição do erro, caso ocorra.
AvisosLista de avisos, caso existam.
Cancelamento
Este artigo explica como é efetuado o cancelamento de um MDF-e (Manifesto Eletrônico de Documentos Fiscais).
O cancelamento é utilizado quando o MDF-e foi emitido incorretamente ou quando a operação de transporte não irá mais ocorrer. No entanto, o cancelamento só é permitido dentro das regras estabelecidas pela SEFAZ.
Atenção!
Um MDF-e somente pode ser cancelado quando:
- Sua autorização de uso já tiver sido concedida pela SEFAZ.
- Ainda não tiver ocorrido o fato gerador, ou seja, o transporte não foi iniciado.
Prazo de cancelamento
O prazo máximo para cancelamento de um MDF-e é de 24 horas após a autorização de uso.
Se o prazo já tiver expirado ou se o transporte já tiver começado, não será possível cancelar o documento.
O que fazer se não for possível cancelar?
Nesses casos, o MDF-e deve ser encerrado ao final da viagem, registrando formalmente o fim do percurso.
Como funciona na API
Este endpoint envia o evento de cancelamento para a SEFAZ, contendo a justificativa e os dados do MDF-e. A resposta retorna:
- O protocolo de cancelamento.
- O status da operação.
- Informações complementares, quando aplicável.
Nota: Cancelamento e encerramento são operações distintas. Utilize o cancelamento apenas quando a viagem não ocorreu e está dentro do prazo legal.
Headers
TokenToken de identificação da empresa. Obrigatório em todas as operações fiscais (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, Consultas, Escriturações, Energia e Comunicação) e nos métodos da seção Empresas que atuam sobre uma empresa específica (Buscar, Editar, Alterar Certificado, Verificar Certificado, Gerar Link de Ativação, Deletar, Consultar Numeração, Atualizar Numeração). Não é exigido em Adicionar nem em Buscar Todas.
Cancelamento › Request Body
ChaveNFChave de acesso do Documento Fiscal (44 dígitos).
JustificativaJustificativa do cancelamento do documento fiscal.
NumeroProtocoloNúmero de protocolo de autorização do documento.
Obrigatório caso a nota foi emitida por outro sistema
NumeroSequencialNúmero sequencial do evento de correção.
Quando não informado o controle do sequencial e realizado pelo Brasil NFe
DataEventoData do evento de cancelamento. Quando não informado, é considerada a data e hora atual.
CpfCnpjRemetenteDCeCPF ou CNPJ do Usuário Emitente (Remetente) da DC-e original. Obrigatório no cancelamento de DC-e quando a nota não está cadastrada no sistema (caso esteja, o valor é lido da própria NotaFiscal).
Cancelamento › Responses
Successful operation
DsMotivoDescrição do status do evento emitido
DsEventoDescrição do evento emitido
DsAmbienteDescrição do ambiente em que foi emitido o evento
NuProtocoloNúmero de protocolo do evento
CodStatusRespostaSefazCódigo de status de resposta da SEFAZ
NumeroSequencialNúmero sequencial do evento
StatusStatus do evento
Valores Possíveis:
1: Evento Processado
2: Aguardando Processamento do Evento
3: Ocorreu um erro ao processar o evento
ErrorDescrição do erro quando ocorrer
AvisosLista de avisos não-bloqueantes do evento (vazia em sucesso sem ressalvas).
Encerrar MDF-e
Este artigo explica como é efetuado o encerramento de um MDF-e (Manifesto Eletrônico de Documentos Fiscais).
O encerramento é o evento utilizado para informar à SEFAZ que o transporte descrito no MDF-e foi concluído, finalizando oficialmente o manifesto. Este procedimento é obrigatório para manter a regularidade fiscal do transporte e evitar bloqueio de novos MDF-e vinculados ao mesmo veículo, UF de carregamento ou tipo de operação.
Quando encerrar um MDF-e?
O encerramento deve ser realizado quando:
- O percurso do transporte foi concluído.
- Todas as cargas vinculadas foram entregues ou finalizadas.
- A viagem chegou ao destino final informado no manifesto.
Importância do encerramento
Encerrar o MDF-e garante:
- Regularidade fiscal perante a SEFAZ.
- Liberação para emissão de novos MDF-e envolvendo o mesmo veículo ou UF.
- Prevenção de rejeições e irregularidades futuras.
Como funciona na API
Este endpoint envia o evento de encerramento para a SEFAZ, contendo:
- Dados do MDF-e autorizado.
- Informações do local de encerramento (UF e município, quando exigido).
A resposta retorna:
- O protocolo de encerramento.
- O status da operação.
- Detalhes adicionais do evento.
Nota: O encerramento só pode ser realizado após a autorização do MDF-e e não substitui o cancelamento. Utilize este evento apenas quando o transporte realmente foi concluído.
Headers
TokenToken de identificação da empresa. Obrigatório em todas as operações fiscais (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, Consultas, Escriturações, Energia e Comunicação) e nos métodos da seção Empresas que atuam sobre uma empresa específica (Buscar, Editar, Alterar Certificado, Verificar Certificado, Gerar Link de Ativação, Deletar, Consultar Numeração, Atualizar Numeração). Não é exigido em Adicionar nem em Buscar Todas.
Encerrar MDF-e › Request Body
tipoAmbienteAmbiente de emissão do evento.
Valores Possíveis:
1: Produção
2: Homologação
chaveChave de acesso do Documento Fiscal (44 dígitos).
protocoloNúmero de protocolo de autorização do documento.
Obrigatório caso a nota foi emitida por outro sistema
numeroSequencialNúmero sequencial do evento de correção.
Quando não informado o controle do sequencial e realizado pelo Brasil NFe
Encerrar MDF-e › Responses
Successful operation
DsMotivoDescrição do status do evento emitido
DsEventoDescrição do evento emitido
DsAmbienteDescrição do ambiente em que foi emitido o evento
NuProtocoloNúmero de protocolo do evento
CodStatusRespostaSefazCódigo de status de resposta da SEFAZ
NumeroSequencialNúmero sequencial do evento
StatusStatus do evento
Valores Possíveis:
1: Evento Processado
2: Aguardando Processamento do Evento
3: Ocorreu um erro ao processar o evento
ErrorDescrição do erro quando ocorrer
AvisosLista de avisos não-bloqueantes do evento (vazia em sucesso sem ressalvas).