MDF-e

Emite un MDF-e a partir del cuerpo enviado. Los campos cMDF, cDV, cUF, dhEmi, mod, tpEmis, procEmi, verProc son calculados automáticamente por el servidor. El cliente envía únicamente los campos de negocio. Los campos serie y nMDF son opcionales: se asignan automáticamente cuando se omiten (o valen 0), o se respetan cuando se envían en la solicitud (útil para saltar la numeración, por ejemplo tras una duplicidad en la autoridad fiscal).

Headers obligatorios

Header	Tipo	Descripción
token	string	Token de la empresa emisora
sign	string	Firma MD5: MD5(token + path + body + timestamp)
timestamp	string	Unix timestamp en segundos (ventana de 5 minutos)

Body — raíz

Campo	Tipo	Descripción
ide *	object	Identificación del MDF-e
emit *	object	Datos del emisor
infModal *	object	Información del modal (solo UNO de los cuatro: rodo, aereo, aquav, ferrov)
infDoc *	object	Documentos fiscales vinculados
tot *	object	Totalizadores de la carga
prodPred	object	Producto predominante de la carga
seg	array	Información de seguro
lacres	array	Precintos del MDF-e
autXML	array	CNPJs/CPFs autorizados a acceder al XML
infAdic	object	Información adicional (fisco y contribuyente)
infRespTec	object	Responsable técnico (CNPJ, contacto, email, etc.)

ide — Identificación

Campo	Tipo	Descripción
tpAmb *	int	Ambiente: 1=producción, 2=homologación
tpEmit *	int	Tipo del emisor: 1=transportador, 2=carga propia, 3=prestador de servicio de transporte
modal *	string	Modal: "1"=carretero, "2"=aéreo, "3"=acuaviario, "4"=ferroviario
UFIni *	string	UF de inicio del viaje (2 letras)
UFFim *	string	UF de fin del viaje
infMunCarrega[] *	array	Municipios de carga: [{ cMunCarrega, xMunCarrega }]
infPercurso[]	array	UFs del recorrido: [{ UFPer }]
tpTransp	string	Tipo de transportador (carretero)
dhIniViagem	string	Fecha/hora de inicio del viaje (ISO 8601)
indCanalVerde	string	Indicador de canal verde
indCarregaPosterior	string	Indicador de carga posterior
serie	int	Serie del MDF-e (3 dígitos de la clave de acceso). Opcional — autoasignada (serie de MDF-e de la empresa) cuando se omite o vale 0; respetada cuando se envía
nMDF	int	Número del MDF-e (compone la clave de acceso). Opcional — autoincrementado por el servidor cuando se omite o vale 0; respetado cuando se envía (útil para saltar la numeración, por ejemplo tras una duplicidad)

emit — Emisor

Campo	Tipo	Descripción
CNPJ ⚠	string	CNPJ del emisor (14 dígitos)
CPF ⚠	string	CPF del emisor (11 dígitos)
IE	string	Inscripción Estadual
xNome *	string	Razón social
xFant	string	Nombre de fantasía
enderEmit	object	Dirección: { xLgr, nro, xCpl, xBairro, cMun, xMun, CEP, UF, fone, email }

infModal — Modal Carretero (modal="1")

Campo	Tipo	Descripción
rodo.veicTracao *	object	Vehículo de tracción: { placa, tara, RENAVAM, capKG, capM3, tpRod, tpCar, UF, condutor[], prop }
rodo.veicTracao.condutor[] *	array	Conductores: [{ xNome, CPF }] — mínimo 1
rodo.veicReboque[]	array	Vehículos de remolque (misma estructura de veicTracao sin conductor)
rodo.infANTT	object	Información de la ANTT: { RNTRC, infCIOT[], valePed, infContratante[], infPag[] }
rodo.codAgPorto	string	Código de agendamiento en el puerto
rodo.lacRodo[]	array	Precintos del modal: [{ nLacre }]

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

Campo	Tipo	Descripción
aereo.nac *	string	Marca de nacionalidad de la aeronave
aereo.matr *	string	Matrícula de la aeronave
aereo.nVoo *	string	Número del vuelo
aereo.cAerEmb *	string	Código IATA del aeropuerto de embarque
aereo.cAerDes *	string	Código IATA del aeropuerto de destino
aereo.dVoo *	string	Fecha del vuelo (AAAA-MM-DD)

infModal — Modal Acuaviario (modal="3")

Campo	Tipo	Descripción
aquav.irin *	string	IRIN de la embarcación
aquav.tpEmb *	string	Tipo de embarcación (2 dígitos). Use valores ≥ 10 para evitar el truncamiento del byte interno del Zeus (ej.: "10", "11")
aquav.cEmbar *	string	Código de la embarcación
aquav.xEmbar *	string	Nombre de la embarcación
aquav.nViag *	string	Número del viaje. No puede empezar con cero (validación del schema) — use "1", "100", etc.
aquav.cPrtEmb *	string	Código del puerto de embarque
aquav.cPrtDest *	string	Código del puerto de destino
aquav.prtTrans	string	Puerto de transbordo
aquav.tpNav	string	Tipo de navegación
aquav.infTermCarreg[]	array	Terminales de carga: [{ cTermCarreg, xTermCarreg }]
aquav.infTermDescarreg[]	array	Terminales de descarga
aquav.infEmbComb[]	array	Embarcaciones de convoy: [{ cEmbComb, xBalsa }]
aquav.infUnidCargaVazia[]	array	Unidades de carga vacías
aquav.infUnidTranspVazia[]	array	Unidades de transporte vacías

