Emitir MDF-e
O MDF-e (modelo 58) é o manifesto da viagem: veículo, condutor, de onde a carga sai, onde ela é descarregada e quais NF-e/CT-e estão no caminhão. A API do FazNota monta o manifesto a partir do corpo da requisição, transmite à SEFAZ e acompanha o manifesto até o encerramento, que é obrigatório ao fim da viagem.
O FazNota emite o MDF-e rodoviário.
Montagem pelo corpo da requisição, contrato completo e consulta por recibo desde a versão 3.21.0.
Pré-requisitos no cadastro da empresa (FazNota)
- Certificado digital. Com A1 o manifesto é transmitido no processamento. Com A3 ele é montado e fica aguardando a assinatura no aplicativo assinador (veja Certificado A3).
- Veículo de tração (e os reboques, se houver) cadastrados na empresa. A API acha o veículo pela placa.
- Condutor cadastrado como pessoa física na empresa. A API acha o condutor pelo CPF.
Fluxo
Como toda operação da v3, o MDF-e é assíncrono: você envia o pedido, recebe um recibo e
consulta o resultado.
-
Emitir
Terminal window curl -X POST $BASE/mdfe/emissao \-H "Authorization: Token $TOKEN" \-H "Content-Type: application/json" \-d '{"numero-origem": "VIAGEM-2026-0042","manifesto": {"serie": "1","tipo-emitente": 2,"veiculo": { "placa": "ABC1D23" },"reboques": [ { "placa": "XYZ9A87" } ],"condutor": { "cpf": "52998224725" },"municipio-carregamento": "3550308","municipio-descarga": "3304557","percurso": [],"documentos": [{ "chave": "35261112345678000195550010000000011123456785" },{ "chave": "35261198765432000110550010000012341987654323", "peso": 1200.5, "valor": 15000.00 }]}}'Resposta:
{ "status": "001", "descricao": "Manifesto eletrônico registrado com sucesso.","data": { "recibo": "..." } } -
Consultar o resultado
Faça polling com intervalo mínimo de 2 segundos:
Terminal window curl $BASE/mdfe/{recibo} -H "Authorization: Token $TOKEN"Quando a SEFAZ autoriza:
{"status": "004","descricao": "MDF-e autorizado pela SEFAZ.","data": {"recibo": "...","processo": "emissao","situacao": "AUTORIZADO","id-mdfe": "19876","chave": "3526115...","numero": "42","serie": "1","protocolo": "935260000123456","c-stat": "100","x-motivo": "Autorizado o uso do MDF-e","data-autorizacao": "2026-11-15T10:32:07-03:00","viagem": "ABERTA"}} -
Encerrar ao fim da viagem
Terminal window curl -X POST $BASE/mdfe/encerramento \-H "Authorization: Token $TOKEN" -H "Content-Type: application/json" \-d '{ "recibo": "<recibo da emissão>", "municipio-encerramento": "3304557" }'A consulta do recibo do encerramento responde
status: "004"comdata.situacao=ENCERRADOedata.viagem=ENCERRADA.
Campos do manifesto
| Campo | Obrigatório | Regra |
|---|---|---|
numero-origem | sim | Seu identificador da viagem (até 60 caracteres). Veja Reenvio |
manifesto.serie | sim | Série do MDF-e (ex.: "1") |
manifesto.numero | não | Omitido = próximo número da série (recomendado) |
manifesto.tipo-emitente | não | 1 prestador de serviço de transporte, 2 carga própria (padrão), 3 prestador com CT-e globalizado |
manifesto.veiculo.placa | sim | Veículo de tração cadastrado na empresa. Padrão antigo ou Mercosul; o hífen é ignorado |
manifesto.reboques[].placa | não | Até 3, cadastrados como reboque |
manifesto.condutor.cpf | sim | Pessoa física cadastrada na empresa. Outros condutores entram depois pela inclusão de condutor |
manifesto.municipio-carregamento | sim | Código IBGE (7 dígitos) |
manifesto.municipio-descarga | sim | Código IBGE. Um por manifesto — documentos para outro município vão em outro MDF-e (pode ser o mesmo veículo) |
manifesto.percurso | não | UFs atravessadas entre o carregamento e a descarga, em ordem (ex.: ["MG"]) |
manifesto.documentos | sim* | NF-e (55) e CT-e (57) pela chave. *Dispensado só com carga-posterior |
manifesto.carga-posterior | não | true = sai sem documento; as NF-e entram depois pela inclusão de DF-e. Exige valor-carga e peso-carga (kg), ignorados quando há documentos |
manifesto.rntrc | não | RNTRC do transportador (8 dígitos) |
manifesto.ciot | não | CIOT da operação (12 dígitos). Veja Emitir CIOT |
manifesto.seguro | quando tipo-emitente é 1 ou 3 | Veja abaixo |
manifesto.vale-pedagio | não | Veja abaixo |
Documentos
- NF-e emitida no FazNota (autorizada): basta a
chave. Peso e valor vêm da própria nota. A UF de destino da nota precisa ser a do município de descarga. - NF-e de outro sistema, ou CT-e:
chave,peso(kg) evalor, maiores que zero. - A chave tem 44 dígitos e o dígito verificador é conferido: chave digitada errado volta
400na hora. - Uma NF-e do FazNota só entra em um manifesto da empresa (de novo, só se o anterior foi cancelado).
Seguro
Obrigatório quando o emitente é prestador de serviço de transporte (tipo-emitente 1 ou 3) —
a SEFAZ exige o seguro da carga.
"seguro": { "responsavel": 1, "seguradora": "Seguradora Exemplo", "cnpj-seguradora": "11222333000181", "apolice": "AP-2026-77", "averbacoes": ["0001234567"]}responsavel: 1 emitente do MDF-e, 2 contratante do serviço (então informe
cpf-cnpj-responsavel). De 1 a 24 averbações, até 40 caracteres cada.
Vale-pedágio
"vale-pedagio": { "tipo": "01", "cnpj-fornecedor": "11222333000181", "numero-compra": "C-9", "valor": 87.40 }tipo: 01 TAG, 02 cupom, 03 cartão, 04 leitura de placa. cnpj-pagador é opcional.
Rascunho montado na tela
Se o manifesto já foi montado na tela do FazNota, emita pelo id dele:
{ "numero-origem": "VIAGEM-2026-0043", "id-mdfe": "19876" }Conferência antes de transmitir
Antes de ir à SEFAZ, o FazNota confere o rascunho: veículo, municípios, condutor, documentos, seguro e outro MDF-e não encerrado no mesmo veículo. Havendo pendência, nada é transmitido e a consulta responde:
{ "status": "900", "descricao": "O MDF-e foi recusado.", "data": { "situacao": "REJEITADO", "erro": "O MDF-e nao foi transmitido: ha pendencias no manifesto.", "pendencias": [ "O veículo tem o MDF-e nº 41 ainda não encerrado com descarregamento em RJ: encerre esse antes de emitir este (encerrar_mdfe)." ] }}Reenvio
numero-origem é obrigatório e decide o que acontece quando o mesmo pedido chega de novo:
| Última tentativa | O reenvio com o mesmo numero-origem |
|---|---|
| na fila, autorizada ou aguardando A3 | devolve o recibo original |
erro técnico (999) | é aceito com o mesmo manifesto e transmite o mesmo rascunho — mesma chave e número. Se a SEFAZ chegou a autorizar, ela responde duplicidade em vez de nascer um segundo MDF-e. Corpo diferente é recusado (400): o rascunho anterior pode já ter sido transmitido |
recusa (900) | é aceito com o manifesto corrigido; o rascunho recusado é descartado |
Eventos
Nos eventos, identifique o manifesto por um destes campos: recibo (o da emissão), chave
(44 dígitos, modelo 58) ou id-mdfe. Evento só vale para manifesto autorizado e aberto. Cada
evento devolve o seu próprio recibo, consultado em GET /mdfe/{recibo}. Enquanto uma operação
do mesmo manifesto está na fila, outra é recusada (400, com o recibo da que está em andamento).
Encerrar
{ "chave": "3526115...", "municipio-encerramento": "3304557" }municipio-encerramento é onde a viagem terminou; omitido, vale o município de descarga do
manifesto.
Cancelar
{ "recibo": "<recibo da emissão>", "motivo": "Viagem cancelada pelo contratante." }motivo de 15 a 255 caracteres. A SEFAZ só aceita o cancelamento nas primeiras 24 horas e antes
do encerramento. A consulta do recibo responde status: "010".
Incluir condutor
{ "recibo": "<recibo da emissão>", "condutor": { "cpf": "11144477735" } }O condutor precisa estar cadastrado na empresa. O recibo responde 004 com data.evento
(tipo, sequencia, protocolo).
Incluir documento
{ "id-mdfe": "19876", "documentos": [ { "chave": "3526...", "peso": 300, "valor": 4200.00 } ] }Só NF-e (modelo 55): o evento de inclusão não carrega CT-e. NF-e emitida no FazNota dispensa
peso e valor; NF-e de outro sistema os exige. O município de descarga é o do manifesto. Chave
que a SEFAZ já tem neste manifesto (no MDF-e autorizado ou numa inclusão registrada) é recusada;
depois de um 999 reenvie a mesma inclusão.
Certificado A3
Com A3 o manifesto (ou o evento) é montado e fica aguardando a assinatura no computador com o
certificado conectado. A consulta responde status: "002" com data.situacao =
AGUARDANDO_ASSINATURA_A3. Isso não é autorização e reenviar não adianta: quem precisa agir é
o operador, no aplicativo assinador. Depois de assinado e registrado pela SEFAZ, o mesmo recibo passa
a responder pelo estado do manifesto (004; 010 no cancelamento). Se a SEFAZ recusar depois
da assinatura, o recibo continua em 002: confira o motivo na tela do MDF-e no FazNota.