EASYSHIPPINGX API

一个 API，完成
比价、选价
与下单。

多家服务商，按你的需求选择。

一次请求，获取账户下适用于这票包裹的报价。选择最低有效价格，或选择你需要的服务商，再从自己的系统创建订单。

申请费率与 API 接入 体验比价流程
  • 多服务商比价
  • 自动判断覆盖
  • 自主选择服务
一个包裹通过统一接口连接多个配送服务选项
一次接入，让每票包裹多一些选择。
按你的规则选价

最低价优先，
也可以自己选。

从本次返回的可用报价中，选择最符合需求的一项。你可以在接入系统中按价格选择，也可以指定服务商。

  • 在同币种有效报价中比较价格。
  • 无有效价格的选项不参与选择。
  • 由你的系统选定服务，再调用创建订单接口。

试着选择服务 B，或点击“选择最低报价”。

同一票包裹

你的报价选项

示例数据
选择示例服务商
已选服务

服务 AUSD 3.71

下一步：使用服务 A 创建订单。

仅为交互示例，不获取实时报价或创建订单。实际报价取决于包裹信息与账户可用服务。

包裹和目的地经过可用性判断，形成可选服务
可用报价无报价，不参与选择
覆盖判断交给接口

不用再逐个检查
服务商的邮编覆盖。

提供收件地址和包裹信息，接口会判断渠道是否适用。某个区域服务商无法覆盖目的地时，就不会产生可供选择的有效价格。

无需在自己的系统中维护每家服务商的邮编覆盖表。直接围绕返回的有效报价，决定这票包裹怎么发。

覆盖是可用条件之一。包裹规格、账户分配渠道及所需服务选项，也会影响能否获得报价。

从报价到订单

三个步骤，接入你的发货流程。

适用于有开发资源的电商团队、3PL，以及 ERP、OMS 和 WMS 平台。

  1. 01

    获取可用报价

    提交同一票包裹的地址、尺寸与重量，查询单个、多个或账户下全部已分配渠道。

    输入一次包裹信息
  2. 02

    选择合适的服务

    在有效报价中比较价格。由你的系统选最低报价，或按需要指定服务商。

    选价规则由你决定
  3. 03

    创建订单

    沿用这票包裹的信息，提交选定渠道创建订单，保存返回的运单编码，衔接后续处理。

    从选择进入履约
为开发团队准备

两个接口，衔接比价与下单。

服务端通过 Api-Token 鉴权，以 JSON 发送请求。以下是简化的字段示例，完整要求请查看 API 文档。

POST/v1/order/quotation

先获取报价

express 为字符串时查询单个渠道，数组查询多个渠道；设为 null 时查询账户已分配渠道。

{
  "order_id": "DEMO-10001",
  "express": null,
  "parcel": {
    "length": 20, "width": 15,
    "height": 10, "weight": 0.5
  },
  "ship_to": {
    "firstname": "Demo",
    "country": "US", "state": "CA",
    "city": "Los Angeles", "zip": "90001",
    "address1": "123 Example Street"
  }
}
查看简化报价响应
[
  {
    "express": "service_a",
    "price": 3.71,
    "price_currency": "USD",
    "weight": 0.5,
    "weight_unit": "kg",
    "surcharge": { "total": 0 }
  },
  {
    "express": "service_b",
    "price": 3.99,
    "price_currency": "USD",
    "weight": 0.5,
    "weight_unit": "kg",
    "surcharge": { "total": 0 }
  }
]

多渠道响应中，不可用项可能返回 price: null 和 reason。只在有效、同币种的报价中比较价格。

POST/v1/order

再提交选定渠道

将选定的渠道编码作为字符串写入 express，沿用包裹信息并补齐该渠道要求的服务选项。

{
  "order_id": "DEMO-10001",
  "express": "service_a",
  "parcel": {
    "length": 20, "width": 15,
    "height": 10, "weight": 0.5
  },
  "ship_to": {
    "firstname": "Demo",
    "country": "US", "state": "CA",
    "city": "Los Angeles", "zip": "90001",
    "address1": "123 Example Street"
  }
}
查看简化创建响应
{
  "data": {
    "order_id": "DEMO-10001",
    "shipment_code": "DEMO-SHIPMENT-10001",
    "price": 3.71,
    "price_currency": "USD",
    "surcharge": { "total": 0 }
  }
}

保存 data.shipment_code。tracking_number 仅在创建时已提供追踪号的情况下返回；后续面单获取流程以文档为准。

请求约定请求头：Content-Type: application/json、Api-Token: YOUR_TOKEN。尺寸使用 cm，重量使用 kg；创建订单时使用唯一的 order_id。

