Encerrar MDF-e

POST/v1/mdfe/{id}/encerrar

Encerra um MDF-e autorizado (evento 110112), marcando o fim do transporte. Depois de encerrado, o status do documento muda para ENCERRADA e nenhum novo DF-e/condutor pode ser incluído nele.

Só se aplica a documentos com mod 58 (MDF-e) que já estejam AUTORIZADA.

Parâmetros do corpo

datastringobrigatório

Data do encerramento (formato AAAA-MM-DD).

sigla_ufstringobrigatório

UF onde ocorreu o encerramento.

nome_municipiostringobrigatório

Nome do município onde ocorreu o encerramento.

codigo_municipiostring

Código IBGE do município. Recomendado para evitar ambiguidade entre municípios de mesmo nome.

Resposta

Evento síncrono — a resposta já vem com o resultado da SEFAZ, sem necessidade de polling.

200 OK

statusstring

"encerrado" ou "erro_encerramento".

status_sefazstring

Código de status retornado pela SEFAZ (cStat).

mensagem_sefazstring

Mensagem retornada pela SEFAZ (xMotivo).

caminho_xmlstring

URL pública do XML do evento, quando autorizado.

cURL

curl -X POST https://app.nfe.tenzanlabs.com/v1/mdfe/35f0a1b2-.../encerrar \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "2026-08-19",
    "sigla_uf": "SP",
    "nome_municipio": "São Paulo",
    "codigo_municipio": "3550308"
  }'

Node.js

const resposta = await client.mdfeClose(invoiceId, {
  data: '2026-08-19',
  sigla_uf: 'SP',
  nome_municipio: 'São Paulo',
  codigo_municipio: '3550308',
});
console.log(resposta.status); // 'encerrado'

Python

resposta = client.mdfe_close(invoice_id, {
    "data": "2026-08-19",
    "sigla_uf": "SP",
    "nome_municipio": "São Paulo",
    "codigo_municipio": "3550308",
})
print(resposta["status"])  # 'encerrado'

Java

MdfeCloseData data = new MdfeCloseData();
data.data = "2026-08-19";
data.sigla_uf = "SP";
data.nome_municipio = "São Paulo";
data.codigo_municipio = "3550308";

SyncEventResponse resposta = client.mdfeClose(invoiceId, data);
System.out.println(resposta.status); // "encerrado"

Exemplo de resposta

{
  "status": "encerrado",
  "status_sefaz": "135",
  "mensagem_sefaz": "Evento registrado e vinculado ao MDF-e",
  "caminho_xml": "https://storage.../evento-encerramento.xml"
}