本节说明在使用 Get Rate 和 Directly Buy Label 接口时,针对特殊运输场景所需的附加参数。
该内容作为参考指南,用于确保在进行运费计算和面单创建时提供了所有必要信息,从而避免失败或不准确的结果。涵盖内容包括:
- 如何提供报关表单数据
- 如何申报运单保险
- 如何包含危险品信息
报关表单通常适用于国际运单,或寄往部分美国属地及特殊地址的运单,例如关岛(Guam)、波多黎各(Puerto Rico)以及美军地址(APO/FPO/DPO)。
在邮政系统中,这些目的地按国际运单处理,因此需要提供报关申报信息。
签字人 —
signing_person(必填)
报关申报表的签字人全名。
该字段为必填项,通常为发件人或其授权代表。货物明细 —
item_data_list(必填)
提供一个货物条目数组。除hs_tariff_number外,其余字段均为必填。description、quantity、origin、weight、unit_cost、weight_unit—— 必填hs_tariff_number—— 可选(推荐填写)
货物内容类型与无法投递处理方式 —
content_type与undeliverable_option(必填)
用于说明运单所包含的物品类型,以及在无法投递时的处理方式。
可用的枚举值请参见 API Reference。美国出口合规(EEI) —
eel_pfc_type与eel_pfc_code(可选)
根据运单申报总价值提供以下其中一组:当申报总价值 大于 $2500 时(需要提供 ITN)
"eel_pfc_type": "ITN", "eel_pfc_code": "X20240427123456"当申报价值 ≤ $2500 时(使用豁免代码)
"eel_pfc_type": "EXEMPTION_CODE", "eel_pfc_code": "NOEEI 30.37(a)"
默认值:
eel_pfc_type=EXEMPTION_CODE,eel_pfc_code=NOEEI 30.37(a)税务识别号 —
tax_ids(可选)
用于报关清关的国家/地区相关税务识别号。
寄往墨西哥的运单为必填;其他目的地视具体国家/地区要求而定。
可用的枚举值、类型及格式请参见 API Reference。
如需为运单购买保险,必须以美元(USD)申报保价金额。
- 第一步 —— 获取保险报价
- 调用
/api/shipment/insurance/rate接口。 - 在请求中提供
service_level和declared_value。 - 返回的保险报价将与所提供的服务等级及申报价值直接关联。
- 第二步 —— 随运单一并购买保险
- 在购买面单时,在请求
/api/shipment/create_and_pay或/api/shipment/shein/direct_buy接口时一并提供insurance_data对象。 - 此步骤中使用的
service_level必须与第一步获取保险报价时使用的service_level完全一致,否则将返回错误。
- 若在获取保险报价与购买保险之间更改了服务等级,保险购买请求将失败。
- 申报价值将作为货物丢失或损坏时的保险赔付金额依据。
如需将运单声明为包含危险品,请按以下步骤操作:
设置字段 在
option_data.hazardous_materials字段中传入true。
该选项仅适用于使用 USPS Ground Advantage 服务等级的运单。面单显示 当声明包含危险品时,生成的运单面单将带有特殊标识或展示形式。
示例面单格式请参考下图。

- 参考文档 有关危险品运输规则、分类及限制的更多信息,请参阅:
Hazardous Shipping 101 with USPS。