MDF-e

Emite um MDF-e a partir do corpo enviado. Os campos cMDF, cDV, cUF, dhEmi, mod, tpEmis, procEmi, verProc são calculados automaticamente pelo servidor. O cliente envia apenas os campos de negócio. Os campos serie e nMDF são opcionais: quando omitidos (ou 0) o servidor aloca a numeração automaticamente; quando enviados no request, são respeitados (útil para pular a numeração, por exemplo após uma duplicidade no Fisco).

Headers obrigatórios

Header	Tipo	Descrição
token	string	Token da empresa emissora
sign	string	Assinatura MD5: MD5(token + path + body + timestamp)
timestamp	string	Unix timestamp em segundos (janela de 5 minutos)

Body — raiz

Campo	Tipo	Descrição
ide *	object	Identificação do MDF-e
emit *	object	Dados do emitente
infModal *	object	Informações do modal (apenas UM dos quatro: rodo, aereo, aquav, ferrov)
infDoc *	object	Documentos fiscais vinculados
tot *	object	Totalizadores da carga
prodPred	object	Produto predominante da carga
seg	array	Informações de seguro
lacres	array	Lacres do MDF-e
autXML	array	CNPJs/CPFs autorizados a acessar o XML
infAdic	object	Informações adicionais (fisco e contribuinte)
infRespTec	object	Responsável técnico (CNPJ, contato, email, etc.)

ide — Identificação

Campo	Tipo	Descrição
tpAmb *	int	Ambiente: 1=produção, 2=homologação
tpEmit *	int	Tipo do emitente: 1=transportador, 2=carga própria, 3=prestador de serviço de transporte
modal *	string	Modal: "1"=rodoviário, "2"=aéreo, "3"=aquaviário, "4"=ferroviário
UFIni *	string	UF de início da viagem (2 letras)
UFFim *	string	UF de fim da viagem
infMunCarrega[] *	array	Municípios de carregamento: [{ cMunCarrega, xMunCarrega }]
infPercurso[]	array	UFs do percurso: [{ UFPer }]
tpTransp	string	Tipo de transportador (rodoviário)
dhIniViagem	string	Data/hora de início da viagem (ISO 8601)
indCanalVerde	string	Indicador de canal verde
indCarregaPosterior	string	Indicador de carregamento posterior
serie	int	Série do MDF-e (3 dígitos da chave de acesso). Opcional — auto-alocada (série de MDF-e da empresa) quando omitida ou 0; respeitada quando enviada
nMDF	int	Número do MDF-e (compõe a chave de acesso). Opcional — auto-incrementado pelo servidor quando omitido ou 0; respeitado quando enviado (útil para pular a numeração, ex.: após uma duplicidade)

emit — Emitente

Campo	Tipo	Descrição
CNPJ ⚠	string	CNPJ do emitente (14 dígitos)
CPF ⚠	string	CPF do emitente (11 dígitos)
IE	string	Inscrição Estadual
xNome *	string	Razão social
xFant	string	Nome fantasia
enderEmit	object	Endereço: { xLgr, nro, xCpl, xBairro, cMun, xMun, CEP, UF, fone, email }

infModal — Modal Rodoviário (modal="1")

Campo	Tipo	Descrição
rodo.veicTracao *	object	Veículo de tração: { placa, tara, RENAVAM, capKG, capM3, tpRod, tpCar, UF, condutor[], prop }
rodo.veicTracao.condutor[] *	array	Condutores: [{ xNome, CPF }] — mínimo 1
rodo.veicReboque[]	array	Veículos de reboque (mesma estrutura de veicTracao sem condutor)
rodo.infANTT	object	Informações da ANTT: { RNTRC, infCIOT[], valePed, infContratante[], infPag[] }
rodo.codAgPorto	string	Código de agendamento no porto
rodo.lacRodo[]	array	Lacres do modal: [{ nLacre }]

infModal — Modal Aéreo (modal="2")

Campo	Tipo	Descrição
aereo.nac *	string	Marca de nacionalidade da aeronave
aereo.matr *	string	Matrícula da aeronave
aereo.nVoo *	string	Número do voo
aereo.cAerEmb *	string	Código IATA do aeroporto de embarque
aereo.cAerDes *	string	Código IATA do aeroporto de destino
aereo.dVoo *	string	Data do voo (AAAA-MM-DD)

infModal — Modal Aquaviário (modal="3")

Campo	Tipo	Descrição
aquav.irin *	string	IRIN da embarcação
aquav.tpEmb *	string	Tipo de embarcação (2 dígitos). Use valores ≥ 10 para evitar truncamento do byte interno do Zeus (ex.: "10", "11")
aquav.cEmbar *	string	Código da embarcação
aquav.xEmbar *	string	Nome da embarcação
aquav.nViag *	string	Número da viagem. Não pode começar com zero (validação do schema) — use "1", "100", etc.
aquav.cPrtEmb *	string	Código do porto de embarque
aquav.cPrtDest *	string	Código do porto de destino
aquav.prtTrans	string	Porto de transbordo
aquav.tpNav	string	Tipo de navegação
aquav.infTermCarreg[]	array	Terminais de carregamento: [{ cTermCarreg, xTermCarreg }]
aquav.infTermDescarreg[]	array	Terminais de descarregamento
aquav.infEmbComb[]	array	Embarcações de comboio: [{ cEmbComb, xBalsa }]
aquav.infUnidCargaVazia[]	array	Unidades de carga vazias
aquav.infUnidTranspVazia[]	array	Unidades de transporte vazias

