Docs/MDF-e

MDF-e — Manifesto Eletrônico de Documentos Fiscais

API-first para emissão, consulta, cancelamento, encerramento e eventos de MDF-e (modelo 58). Não passa por venda nem por invoice de produto/serviço. A emissão é sempre em produção (SEFAZ tpAmb=1).

Ver requisitos de autenticação

Pré-requisitos

Certificado digital A1 válido na empresa
Série e próximo número em settings.mdfe (padrão série 1, número 1)
Assinatura com direito a emitir (mesmo limite mensal de notas)
Recurso features.mdfeEmission habilitado na conta

Configuração na empresa

JSON

{
  "settings": {
    "mdfe": {
      "series": 1,
      "number": 1
    }
  }
}

Fluxo assíncrono

POST /v1/companies/{companyId}/mdfe cria o documento e enfileira a transmissão à SEFAZ. A resposta imediata traz status: processing (ou pending se ainda não enfileirado). O desfecho chega por webhook (mdfe.authorized / mdfe.rejected) ou por GET /v1/companies/{companyId}/mdfe/{id}.

Após autorizado, use POST .../close para encerrar o manifesto, POST .../drivers, POST .../documents ou POST .../payments para eventos complementares, e DELETE .../mdfe/{id} para cancelamento (com justificativa).

Idempotência

Informe Idempotency-Key (header) ou externalId no body. A chave é única por empresa na coleção mdfes.

Campos Zod ↔ tag XML

Campo (API)	Tag / grupo XSD
`ufStart`	`ide/UFIni`
`ufEnd`	`ide/UFFim`
`municipalityStartIbge`	`ide/infMunCarrega/cMunCarrega`
`issueDate`	`ide/dhEmi`
`modal.kind`	`ide/modal` (1 rodoviário)
`modal.rntrc`	`infModal/rodo/infANTT/RNTRC`
`modal.vehicle`	`infModal/rodo/veicTracao`
`modal.trailers[]`	`infModal/rodo/reboque`
`drivers[]` / `modal.drivers[]`	`infModal/rodo/condutor`
`documents[].cityCode`	`infDoc/infMunDescarga/cMunDescarga`
`documents[].nfeAccessKeys[]`	`infDoc/infNFe/chNFe`
`documents[].cteAccessKeys[]`	`infDoc/infCTe/chCTe`
`documents[].mdfeAccessKeys[]`	`infDoc/infMDFeTransp/chMDFe`
`cargoTotalAmount`	`tot/vCarga`
`cargoQuantity`	`tot/qCarga`
`cargoUnit`	`tot/cUnid` (default KG → 01)
`insurance[]`	`seg`
`predominantProduct`	`prodPred`
`seals[]`	`lacres`
`autXml[]`	`autXML`
`additional`	`infAdic`
`techResponsible`	`infRespTec`
`payments[]`	`infPag`
(empresa cadastrada)	`emit`, `enderEmit`