物流中心上线与验收总览

入口和操作人员

在 PC 端进入“物流中心 → 接入与发件”。物流服务商、仓库发件档案和生产能力应由老板、系统管理员或负责物流实施的人员配置；仓库人员在验收完成后再使用取号、打印、发货和轨迹功能。

ZenTea 内置快递100、快递鸟、菜鸟、京东物流、顺丰、中通官方直连和自定义 HTTP 接入。京东、顺丰和中通是物流商官方接口直连，不经过快递100；选择某种接入只表示系统知道相应的协议和签名格式，不代表第三方已经为当前企业、网点、承运商或产品开通电子面单、取消、轨迹、代收货款和打印。

推荐上线顺序

1. 向第三方申请正式应用、接口产品和业务账号，确认允许使用的承运商编码与产品编码。
2. 新增物流服务商，填写该平台要求的凭证。正式、预发布和沙箱凭证不得混用。
3. 保存后执行“测试配置”：先做配置自检，再按需执行真实轨迹查询；只有明确的测试或沙箱配置才允许测试取号和取消。
4. 为每个仓库建立发件档案，绑定服务商、寄件地址、客户号或月结号和打印方式。
5. 用真实账号完成取号、取消、面单内容、真机打印、发货、轨迹和异常件验收。
6. 仅把已通过验收的承运商能力写入生产能力矩阵。矩阵为空时，生产取号保持“未开放”。
7. 使用一张测试销售单走完待发货、取号、打印、发货和轨迹查询，再开放给仓库人员。

生产能力矩阵

能力矩阵按第三方要求的承运商编码填写。可声明取号、打印、取消、轨迹、代收货款和手机号校验。只有同一承运商的取号与打印都完成真实验收，才会进入生产取号列表。

不要为了让按钮出现而提前标记能力可用。错误声明会把仓库人员带入第三方尚未开通的流程，常见结果是取号被拒绝、只返回运单号却没有面单、打印按钮不可用或取消失败。

如何理解“测试通过”

• “配置与签名自检通过”通常只证明必填字段和本地签名算法可用，不一定向第三方发送了业务请求。
• 真实轨迹测试需要正确的快递公司编码与真实运单号，并可能消耗第三方查询量。
• 沙箱取号只证明测试环境的签名、协议、取号和取消可用，不证明正式账号已有网点授权或面单余额。
• 菜鸟正式接入预检可以查询模板和账户能力，但不会占用正式面单。
• 顺丰自检通过不代表获得完整可打印面单；当前返回的路由标签不能当作电子面单。

京东、顺丰和中通的统一回调

顺丰和中通的轨迹推送可以使用 ZenTea 统一物流回调网关；京东轨迹推送也按其已配置的推送开关和事件类型接入。物流平台只需要登记统一的回调入口，不能为每个客户不断替换平台上的固定地址。每个客户仍要在自己的 ZenTea 中登记独立的服务商账号标识、客户域名和回调路由；统一网关按服务商账号标识和租户路由转发到对应客户。

因此客户要使用自己的物流商业务账号，不能共用另一个客户的 accountId、customerId、Partner ID 或月结账号。统一网关不能替客户申请面单、购买套餐、保存明文密钥或绕过物流平台授权。如果第三方推送报文不包含可区分客户的业务账号标识，不能仅靠域名安全猜测租户，应先让物流平台开通可路由的账号字段。

停用、删除和历史数据

停用服务商只影响后续业务，历史运单、取号请求、代收结算和操作记录会保留。存在处理中或结果未知的取号请求、启用的发件档案或履约中运单时，系统会阻止停用。已经被业务数据引用的服务商和发件档案只能停用，不能永久删除。

上线完成标准

正式可用至少应满足：凭证属于正式环境、服务商和发件档案均启用、仓库范围正确、承运商与产品已开通、能力声明与真实验收一致、取号能返回运单号及可打印内容、真机打印尺寸正确、取消与轨迹可用，并且已经演练网络超时后的人工对账。