首页 > API调用场景 > 商家对接青龙系统指南

商家对接青龙系统指南

一、对接jos平台

一、对接京东JOS平台

京东配送使用的是京东青龙系统,属于京东内网系统。要与之对接,需要京东商家&外部商家在JOS平台注册开发者,创建自研类型应用(通用类型应用指市场上的三方ISV软件类型,通用类型应用需发布到京东服务市场才可以上线,客户付费订购),对接青龙系统对外开放接口。

请技术关注JOS上的开发文档,尤其是接入流程-商家自研应用开发指南部分。

对接常见问题,在文档旁边的常见问题中均有收录,可通过搜索框快速查询。

 

大体接入流程如下。

第一步:提交以下资料到jos@jd.com审核,通过审核,才有创建自研类型应用资格。

第二步:创建自研类型应用,将创建好的appkey发给jos@jd.com psxt@jd.com做处理

1. 审核通过后,使用第一步中被授权账号作为开发者账号登录京东开放服务平台(jos.jd.com

2. 在宙斯控制台中创建自研应用,将创建的appkey发给jos@jd.com  psxt@jd.com处理

第三步:appkey处理好后会收到JOS返回的邮件,在控制台中点击上线运行即可。

注:正式上线后,授权的有效期是一年,超过授权有效期,或登录账号密码有修改,都会导致授权失效,需重新获取授权!!!

二、对接京东快递ApI

二、对接京东快递API

2. Docking with JD express API

成功后,可调用已开放到JOS平台上的青龙系统对应接口。京东物流配送的接口请参考:https://jos.jd.com/api/list.htm?id=64,普通商家对接只需关注以下接口。

2.1接口调用流程(建议)

2.1 Interface calling process (recommended)

1 提前调用运单获取接口,获取一批运单号,放在商家系统运单池里备用。

2 订单进入后,尽快调用是否可以京配接口,并存储接口返回信息(打单时使用)。

3 调用接单接口下发运单信息,如果此前是否可以京配接口返回信息为超区,此处最好限制使用京东快递。

4 调用全程跟踪接口查询物流信息。

5 接单接口信息提交后,实物交接给京东快递前,发现包裹数有问题的,可以提交修改包裹数接口修改数,重新打印面单。

6 实物交给京东快递后,京东投递前,需要拦截的货物,可通过运单拦截接口进行系统拦截信息传递,但目前此接口不能反馈是否拦截成功,只能通过物流跟踪接口跟踪该单后续状态。

注:以上为建议调用流程。

SDK包下载:

Sdk下载流程如下https://jos.jd.com/doc/channel.htm?id=285

以下对几个主要接口做详细说明,其它接口可直接参照JOS上接口对接说明直接对接。

2.2 运单获取接口

2.2 Waybill acquisition interface

获取京东物流运单号接口:

https://jos.jd.com/api/detail.htm?apiName=jingdong.etms.waybillcode.get&id=246

输入参数:

输出参数:


接口说明

1 运单号不可混用,即A配送商家编码获取的运单号,只能由A商家使用。

2 此处可以支持运单批量调用,接口限制商家每日调用量为5000单,如果不满足商家实际发货需求,可以向销售人员提出申请,销售人员评估后向配送支持部门申请上调限额;

3 返回的运单集合,请参考详细技术文档。

4 运单号有效期为3个月3个月后运单号作废,会导致下单不成功。建议不要囤积大量运单号,避免作废后运单无法流转。

2.3是否可以京配

2.3 whether JD distribution is allowed

商品是否可以京配:

https://jos.jd.com/api/detail.htm?apiName=jingdong.etms.range.check&id=1023

输入参数(黄色部分请重点关注)


注:

1发货仓寄件人省、市不能同时为空,否则会校验不通过。

1. “Distribution warehouse” and “province, city of sender” cannot be blank at the same time, otherwise it will not pass the check.

青龙可通过发货仓定位始发分拣中心。

Qinglong can position the source sort center through distribution warehouse.

2发货时间:指此单的预计发货时间,根据预计发货时间,计算时效,返回当日达”“次日达”“隔日达”“次晨达等产品类型。

输出参数:

Output parameters:



1关于”rcode”返回代码的详细说明。

1. Detailed description of “rcode” returned code.

100:可以京配。

200:不能京配。收到200,建议发货系统限制发京东快递。

150:人工预分拣。

100: can be delivered by JD.

200: cannot be delivered by JD. It is recommended to limit the use of JD express through the shipment system when receiving 200.

150: manual pre-sort.

人工预分拣状态是指此单流转到京东的人工预分拣部门分拣,还未产生最终分配结果,需等待。京东规定人工预分拣需在30分钟内完成,不排除工作量大情况下,未能在30分钟内返回最终结果。

如果接口返回150,建议商家可以:

1隔一段时间再次调用此接口(建议15分钟),注意不可换单号调用,直到获取到最终结果100or200

2如果30分钟后仍为人工预分拣状态,商家着急出货不愿意等待,也可以放弃调用,打出一张普通面单(始发分拣中心、目的分拣中心、道口、笼车号、配送站点信息空白),缺失的空白字段,待货物到达京东的分拣中心后,分拣中心可以补打一张包裹标签弥补,在分拣中心补打标签有超区退回的风险。

3如果商家着急出货,又不愿意承担货物到分拣中心后超区退回的风险,可以选择使用其它快递。

2关于时效名称返回字段详细说明。

2. Detailed description of “Aging name”returned field

此字段返回该单属于京东哪类时效产品的信息,时效产品有接货时间要求,建议在发货界面增加时效产品筛选框,则商家发货时可筛出同时效产品的运单,优先批量打出接货时间早的单子,及时交接,保证时效。

2.4京东快递提交运单信息接口(青龙接单接口)

2.4 Waybill information submission interface of JD express (Qinglong order receiving interface)

京东物流接单接口:

JD logistics order receiving interface:

https://jos.jd.com/api/detail.htm?apiName=jingdong.etms.waybill.send&id=245

输入参数(黄色部分请重点关注)

Interface description:接口说明:

1)非空字段为必填项,需要商家返回;

