MDF-e 货运清单

从提交的主体中开具 MDF-e。cMDF、cDV、cUF、dhEmi、mod、tpEmis、procEmi、verProc 字段由服务器自动计算。客户端仅发送业务字段。serie 和 nMDF 为可选字段——省略（或为 0）时由服务器自动分配，发送时则予以采用（适用于跳过编号，例如在税务局出现重复后）。

必需请求头

请求头	类型	说明
token	string	发行企业 token
sign	string	MD5 签名:MD5(token + path + body + timestamp)
timestamp	string	Unix 时间戳(秒,5 分钟窗口)

Body — 根

字段	类型	说明
ide *	object	MDF-e 标识
emit *	object	发行者数据
infModal *	object	模式信息(四个中仅一个:rodo、aereo、aquav、ferrov)
infDoc *	object	关联税务文档
tot *	object	货物合计
prodPred	object	主要货物产品
seg	array	保险信息
lacres	array	MDF-e 封条
autXML	array	授权访问 XML 的 CNPJ/CPF
infAdic	object	附加信息(税务机关和纳税人)
infRespTec	object	技术负责人(CNPJ、联系人、邮箱等)

ide — 标识

字段	类型	说明
tpAmb *	int	环境:1=生产,2=同源
tpEmit *	int	发行者类型:1=承运商,2=自有货物,3=运输服务提供商
modal *	string	模式:"1"=公路,"2"=航空,"3"=水路,"4"=铁路
UFIni *	string	行程开始的 UF(2 个字母)
UFFim *	string	行程结束的 UF
infMunCarrega[] *	array	装载市:[{ cMunCarrega, xMunCarrega }]
infPercurso[]	array	路线的 UF:[{ UFPer }]
tpTransp	string	承运商类型(公路)
dhIniViagem	string	行程开始日期/时间(ISO 8601)
indCanalVerde	string	绿色通道指示器
indCarregaPosterior	string	后续装载指示器
serie	int	MDF-e 系列号（访问密钥的 3 位）。可选——省略或为 0 时自动分配（公司的 MDF-e 系列）；发送时则按发送值使用
nMDF	int	MDF-e 编号（构成访问密钥）。可选——省略或为 0 时由服务器自动递增；发送时则按发送值使用（便于跳过编号，例如：发生重复后）

emit — 发行者

字段	类型	说明
CNPJ ⚠	string	发行者 CNPJ(14 位)
CPF ⚠	string	发行者 CPF(11 位)
IE	string	州登记号
xNome *	string	法人名称
xFant	string	商号
enderEmit	object	地址:{ xLgr, nro, xCpl, xBairro, cMun, xMun, CEP, UF, fone, email }

infModal — 公路模式(modal="1")

字段	类型	说明
rodo.veicTracao *	object	牵引车辆:{ placa, tara, RENAVAM, capKG, capM3, tpRod, tpCar, UF, condutor[], prop }
rodo.veicTracao.condutor[] *	array	司机:[{ xNome, CPF }] — 最少 1
rodo.veicReboque[]	array	拖车(与 veicTracao 相同结构,无司机)
rodo.infANTT	object	ANTT 信息:{ RNTRC, infCIOT[], valePed, infContratante[], infPag[] }
rodo.codAgPorto	string	港口预约代码
rodo.lacRodo[]	array	模式封条:[{ nLacre }]

infModal — 航空模式(modal="2")

字段	类型	说明
aereo.nac *	string	飞机国籍标志
aereo.matr *	string	飞机注册号
aereo.nVoo *	string	航班号
aereo.cAerEmb *	string	登机机场 IATA 代码
aereo.cAerDes *	string	目的机场 IATA 代码
aereo.dVoo *	string	航班日期(YYYY-MM-DD)

infModal — 水路模式(modal="3")

字段	类型	说明
aquav.irin *	string	船舶 IRIN
aquav.tpEmb *	string	船舶类型(2 位)。使用 ≥ 10 的值以避免 Zeus 内部 byte 截断(例:"10"、"11")
aquav.cEmbar *	string	船舶代码
aquav.xEmbar *	string	船舶名称
aquav.nViag *	string	航次号。不能以零开头(schema 验证) — 使用 "1"、"100" 等。
aquav.cPrtEmb *	string	登船港代码
aquav.cPrtDest *	string	目的港代码
aquav.prtTrans	string	转运港
aquav.tpNav	string	航行类型
aquav.infTermCarreg[]	array	装载码头:[{ cTermCarreg, xTermCarreg }]
aquav.infTermDescarreg[]	array	卸载码头
aquav.infEmbComb[]	array	船队船舶:[{ cEmbComb, xBalsa }]
aquav.infUnidCargaVazia[]	array	空货物单元
aquav.infUnidTranspVazia[]	array	空运输单元

