Emitir MDFe
POST /mdfe/emitir
Emite um Manifesto de Documentos Fiscais Eletrônicos (modelo 58).
Autenticação
Authorization: Bearer {token} ou x-api-key: {apiKey}
Parâmetros do Body
Campos Obrigatórios
| Campo | Tipo | Descrição |
|---|---|---|
issuerId | string | ID da empresa emissora |
ufStart | string | UF de início do transporte (ex: "SP") |
ufEnd | string | UF de destino (ex: "RJ") |
dtViagem | string | Data/hora início viagem (ISO 8601) |
placaVeiculo | string | Placa do veículo de tração |
rntrc | string | RNTRC (Registro Nacional de Transportadores) |
cpfMotorista | string | CPF do motorista |
nomeMotorista | string | Nome do motorista |
documentos | array | Documentos vinculados (NFe/CTe) |
Campos Opcionais
| Campo | Tipo | Descrição |
|---|---|---|
series | number | Série do MDFe |
percurso | array | UFs de passagem (ex: ["MG"]) |
municipiosCarregamento | array | Municípios de carregamento |
municipiosDescarregamento | array | Municípios de descarregamento |
renavam | string | RENAVAM do veículo |
tara | number | Peso do veículo vazio (KG) |
capKg | number | Capacidade em KG |
capM3 | number | Capacidade em M³ |
tipoCarroceria | string | "01" Caminhão, "02" Carreta, "03" Cavalo Mecânico |
tipoRodado | string | "00" N/A, "01" Aberta, "02" Fechada/Baú, "03" Granelera, "04" Porta Container, "05" Sider |
ciot | string | Código CIOT |
vCarga | number | Valor total da carga |
pesoBruto | number | Peso bruto total (KG) |
produtoPredominante | object | Produto predominante |
seguro | object | Dados do seguro |
lacres | array | Números dos lacres |
informacoesComplementares | string | Info adicional |
Objeto documentos[]
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
chNFe | string | ✅ | Chave de acesso do documento (44 dígitos) |
tpDoc | string | ✅ | "1" NFe, "2" CTe |
Objeto municipiosCarregamento[]
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
codigoMunicipio | string | ✅ | Código IBGE |
nome | string | ✅ | Nome do município |
Objeto municipiosDescarregamento[]
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
codigoMunicipio | string | ✅ | Código IBGE |
nome | string | ✅ | Nome do município |
documentos | array | ✅ | Documentos descarregados neste município |
Objeto produtoPredominante
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
nome | string | ✅ | Nome do produto (ex: "CARGA EM GERAL") |
ncm | string | NCM | |
cEAN | string | EAN/GTIN |
Objeto seguro
| Campo | Tipo | Descrição |
|---|---|---|
responsavel | integer | 1 Emitente, 2 Tomador |
cnpjSeguradora | string | CNPJ da seguradora |
nomeSeguradora | string | Nome da seguradora |
numApolice | string | Número da apólice |
numAverbacao | string | Número da averbação |
Exemplo
curl -X POST https://api.engineapi.com.br/mdfe/emitir \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"issuerId": "ISSUER_ID",
"ufStart": "SP",
"ufEnd": "RJ",
"dtViagem": "2026-02-15T08:00:00",
"placaVeiculo": "ABC1D23",
"rntrc": "12345678",
"cpfMotorista": "12345678901",
"nomeMotorista": "João da Silva",
"documentos": [
{ "chNFe": "35260211222333000144550010000000011000000019", "tpDoc": "1" }
],
"vCarga": 50000.00,
"pesoBruto": 15000
}'
Resposta (200)
{
"success": true,
"mdfe": {
"id": "uuid",
"accessKey": "35260211222333000144580010000000011000000019",
"number": 1,
"status": "AUTHORIZED"
}
}