2)可扩展业务选项,做为预留字段,以适应未来可能开展的业务;

3)对于商家传入的包裹的重量、体积,主要用来进行订单信息的参考。实际运费的结算是以京东进行再次称重后的重量作为依据。

1) Non-null fields are required and need the merchant to return;

2) The option of extensible business is regarded as reserved field to adapt to the business which may be carried out in the future;

3) The weight, volume of merchants’ packages are the reference for order information. The settlement of actual freight is based on the weight measured by JD.

2.5全程跟踪接口需求

2.5 Tracking interface demand

京东物流全程跟踪查询接口:

JD logistics tracking query interface:

https://jos.jd.com/api/detail.htm?apiName=jingdong.ldop.receive.trace.get&id=1539

 

接口说明

Interface description

1)    此接口由京东快递物流系统提供;

2)    处理时间包含日期、时间;年// 小时::秒,处理时间以先后顺序进行显示;

3)    商家可调用此接口展示京东快递的物流跟踪信息。

1) The interface is provided by JD express logistics system;

2) Processing time includes date, time; mm/dd/yy hh:mm:ss, the processing time is displayed in sequential order;

3) The merchant can call this interface to manifest JD express logistics tracking information.


三、快递单说明

3. Description of express bill

3.1 纸质运单样式

3.1 Form of paper waybill

The figure shows the form of JD paper waybill

纸质面单为上图所示,带京东快递Logo的空白热敏标签纸。

The paper express bill is shown above, blank thermo-sensitive label paper with JD express logo.

3.2 打印后的运单样式

3.2 Form of printed waybill


The figure shows the form of printed waybill

打印模板的框线规格如上图所示,单位cm