infModal — 铁路模式(modal="4")

字段	类型	说明
ferrov.trem *	object	火车数据:{ xPref, dhTrem, xOri, xDest, qVag }
ferrov.vag[] *	array	车厢:[{ pesoBC, pesoR, tpVag, serie, nVag, nSeq, TU }] — 最少 1。Zeus/税务局约束: serie 必须正好 3 位(使用 100+,例:"100");nVag 仅接受数字(内部为 long,例:"100001");nSeq 可选 1-3 位。

infDoc — 关联文档

字段	类型	说明
infMunDescarga[] *	array	卸货市 — 最少 1
infMunDescarga[].cMunDescarga *	string	市 IBGE 代码
infMunDescarga[].xMunDescarga *	string	市名称
infMunDescarga[].infNFe[]	array	关联 NF-e:[{ chNFe, SegCodBarras, indReentrega, infUnidTransp[], peri[] }]
infMunDescarga[].infCTe[]	array	关联 CT-e
infMunDescarga[].infMDFeTransp[]	array	运输 MDF-e(转包)

prodPred — 主要产品

字段	类型	说明
tpCarga *	string	货物类型:"01"=散装固体,"02"=散装液体,"03"=冷藏,"04"=集装箱,"05"=一般货物,"06"=新散装,"07"=危险品,"08"=加压散装
xProd *	string	主要产品描述
cEAN	string	GTIN/EAN
NCM	string	NCM
infLotacao	object	批次:{ infLocalCarrega{CEP,latitude,longitude}, infLocalDescarrega{...} }

tot — 合计

字段	类型	说明
vCarga *	decimal	货物总值(> 0)
cUnid *	string	单位代码:"01"=KG,"02"=TON
qCarga *	decimal	货物总量(> 0)
qCTe	int	关联 CT-e 数量
qNFe	int	关联 NF-e 数量
qMDFe	int	关联 MDF-e 数量

* 必填字段。⚠ CNPJ 或 CPF 至少其中一个为必填项。

使用访问密钥直接在税务局查询 MDF-e 状态。

必需请求头

请求头	类型	说明
token	string	发行企业 token
sign	string	MD5 签名
timestamp	string	Unix 时间戳(秒)

Body

字段	类型	说明
chMDFe *	string	MDF-e 访问密钥(44 位)

* 必填字段。

取消已授权的 MDF-e。窗口: 授权后最多 24 小时。如果 MDF-e 已关闭,则不允许。

必需请求头

请求头	类型	说明
token	string	发行企业 token
sign	string	MD5 签名
timestamp	string	Unix 时间戳(秒)

Body

字段	类型	说明
chMDFe *	string	MDF-e 访问密钥(44 位)
xJust *	string	取消理由(根据税务局要求最少 15 个字符)

* 必填字段。

在行程结束时关闭 MDF-e。关闭后,无法再取消。dtEnc、cUF 和 cMun 字段是可选的 — 省略时,系统将从原始 MDF-e 推断(当前日期、发行人的 UF 和市)。

必需请求头

请求头	类型	说明
token	string	发行企业 token
sign	string	MD5 签名
timestamp	string	Unix 时间戳(秒)

Body

字段	类型	说明
chMDFe *	string	MDF-e 访问密钥(44 位)
dtEnc	string	关闭日期(YYYY-MM-DD)。默认:当前日期
cUF	int	关闭发生地 UF 的 IBGE 代码。默认:发行者的 UF
cMun	string	市 IBGE 代码 onde ocorreu o encerramento. Default: município do emitente

* 必填字段。

分页列出公司的 MDF-e。参数通过 查询字符串（query string）传递（不在 body 中）。时间过滤可选，但若使用则需同时传入 start_create_time 和 end_create_time。

必需请求头

请求头	类型	说明
token	string	开票公司令牌
sign	string	MD5 签名（path 包含查询字符串）
timestamp	string	秒级 Unix 时间戳

查询字符串

参数	类型	说明
page *	int	页码（≥ 1）
page_size *	int	每页大小（1–50）
start_create_time	long	Unix 时间戳（毫秒） — 起始（需要 end_create_time）
end_create_time	long	Unix 时间戳（毫秒） — 结束
status	string	按状态过滤。值: "Success"（已授权）、"Canceled"（已取消）、"Voided"（已关闭）、"Processing"（处理中）、"Failed"（失败）、"Unknown"（未知）

* 必填字段。