示例说明渠道编码、地址、订单号、凭证和金额均为演示值。请替换为有效信息及账户实际分配的渠道；部分渠道需要额外字段。报价为预估，不代表最终账单金额。

准备开始接入？

查看完整参数与渠道要求。需要文档访问或接入帮助时，请在费率申请表的“补充信息”中说明。

查看 API 文档提交接入需求
面向实际发货流程

海外仓与 3PL 接入评估

先提交发货仓 ZIP、订单重量及尺寸分布、目的地区域、账户要求和当前 WMS/OMS 对接方式。用相同样本验证可用报价、服务选择、创建订单返回值及错误恢复，再决定自动化范围。报价成功不等于订单创建成功。

3PL 多客户发货

3PL 可先验证同一包裹在不同客户账户下的报价与订单归属。

4PL 多仓协同

4PL 应按仓库确认执行方、凭证与恢复责任。

大型品牌履约

大型品牌应核对 OMS/WMS 订单、退货和账单之间的关联。

客户隔离、白标、webhook、财务字段及测试环境都是需核验的接入要求，不由本页示例推定已开放。

EasyShippingX 本页承接美国境内运输与 API。头程、进口清关及仓储由客户或其伙伴负责；承运商可接收的产品、账户、起运地点与交接方式需另行确认。

本页用于评估 EasyShippingX 产品与申请接入；Shipping API 技术指南解释流程与开发边界，3PL API 评估指南帮助核对多客户需求。服务开放范围与交接安排须在账户接入时确认。

用验收结果确定接入范围

评估任务需要验证业务通过条件
可用报价用相同起运、目的地、实重、尺寸和商品样本取得实际响应；记录账户、服务与报价时间。有可用报价才进入服务选择；无结果、无资格和请求失败应分别处理。
创建订单按现有文档传递所选报价及订单数据，核对响应、业务标识、面单与客户订单的关联。报价成功不代表创建成功；按实际接口合同核对状态，不以页面示例推定功能。
异常恢复测试无效参数、权限、超时、重复操作以及恢复后的状态查询；重复策略先与接入团队确认。能识别已发生的业务动作并保留人工处理路径，避免未经核验的重复创建。
履约与账单将仓库交接、首扫、轨迹、异常和最终费用映射回原订单，确认实际可开放的数据与责任人。按门户或 API 的已开通能力分阶段验收；多客户隔离、通知和财务字段作为接入需求逐项确认。

建议先准备一份脱敏样本和一页接入清单：仓库 ZIP、包裹画像、月单量、当前系统、客户归属和上线范围。门户与 API 分阶段接入帮助选择起点，WMS/API 验收指南帮助组织开发测试。现有截图与请求示例继续用于说明流程，正式字段和可用服务以当前接口文档及账户确认结果为准。

商务评估先申请费率评估，开发团队再按 技术指南与当前接口文档核对字段，最后 申请接入讨论。

评估 API 接入

本节为 EasyShippingX 的采购与接入评估建议，复核日期：2026-10-09。公开资料、保留文件与账户开通状态需要分别核验，示例不构成真实报价或客户成果。

常见问题

接入前，
你可能想了解。

需要自行检查区域服务商的邮编覆盖吗？

不需要自行维护覆盖表。提交收件地址与包裹信息后，接口会判断适用性。无法覆盖的服务不会产生有效报价；包裹规格、账户渠道和服务选项也会影响报价可用性。

可以自动选择最低价格吗？

可以在你的系统中，对本次返回的同币种有效报价进行比较，选择最低价格，再把对应渠道提交给创建订单接口。报价接口本身不会替你创建订单，也不保证全市场最低价。

可以指定服务商，而不是选择最低价吗？

可以。你可以查询指定的单个或多个渠道，再从有效报价中选择所需服务。创建订单时，传入选定的渠道编码，而不是价格数字。

报价是否就是最终账单金额？

报价基于提交信息预估费用与计费重量。实际计费可能受到包裹信息、适用费率及附加费影响，且报价中的附加费明细未必列出所有项目；请以适用价卡与最终账单为准。

如何开始测试？

请先提交费率申请，并在“补充信息”中注明 API 接入、测试或技术支持需求，以便确认可用渠道与后续安排。获得测试配置后，先验证报价、服务选择和创建订单流程。测试地址为 https://test-api.easyshippingx.com。

EASYSHIPPINGX API

让每票包裹，都有更合适的选择。

申请配送费率，并在“补充信息”中告诉我们你的 API 接入、测试或技术支持需求。

申请费率与 API 接入说明接入需求