跳转到内容
最后更新于

参数指南

本节说明在使用 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)申报保价金额。

  1. 第一步 —— 获取保险报价
  • 调用 /api/shipment/insurance/rate 接口。
  • 在请求中提供 service_level 和 declared_value。
  • 返回的保险报价将与所提供的服务等级及申报价值直接关联。
  1. 第二步 —— 随运单一并购买保险
  • 在购买面单时,在请求 /api/shipment/create_and_pay 或 /api/shipment/shein/direct_buy 接口时一并提供 insurance_data 对象。
  • 此步骤中使用的 service_level 必须与第一步获取保险报价时使用的 service_level 完全一致,否则将返回错误。
重要说明
  1. 若在获取保险报价与购买保险之间更改了服务等级,保险购买请求将失败。
  2. 申报价值将作为货物丢失或损坏时的保险赔付金额依据。

☠️ 如何包含危险品信息

如需将运单声明为包含危险品,请按以下步骤操作:

  1. 设置字段 在 option_data.hazardous_materials 字段中传入 true。
    该选项仅适用于使用 USPS Ground Advantage 服务等级的运单。

  2. 面单显示 当声明包含危险品时,生成的运单面单将带有特殊标识或展示形式。
    示例面单格式请参考下图。

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