Endpoints MDF-e Recebidos & Cargas
Monitoramento de manifestos de transporte modelo 58, rotas, veículos e download de DAMDFE.
Referência técnica completa dos endpoints da API REST para auditoria, rastreio e monitoramento de MDF-e (Manifesto Eletrônico de Documentos Fiscais - Modelo 58) emitidos por transportadoras e emitentes de carga onde a sua empresa participa como remetente, tomador ou interveniente de transporte perante o Ambiente Nacional da SEFAZ.
Endpoints Disponíveis
| Operação | Método e Rota | Referência Técnica |
|---|---|---|
| Listar MDF-e Recebidos | GET /api/mdfe/received | Ver Filtros & Parâmetros → |
| Status da Sincronização | GET /api/mdfe/received/sync-status | Ver NSU & Cooldown → |
| Sincronizar sob Demanda | POST /api/mdfe/received/sync | Ver Sincronização → |
| Configurar Busca Periódica | PUT /api/mdfe/received/settings | Ver Opt-in & Notificações → |
| Detalhes do Manifesto | GET /api/mdfe/received/:id | Ver Veículo & Documentos → |
| Download XML Original | GET /api/mdfe/received/:id/xml | Ver Download do XML → |
| Download DAMDFE (PDF) | GET /api/mdfe/received/:id/damdfe | Ver Download do PDF → |
Como Funciona a Captura de MDF-e
O webservice MdfeDistribuicaoDFe distribui os manifestos fiscais em que o CNPJ da empresa conste no documento fiscal vinculado (como emitente ou destinatário das mercadorias transportadas). Isso permite à sua empresa:
- Rastreabilidade de Cargas: Saber exatamente quando seus produtos entraram em trânsito rodoviário antes mesmo da chegada física na doca.
- Auditoria de Encerramento: Verificar se a transportadora encerrou o MDF-e na SEFAZ após a entrega, evitando bloqueios do veículo em postos fiscais de pesagem.
- Cruzamento com NF-e e CT-e: Conferência automática entre os conhecimentos de transporte contratados e as notas fiscais transportadas no mesmo veículo.
Disparar Sincronização de MDF-e
Solicita à fila distribuída a leitura do próximo lote de NSUs na SEFAZ:
Resposta da API
Retorno confirmando novos manifestos capturados:
Campos e Estrutura do MDF-e
| Campo | Tipo | Descrição |
|---|---|---|
| chave_acesso | string | Chave de acesso de 44 dígitos do MDF-e modelo 58. |
| numero | number | Número do manifesto fiscal. |
| serie | number | Série do documento. |
| uf_ini | string | Sigla da UF onde a viagem foi iniciada. |
| uf_fim | string | Sigla da UF de destino final do percurso. |
| placa | string | Placa do veículo de tração cadastrado no modal rodoviário. |
| status_viagem | string | EM_TRANSITO ou ENCERRADO na SEFAZ. |
| emitente_razao_social | string | Razão social da transportadora ou emitente do manifesto. |
| emitente_cnpj | string | CNPJ da empresa emitente do MDF-e. |