快递100接口配置与错误排查

申请前先区分两项产品

快递100的实时查询和电子面单是两套独立产品，凭证不能交叉使用。

首次新增至少完整填写一组产品凭证。只查询轨迹可以不填电子面单凭证；需要取号时必须填写 Label Key 和 Label Secret。

新增配置

1. 进入“物流中心 → 接入与发件 → 物流服务商”，选择“快递100（内置直连）”。
2. 选择适用门店；留空表示全部门店，只应由老板维护全局配置。
3. 填写配置名称和内部编码。内部编码只允许字母、数字、点、下划线和短横线。
4. 在“实时查询与订阅推送凭证”填写 Query Key、Query Customer 和默认快递公司编码。
5. 需要电子面单时填写 Label Key、Label Secret；根据网点要求补充 Partner 字段和电子面单账号 Code。
6. 选择面单处理方式并填写对应字段，保存后执行配置自检。

快递公司编码

快递100使用官方小写编码，例如 shunfeng、yuantong、shentong、zhongtong、yunda、jtexpress。ZenTea 会转换常见缩写，但生产前仍应以快递100账号中实际开通的编码为准。

面单处理方式

• 只取号：不要求模板和打印设备，适合先验证取号或在第三方后台打印。
• 返回图片/HTML：必须填写当前承运商的面单模板 ID。
• 先取号后打印：必须填写模板 ID 和 SIID，支持后续官方云打印复打。
• 立即云打印：必须填写模板 ID 和 SIID，取号成功后立即向设备投递。

手机号脱敏、月结、到付、子母单和产品类型都受承运商与网点能力限制，不能仅靠页面开关获得授权。

测试步骤

先执行配置自检，确认凭证结构和签名可以生成。验证轨迹时填写真实运单号、快递100小写公司编码，并按平台要求补充收寄件电话。实时查询使用正式官方网关，没有单独的轨迹测试地址。

官方电子面单测试地址的联通检查不会验证 Key、Secret 和面单权限。需要在明确的测试环境中执行“测试取号”，成功后再用页面生成的取消令牌验证取消。

常见提示与处理

编辑已有配置时，凭证字段留空表示保留原值；系统不会回显已保存的密钥。