MDF-e Manifest

Issues an MDF-e from the submitted body. The fields cMDF, cDV, cUF, dhEmi, mod, tpEmis, procEmi, verProc are calculated automatically by the server. The client sends only the business fields. The fields serie and nMDF are optional: they are allocated automatically when omitted (or set to 0), but are honored when sent (useful for skipping the numbering, e.g. after a duplicate at the tax authority).

Required headers

Header	Type	Description
token	string	Token of the issuing company
sign	string	MD5 signature: MD5(token + path + body + timestamp)
timestamp	string	Unix timestamp in seconds (5-minute window)

Body — root

Field	Type	Description
ide *	object	Identification of the MDF-e
emit *	object	Issuer data
infModal *	object	Mode information (only ONE of the four: rodo, aereo, aquav, ferrov)
infDoc *	object	Linked fiscal documents
tot *	object	Cargo totalizers
prodPred	object	Predominant product of the cargo
seg	array	Insurance information
lacres	array	Seals of the MDF-e
autXML	array	CNPJs/CPFs authorized to access the XML
infAdic	object	Additional information (tax authority and taxpayer)
infRespTec	object	Technical responsible (CNPJ, contact, email, etc.)

ide — Identification

Field	Type	Description
tpAmb *	int	Environment: 1=production, 2=homologation
tpEmit *	int	Issuer type: 1=carrier, 2=own cargo, 3=transport service provider
modal *	string	Mode: "1"=road, "2"=air, "3"=waterway, "4"=rail
UFIni *	string	State (UF) where the trip starts (2 letters)
UFFim *	string	State (UF) where the trip ends
infMunCarrega[] *	array	Loading municipalities: [{ cMunCarrega, xMunCarrega }]
infPercurso[]	array	States (UFs) of the route: [{ UFPer }]
tpTransp	string	Carrier type (road)
dhIniViagem	string	Trip start date/time (ISO 8601)
indCanalVerde	string	Green channel indicator
indCarregaPosterior	string	Later loading indicator
serie	int	MDF-e series (3 digits of the access key). Optional — auto-allocated (the company's MDF-e series) when omitted or 0; respected when sent
nMDF	int	MDF-e number (part of the access key). Optional — auto-incremented by the server when omitted or 0; respected when sent (useful for skipping numbering, e.g.: after a duplicate)

emit — Issuer

Field	Type	Description
CNPJ ⚠	string	CNPJ of the issuer (14 digits)
CPF ⚠	string	CPF of the issuer (11 digits)
IE	string	State Registration
xNome *	string	Company name
xFant	string	Trade name
enderEmit	object	Address: { xLgr, nro, xCpl, xBairro, cMun, xMun, CEP, UF, fone, email }

infModal — Road Mode (modal="1")

Field	Type	Description
rodo.veicTracao *	object	Traction vehicle: { placa, tara, RENAVAM, capKG, capM3, tpRod, tpCar, UF, condutor[], prop }
rodo.veicTracao.condutor[] *	array	Drivers: [{ xNome, CPF }] — minimum 1
rodo.veicReboque[]	array	Trailer vehicles (same structure as veicTracao without driver)
rodo.infANTT	object	ANTT information: { RNTRC, infCIOT[], valePed, infContratante[], infPag[] }
rodo.codAgPorto	string	Port scheduling code
rodo.lacRodo[]	array	Seals of the mode: [{ nLacre }]

infModal — Air Mode (modal="2")

Field	Type	Description
aereo.nac *	string	Aircraft nationality mark
aereo.matr *	string	Aircraft registration
aereo.nVoo *	string	Flight number
aereo.cAerEmb *	string	IATA code of the boarding airport
aereo.cAerDes *	string	IATA code of the destination airport
aereo.dVoo *	string	Flight date (YYYY-MM-DD)

infModal — Waterway Mode (modal="3")

Field	Type	Description
aquav.irin *	string	IRIN of the vessel
aquav.tpEmb *	string	Vessel type (2 digits). Use values ≥ 10 to avoid truncation of the internal Zeus byte (e.g.: "10", "11")
aquav.cEmbar *	string	Vessel code
aquav.xEmbar *	string	Vessel name
aquav.nViag *	string	Trip number. Cannot start with zero (schema validation) — use "1", "100", etc.
aquav.cPrtEmb *	string	Boarding port code
aquav.cPrtDest *	string	Destination port code
aquav.prtTrans	string	Transshipment port
aquav.tpNav	string	Navigation type
aquav.infTermCarreg[]	array	Loading terminals: [{ cTermCarreg, xTermCarreg }]
aquav.infTermDescarreg[]	array	Unloading terminals
aquav.infEmbComb[]	array	Convoy vessels: [{ cEmbComb, xBalsa }]
aquav.infUnidCargaVazia[]	array	Empty cargo units
aquav.infUnidTranspVazia[]	array	Empty transport units

infModal — Rail Mode (modal="4")

Field	Type	Description
ferrov.trem *	object	Train data: { xPref, dhTrem, xOri, xDest, qVag }
ferrov.vag[] *	array	Wagons: [{ pesoBC, pesoR, tpVag, serie, nVag, nSeq, TU }] — minimum 1. Zeus/tax authority restrictions: serie must have exactly 3 digits (use 100+, e.g.: "100"); nVag only accepts digits (long internally, e.g.: "100001"); nSeq optional 1-3 digits.

infDoc — Linked documents

Field	Type	Description
infMunDescarga[] *	array	Unloading municipalities — minimum 1
infMunDescarga[].cMunDescarga *	string	IBGE code of the municipality
infMunDescarga[].xMunDescarga *	string	Name of the municipality
infMunDescarga[].infNFe[]	array	Linked NF-es: [{ chNFe, SegCodBarras, indReentrega, infUnidTransp[], peri[] }]
infMunDescarga[].infCTe[]	array	Linked CT-es
infMunDescarga[].infMDFeTransp[]	array	Transport MDF-es (subcontracting)

prodPred — Predominant product

Field	Type	Description
tpCarga *	string	Cargo type: "01"=solid bulk, "02"=liquid bulk, "03"=refrigerated, "04"=containerized, "05"=general cargo, "06"=neobulk, "07"=hazardous, "08"=pressurized bulk
xProd *	string	Description of the predominant product
cEAN	string	GTIN/EAN
NCM	string	NCM
infLotacao	object	Full load: { infLocalCarrega{CEP,latitude,longitude}, infLocalDescarrega{...} }

tot — Totalizers

Field	Type	Description
vCarga *	decimal	Total value of the cargo (> 0)
cUnid *	string	Unit code: "01"=KG, "02"=TON
qCarga *	decimal	Total quantity of the cargo (> 0)
qCTe	int	Number of linked CT-es
qNFe	int	Number of linked NF-es
qMDFe	int	Number of linked MDF-es

* Required field. ⚠ At least one of CNPJ or CPF is required.

Queries the status of the MDF-e directly at the tax authority from the access key.

Required headers

Header	Type	Description
token	string	Token of the issuing company
sign	string	MD5 signature
timestamp	string	Unix timestamp in seconds

Body

Field	Type	Description
chMDFe *	string	Access key of the MDF-e (44 digits)

* Required field.

Cancels an authorized MDF-e. Window: up to 24 hours after authorization. Not allowed if the MDF-e has already been closed.

Required headers

Header	Type	Description
token	string	Token of the issuing company
sign	string	MD5 signature
timestamp	string	Unix timestamp in seconds

Body

Field	Type	Description
chMDFe *	string	Access key of the MDF-e (44 digits)
xJust *	string	Cancellation justification (minimum 15 characters per tax authority requirement)

* Required field.

Closes an MDF-e at the end of the trip. After closing, it is no longer possible to cancel. The fields dtEnc, cUF and cMun are optional — when omitted, the system infers them from the original MDF-e (current date, UF and municipality of the issuer).

Required headers

Header	Type	Description
token	string	Token of the issuing company
sign	string	MD5 signature
timestamp	string	Unix timestamp in seconds

Body

Field	Type	Description
chMDFe *	string	Access key of the MDF-e (44 digits)
dtEnc	string	Closing date (YYYY-MM-DD). Default: current date
cUF	int	IBGE code of the UF where the closing occurred. Default: UF of the issuer
cMun	string	IBGE code of the municipality where the closing occurred. Default: municipality of the issuer

* Required field.

Lists the company's MDF-e with pagination. Parameters are passed via query string (not in the body). The time filter is optional, but if used, both start_create_time and end_create_time are required.

Required headers

Header	Type	Description
token	string	Issuing company token
sign	string	MD5 signature (path includes the query string)
timestamp	string	Unix timestamp in seconds

Query string

Parameter	Type	Description
page *	int	Page number (≥ 1)
page_size *	int	Page size (1–50)
start_create_time	long	Unix timestamp in milliseconds — start (requires end_create_time)
end_create_time	long	Unix timestamp in milliseconds — end
status	string	Filter by status. Values: "Success" (authorized), "Canceled" (canceled), "Voided" (closed), "Processing" (processing), "Failed" (failed), "Unknown" (unknown)

* Required field.