Pular para o conteúdo

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.

  1. 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": "..." } }
  2. 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"
    }
    }
  3. 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" com data.situacao = ENCERRADO e data.viagem = ENCERRADA.

Campos do manifesto

CampoObrigatórioRegra
numero-origemsimSeu identificador da viagem (até 60 caracteres). Veja Reenvio
manifesto.seriesimSérie do MDF-e (ex.: "1")
manifesto.numeronãoOmitido = próximo número da série (recomendado)
manifesto.tipo-emitentenão1 prestador de serviço de transporte, 2 carga própria (padrão), 3 prestador com CT-e globalizado
manifesto.veiculo.placasimVeículo de tração cadastrado na empresa. Padrão antigo ou Mercosul; o hífen é ignorado
manifesto.reboques[].placanãoAté 3, cadastrados como reboque
manifesto.condutor.cpfsimPessoa física cadastrada na empresa. Outros condutores entram depois pela inclusão de condutor
manifesto.municipio-carregamentosimCódigo IBGE (7 dígitos)
manifesto.municipio-descargasimCódigo IBGE. Um por manifesto — documentos para outro município vão em outro MDF-e (pode ser o mesmo veículo)
manifesto.percursonãoUFs atravessadas entre o carregamento e a descarga, em ordem (ex.: ["MG"])
manifesto.documentossim*NF-e (55) e CT-e (57) pela chave. *Dispensado só com carga-posterior
manifesto.carga-posteriornãotrue = 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.rntrcnãoRNTRC do transportador (8 dígitos)
manifesto.ciotnãoCIOT da operação (12 dígitos). Veja Emitir CIOT
manifesto.seguroquando tipo-emitente é 1 ou 3Veja abaixo
manifesto.vale-pedagionãoVeja 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) e valor, maiores que zero.
  • A chave tem 44 dígitos e o dígito verificador é conferido: chave digitada errado volta 400 na 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 tentativaO reenvio com o mesmo numero-origem
na fila, autorizada ou aguardando A3devolve 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.

Códigos de status

Veja Códigos de status — MDF-e.