infModal — Modal Ferroviario (modal="4")

Campo	Tipo	Descripción
ferrov.trem *	object	Datos del tren: { xPref, dhTrem, xOri, xDest, qVag }
ferrov.vag[] *	array	Vagones: [{ pesoBC, pesoR, tpVag, serie, nVag, nSeq, TU }] — mínimo 1. Restricciones del Zeus/autoridad fiscal: serie debe tener exactamente 3 dígitos (use 100+, ej.: "100"); nVag solo acepta dígitos (long internamente, ej.: "100001"); nSeq opcional 1-3 dígitos.

infDoc — Documentos vinculados

Campo	Tipo	Descripción
infMunDescarga[] *	array	Municipios de descarga — mínimo 1
infMunDescarga[].cMunDescarga *	string	Código IBGE del municipio
infMunDescarga[].xMunDescarga *	string	Nombre del municipio
infMunDescarga[].infNFe[]	array	NF-es vinculadas: [{ chNFe, SegCodBarras, indReentrega, infUnidTransp[], peri[] }]
infMunDescarga[].infCTe[]	array	CT-es vinculados
infMunDescarga[].infMDFeTransp[]	array	MDF-es de transporte (subcontratación)

prodPred — Producto predominante

Campo	Tipo	Descripción
tpCarga *	string	Tipo de carga: "01"=granel sólido, "02"=granel líquido, "03"=refrigerada, "04"=contenerizada, "05"=carga general, "06"=neogranel, "07"=peligrosa, "08"=granel presurizado
xProd *	string	Descripción del producto predominante
cEAN	string	GTIN/EAN
NCM	string	NCM
infLotacao	object	Lotación: { infLocalCarrega{CEP,latitude,longitude}, infLocalDescarrega{...} }

tot — Totalizadores

Campo	Tipo	Descripción
vCarga *	decimal	Valor total de la carga (> 0)
cUnid *	string	Código de la unidad: "01"=KG, "02"=TON
qCarga *	decimal	Cantidad total de la carga (> 0)
qCTe	int	Cantidad de CT-es vinculados
qNFe	int	Cantidad de NF-es vinculadas
qMDFe	int	Cantidad de MDF-es vinculados

* Campo obligatorio. ⚠ Al menos uno de CNPJ o CPF es obligatorio.

Consulta la situación del MDF-e directamente en la autoridad fiscal a partir de la clave de acceso.

Headers obligatorios

Header	Tipo	Descripción
token	string	Token de la empresa emisora
sign	string	Firma MD5
timestamp	string	Unix timestamp en segundos

Body

Campo	Tipo	Descripción
chMDFe *	string	Clave de acceso del MDF-e (44 dígitos)

* Campo obligatorio.

Cancela un MDF-e autorizado. Ventana: hasta 24 horas después de la autorización. No permitido si el MDF-e ya ha sido cerrado.

Headers obligatorios

Header	Tipo	Descripción
token	string	Token de la empresa emisora
sign	string	Firma MD5
timestamp	string	Unix timestamp en segundos

Body

Campo	Tipo	Descripción
chMDFe *	string	Clave de acceso del MDF-e (44 dígitos)
xJust *	string	Justificación de la cancelación (mínimo 15 caracteres por exigencia autoridad fiscal)

* Campo obligatorio.

Cierra un MDF-e al final del viaje. Después del cierre, ya no es posible cancelar. Los campos dtEnc, cUF y cMun son opcionales — cuando se omiten, el sistema los infiere a partir del MDF-e original (fecha actual, UF y municipio del emisor).

Headers obligatorios

Header	Tipo	Descripción
token	string	Token de la empresa emisora
sign	string	Firma MD5
timestamp	string	Unix timestamp en segundos

Body

Campo	Tipo	Descripción
chMDFe *	string	Clave de acceso del MDF-e (44 dígitos)
dtEnc	string	Fecha del cierre (AAAA-MM-DD). Default: fecha actual
cUF	int	Código IBGE de la UF donde ocurrió el cierre. Default: UF del emisor
cMun	string	Código IBGE del municipio donde ocurrió el cierre. Default: municipio del emisor

* Campo obligatorio.

Lista los MDF-e de la empresa con paginación. Los parámetros se pasan por query string (no en el body). El filtro de tiempo es opcional, pero si se envía requiere tanto start_create_time como end_create_time.

Headers obligatorios

Header	Tipo	Descripción
token	string	Token de la empresa emisora
sign	string	Firma MD5 (path incluye la query string)
timestamp	string	Unix timestamp en segundos

Query string

Parámetro	Tipo	Descripción
page *	int	Número de página (≥ 1)
page_size *	int	Tamaño de página (1–50)
start_create_time	long	Unix timestamp en milisegundos — inicio (requiere end_create_time)
end_create_time	long	Unix timestamp en milisegundos — fin
status	string	Filtrar por estado. Valores: "Success" (autorizado), "Canceled" (cancelado), "Voided" (cerrado), "Processing" (en proceso), "Failed" (falló), "Unknown" (desconocido)

* Campo obligatorio.