Emissão
Novo

Emissão MDF-e Passo a Passo

Criação do manifesto, envio à SEFAZ, encerramento no destino e DAMDFE em PDF.

O MDF-e (Manifesto Eletrônico de Documentos Fiscais, modelo 58) é o documento fiscal obrigatório para transportadoras e empresas emitentes de carga própria que realizam transporte interestadual ou intermunicipal com mais de um CT-e ou NF-e no mesmo veículo. Ele consolida a carga, identifica o veículo de tração e os motoristas.

BASE URL
https://api.nfer.me/v1

Exemplo de Criação de MDF-e

Requisição padrão informando veículo, motoristas, rota interestadual e documentos originários:

curl -s -X POST https://api.nfer.me/v1/mdfe \
-H "X-API-Key: $NFER_KEY" \
-H "Content-Type: application/json" \
-d '{
"modal": "01",
"ufIni": "SP",
"ufFim": "RJ",
"ufsPercurso": ["MG"],
"veiculoTracao": {
"placa": "ABC1D23",
"uf": "SP",
"rntrc": "12345678",
"tara": 5000,
"capKG": 15000
},
"condutores": [
{
"xNome": "Carlos Eduardo da Silva",

Fluxo de Emissão e Encerramento

1POST /v1/mdfe

Criar Rascunho

Agrupa as notas e conhecimentos, calcula o peso total e valida a placa do veículo na SEFAZ. Retorna 201 Created.

2POST /v1/mdfe/:id/send

Transmitir & DAMDFE

Assina com Certificado A1 e transmite à SEFAZ de origem (202 Accepted), liberando o DAMDFE em PDF para viagem.

3POST .../close

Encerrar Viagem

Ao entregar a mercadoria no destino final, encerre o manifesto para liberar o veículo para novas viagens sem bloqueios de barreira fiscal.

Estrutura do Payload

Principais grupos exigidos no manifesto de carga:

BlocoCampoPropósito e Conteúdo
Rota e PercursoufIni, ufFim, ufsPercurso[]UF de partida, UF de destino e lista ordenada das UFs intermediárias por onde o caminhão transitará.
Veículo de TraçãoveiculoTracaoPlaca, UF de licenciamento, RNTRC (registro ANTT), tara em kg e capacidade de carga.
Motoristascondutores[]Nome completo e CPF do condutor (ou condutores) habilitados a dirigir o veículo.
Cargas e Documentosdocumentos[]Lista de chaves de NF-e ou CT-e acobertadas, com o município de descarregamento correspondente.
Totais da CargatotVCarga, totQCargaValor total das mercadorias transportadas e peso bruto total da carga em quilogramas.

Operações Relacionadas

Endpoints dedicados para o manifesto eletrônico:

OperaçãoMétodo e RotaReferência Técnica
Criar MDF-ePOST /v1/mdfeVer Parâmetros →
Transmitir à SEFAZPOST /v1/mdfe/:id/sendVer Transmissão →
Consultar MDF-eGET /v1/mdfe/:idVer Retorno e Status →
Baixar DAMDFE (PDF)GET /v1/mdfe/:id/damdfeVer Download do PDF →
Encerrar ViagemPOST /v1/mdfe/:id/closeVer Evento de Encerramento →
Incluir CondutorPOST /v1/mdfe/:id/condutorVer Troca de Motorista →
Cancelar MDF-ePOST /v1/mdfe/:id/cancelVer Cancelamento →

Próximos Passos