邮 编:101100
Q Q:371502685
l 商家登录京东POP商家后台, 我的配送 > 电子面单服务,选择签约的快递公司、发货地、以及网点进行签约。
l 快的公司对签约进行审核并操作电子面单打印数量充值,商家可以在后台看到相关的快递公司网点编码。(当可用单号数量为0时则不可打印电子面单)
l 商家登录京东POP商家后台, 我的配送 > 电子面单服务,选择签约的快递公司、发货地、快递公司财务结算编码(月结卡号)进行签约。
l 快的公司对签约进行审核,商家可以在后台看到相关的快递公司网点编码。(直营型快递公司无需单号充值)
通过JOS平台jingdong.seller.vender.info.get 查询商家基本信息接口,获取商家ID接口地址为:http://jos.jd.com/api/detail.htm?id=493,返回参数中“vender_id”为POP商家ID,作为后续调用的商家编码使用
调用“根据商家编码查询商家所有审核成功的签约信息”接口,使用POP商家ID,获取商家所有审核通过的签约信息。
包含商家签约承运商、承运商类型、签约的网点或者财务结算编码、签约用发货地等信息
l 商家需要设置使用哪家快递公司的电子面单
l 商家根据签约信息,配置使用的快递公司网点编码
l 调用“商家库存查询接口”查询是否有库存信息
l 商家需要设置使用哪家快递公司的电子面单
l 商家根据签约信息,配置快递公司使用的财务结算编码(月结卡号)
l 顺丰需要额外配置面单支付方式和快递产品类型
l 第一步:调用接单接口 (jingdong.ldop.alpha.waybill.receive),获取快递公司运单号
l 第二步:调用大头笔查询接口 (jingdong.ldop.alpha.vendor.bigshot.query),获取快递公司大头笔、二段码、三段码、集包地等信息
l 除顺丰外的承运商,电子面单打印模板如下。
其中大头笔位置依次打印大头笔查询接口返回的“大头笔名称bigShotName”、“二段码secondSectionCode”、“三段码thirdSectionCode”
l 顺丰的模板采用顺丰自有的电子面单模板样式, “大头笔名称bigShotName”为顺丰的“目的地代码”
顺丰模板示例:示例 顺丰 150*100,180*100模板
l 如果订单信息,如收件人信息地址改动、修改承运商等,需要调用电子面单解绑接口,然后重新获取单号及大头笔信息
(解绑的运单就作废了,不能再次使用,如果没有解绑,用同样的订单信息,二次获取返回的还是之前的,不会重新生成)
l 目前除顺丰外都支持一单发多件
l 下单接口,根据输入的包裹数量,可以返回多个运单号
l 如果订单已经获取过运单号,如果想更改获取的运单号数量,需要先调用解绑接口取消之前获取的运单号,然后再次获取
可以通过“根据商家编码查询商家所有审核成功的签约信息”
承运商名称 | 承运商编码 | 承运商ID | 承运商类型 |
中通快递 | ZTO | 1499 | 加盟型 |
韵达快递 | YUNDA | 1327 | 加盟型 |
申通快递 | STO | 470 | 加盟型 |
优速快递 | UC | 1747 | 加盟型 |
全峰快递 | QFKD | 2016 | 加盟型 |
快捷快递 | KJKD | 2094 | 加盟型 |
国通快递 | GTO | 2465 | 加盟型 |
全一快递 | QY | 2100 | 加盟型 |
速尔快递 | SE | 2105 | 加盟型 |
邮政EMS经济快递 | EMS | 465 | 直营型 |
邮政EMS标准快递 | EMSBZ | 3668 | 直营型 |
宅急送 | ZJS | 1409 | 直营型 |
中国邮政小包 | ZGYZZHDD | 2170 | 直营型 |
跨越速运 | KYE | 599866 | 直营型 |
顺丰快递 | SF | 467 | 直营型 |
安能快递 | ANXB | 596494 | 加盟型 |
承运商名称 | 承运商编码 | 承运商ID | 承运商类型 |
中通快递 | ZTO | 1499 | 加盟型 |
韵达快递 | YUNDA | 1327 | 加盟型 |
申通快递 | STO | 470 | 加盟型 |
优速快递 | UC | 1747 | 加盟型 |
全峰快递 | QFKD | 2016 | 加盟型 |
快捷快递 | KJKD | 2094 | 加盟型 |
国通快递 | GTO | 2465 | 加盟型 |
全一快递 | QY | 2100 | 加盟型 |
速尔快递 | SE | 2105 | 加盟型 |
邮政EMS经济快递 | EMS | 465 | 直营型 |
邮政EMS标准快递 | EMSBZ | 3668 | 直营型 |
宅急送 | ZJS | 1409 | 直营型 |
中国邮政小包 | ZGYZZHDD | 2170 | 直营型 |
跨越速运 | KYE | 599866 | 直营型 |
顺丰快递 | SF | 467 | 直营型 |
安能快递 | ANXB | 596494 | 加盟型 |
l 第一步:根据获取到的商家ID“根据商家编码查询商家所有审核成功的签约信息”接口,获取,商家签约的承运商、网点、月结卡号、签约发货地、单号库存等信息
l 第二步:需要商家根据其在京东POP商家后台签约的电子面单,配置其京东电子面单使用的承运商、以及对应的网点ID和名称。
l 第三步:根据商家订单信息,以及承运商电子面单签约信息,调用“ISV、POP后台推送运单接口”,操作下单,获取承运商运单号
l 第四步:根据承运商运单号,调用“大头笔信息查询接口”,获取承运商大头笔信息及其他分单信息
l 第五步:按照京东阿尔法电子面单模板要求,根据获取的单号、承运商分单信息、以及订单信息,打印电子面单
注意:如果商家快递公司时直营型快递公司,需要设置其签约使用的承运商月结编码,而不是网点ID,直营型快递公司无需单号充值
本接口仅用于ISV根据商家编码查询商家有效的商承运商的签约信息,可用的库存单号
名称 | 根据商家编码查询商家所有审核成功的签约信息 |
功能描述 | 根据商家编码查询商家所有审核成功的签约信息 |
接口名 | jingdong.ldop.alpha.provider.sign.success |
JOS接口地址 | http://jos.jd.com/api/detail.htm?apiName=jingdong.ldop.alpha.provider.sign.success&id=2063 |
线上模拟测试 | http://jos.jd.com/api/showTools.htm?id=2063&groupId=218 |
字段名称 | 字段类型 | 字段描述 | 是否必填 | 示例值 |
vendorCode | String(32) | 商家编码,使用POP商家ID | 是 |
字段名称 | 字段类型 | 字段描述 | 是否必填 | 示例值 |
statusCode | Integer | 0: 成功, 1:参数异常, -1:系统异常 | 是 | |
statusMessage | String | 异常消息 | 否 | |
data | List<SignSuccessQueryDTO> | 签约列表 | 否 |
SignSuccessQueryDTO对象
字段名称 | 字段类型 | 字段描述 | 是否必须 | 示例值 |
providerCode | String | 承运商编码 | 是 | |
providerId | Integer | 承运商ID | 是 | |
providerName | String | 承运商名称 | 是 | |
providerType | Byte | 承运商类型:1 快递公司, 2 物流公司, 3 安装公司, 4 生鲜冷链承运商 | 是 | |
supportCod | Boolean | 是否支持货到付款 | 否 | |
operationType | Byte | 经营类型:1 直营,2 加盟 | 是 | |
branchCode | String | 网点编码(加盟型快递公司必返回) | 否 | |
branchName | String | 网点名称(加盟型快递公司必返回) | 否 | |
settlementCode | String | 财务结算编码(直营型快递公司必返回) | 否 | |
amount | Long | 剩余单号量 | 否 | |
address | WaybillAddress | 与快递公司签约时使用的发货地址 | 是 |
WaybillAddress类型说明
字段名称 | 字段类型 | 字段描述 | 是否必填 | 示例值 |
provinceId | Integer | 省份id | 否 | |
provinceName | String(50) | 省份名称 | 否 | |
cityId | Integer | 市id | 否 | |
cityName | String(50) | 市名称 | 否 | |
countryId | Integer | 区县id | 否 | |
countryName | String(50) | 区县名称 | 否 | |
countrysideId | Integer | 乡镇/街道id | 否 | |
countrysideName | String(50) | 乡镇/街道名称 | 否 | |
address | String(100) | 详细地址 | 否 |
查询商家签约的加盟型商家库存信息
名称 | 商家单号库存查询 |
功能描述 | 用于查询某个商家在某个加盟型承运商(网点)的单号剩余库存量 |
接口名 | |
JOS平台地址 | http://jos.jd.com/api/detail.htm?apiName=jingdong.ldop.alpha.vendor.stock.queryByProviderCode&id=1928 |
线上模拟测试 | http://jos.jd.com/api/showTools.htm?id=1928&groupId=218 |
字段名称 | 字段类型 | 字段描述 | 是否必须 | 示例值 |
vendorCode | String | 商家编码,使用POP商家ID | 是 | 0001 |
providerCode | String | 承运商编码 | 是 | |
branchCode | String | 网点编码 | 否 |
JOS接口调用示例:https://api.jd.com/routerjson?v=2.0&method=jingdong.ldop.alpha.provider.stock.query&app_key=XXXXXXXXXXXXXXXX&access_token=yyyyyyyyyyyyyyyyyyyyyyyyyy&360buy_param_json={"providerCode":"","branchCode":"","vendorCode":""}
字段名称 | 字段类型 | 字段描述 | 是否必填 | 示例值 |
statusCode | Integer | 0: 成功, 1:参数异常, -1:系统异常 | 是 | -1 |
statusMessage | String | 异常消息 | 否 | 系统异常 |
data | List<WaybillStockDTO> | 结果对象 |
WaybillStockDTO对象
字段名称 | 字段类型 | 字段描述 | 是否必填 | 示例值 |
providerCode | Integer | 承运商编码 | 是 | |
providerName | String | 承运商名称 | 否 | |
branchCode | String | 网点编码 | 是 | |
amount | Integer | 剩余单号量 | 是 |
使用商家通过订单号获取运单号。
名称 | 接单接口 |
功能描述 | 提供给ISV软件下单调用的接口,通过该接口完成订运关系绑定,返回运单号,共ISV软件打印面单。 |
接口名 | jingdong.ldop.alpha.waybill.receive |
JOS平台地址 | http://jos.jd.com/api/detail.htm?apiName=jingdong.ldop.alpha.waybill.receive&id=1940 |
线上模拟测试 | http://jos.jd.com/api/showTools.htm?id=1532&groupId=218 |
WaybillAddress类型说明
字段名称 | 字段类型 | 字段描述 | 必填 | 示例值 |
provinceId | Integer | 省/直辖市id | 是 | 10 |
provinceName | String(16) | 省/直辖市名称 | 是 | 北京 |
cityId | Integer | 市id | 是 | 101 |
cityName | String(16) | 市名称 | 是 | 北京市 |
countryId | Integer | 区/县id | 是 | 10120 |
countryName | String(16) | 区/县名称 | 是 | 朝阳区 |
countrysideId | Integer | 乡镇/街道id | 否 | 10120002 |
countrysideName | String(16) | 县镇/街道名称 | 否 | 和平里北街 |
address | String(100) | 发货详细地址 | 是 | 广东省深圳市宝安区沙井镇上星路1001号 |
contact | String(16) | 发货联系人 | 是 | 李四 |
phone | String(16) | 发货人电话 | 是 | 18810909090 |
mobile | String(16) | 发货人手机 | 是 | 010-99929991 |
JOS接口调用示例:
https://api.jd.com/routerjson?v=2.0&method=jingdong.ldop.alpha.provider.sync.branch&app_key= XXXXXXXXXXXXXXXX&access_token= yyyyyyyyyyyyyyyyyyyyyyyyyy&360buy_param_json={"content":"{\"waybillType\":1,\"waybillCount\":1,\"providerId\":1,\"providerCode\":\"STO\",\"branchCode\":\"1001\",\"platformOrderNo\":\"u89213sas\",\"vendorCode\":\"1001\",\"vendorName\":\"xXXX\",\"vendorOrderCode\":\"999s9\",\"salePlatform\":\"0010001\",\"fromAddress\":{\"provinceId\":1,\"provinceName\":\"XXX\",\"cityId\":232,\"cityName\":\"YYY\",\"countryId\":1232,\"countryName\":\"ZZZ\",\"countrysideId\":10098,\"countrysideName\":\"CCC\",\"address\":\"北京市通州区经海路\",\"contact\":\"XXXXXXXXXXXXX\",\"phone\":\"010-19999999\",\"mobile\":\"18988882228\"},\"toAddress\":{\"provinceId\":12,\"provinceName\":\"XXX\",\"cityId\":232,\"cityName\":\"YYY\",\"countryId\":1232,\"countryName\":\"ZZZ\",\"countrysideId\":10098,\"countrysideName\":\"CCC\",\"address\":\"北京市海淀区XXX小区\",\"contact\":\"李小溪\",\"phone\":\"010-19999999\",\"mobile\":\"18988882228\"},\"weight\":1,\"volume\":1,\"payType\":1,\"shouldPayMoney\":22,\"needGuarantee\":false,\"guaranteeMoney\":10}"}
字段名称 | 字段类型 | 字段描述 | 是否必须 | 示例值 |
statusCode | Integer | 0: 成功, 1:参数异常, -1:系统异常 | 是 | -1 |
statusMessage | String | 异常消息 | 否 | 系统异常 |
data | WaybillResultDTO | 运单号信息 | 是 |
WaybillResultDTO对象
字段名称 | 字段类型 | 字段描述 | 是否必须 | 示例值 |
waybillCodeList | List<String> | 运单号 | 是 | STO00103221 |
platformOrderNo | String(32) | 平台订单号 | 是 | 2000200201 |
查询运单号对应的大头笔,用于商家打印面单使用。
名称 | 大头笔信息查询接口 |
功能描述 | 提供给POP端、ISV调用,用于异步查询大头笔信息的接口,用于打印面单 |
接口名 | jingdong.ldop.alpha.vendor.bigshot.query |
JOS接口地址 | http://jos.jd.com/api/detail.htm?apiName=jingdong.ldop.alpha.vendor.bigshot.query&id=1530 |
线上模拟测试 | http://jos.jd.com/api/showTools.htm?id=1530&groupId=218 |
字段名称 | 类型 | 字段描述 | 是否必须 | 示例值 |
waybillCode | String | 运单号 | 是 | STO00200302 |
providerId | Integer | 承运商编码 | 是 |
JOS接口调用示例:
https://api.jd.com/routerjson?v=2.0&method=jingdong.ldop.alpha.vendor.bigshot.query&app_key= XXXXXXXXXXXXXXXX&access_token=yyyyyyyyyyyyyyyyyyyyyyyyyy&360buy_param_json={"waybillCode ":"111","providerId ":1100}
字段名称 | 字段类型 | 字段描述 | 是否必须 | 示例值 |
statusCode | Integer | 0: 成功, 1:参数异常, -1:系统异常 | 是 | -1 |
statusMessage | String | 异常消息 | 否 | 系统异常 |
data | List<BigShotDTO> | 大头笔信息
| 否 |
BigShotDTO对象
字段名称 | 字段类型 | 字段描述 | 是否必须 | 示例值 |
waybillCode | String | 运单号 | 是 | |
bigShotName | String(64) | 大头笔名称,如果有值,需要打印到面单上 | 是 | |
bigShotCode | String(64) | 大头笔编码 | 是 | |
gatherCenterName | String(64) | 集包地名称,如果有值,需要打印到面单上 | 否 | |
gatherCenterCode | String(64) | 集包地编码 | 否 | |
branchName | String(64) | 目的网点名称 | 否 | |
branchCode | String(64) | 目的网点编码 | 否 | |
secondSectionCode | String(64) | 二段码,如果有值,需要打印到面单上 | 否 | |
thirdSectionCode | String(64) | 三段码,如果有值,需要打印到面单上 | 否 |
用于取消运单,让订单可以重新获取运单,如果订单信息有更新,或者获取更多的运单号,必须重新解绑后重新下单获取运单号。
名称 | 订运关系解绑接口 |
功能描述 | 提供给POP端、ISV调用,用于解绑运单号,解绑后单号不回收,单号不再使用。 |
接口名 | jingdong.ldop.alpha.waybill.unbind |
JOS接口地址 | http://jos.jd.com/api/detail.htm?apiName=jingdong.ldop.alpha.waybill.unbind&id=1527 |
线上模拟测试 | http://jos.jd.com/api/showTools.htm?id=1527&groupId=218 |
字段名称 | 类型 | 字段描述 | 是否必须 | 示例值 |
waybillCodeList | List<String> | 运单号 | 是 | |
platformOrderNo | String(16) | 平台订单号 | 否 | |
providerCode | Integer | 承运商编码 | 是 | |
operatorTime | Date | 解绑时间 | 是 | 2016-08-01 12:00:00 |
operatorName | String(16) | 解绑操作人 | 是 | 张三 |
JOS接口调用示例:
https://api.jd.com/routerjson?v=2.0&method=jingdong.ldop.alpha.waybill.unbind&app_key= XXXXXXXXXXXXXXXX&access_token= yyyyyyyyyyyyyyyyyyyyyyyyyy&360buy_param_json={"platformOrderNo":"","providerId":"","operatorName":"","operatorTime":"","waybillCode":""}
字段名称 | 字段类型 | 字段描述 | 是否必须 | 示例值 |
statusCode | Integer | 0: 成功, 1:参数异常, -1:系统异常 | 是 | -1 |
statusMessage | String | 异常消息 | 否 | 系统异常 |