操作指南 · 物流与打印
顺丰官方直连客户配置与验收
说明顺丰开放平台申请、Partner ID/Checkword 回填、丰桥 PDF 面单、打印和轨迹验收。
适用版本：2.1.94 及以上 · 客户物流手册 2026-08-24 · 适用端：PC · 2026-08-24 验证
去哪里申请
打开顺丰开放平台，登录后进入丰桥应用管理。若客户使用 ZenTea 服务商应用，跳过创建应用，向实施人员领取已审核的应用凭证；客户仍要办理自己的月结/寄件账号、电子面单、发件网点和 COD 资质。
申请前准备营业执照或个体资料、负责人和联系人手机号、门店发件地址，以及顺丰月结或寄件账号。需要打印时申请丰桥云打印和模板管理权限；需要货到付款时单独申请 COD 结算账号和服务项。
申请能力时至少确认下单/寄件、电子面单、路由查询；需要更及时更新再申请路由订阅；需要打印再申请云打印。只申请轨迹查询不能自动取号或打印。
申请完成后回填什么
进入“物流中心 → 接入与发件 → 新建物流服务商”，选择“顺丰开放平台（内置直连）”。字段对应关系如下：
| 顺丰资料 | ZenTea 页面字段 | 注意 |
|---|---|---|
| Partner ID / 合作伙伴编码 | Partner ID | 与 Checkword 属于同一应用，不是月结卡号 |
| Checkword | Checkword | 不是网页登录密码 |
| 沙箱或正式 | 接入环境 | 两套环境的凭证不能混用 |
| 月结卡号 | 月结卡号 | 按页面付费方式和顺丰合同填写 |
| COD 结算账号/服务项 | COD 结算账号、COD 服务项编码 | 未开通 COD 不填写 |
| 丰桥模板编码 | 丰桥面单模板编码 | 不是 ZenTea 本地打印模板名称 |
编辑已有配置时，密码框留空表示保留原值。填写后保存，再点击“测试配置 → 配置自检”。自检只在 ZenTea 本地生成摘要签名，不会向顺丰发送业务请求，也不代表已经具备正式取号权限。
面单和打印
顺丰下单返回的路由标签不是完整面单。需要完整面单时，在正式配置中启用顺丰云打印，填写当前 Partner ID 可用的丰桥模板编码；系统获取的是 PDF。打印时选择浏览器、本地打印服务或支持 PDF 渲染的 Windows 代理，不能把 PDF 直接走 TSPL/ZPL RAW 端口。
面单尺寸必须同时匹配顺丰模板和 Windows 驱动纸张。默认的 waybill-100x180 只是 ZenTea 预置档案，实际尺寸以顺丰模板和现场试打一张为准。
正式使用
- 在“发件档案 → 新建”选择门店和顺丰服务商，填写真实寄件人、电话、四级地址及门店账号覆盖。
- 销售单选择“快递配送 → 物流中心取号”。
- 在“待取号销售单”按顺丰服务商筛选，选择发件档案后取号。
- 到“运单与打印”获取并打印面单，确认实际出纸后再“确认发货出库”。
- 在运单列表查看轨迹；未配置推送时使用系统主动查询。
常见问题
| 现象 | 处理 |
|---|---|
| Partner ID 或签名错误 | 核对 Partner ID、Checkword、环境来自同一应用 |
| 能查轨迹但不能取号 | 只开通了查询，补开下单和电子面单能力 |
| 取号后没有完整面单 | 检查云打印开关和丰桥模板编码，再在运单与打印中重试 |
| 提示不支持 RAW 代理打印 | 改用浏览器、本地 PDF 打印服务或升级 PDF 代理，不要改成 TSPL/ZPL |
| 月结或 COD 失败 | 按顺丰合同核对月结卡号、COD 结算账号和服务项 |
| 回调没有消息 | 先用主动查询；推送地址必须使用系统生成的 HTTPS 地址 |
正式环境中，只有完成真实取号、取消、面单出纸和轨迹验收的能力才能在生产能力矩阵中启用。