京东取号指南

一、背景

京东物流本次接入菜鸟电子面单为直营单品牌模式接入，其京东快递和京东快运分别作为不同的物流服务商入驻，为两个不同的CP。

本次改动主要为云打印接口在京东仓发场景需要增加额外的透传标识，其他接口无改动，具体详情参考下文。

CP NAME CP CODE 资源编码 品牌名称 号段规则
京东快递 LE04284890 DISTRIBUTOR_31481193 京东快递 JDAP2开头15位
京东快运 LE38288910 DISTRIBUTOR_31481205 京东快运 JDAP3开头15位

二、存在变更的接口

电子面单云打印接口

  • 变更入参说明：
参数名 参数类型 是否必须 描述
customer_code String 是 月结卡号。本次京东快递和京东快运均是直营模式入驻，取号入参中该字段为必填字段。可从服务订购关系接口 cainiao.waybill.ii.search 中获取月结卡号。
trade_order_info_dtos.logistics_services String 否 （仓发场景必传） 物流服务。在京东仓发场景，该字段需要传入指定的仓发物流服务标识。服务定义可从服务订购关系接口查询。仓发服务编码为SVC-WhDeliveryType
trade_order_info_dtos.extra_info String 否 （仓发场景必传） 扩展字段。在京东仓发场景，该字段需要传入这一单的出库单号。扩展字段key为 whOrderCode

**ps:京东取号product_code参数必传,product_code参数取值详见附录四

面单模板

cp code 模板名称 模板id 自定义区域尺寸 效果图
京东快递 LE04284890 京东快递一联单-76*130 776130 72*28
京东快递 LE04284890 京东快递一联单-100*113 775828 99*28
京东快运 LE38288910 京东快运一联单-76*130 777133 72*28
京东快运 LE38288910 京东快运一联单-100*113 776630 94*30
京东快运 LE38288910 京东快运大件-100*113 777136 98*25

ps：当取号cp code为LE38288910，取号参数product带有【lq-m-0025或lq-m-0011或lq-m-0005】时，必须选择模板【京东快运大件-100*113】进行打印，否则快递侧无法揽收。

（大件宅配lq-m-0025、大件零担lq-m-0011、大件商务仓lq-m-0005）

物流服务

京东快递LE04284890:

京东快递服务编码 服务名称 value值 举例
SVC-WAREHOUSE 送货入仓 无 “services”:{“SVC-COD”:{“value”:”100”},”SVC-SIGN-TYPE”:{“value”:”electronic”},”SVC-PICKUPTIME”:{“value”:”2024-09-30 19:19”},”SVC-WhDeliveryType”:{“value”:”C”},”SVC-INSURE”:{“value”:”100”},”SVC-WAREHOUSE”}
SVC-COD 代收货款 为数字金额
SVC-SIGN-TYPE 签单返还 “written”: “纸质”, “electronic”: “电子” “written-electronic”: “纸质+电子
SVC-PICKUPTIME 预约派送 派件时间格式（yyyy-MM-dd HH:mm） 时间格式为固定格式
SVC-INSURE 保价 为数字金额
SVC-WhDeliveryType 仓配标识 “E”: “E仓”, “C”: “C仓”

京东快运LE38288910:

京东快运服务编码 服务名称 value值
SVC-INSTALL 送装一体 无
SVC-ExamineGoods 开箱服务 “cantOpenCheck”: “禁止开箱”, “openElectrify”: “开箱通电”, “openCheck”: “开箱验货”
SVC-WAREHOUSE 送货入仓 无
SVC-COD 代收货款 为数字金额
SVC-SIGN-TYPE 签单返还 “written”: “纸质”, “electronic”: “电子”, “written-electronic”: “纸质+电子”
SVC-PICKUPTIME 预约派送 派件时间格式（yyyy-MM-dd HH:mm） 时间格式为固定格式
SVC-INSURE 保价 为数字金额
SVC-WhDeliveryType 仓配标识 “E”: “E仓”, “C”: “C仓”

三、常见问题

Q：京东是否支持子母单取号？

A：支持，本次京东快递和京东快运两个CP都支持子母单取号和普通取号。

Q：京东如何取子母单号？

A：trade_order_info_dtos[0].package_info.total_packages_count ⼤于等于1则表示⼦⺟件取号。在取号请求中，订单号trade_order_list⼀致，包裹号package_info.id不同时会生成不同的子单号。需要注意的是京东的子母单取号模式中total_packages_count是不允许修改的。

Q：子母单是否可以修改或取消？

A：子母单取号成功之后无法修改；但可以通过母单号进行取消，取消时只支持母单号取消且连同所有关联的子单号一起取消

Q：如何使用京东仓发单？

A：这种业务场景是指商家使用了京东仓的服务，但是需要使用菜鸟电子面单进行取号发货。关于京东仓的使用能力以及如何获取京东仓出库单号可以咨询京东（推荐京东联系人：杜涛）

仓发单仅特定ISV需要传值，京东侧已单独通知，其他商家和ISV可忽略。

四、京东快递产品

京东产品编码，对应取号接口的product_code参数（top取号接口）

cp code 产品名称 产品编码（product_code） 业务线
LE04284890 京东标快 ed-m-0001 快递
LE04284890 京东特快 ed-m-0002 快递
LE04284890 生鲜标快常温 LL-HD-M_usual 快递
LE04284890 生鲜标快鲜活 LL-HD-M_alive 快递
LE04284890 生鲜标快控温 LL-HD-M_control 快递
LE04284890 生鲜标快冷藏 LL-HD-M_cold 快递
LE04284890 生鲜标快冷冻 LL-HD-M_freezing 快递
LE04284890 生鲜标快深冷 LL-HD-M_deepCool 快递
LE04284890 生鲜特快常温 LL-SD-M_usual 快递
LE04284890 生鲜特快鲜活 LL-SD-M_alive 快递
LE04284890 生鲜特快控温 LL-SD-M_control 快递
LE04284890 生鲜特快冷藏 LL-SD-M_cold 快递
LE04284890 生鲜特快冷冻 LL-SD-M_freezing 快递
LE04284890 生鲜特快深冷 LL-SD-M_deepCool 快递
LE04284890 冷链专送常温 ll-m-0015_usual 快递
LE04284890 冷链专送鲜活 ll-m-0015_alive 快递
LE04284890 冷链专送控温 ll-m-0015_control 快递
LE04284890 冷链专送冷藏 ll-m-0015_cold 快递
LE04284890 冷链专送冷冻 ll-m-0015_freezing 快递
LE04284890 冷链专送深冷 ll-m-0015_deepCool 快递
LE04284890 电商特惠 ed-m-0059 快递
LE04284890 特惠包裹 ed-m-0012 快递
LE04284890 京东特惠 ed-m-0019 快递
LE04284890 特快包裹 ed-m-0020 快递
LE38288910 特快零担 fr-m-0001 快运
LE38288910 特快重货 fr-m-0004 快运
LE38288910 特惠专配 fr-m-0017 快运
LE38288910 快运零担 fr-m-0006 快运
LE38288910 大件宅配 lq-m-0025 快运
LE38288910 大件零担 lq-m-0011 快运
LE38288910 大件商务仓 lq-m-0005 快运

ps：当取号cp code为LE38288910，取号参数product带有【lq-m-0025或lq-m-0011或lq-m-0005】时，必须选择模板【京东快运大件-100*113】进行打印，否则快递侧无法揽收。

文档更新时间: 2024-10-22 15:12   作者：admin