注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 电子面单对接知识库

京东取号指南

更新时间:2024/11/21 访问次数:1179

京东取号指南

一、背景

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

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

CP NAME

CP CODE

资源编码

品牌名称

号段规则

京东快递

LE04284890

DISTRIBUTOR_31481193

京东快递

JDAP2开头15位

京东快运

LE38288910

DISTRIBUTOR_31481205

京东快运

JDAP3开头15位

二、top存在变更的接口

电子面单云打印接口

  • 接口名:cainiao.waybill.ii.get

  • 变更入参说明:

参数名

参数类型

是否必须

描述

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

三、link存在变更的接口

电子面单云打印接口

  • 接口名:TMS_WAYBILL_GET

  • 变更入参说明:

参数名

参数类型

是否必须

描述

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值格式为时间区间且取件时间不得早于取号时间:
start:yyyy-MM-dd HH:mm:ss——end:yyyy-MM-dd HH:mm:ss

{\"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

快运

四、常见问题

Q:京东是否支持子母单取号?

A:支持,本次京东快递和京东快运两个CP都支持子母单取号和普通取号。京东快递和京东快运两个CP取普通单号的场景trade_order_info_dtos.package_info.total_packages_count 不传值即可;取子母单的场景该字段需要大于等于1。

Q:京东如何取子母单号?

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

Q:子母单是否可以修改或取消?

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

Q:如何使用京东仓发单?

A:这种业务场景是指商家使用了京东仓的服务,但是需要使用菜鸟电子面单进行取号发货。这部分业务京东侧已经单独和支持的ISV进行沟通,目前仅指定ISV可取,其他未收到沟通的商家和ISV可以忽略京东仓发场景。在支持的ISV上,商家无需感知出库单号,ISV内部在取号时会将出库单号放到入参中进行取号。

FAQ

关于此文档暂时还没有FAQ
返回
顶部