菜鸟-京东取号接入

京东取号指南

一、背景

京东物流本次接入菜鸟电子面单为直营单品牌模式接入，其京东快递和京东快运分别作为不同的物流服务商入驻，为两个不同的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	快运