MDF-e (Manifesto)

Criar manifesto MDF-e

Cria o manifesto MDF-e (modelo 58) em modo rascunho com vínculo de percurso (UF inicial e final), veículo de tração, condutor e chaves de documentos fiscais transportados (NF-e ou CT-e).

POST
https://api.nfer.me
/v1/mdfe

Authorizations

X-API-Key
string
header
required

Chave de API emitida no painel NFER enviada no header da requisição.

Content-Type
string
header
required

application/json

Body

application/json
modal
string
opcional
default:01

Modal de transporte. Padrão: "01" (Rodoviário).

Exemplo:01
ufIni
string
required

Sigla da UF de início da viagem (carregamento).

Exemplo:SP
ufFim
string
required

Sigla da UF de destino final da viagem (descarregamento).

Exemplo:RJ
ufsPercurso
string[]
opcional

Lista ordenada de UFs transitadas entre a origem e o destino quando não fizerem fronteira direta.

Exemplo:["MG"]
veiculoTracao
object
required

Dados do caminhão/veículo trator: { placa, uf?, rntrc?, tara?, capKG?, capM3?, tpRod?, tpCar? }.

condutores
object[]
opcional

Lista de motoristas habilitados na viagem: [{ xNome, cpf }].

Exemplo:[{"xNome":"Carlos Eduardo da Silva","cpf":"12345678909"}]
documentos
object[]
required

Chaves de acesso vinculadas ao manifesto (NF-e e/ou CT-e): [{ tipo: "NFe" | "CTe", chave, cMunDescarga?, xMunDescarga? }].

Exemplo:[{"tipo":"NFe","chave":"35260900000000000191550010000001051000001054"}]
totVCarga
number
opcional

Valor total consolidado das mercadorias transportadas.

Exemplo:45000.00
totQCarga
number
opcional

Peso bruto total da carga em KG.

Exemplo:1250.50

Response

application/json

MDF-e criado com status rascunho.

id
string<uuid>
opcional

Identificador único do recurso.

Exemplo:5e4d3c2b-1a09-4876-b543-987654abcdef
company_id
string<uuid>
opcional

Identificador único da empresa emissora.

Exemplo:a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11
numero
integer
opcional

Número da nota fiscal.

Exemplo:42
serie
integer
opcional

Série da nota fiscal.

Exemplo:1
status
string
opcional

Status atual do processamento da nota.

Exemplo:rascunho
uf_ini
string
opcional

Exemplo retornado: "SP"

Exemplo:SP
uf_fim
string
opcional

Exemplo retornado: "RJ"

Exemplo:RJ
tot_v_carga
integer
opcional
Exemplo:45000
created_at
string<date-time>
opcional

Data e hora de criação do registro.

Exemplo:2026-09-20T22:00:00.000Z
curl --request POST \
  --url https://api.nfer.me/v1/mdfe \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ufIni": "SP",
  "ufFim": "RJ",
  "ufsPercurso": [
    "MG"
  ],
  "veiculoTracao": {
    "placa": "ABC1D23",
    "uf": "SP",
    "rntrc": "12345678",
    "tara": 5000,
    "capKG": 15000
  },
  "condutores": [
    {
      "xNome": "Carlos Eduardo da Silva",
      "cpf": "12345678909"
    }
  ],
  "documentos": [
    {
      "tipo": "NFe",
      "chave": "35260900000000000191550010000001051000001054",
      "cMunDescarga": "3304557",
      "xMunDescarga": "Rio de Janeiro"
    }
  ],
  "totVCarga": 45000,
  "totCUnid": "01",
  "totQCarga": 1250.5
}'
{
  "id": "5e4d3c2b-1a09-4876-b543-987654abcdef",
  "company_id": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
  "numero": 42,
  "serie": 1,
  "status": "rascunho",
  "uf_ini": "SP",
  "uf_fim": "RJ",
  "tot_v_carga": 45000,
  "created_at": "2026-09-20T22:00:00.000Z"
}