Pular para o conteúdo principal

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

CampoTipoDescrição
issuerIdstringID da empresa emissora
ufStartstringUF de início do transporte (ex: "SP")
ufEndstringUF de destino (ex: "RJ")
dtViagemstringData/hora início viagem (ISO 8601)
placaVeiculostringPlaca do veículo de tração
rntrcstringRNTRC (Registro Nacional de Transportadores)
cpfMotoristastringCPF do motorista
nomeMotoristastringNome do motorista
documentosarrayDocumentos vinculados (NFe/CTe)

Campos Opcionais

CampoTipoDescrição
seriesnumberSérie do MDFe
percursoarrayUFs de passagem (ex: ["MG"])
municipiosCarregamentoarrayMunicípios de carregamento
municipiosDescarregamentoarrayMunicípios de descarregamento
renavamstringRENAVAM do veículo
taranumberPeso do veículo vazio (KG)
capKgnumberCapacidade em KG
capM3numberCapacidade em M³
tipoCarroceriastring"01" Caminhão, "02" Carreta, "03" Cavalo Mecânico
tipoRodadostring"00" N/A, "01" Aberta, "02" Fechada/Baú, "03" Granelera, "04" Porta Container, "05" Sider
ciotstringCódigo CIOT
vCarganumberValor total da carga
pesoBrutonumberPeso bruto total (KG)
produtoPredominanteobjectProduto predominante
seguroobjectDados do seguro
lacresarrayNúmeros dos lacres
informacoesComplementaresstringInfo adicional

Objeto documentos[]

CampoTipoObrigatórioDescrição
chNFestringChave de acesso do documento (44 dígitos)
tpDocstring"1" NFe, "2" CTe

Objeto municipiosCarregamento[]

CampoTipoObrigatórioDescrição
codigoMunicipiostringCódigo IBGE
nomestringNome do município

Objeto municipiosDescarregamento[]

CampoTipoObrigatórioDescrição
codigoMunicipiostringCódigo IBGE
nomestringNome do município
documentosarrayDocumentos descarregados neste município

Objeto produtoPredominante

CampoTipoObrigatórioDescrição
nomestringNome do produto (ex: "CARGA EM GERAL")
ncmstringNCM
cEANstringEAN/GTIN

Objeto seguro

CampoTipoDescrição
responsavelinteger1 Emitente, 2 Tomador
cnpjSeguradorastringCNPJ da seguradora
nomeSeguradorastringNome da seguradora
numApolicestringNúmero da apólice
numAverbacaostringNú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"
}
}