Frameline specification of print template is shown above, unit: cm.

3.3 快递单内容说明

3.3 Description of express bill contents


The figure shows the contents of the express bill



 

 

四、对接FAQ

四、对接FAQ

4. Docking FAQ

1、京东快递、京邦达、青龙是什么关系?

答:京东快递、京邦达都是指京东配送,一个意思,两种叫法。青龙系统是指京东快递的物流信息系统。

1. What’s the relationship between JD express, Jingbangda, and Qinglong?

A: Both JD express and Jingbangda refer to JD distribution, one meaning, two names. Qinglong system refers to the logistics information system of JD express.

2、商家通过系统发货完成后,可以重新修改订单信息(如包裹数量等)再次发货吗?

答:目前提供了一个接口修改包裹数量,

https://jos.jd.com/api/detail.htm?apiName=jingdong.etms.package.update&id=712。参数传值详见接口说明。

2. After sending out the goods through the system, can the merchant send out again after modifying order information (such as the quantity of packages)?

A: At present, one interface to modify package quantity is provided, https://jos.jd.com/api/detail.htm?apiName=jingdong.etms.package.update&id=712. See interface description for parameter pass-by-value.

3、商家要通过第三方ERP软件发货给京东,需要具备什么条件?

       答:1、首先跟京东快递签订合同;2、通知配送运营人员在物流系统录入商家资料;3、完成erp软件跟京东快递的对接(如果是E店宝等已经对接完成的使用商家,需要通知E店宝帮其开通发货功能);4、通知配送运营人员在京东平台后台开通京东快递选项(如果非京东平台订单,则无此项);

3. What does the merchant need to send goods to JD through the third-party ERP software?

A: 1. Sign the contract with JD express; 2. Notify the distribution operation personnel to enter merchant information in the logistics system; 3. complete the docking of erp software with JD express (for the merchants who have completed the docking, for example, merchants who use E Dianbao, they need to inform E dianbao to help them open shipment function); 4. Inform the distribution operation personnel to open JD express option at background of JD platform (there is no need for this if the order is not the one on JD platform);

4、对接时调用接口时商家编号是什么东东?

       答:商家编号是配送运营人员在物流系统给商家录入的唯一身份标识,如果调用接口需要此ID,需向配送运营人员索取;

4. What is “merchant code”when docking and calling interface?

A: Merchant code is the unique identification recorded by distribution operation personnel in logistics system for the merchants. If the ID is needed when calling interface, you can request it from the distribution operation personnel;

5、对接时,接口中重量、体积等信息怎么传?

       答:商家传给配送系统的重量、体积等信息,配送只是作为参考,实际并不作为运费结算的依据。配送收货后需要重新称重。故此处若没有,可统一传默认值即可,但不要太大哦;

5. How to transfer the information such as weight, volume in the interface when docking?

A: The information which merchants transfer to distribution system, such as weight, volume is only for reference and will not be the basis for settlement of actual freight. After receiving, the weight will be measured again. If there is no information of weight or volume, the unified default values can be transferred, however, the value shall not be too large.

6、商家发货SOP订单时用京东后台操作出库,却用ERP软件打印京东运单发货,可以吗?

       答:不可以,如按此操作,则出库时填写的运单号跟打印后贴的运单号不一致,出现异常,导致客户收货延期,万万不能如此操作。

6. If the merchants use JD background to operate delivery from warehouse for SOP order, can they use ERP software to print JD waybill for delivery?

A: No, if you do so, the waybill number filled in when delivering from warehouse is inconsistent with the printed pasted waybill number. The abnormality will cause the delay in customer’s receiving, so don’t operate like this.

7、快递单可以提前打印吗?

       答:只要商家有该订单的发件人、收件人等信息、并获取到京东运单号,可随时打印。

7. Can the express bill be printed in advance?

A: Merchants can print the express bill at any time as long as they get the order information, such as sender, receiver, and JD waybill number.