infModal — Modal Ferroviário (modal="4")

Campo	Tipo	Descrição
ferrov.trem *	object	Dados do trem: { xPref, dhTrem, xOri, xDest, qVag }
ferrov.vag[] *	array	Vagões: [{ pesoBC, pesoR, tpVag, serie, nVag, nSeq, TU }] — mínimo 1. Restrições do Zeus/Fisco: serie deve ter exatamente 3 dígitos (use 100+, ex.: "100"); nVag só aceita dígitos (long internamente, ex.: "100001"); nSeq opcional 1-3 dígitos.

infDoc — Documentos vinculados

Campo	Tipo	Descrição
infMunDescarga[] *	array	Municípios de descarga — mínimo 1
infMunDescarga[].cMunDescarga *	string	Código IBGE do município
infMunDescarga[].xMunDescarga *	string	Nome do município
infMunDescarga[].infNFe[]	array	NF-es vinculadas: [{ chNFe, SegCodBarras, indReentrega, infUnidTransp[], peri[] }]
infMunDescarga[].infCTe[]	array	CT-es vinculados
infMunDescarga[].infMDFeTransp[]	array	MDF-es de transporte (subcontratação)

prodPred — Produto predominante

Campo	Tipo	Descrição
tpCarga *	string	Tipo de carga: "01"=granel sólido, "02"=granel líquido, "03"=frigorificada, "04"=conteinerizada, "05"=carga geral, "06"=neogranel, "07"=perigosa, "08"=granel pressurizado
xProd *	string	Descrição do produto predominante
cEAN	string	GTIN/EAN
NCM	string	NCM
infLotacao	object	Lotação: { infLocalCarrega{CEP,latitude,longitude}, infLocalDescarrega{...} }

tot — Totalizadores

Campo	Tipo	Descrição
vCarga *	decimal	Valor total da carga (> 0)
cUnid *	string	Código da unidade: "01"=KG, "02"=TON
qCarga *	decimal	Quantidade total da carga (> 0)
qCTe	int	Quantidade de CT-es vinculados
qNFe	int	Quantidade de NF-es vinculadas
qMDFe	int	Quantidade de MDF-es vinculados

* Campo obrigatório. ⚠ Pelo menos um de CNPJ ou CPF é obrigatório.

Consulta a situação do MDF-e diretamente no Fisco a partir da chave de acesso.

Headers obrigatórios

Header	Tipo	Descrição
token	string	Token da empresa emissora
sign	string	Assinatura MD5
timestamp	string	Unix timestamp em segundos

Body

Campo	Tipo	Descrição
chMDFe *	string	Chave de acesso do MDF-e (44 dígitos)

* Campo obrigatório.

Cancela um MDF-e autorizado. Janela: até 24 horas após a autorização. Não permitido se o MDF-e já tiver sido encerrado.

Headers obrigatórios

Header	Tipo	Descrição
token	string	Token da empresa emissora
sign	string	Assinatura MD5
timestamp	string	Unix timestamp em segundos

Body

Campo	Tipo	Descrição
chMDFe *	string	Chave de acesso do MDF-e (44 dígitos)
xJust *	string	Justificativa do cancelamento (mínimo 15 caracteres por exigência Fisco)

* Campo obrigatório.

Encerra um MDF-e ao final da viagem. Após o encerramento, não é mais possível cancelar. Os campos dtEnc, cUF e cMun são opcionais — quando omitidos, o sistema infere a partir do MDF-e original (data atual, UF e município do emitente).

Headers obrigatórios

Header	Tipo	Descrição
token	string	Token da empresa emissora
sign	string	Assinatura MD5
timestamp	string	Unix timestamp em segundos

Body

Campo	Tipo	Descrição
chMDFe *	string	Chave de acesso do MDF-e (44 dígitos)
dtEnc	string	Data do encerramento (AAAA-MM-DD). Default: data atual
cUF	int	Código IBGE da UF onde ocorreu o encerramento. Default: UF do emitente
cMun	string	Código IBGE do município onde ocorreu o encerramento. Default: município do emitente

* Campo obrigatório.

Lista os MDF-e da empresa com paginação. Parâmetros passados via query string (não no body). O filtro de tempo é opcional, mas se enviado exige ambos start_create_time e end_create_time.

Headers obrigatórios

Header	Tipo	Descrição
token	string	Token da empresa emissora
sign	string	Assinatura MD5 (path inclui a query string)
timestamp	string	Unix timestamp em segundos

Query string

Parâmetro	Tipo	Descrição
page *	int	Número da página (≥ 1)
page_size *	int	Tamanho da página (1–50)
start_create_time	long	Unix timestamp em milissegundos — início (exige end_create_time)
end_create_time	long	Unix timestamp em milissegundos — fim
status	string	Filtrar por status. Valores: "Success" (autorizado), "Canceled" (cancelado), "Voided" (encerrado), "Processing" (em processamento), "Failed" (falhou), "Unknown" (desconhecido)

* Campo obrigatório.