操作指南 · 物流与打印
快递鸟接口配置与错误排查
配置应用凭证、电子面单网点账号、产品字段与轨迹查询所需信息。
适用版本：2.1.94 及以上 · 适用端：PC · 2026-08-24 验证
准备应用与网点资料
快递鸟应用统一使用 EBusinessID 和 AppKey 签名。电子面单客户号、密码、月结编码和发货网点编码由具体快递公司或网点发放，不是应用凭证的一部分。
ZenTea 当前使用快递鸟电子面单、取消和即时查询接口，并主动轮询轨迹；下单时不会默认开启额外的付费轨迹订阅。
配置步骤
- 选择“快递鸟（内置直连）”，填写适用门店、名称和内部编码。
- 填写必填的 EBusinessID / 用户 ID 和 AppKey。
- 需要电子面单时，按承运商要求填写电子面单客户号、电子面单密码、月结编码和发货网点编码。
- 填写默认快递公司编码，例如顺丰
SF、圆通YTO。 - 选择现付、到付或月结；快件类型编码默认
1，以账号开通产品为准。 - 保存后先执行配置自检，再使用真实运单测试轨迹。
取号前检查
发件档案与销售单收件信息都必须包含姓名、手机号、省、市、区和详细地址。启用代收货款时，还需要快递鸟认可的代收客户标识或电子面单客户号，并在 ZenTea 中选择实际到账账户。
常见提示与处理
| 页面提示 | 原因与处理 |
|---|---|
| EBusinessID 和 AppKey 尚未配置 | 应用凭证缺失；重新填写当前账号的两项凭证 |
| 寄件人/收件人缺少资料 | 姓名、手机号或地址不完整；补齐销售单和发件档案 |
| 请选择快递公司编码 | 未填写承运商编码；使用快递鸟官方编码 |
| 未返回运单号 | 网点账号、产品、客户号或面单余量不满足；查看平台返回原因 |
| 代收货款需要客户标识 | 尚未签约代收或未填写电子面单客户号 |
| 查询顺丰、跨越或中通需要手机号后四位 | 在轨迹测试或订单中提供有效收寄件电话 |
| 返回格式无效 | 第三方返回非预期内容；检查出站网络、接口状态和官方公告 |
配置自检通过只说明凭证与签名结构正确。生产上线仍需分别验收目标承运商的取号、取消、轨迹、面单内容与真机打印。