家庭仓刚开始处理尾程订单时，不一定要先做 API。只要把字段、校验、回传和防重复规则定清楚，表格就能用于小批量测试和日常操作。
但要先说明一件容易误解的事：不存在一张表格可以原样上传所有承运商。 UPS、USPS 与 FedEx 的工具、字段和导入规则并不相同。更稳妥的做法，是先建立一份仓库内部的“中间表”，再根据最终渠道转换成对应系统要求的文件或请求。
这份模板用于整理和交接数据，不代表任何承运商的官方导入格式。模板内的第 2 行是明确标记的虚构示例，真实导入前必须删除。
同一套中间字段也可以用于跨境卖家或多仓团队的测试阶段：增加 warehouse_code、货型分组和批次参考，再按仓库分别验证。它仍然只是内部数据源，不能因此假设所有仓库权限、账单分组或承运商格式都已经打通；多仓采购可同时参考跨境卖家美国尾程方案。
一行只代表一个包裹
最简单的规则是：每一行对应一个包裹，并有一个不会重复的内部编号。不要把两个包裹的尺寸写在同一格里，也不要只用收件人姓名当订单号。
| 字段组 | 建议字段 | 为什么需要 |
|---|---|---|
| 内部识别 | client_order_id、批次参考 | 回传、查错和防止重复创建 |
| 渠道信息 | 渠道偏好或候选渠道 | 已确定时填写；需要匹配时先保留 Auto |
| 收件信息 | 姓名或公司、地址两行、城市、州、邮编、国家 | 创建面单和地址检查的基本数据 |
| 地址属性 | 住宅、商业或待确认 | 部分承运商会据此分类和计费 |
| 包裹信息 | 实重、重量单位、长宽高、尺寸单位、包装类型 | 判断产品适用范围与计费重量 |
| 操作参考 | 客户单号、仓库备注 | 用于拣货、打印和售后对照 |
重量和尺寸必须带单位。如果仓库同时使用公制和英制，应在字段中明确单位，而不是让操作人员凭经验猜。
导入前做三层校验
第一层：文件结构
先检查列名、文件编码、空行以及重量和尺寸单位。导出的 CSV 还要确认分隔符和文本中的换行没有破坏列结构。
第二层：逐行数据
检查必填字段、州和邮编组合、国家代码、重量尺寸是否为正数，以及同一行是否混用了厘米和英寸。地址校验可以帮助发现格式或分类问题，但不能把“格式通过”理解成“一定可以派送”。更细的检查方法，可以看美国海外仓地址校验清单。
第三层：业务规则
再判断所选服务是否覆盖目的地、包裹是否超过限制、住宅属性是否正确，以及是否需要特殊处理。UPS 官方提醒，错误的重量、尺寸或住宅/商业属性可能导致后续运费更正。因此，报价前填写的数据和仓库实际交给承运商的数据应保持一致。
为什么要按承运商转换文件
不同系统的批量规则存在实质差异，内部表只能作为统一数据源，不能直接替代官方模板。
UPS：先预览，再处理错误行
截至本文更新日，UPS 官方 Batch File Shipping 支持 CSV 或 SSV，一次最多创建 250 票单包裹货件。一个批次要使用相同的发货地址和付款方式，也不支持多包裹 shipment。其官方格式要求可选字段为空时仍保留分隔符，且不要加入列标题。
这意味着仓库自己的 Excel 表不能直接改个文件名就上传。应先转换为 UPS 要求的列顺序，再使用 Preview Batch 检查错误或单独修正失败行。
USPS：优先使用官方模板并完成字段映射
截至本文更新日，USPS Click-N-Ship 支持通过 CSV 一次导入最多 1,000 个标签。USPS 官方指南建议使用其提供的模板，以提高字段映射准确性；使用自有文件时，也需要在界面中映射列。文件上传成功不等于每一行都导入成功，还要查看导入结果、失败行和原因。
FedEx：先确认使用的是哪种工具
FedEx 可能通过 Ship Manager、桌面软件或 Ship API 处理数据，三者的字段和接入方式不同。FedEx Ship API 要求发件人、收件人、服务、包装和付款等信息。使用 FedEx 前应先确认实际工具，再制作对应的转换规则，不能假设通用表可以直接上传。
如果每天都要反复转换多个渠道，可以进一步比较表格导入与 API 对接；准备接 API 前，也建议先完成尾程面单 API 接入检查。
防重复比“批量”更重要
批量创建最危险的错误不是一行失败，而是同一批被重复处理。建议至少设置三道保护：
client_order_id保持唯一；- 每次上传生成批次号，并记录文件指纹、上传时间和操作人；
- 重复提交时默认返回原处理结果，由操作人员明确选择是否重新创建。
系统回传也不应只给一个“成功”提示。每一行最好都有状态：待校验、已创建、失败、已作废或待人工确认，并回传承运商、服务、追踪号、错误原因和处理时间。重新上传时，只处理确认失败且尚未创建的行。
面单创建后还要检查什么
面单返回后，先抽查内部订单号、收件地址、服务产品、重量尺寸和追踪号的对应关系，再检查打印尺寸与条码清晰度。PDF、ZPL、纸张尺寸和打印设备需要分别确认，具体可以按海外仓面单打印与贴标检查表逐项复核。交货时保留承运商接收或首次扫描记录；只有“面单已创建”但没有承运商接收记录，并不能证明包裹已经进入运输网络。
遇到已出单但一直没有轨迹，可以参考面单创建后没有首扫的排查顺序。未使用的标签也要有处理状态，不能只在 Excel 中删除一行。不同承运商的作废或退款路径和时限不同，应通过创建标签的原系统操作并保存结果。
什么时候再升级 API
出现以下情况时，API 才通常开始有实际价值：
- 每天反复导入、下载和回填已成为稳定瓶颈；
- 订单字段与路由规则已经固定；
- 仓库有人能处理接口错误、超时和重复请求；
- 能保存请求、响应、追踪号和操作日志；
- 能先在测试环境用脱敏数据验证。
真实收件数据只应在已确认的安全对接环境中传输，不要通过官网公开咨询表单发送订单文件、密码或 API 密钥。