Encerrando um MDF-e
POST /v1/mdfe/encerrar
{
"cpf_cnpj": "11222333000181",
"chave": "3126...",
"codigo_municipio": "3550308",
"protocolo": "131260001234567",
"data": "2026-09-07"
}
Consome cota de MDF-e. Devolve 202 com um job_id.
Isto não é opcional
Todos os outros documentos do Conota acabam quando a SEFAZ autoriza. O MDF-e é o único que exige uma segunda ação, e o intervalo entre a autorização e o encerramento é uma janela em que a empresa está irregular.
Se a sua integração emite MDF-e e não encerra, ela está construindo um passivo — e ele só aparece quando alguém olha.
O município é onde a viagem terminou
codigo_municipio é o IBGE do lugar onde a viagem de fato acabou. Se o veículo foi
desviado, se a última entrega mudou, se a carga voltou — o que vale é o real, não o que
estava no manifesto.
Errar isso não é detalhe de preenchimento: o encerramento é a declaração de onde a operação terminou.
O protocolo é o da autorização do manifesto
Sai da consulta do job de emissão. Guarde-o junto com a chave — você vai precisar dos dois no encerramento, possivelmente dias depois.
Como saber quais estão abertos
POST /v1/mdfe/nao-encerrados
{ "cpf_cnpj": "11222333000181" }
Esta rota consulta o próprio autorizador: quais manifestos deste CNPJ ele considera abertos. Não é um espelho nosso do que aconteceu — é a fonte.
Isso importa porque um espelho pode divergir: um encerramento que falhou no meio, um manifesto emitido por outro sistema, uma reconciliação que ninguém rodou. A SEFAZ sabe.
Não consome cota — é consulta. Rode com a frequência que fizer sentido para a sua operação; um manifesto que ficou aberto por engano custa mais que a chamada.
Cancelar não é encerrar
| Quando | O que significa | |
|---|---|---|
| cancelar | antes de iniciada a viagem | o manifesto não valeu |
| encerrar | depois que a viagem terminou | o manifesto cumpriu o papel |
Depois que a viagem começou, o caminho é o encerramento. Cancelar deixa de ser possível — e essa é uma regra da SEFAZ, não da API.
Depois do encerramento
O manifesto continua existindo e o XML continua disponível em Arquivos. Encerrar não apaga: registra que a viagem acabou.