操作指南 · 物流与打印
京东、顺丰、中通官方直连客户配置总览
按申请账号、回填 ZenTea、测试取号、打印、轨迹和上线验收完成三家官方直连配置。
适用版本:2.1.94 及以上 · 客户物流手册 2026-08-24 · 适用端:PC、部署端 · 2026-08-24 验证
先确认接入模式
ZenTea 当前是“客户自己的物流账号直连”模式。客户仍需向京东、顺丰或中通申请业务账号、电子面单和产品权限,承担第三方费用;ZenTea 负责把这些账号接入系统并完成取号、取消、打印和轨迹操作。部分 ERP 可以直接购买面单,那是另一种物流 ISV 统一采购和结算模式,不能把两种模式混为一谈。
如果只想登记已有运单和查询物流,在销售单选择“手动发货”,不需要官方直连。需要 ZenTea 自动申请电子面单时,才配置对应官方服务商。
申请前先问清楚三件事
- 本客户使用自己的开放平台应用,还是使用 ZenTea 实施人员提供的服务商应用?不要重复申请错误的主体。
- 当前应用是否已经绑定本门店的电子面单账号,并开通下单取号、取消、获取面单和轨迹查询?只说“应用审核通过”不够。
- 需要哪些独立能力:取号、取消、面单、打印、轨迹、轨迹推送和 COD。它们不是一个总开关。
在 ZenTea 的共同入口
进入“物流中心 → 接入与发件”。先新建对应的物流服务商,选择适用门店和环境,保存后点击“测试配置”。再在同一页面建立“发件档案”,填写实际门店的联系人、电话、省市区、详细地址和账号覆盖信息。
配置自检只检查已保存的字段、环境和签名格式,通常不会替第三方验证全部业务权限。正式启用前必须用快递公司认可的测试单或低风险正式单分别验收取号、取消、面单打印和轨迹。
三家平台的资料速查
| 平台 | 申请入口 | 关键资料 | 不能混用的字段 |
|---|---|---|---|
| 顺丰 | 顺丰开放平台 | Partner ID、Checkword、月结卡号、丰桥模板编码 | 月结卡号不是 Partner ID |
| 中通 | 中通开放平台 或文档中心 | AppKey、AppSecret、accountId 或 customerId、面单类型 | 官方直连不填快递100 的 net、SIID |
| 京东 | 京东物流开放平台 | AppKey、AppSecret、Access Token、LOP-DN、配送产品和云打印模板 | UAT 凭证不能用于生产 |
推荐验收顺序
- 保存测试/沙箱配置,执行“测试配置 → 配置自检”。
- 用已有测试运单做实时查询,确认查询权限和承运商编码。
- 平台开放测试下单时,执行“测试取号”,然后立即执行“取消测试”。
- 用测试运单打印一张,核对条码、地址、纸张尺寸和实际出纸。
- 新建正式环境配置,用快递公司认可的真实/小额测试单再次验收。
- 只在“已验收生产能力”中勾选已经真实成功的能力;轨迹推送还要在第三方后台完成公网回调测试。
任何取号超时或结果未知,先进入“取号待对账”并到快递公司后台核对,确认未生成或已取消后才能重试。