接入方式要跟业务量和流程成熟度匹配。表格适合快速验证，API 适合订单字段、路由规则和异常处理已经比较稳定，并且有明确技术与运营负责人的团队。网站公开的是准备和评估方法，不代表所有接口能力已经上线。
表格和 API 怎么选
| 情况 | 更适合先用表格 | 可以进一步评估 API |
|---|---|---|
| 订单字段 | 仍在调整，需要人工发现问题 | 字段字典和单位已经固定 |
| 业务量 | 小批量测试或偶尔处理 | 重复导入、下载和回填已成为稳定瓶颈 |
| 路由 | 仍需人工判断货型和渠道 | 路由条件明确，并有备用与停用规则 |
| 异常处理 | 由操作人员逐行处理 | 有人负责超时、重复、作废和错误日志 |
| 系统能力 | 暂无开发资源 | 有 WMS/ERP、开发联系人和测试环境 |
表格导入
- 使用约定模板提交订单字段。
- 导入前校验必填项、重量、尺寸和单位。
- 返回面单或处理结果，异常行单独提示。
- 适合家庭仓、小型海外仓或前期测试。
可以先使用SOONEASY 批量打单字段模板整理数据。该文件是内部中间表，不是 FedEx、UPS 或 USPS 的官方导入模板；进入具体渠道前仍需做字段映射和规则校验。
API 对接
- 根据现有 WMS、ERP 或打单系统确认调用方式。
- 约定鉴权、字段、渠道代码、面单文件与错误码。
- 做测试环境、幂等、防重复打单和失败重试。
- 上线后保留日志，便于查找补扣、退件或面单异常。
公开字段准备示例
以下字段用于沟通和测试设计，不是可直接调用的接口文档，也不包含生产地址或鉴权信息。
| 字段组 | 示例字段 | 需要验证的内容 |
|---|---|---|
| 订单识别 | client_order_id、warehouse_code | 唯一性、重复提交和多仓权限 |
| 包裹 | weight、weight_unit、length、width、height、dimension_unit | 单位、取值范围和包装后尺寸 |
| 地址 | 国家、州、城市、邮编、地址行、住宅/商业属性 | 格式校验、隐私保护和失败回传 |
| 服务 | 候选渠道、服务代码、面单格式 | 产品是否开放、PDF/ZPL 与打印尺寸 |
| 回传 | 处理状态、追踪号、错误代码、创建时间 | 查询、重试、作废和审计留痕 |
真实收件资料只应在双方确认的安全环境中传输，不要通过官网咨询表单发送。
接口能力要逐项验收
| 能力 | 公开状态 | 建议怎么核验 |
|---|---|---|
| 创建面单 | 需要结合渠道和系统确认 | 用脱敏字段完成测试请求并核对返回 |
| 查询结果 | 需要确认 | 验证正常、失败和超时后的查询路径 |
| 重打与作废 | 需要确认具体产品规则 | 保存操作结果、时间和原订单关联 |
| 轨迹回传 | 需要确认 | 区分面单生成与承运商实际接收 |
| 账单回传 | 需要确认 | 验证是否能对应订单、复核项和最终结果 |
| 多仓权限与峰值 | 需要按实际场景测试 | 使用不同仓库账号、角色和代表性峰值计划验收 |
不要把“接口返回了面单”当成全部能力已经验证。多仓权限、批次上限、响应延迟、超时恢复和可用性数据，只能在实际测试后确认。
接入前需要准备
开发联系人、现有系统说明、字段样例、预计峰值单量、主要货型、重量尺寸单位，以及异常订单由谁处理。不要通过首次咨询表单发送真实收件地址或生产密钥。
建议把创建、查询、重复、超时、单位错误、余额或权限问题和作废分别写成验收用例。可使用API 接入检查清单记录输入、预期、实际结果、证据和负责人。
不是接上就结束
渠道规则会变化。系统需要能调整路由条件、停用异常渠道、回溯订单与更新字段，而不是把一个账号写死在流程里。
已有多个美国仓的团队，可以先看跨境电商卖家美国尾程方案；仍在整理字段的仓库，建议先看家庭仓如何通过表格批量打单。准备好系统和脱敏字段说明后，再到联系咨询讨论下一步。