Encerrar e cancelar MDF-e

Encerrar MDF-e

POST https://apifiscal.weesy.com.br/v1/mdfe/{id}/encerramento

Avisa a SEFAZ que a viagem terminou. Faça isso sempre no fim da viagem: MDF-e aberto impede emitir o próximo MDF-e do mesmo veículo (a SEFAZ rejeita com os códigos 611, 662, 462 ou 686).

Só MDF-e autorizado pode ser encerrado. Se a SEFAZ aceitar, o MDF-e volta encerrado; se recusar, continua autorizado e o motivo está em sefaz.mensagem.

Parâmetros

Nome	Onde	Tipo	Descrição
id obrigatório	caminho	string	Id do MDF-e, devolvido no campo `id` quando você emitiu.

Exemplo de chamada

cURLcurl --request POST \
  --url "https://apifiscal.weesy.com.br/v1/mdfe/6ade6278e8340a492a46b564/encerramento" \
  --header "Authorization: Bearer $WEESY_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "codigoIbge": "4106902"
}'

Node.jsconst resposta = await fetch("https://apifiscal.weesy.com.br/v1/mdfe/6ade6278e8340a492a46b564/encerramento", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WEESY_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "codigoIbge": "4106902"
  }),
});
console.log(resposta.status, await resposta.text());

Pythonimport os

import requests

resposta = requests.post(
    "https://apifiscal.weesy.com.br/v1/mdfe/6ade6278e8340a492a46b564/encerramento",
    headers={"Authorization": f"Bearer {os.environ['WEESY_TOKEN']}"},
    json={
        "codigoIbge": "4106902",
    },
    timeout=30,
)
print(resposta.status_code, resposta.text)

PHP<?php

$corpo = <<<'JSON'
{
  "codigoIbge": "4106902"
}
JSON;

$contexto = stream_context_create(["http" => [
    "method" => "POST",
    "header" => implode("\r\n", ["Authorization: Bearer " . getenv("WEESY_TOKEN"), "Content-Type: application/json"]),
    "content" => $corpo,
    "ignore_errors" => true, // lê o corpo também nas respostas de erro
]]);
$resposta = file_get_contents("https://apifiscal.weesy.com.br/v1/mdfe/6ade6278e8340a492a46b564/encerramento", false, $contexto);
echo $http_response_header[0], PHP_EOL, $resposta, PHP_EOL;

C#using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("WEESY_TOKEN"));

var corpo = """
    {
      "codigoIbge": "4106902"
    }
    """;

using var resposta = await http.PostAsync(
    "https://apifiscal.weesy.com.br/v1/mdfe/6ade6278e8340a492a46b564/encerramento",
    new StringContent(corpo, Encoding.UTF8, "application/json"));
Console.WriteLine($"{(int)resposta.StatusCode} {await resposta.Content.ReadAsStringAsync()}");

Corpo da requisição

Campo	Tipo	Descrição
codigoIbge obrigatório	string	Código IBGE da cidade onde a viagem terminou (7 dígitos). A UF sai do código.
data	string (date)	Dia em que a viagem terminou. Padrão = hoje.

Exemplo

JSON

{
  "codigoIbge": "4106902"
}

Respostas

202: Pedido recebido. Veja status e sefaz no MDF-e.
400: Algum dado está errado ou faltando. A lista erros diz qual campo e o que corrigir (code = validacao). (formato de erro)
401: Token ausente, errado ou revogado (credencialinvalida). Confira o cabeçalho Authorization. (formato de erro)
404: mdfenaoencontrado — não existe, ou é de outra empresa. (formato de erro)
409: mdfestatusinvalido — o MDF-e não está autorizado (ainda não foi, ou já foi cancelado ou encerrado). (formato de erro)
503: A prefeitura, o sistema nacional ou a SEFAZ estão fora do ar (autorizadorindisponivel). Tente de novo em alguns minutos. (formato de erro)

Campos da resposta 202

Campo Tipo Descrição

id
obrigatório

string

O id que a Weesy dá ao documento. Guarde como texto e não tente interpretar.

idIntegracao
obrigatório

string

O código seu que veio na emissão.

status
obrigatório

string

Situação do MDF-e. A lista pode crescer: trate valor desconhecido sem quebrar.

Valor	Significado
`recebido`	Recebemos o MDF-e; ele ainda vai para a SEFAZ
`em_processamento`	Enviado à SEFAZ; aguardando a resposta
`autorizado`	A SEFAZ autorizou — a viagem pode começar. Lembre de encerrar no fim
`rejeitado`	A SEFAZ recusou por algum dado — veja `sefaz.mensagem`, corrija e mande de novo com o mesmo `idIntegracao`
`erro`	Falha técnica (SEFAZ fora do ar, tempo esgotado) — reenvie em `POST /mdfe/{id}/reprocessamento`
`cancelado`	A SEFAZ confirmou o cancelamento
`encerrado`	A viagem terminou e a SEFAZ registrou o encerramento

