Cancelando um MDF-e

POST /v1/mdfe/cancelar

{
  "cpf_cnpj": "11222333000181",
  "chave": "3126...",
  "justificativa": "Viagem cancelada antes do inicio do transporte"
}

Justificativa com mínimo de 15 caracteres — exigência do autorizador. Consome cota.

Só antes de a viagem começar

Depois disso, o caminho é o encerramento

O cancelamento vale enquanto o transporte não começou. Uma vez iniciada a viagem, o manifesto não se cancela: ele se encerra.

Situação	O que fazer
manifesto emitido, veículo ainda parado	cancelar
viagem em andamento ou concluída	encerrar
manifesto rejeitado	nada — não chegou a valer

Confundir os dois é o erro mais comum de quem está começando com MDF-e, e a SEFAZ responde com rejeição, não com orientação.

Há também prazo: cada UF define até quando o cancelamento é aceito, e ele é curto. Confirme a regra do estado do emitente.

Depois do cancelamento

O XML do evento fica disponível como xml_cancelamento — ver Arquivos.