京东快递 / 快运 2025 物流开放平台与快递鸟对接指南

作者：快递鸟

2025-10-17
广东
本文字数：1680 字
阅读完需：约 6 分钟

文档前言

随着京东物流业务体系的持续扩展和升级，现有参数标准中的字段配置已无法完全满足日益丰富的业务场景需求。为此，快递鸟平台对下单接口参数进行了重要更新，特别针对冷链等新兴业务场景进行了深度优化。

本文档详细介绍了京东快递/快运 2025 版物流开放平台与快递鸟的对接标准。自 2025 年初起，新对接项目建议直接采用本文档规范，原有 2024 版接口仍可继续使用但将不再更新维护。

重要提示：为方便开发者快速识别变更内容，本文档中所有新增或修改的参数均以#E0F9FB底色标注。

一、前期准备工作

1.1 京东平台参数获取

在开始对接前，需首先联系京东销售支持团队创建应用，并获取以下关键参数：

1.2 参数获取路径

京东开放平台操作步骤：

访问 京东开放平台
进入"应用管理"，选择"对接方案"
新建两个对接方案：
京东快递快运
京东云打印
确保两个方案均保持上线状态

参数获取方法：

AppKey 和 AppSecret：在应用管理页面生成获取
AccessToken：参照京东官方文档的令牌获取流程

二、接口核心规范

2.1 基础接口信息

温馨提示：如您首次使用快递鸟接口，建议先参考 API 参数示意图了解基本调用流程。

三、请求与响应示例

3.1 请求参数示例（京东快递）

json

{  "OrderCode": "TAN951324222372",  "ShipperCode": "JD",  "LogisticsRouteCode": "OPEN",  "CustomerMap": {    "Param2": "020K2311100",    "Param3": "0a3abb77fc3c4a439c95dc4c83529900",    "Param4": "67ad2c16ae194a07a2f00598c837d20c",    "Param5": "c312d533280a40648afca9fc5cafc0bf"  },  "PayType": 3,  "ExpType": 17,  "Remark": "小心破损",  "Sender": {    "Name": "哈哈",    "Mobile": "1840****905",    "ProvinceName": "广东省",    "CityName": "深圳市",    "ExpAreaName": "福田区",    "Address": "北环大道6018号华强科创广场1栋17层"  },  "TemplateSize": "P1303",  "Receiver": {    "Name": "雅雅",    "Mobile": "178****7360",    "ProvinceName": "广东省",    "CityName": "深圳市",    "ExpAreaName": "南山区",    "Address": "桃源街道平山村40栋菜鸟驿站"  },  "Commodity": [{    "GoodsName": "日用品",    "Goodsquantity": 20,    "GoodsWeight": 1.0  }],  "IsReturnPrintTemplate": 1}

复制代码

3.2 成功响应示例

json

{  "Order": {    "MarkDestination": "D-武汉",    "OriginName": "长春集货分拣中心",    "LogisticCode": "JDVF02543099355",    "ShipperCode": "JD",    "PackageName": "2-K33",    "OrderCode": "WBM2311480",    "KDNOrderCode": "KDN2311231150028110",    "DestinatioName": "长沙望城散货分拣中心",    "SortingCode": "JDVF02543099355-1-1-"  },  "EBusinessID": "1000000",  "UniquerRequestNumber": "69ecd9cd-baa8-4ecf-a66d-f4456cb60e5c",  "ResultCode": 100,  "Reason": "成功",  "Success": true}

复制代码

3.3 失败响应示例

json

{  "EBusinessID": "1237100",  "ResultCode": "105",  "Reason": "上门收件时间不能为空",  "UniquerRequestNumber": "5e66486b-8fbc-4131-b875-9b13d2ad1354"}

复制代码

四、常见问题排查指南

4.1 基础配置问题

问题 1：返回"下单失败|B2C 订单接单的基本信息-配送信息的揽收方式为空"

解决方案：检查 PickupMethod 字段是否正确赋值 1 或 2

问题 2：返回"客户配置信息校验失败，余额小于等于停用金额"

解决方案：该提示表明商家编码账户余额不足，需联系京东销售进行充值

问题 3：返回"不存在订阅关系"

解决方案：确认已在京东物流开放平台正确创建"京东快递"及"京东云打印"应用，并确保应用处于上线状态

4.2 面单模板配置

京东物流提供多种标准面单模板样式，开发者可根据实际业务需求选择合适的模板尺寸和布局。

五、注意事项

参数映射准确性：确保京东参数与快递鸟参数的映射关系正确无误
并发控制：严格遵守 20 次/秒的并发限制，避免请求被拒绝
令牌管理：AccessToken 具有时效性，需建立有效的刷新机制
环境验证：上线前务必在测试环境完成全流程验证

本指南将随着双方平台的升级而持续更新，建议开发者定期关注最新版本，以确保对接的顺畅和稳定。

发布于: 刚刚阅读数: 3

快递鸟

关注

还未添加个人签名 2023-11-06 加入

还未添加个人简介

发布

暂无评论

创作场景

京东快递 / 快运 2025 物流开放平台与快递鸟对接指南

文档前言

一、前期准备工作

1.1 京东平台参数获取

1.2 参数获取路径

二、接口核心规范

2.1 基础接口信息

三、请求与响应示例

3.1 请求参数示例（京东快递）

3.2 成功响应示例

3.3 失败响应示例

四、常见问题排查指南

4.1 基础配置问题

4.2 面单模板配置

五、注意事项

快递鸟

评论