Weesy API Fiscal — MDF‑e (1.0.0)

O MDF-e (Manifesto Eletrônico de Documentos Fiscais, modelo 58) é o documento que acompanha o caminhão na viagem e lista os CT-e da carga que ele leva. Com esta API você manda os dados da viagem e a Weesy gera o XML, assina com o certificado digital da empresa e envia para a SEFAZ.

Como funciona

1. Antes de sair, emita o MDF-e em POST /mdfe com os CT-e que vão no caminhão. A resposta (201) só confirma que recebemos — o MDF-e ainda não está autorizado.
2. O resultado chega pelo webhook (mdfe.autorizado, mdfe.rejeitado...) ou consultando GET /mdfe/{id}.
3. Quando a viagem terminar, encerre o MDF-e em POST /mdfe/{id}/encerramento. Isso é obrigatório: enquanto um MDF-e estiver aberto, a SEFAZ recusa o próximo MDF-e do mesmo veículo (por exemplo, a viagem de volta).

Bom saber

• Hoje a Weesy emite MDF-e do modal rodoviário, versão 3.00 do leiaute.
• O MDF-e é sempre de uma empresa (cnpjEmitente), que precisa estar cadastrada na Weesy com certificado digital A1. Os dados da empresa vêm do cadastro.
• MDF-e de outra empresa responde 404, como se não existisse.
• Os valores de status podem ganhar itens novos no futuro: trate valor desconhecido sem quebrar.
• Convenções (nomes, datas, dinheiro, erros) são as mesmas da NFS-e — veja comum.yaml.