京东物流本次接入菜鸟电子面单为直营单品牌模式接入,其京东快递和京东快运分别作为不同的物流服务商入驻,为两个不同的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参数取值详见:https://support-cnkuaidi.taobao.com/doc.htm#?docId=121886&docType=1
电子面单云打印接口
参数名 |
参数类型 |
是否必须 |
描述 |
productCode |
String |
是 |
本次京东快递和京东快运的主产品类型是必传参数,详细的产品编码参考下文 https://support-cnkuaidi.taobao.com/doc.htm#?docId=121886&docType=1 |
customerCode |
String |
是 |
月结卡号。本次京东快递和京东快运均是直营模式入驻,取号入参中该字段为必填字段。可从服务订购关系接口TMS_WAYBILL_SUBSCRIPTION_QUERY 中获取月结卡号。 |
tradeOrderInfoDtos.tradeOrderInfoDto.logisticsServices |
String |
否 (京东仓发场景必传) |
物流服务。在京东仓发场景,该字段需要传入指定的仓发物流服务标识。服务定义可从服务订购关系接口查询。仓发服务编码为SVC-WhDeliveryType |
tradeOrderInfoDtos.tradeOrderInfoDto.extraInfo |
String |
否 (京东仓发场景必传) |
扩展字段。在京东仓发场景,该字段需要传入这一单的出库单号。扩展字段key为 whOrderCode |
ps:京东取号productcode参数必传,productcode参数取值详见:https://support-cnkuaidi.taobao.com/doc.htm#?docId=121886&docType=1
面单模板
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仓" |
|
SVC-DOOR-TIME |
预约取件时间 |
有value值,value值格式为时间区间且取件时间不得早于取号时间: |
{\"SVC-DOOR-TIME\": {\"value\": \"{\\\"start\\\": \\\"2024-11-1813:00:00\\\",\\\"end\\\": \\\"2024-11-20 12:00:00\\\"}\"}} |
京东快运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仓" |
SVC-HeavyUpstair |
重货上楼 |
无 |
注意:SVC-ExamineGoods 这个普通快运产品不支持,只有大件的产品支持。也就是如果要使用这个服务,产品需要传入lq-m-0025、lq-m-0011、或者lq-m-0005。
快递与快运产品类型(product_code)
注意:京东不支持 STANDARD_EXPRESS,传参STANDARD_EXPRESS会报错。
cp 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 |
快运 |
A:支持,本次京东快递和京东快运两个CP都支持子母单取号和普通取号。京东快递和京东快运两个CP取普通单号的场景trade_order_info_dtos.package_info.total_packages_count 不传值即可;取子母单的场景该字段需要大于等于1。
A:trade_order_info_dtos.package_info.total_packages_count ?于等于1则表示??件取号。在取号请求中,订单号trade_order_list?致,包裹号package_info.id不同时会生成不同的子单号。需要注意的是京东的子母单取号模式中total_packages_count是不允许修改的。
A:子母单取号成功之后无法修改;但可以通过母单号进行取消,取消时只支持母单号取消且连同所有关联的子单号一起取消
A:这种业务场景是指商家使用了京东仓的服务,但是需要使用菜鸟电子面单进行取号发货。这部分业务京东侧已经单独和支持的ISV进行沟通,目前仅指定ISV可取,其他未收到沟通的商家和ISV可以忽略京东仓发场景。在支持的ISV上,商家无需感知出库单号,ISV内部在取号时会将出库单号放到入参中进行取号。