首页 > API调用场景 > 物流开放指南 > 无界电子面单系统众邮快递接入

无界电子面单系统众邮快递接入

一、业务说明

1.1 众邮快递承运商编码ID

承运商名称

承运商编码

承运商ID

承运商类型

众邮快递

ZYKD

881232

加盟型

1.2 电子面单打印

1.2.1 获取众邮快递电子面单打印信息

l 第一步:调用接单接口 (jingdong.ldop.alpha.waybill.receive),获取快递公司运单号

l  第二步:调用大头笔查询接口 (jingdong.ldop.alpha.vendor.bigshot.query),获取众邮快递公司打印信息

1.2.2 众邮快递电子面单模板



二、接口说明

2.1根据商家编码查询商家所有审核成功的签约信息

2.1.1 接口说明

本接口仅用于ISV根据商家编码查询商家有效的商承运商的签约信息,可用的库存单号

名称

根据商家编码查询商家所有审核成功的签约信息

功能描述

根据商家编码查询商家所有审核成功的签约信息

接口名

jingdong.ldop.alpha.provider.sign.success.info.get

JOS接口地址

https://jos.jd.com/api/detail.htm?apiName=jingdong.ldop.alpha.provider.sign.success.info.get&id=2121

线上模拟测试

https://jos.jd.com/api/showTools.htm?id=2121&groupId=218

2.2商家单号库存查询

查询商家签约的加盟型商家库存信息

2.2.1接口说明

名称

商家单号库存查询

功能描述

用于查询某个商家在某个加盟型承运商(网点)的单号剩余库存量

接口名

jingdong.ldop.alpha.vendor.stock.queryByProviderCode

JOS平台地址

https://jos.jd.com/api/detail.htm?apiName=jingdong.ldop.alpha.vendor.stock.queryByProviderCode&id=1928

线上模拟测试

https://jos.jd.com/api/showTools.htm?id=1928&groupId=218

2.3接单接口

使用商家通过订单号获取运单号。

2.3.1接口说明

名称

接单接口

功能描述

提供给ISV软件下单调用的接口,通过该接口完成订运关系绑定,返回运单号,共ISV软件打印面单。

接口名

jingdong.ldop.alpha.waybill.receive

JOS平台地址

https://jos.jd.com/api/detail.htm?apiName=jingdong.ldop.alpha.waybill.receive&id=1940

线上模拟测试

https://jos.jd.com/api/showTools.htm?id=1532&groupId=218

JOS接口调用示例:

https://api.jd.com/routerjson?v=2.0&method=jingdong.ldop.alpha.waybill.receive &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}"}

2.4大头笔信息查询接口

查询运单号对应的大头笔,用于商家打印面单使用。

2.4.1接口说明

名称

大头笔信息查询接口

功能描述

提供给POP端、ISV调用,用于异步查询大头笔信息的接口,用于打印面单

接口名

jingdong.ldop.alpha.vendor.bigshot.query

JOS接口地址

https://jos.jd.com/api/detail.htm?apiName=jingdong.ldop.alpha.vendor.bigshot.query&id=1530

线上模拟测试

https://jos.jd.com/api/showTools.htm?id=1530&groupId=218

2.5根据运单解绑接口

用于取消运单,让订单可以重新获取运单,如果订单信息有更新,或者获取更多的运单号,必须重新解绑后重新下单获取运单号。

2.5.1接口说明

名称

根据运单解绑接口

功能描述

提供给POP端、ISV调用,用于解绑运单号,解绑后单号不回收,单号不再使用。

接口名

jingdong.ldop.alpha.waybill.api.unbind

JOS接口地址

https://jos.jd.com/api/detail.htm?apiName=jingdong.ldop.alpha.waybill.api.unbind&id=2190

线上模拟测试

https://jos.jd.com/api/showTools.htm?id=2190&groupId=218