ambiente
obrigatório

string

Onde o documento é emitido.

Valor	Significado
`producao`	Documento de verdade, com valor fiscal
`homologacao`	Teste na SEFAZ, sem valor fiscal. Exige certificado

O ambiente simulacao (sem certificado, sem sair da Weesy), que a NFS-e tem, ainda não existe para CT-e e MDF-e.

empresa
obrigatório object

empresa.cnpj
obrigatório

string

CNPJ sem pontos, barra ou traço (14 posições). Já aceita o CNPJ com letras, que começa a valer em 2026.

empresa.razaoSocial
obrigatório string

empresa.uf

string

Sigla do estado, em maiúsculas.

Valores: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.

serie
obrigatório string

numero

string ou null

Número do MDF-e. Vazio até a Weesy montar o XML.

chaveAcesso string ou null

protocolo

string ou null

Protocolo de autorização da SEFAZ.

autorizadoEm string (date-time) ou null

ufInicio

string

Sigla do estado, em maiúsculas.

Valores: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.

ufFim

string

Sigla do estado, em maiúsculas.

Valores: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.

percurso array de string

carregamento array de object

carregamento[].codigoIbge
obrigatório

string

Código IBGE do município.

carregamento[].nome

string

Nome do município.

carregamento[].uf

string

Sigla da unidade federativa.

descarregamento array de object

descarregamento[].codigoIbge
obrigatório

string

Código IBGE do município.

descarregamento[].nome

string

Nome do município.

descarregamento[].uf

string

Sigla da unidade federativa.

descarregamento[].chavesCte array de string

veiculo object

veiculo.placa

string

Placa do veículo, sem traço, em maiúsculas (formato antigo ou Mercosul).

veiculo.uf

string

Sigla do estado, em maiúsculas.

Valores: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.

carga object

carga.valor

number

Valor em reais, como número com 2 casas decimais (ex. 100.00). Não mande como texto.

carga.quantidadeCte

integer

Quantos CT-e o MDF-e leva (contado das chaves em descarregamento).

sefaz

object

Última resposta da SEFAZ, como ela mandou. Útil para entender uma rejeição.

sefaz.cStat

integer ou null

Código de resposta da SEFAZ (ex. 100 = autorizado; 135 = evento registrado).

sefaz.mensagem

string ou null

Texto da SEFAZ que explica o código.

sefaz.protocolo

string ou null

Número do protocolo da SEFAZ, quando houver.

encerramento

null ou object

Preenchido quando o MDF-e é encerrado.

encerramento.municipio

object

Identificação do município por código IBGE, nome e UF.

encerramento.municipio.codigoIbge
obrigatório

string

Código IBGE do município.

encerramento.municipio.nome

string

Nome do município.

encerramento.municipio.uf

string

Sigla da unidade federativa.

encerramento.encerradoEm

string (date-time)

Data e hora no horário de Brasília (ex. 2026-10-26T09:27:34-03:00).

encerramento.protocolo string ou null

cancelamento

null ou object

Preenchido quando o MDF-e é cancelado.

cancelamento.justificativa string

cancelamento.canceladoEm

string (date-time)

Data e hora no horário de Brasília (ex. 2026-10-26T09:27:34-03:00).

cancelamento.protocolo string ou null

historico

array de object

Por onde o MDF-e passou, em ordem.

historico[].status
obrigatório

string

Situação do MDF-e. A lista pode crescer: trate valor desconhecido sem quebrar.

Valor	Significado
`recebido`	Recebemos o MDF-e; ele ainda vai para a SEFAZ
`em_processamento`	Enviado à SEFAZ; aguardando a resposta
`autorizado`	A SEFAZ autorizou — a viagem pode começar. Lembre de encerrar no fim
`rejeitado`	A SEFAZ recusou por algum dado — veja `sefaz.mensagem`, corrija e mande de novo com o mesmo `idIntegracao`
`erro`	Falha técnica (SEFAZ fora do ar, tempo esgotado) — reenvie em `POST /mdfe/{id}/reprocessamento`
`cancelado`	A SEFAZ confirmou o cancelamento
`encerrado`	A viagem terminou e a SEFAZ registrou o encerramento

historico[].em
obrigatório

string (date-time)

Data e hora em UTC, terminada em Z (ex. 2026-10-26T12:27:34Z).

historico[].mensagem string ou null

links
obrigatório object

links.self
obrigatório string

links.xml

string ou null

Vazio até autorizar.

links.damdfe

string ou null

Vazio até autorizar.

criadoEm
obrigatório

string (date-time)

Data e hora em UTC, terminada em Z (ex. 2026-10-26T12:27:34Z).

atualizadoEm
obrigatório

string (date-time)

Data e hora em UTC, terminada em Z (ex. 2026-10-26T12:27:34Z).

← Voltar ao início