首页 > API调用场景 > 京东健康药急送对接指南-自研

京东健康药急送对接指南-自研

一、 京东健康药急送介绍

当用户在京东APP搜索药品品牌、品名、疾病时,基于 LBS手机定位为用户推荐附近的一家门店。下单后由京东合作运力骑手提供送药上门服务。目前已上线1小时达、同城送业务,支持药房配送及用户自提两种配送方式。

1. 平台服务:提供京东主站多模块高流量入口,保证医药店送门店及商品的高曝光与展示

2. 配送服务:京东整合达达、美团等优质运力商, 提供门店1小时配送服

3. 运营服务:精选上万商品的标品库,快捷上线方 法,解决商家传品难题

4. 营销服务:资深京东营销团队,针对地区、节气 等出具权威的促销与指导方案

5. 药事服务:整合京东互联网医院资源,连接医 生、药品与患者,提供用药咨询,在线开方服

本文档主要针对系统对接商家的商品、库存、订单、售后各模块对接流程、接口等作以说明。商家可根据需要阅读。

如果需要合作药急送业务,请联系010-89113729zhaoyuan6@jd.com


二、 对接前的准备工作

1.    准备工作

1)    注册开发者账号: https://open.jd.com/home/home#/doc/common?listId=840

a)     需用商家总账号登录和开通;

2)    创建应用: https://open.jd.com/home/home#/doc/common?listId=841

a)     选择商家自研”——“第三方店铺

b)     回调地址填写线上正式回调地址;

c)     填写“商家自研应用.doc”,按照要求规范填写,包括界面截图(必填);

d)     一般工作日T+1会有审核结果,如申请材料驳回,需按照驳回的原因修改。

3)    开放平台介绍文档:https://open.jd.com/home/home#/doc/common


三、 订单对接流程

1.    订单对接方案说明

1)     审批流程:订单涉及到敏感数据,需走特殊申请流程,需要与对接的京东运营沟通走审批流程,审批通过后才能调用接口;

a)     如需查询订单中的金额明细(如平台和商家的优惠金额分摊金额),需与对接的京东运营沟通,由运营申请;

2)     购买云服务:注册京东云服务,选择企业账号,并且在控制台购买云主机和IP服务;

a)     如果需要监听新订单或订单状态变更消息,则需购买京东云服务(购买流程见 https://yunding.s3.cn-north-1.jdcloud-oss.com/yunding_guide.pdf  );

b)     需购买京东云华北区服务,目前仅华北区云服务支持消息订阅,其他地区正在升级暂不支持;

c)     如果不购买云服务,则需要通过轮询接口的方式获取订单状态变更;

3)     消息推送服务:https://open.jd.com/home/home#/doc/common?listId=864

处理消息队列:https://docs.jdcloud.com/cn/message-queue/product-overview

2.    订单对接流程

对接方案有两种:

对接方案

流程

优点

缺点

备注

方案A

监听消息,见图1

系统稳定性高

需购买京东云服务

建议使用

方案B

轮询接口,见图2

无需购买京东云服务

系统稳定性较差,可能丢单

方案A对接流程图1(流程图上标注的接口序号与下方的接口序号一一对应):

方案B对接流程图2(流程图上标注的接口序号与下方的接口序号一一对应):

3.    接口明细

开放平台链接:https://open.jd.com/home/home#/doc/api?apiCateId=661

接口1:新订单查询:

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4368&apiName=jingdong.medicine.ds.order.getIncrementOrderList

订单字段agingType12-同城送订单,或者商家内部系统通过门店id识别判断;

订单字段distribution1-商家配送,2-门店自提

接口2:商家确认接单/审核驳回

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4326&apiName=jingdong.medicine.ds.order.confirmAcceptOrder

接口3:呼叫运力

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4308&apiName=jingdong.medicine.ds.order.callCapacity

接口4:订单操作记录

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4307&apiName=jingdong.medicine.ds.order.getOrderOpRec

接口5:订单转为商家自送

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4382&apiName=jingdong.medicine.ds.order.vendorSelfDelivery

接口6:自送妥投(商家自有运力,非达达或美团,也非顺丰等三方物流)

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4386&apiName=jingdong.medicine.ds.order.vendorSelfDeliveryComplete

接口7:订单被用户拒收后,门店确认收货

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4322&apiName=jingdong.medicine.ds.order.confirmReject4Jos

接口8:单笔订单查询

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4315&apiName=jingdong.medicine.ds.order.getOrder

接口9:订单列表查询(建议用该接口作为补偿机制,每日轮询该接口查漏补缺)

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4327&apiName=jingdong.medicine.ds.order.getOrderList

接口10:取货码核销接口

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4907&apiName=jingdong.medicine.ds.order.userPickUpGoods

接口11:同城送订单同步物流单号接口

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4899&apiName=jingdong.medicine.ds.order.orderStockOut

接口12:取消订单详情https://open.jd.com/home/home#/doc/api?apiCateId=71&apiId=925&apiName=jingdong.pop.afs.soa.refundapply.queryPageList

接口13:取消订单审核

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4314&apiName=jingdong.medicine.ds.order.auditCancelOrder

接口14:订单金额明细

https://open.jd.com/home/home#/doc/api?apiCateId=250&apiId=2402&apiName=jingdong.queryOrderSplitAmountByQueryArr

MQ 1 medicine_ordcreate(新订单消息)

MQ 2medicine_ordchange(订单状态变更消息)



四、 商品库存&价格对接流程

特别注意:

(1)、若sku未维护门店价,则以商家价进行销售,若维护了门店价,则以sku门店价为准

(2)、门店价功能需向京东运营申请开通

1.    京东商品结构说明



2.    库存及价格对接流程图




3.    接口明细

(1).门店映射关系:

暂无接口,需自行维护京东门店编号的映射表

(2).查询商品列表:

https://open.jd.com/home/home#/doc/api?apiCateId=48&apiId=1227&apiName=jingdong.sku.read.searchSkuList

创建商品时若维护了商家sku,则接口可通过outerid查询京东SKUID

(3).设置商品sku门店库存:

https://open.jd.com/home/home#/doc/api?apiCateId=48&apiId=2980&apiName=jingdong.stock.write.updateSkuSiteStock

需入参京东门店ID京东SKUID及门店现货数量进行门店库存设置

(4).设置商品sku商家价格:

https://open.jd.com/home/home#/doc/api?apiCateId=48&apiId=1253&apiName=jingdong.price.write.updateSkuJdPrice

需入参京东SKUID及商家商品售价进行商品价格设置

https://open.jd.com/home/home#/doc/api?apiCateId=48&apiId=1248&apiName=jingdong.price.write.updateWareMarketPrice

需入参京东商品编码wareid)及商家商品市场价进行商品市场价设置,商品市场价需高于或等于SKU价格(若商家自有系统无最高售价,可与SKU价相同)

(5).设置商品sku门店价格:

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4827&apiName=jingdong.medicine.ds.order.updateStorePrice

入参京东SKUID(或商家货号)、京东门店ID(或商家门店编号)进行sku门店价的设置更新

https://open.jd.com/home/home#/doc/api?apiCateId=661&apiId=4851&apiName=jingdong.medicine.ds.order.getStorePrice

入参京东SKUID(或商家货号)、京东门店ID(或商家门店编号)进行sku门店价的查询


五、 售后对接流程

1.    售后对接流程说明

2.    对接说明

注意:由于财务风险问题,目前开放平台售后接口仅支持“全退”,不支持选择部分退(例如用户购买了商品A,价值10元,则退款默认退10元,无法选择退5元)。若需要部分退,可以在shop.jd.com进行操作。

注意:jingdong.pop.afs.soa.vipApplyRefund 需要提供APPKEY给京东运营进行权

1.    获取待审核申请单列表 jingdong.asc.audit.list

2.    获取服务申请单明细 jingdong.asc.audit.detail

3.    审核同意jingdong.asc.audit.delivery 

1.    确认收到顾客退回的货jingdong.asc.receive.register

1.    获取待处理服务单jingdong.asc.process.list

1.    处理退款jingdong.pop.afs.soa.vipApplyRefund——————>【结束】

2.    客户放弃,处理取消jingdong.asc.process.close——————>【结束】

2.    用户放弃,取消服务单jingdong.asc.common.cancel——————>【结束】

4.    审核拒绝==jingdong.asc.audit.refuse ( 拒绝服务单——————>【结束】

3.     相关文档

相关枚举值查询文档:https://open.jd.com/home/home#/doc/common?listId=512


六、 对接Q&A

1.    开通权限

1)     创建应用时提示没有权限是什么原因?

A: 开放平台需用商家账号登录,以及京东健康药急送商家需选择第三方店铺创建应用,从以上两个方面进行排查报错原因。

2)     如果总部在不同地区有分公司,分公司分别入驻京东药急送,能否共享一套应用?

A:可以支持,需要提供股权关系证明和需绑定的开放平台 APPKEY ,在 开放平台  提交工单, 开放平台会绑定分公司的关系。生效后可以用同一个 开放平台应用监听不同分公司的消息,处理不同分公司的数据。

 

2.     商品相关

1)     库存同步和价格同步只支持单商品吗?有批量的接口没?如果没有那平台在接口调用方面有流量限制吗?

A:目前不支持批量同步。接口调用有流量限制,如果需要扩容可与对接的京东运营沟通和申请。


3.    订单相关

1)     订单信息中收货地址有坐标吗?没有坐标的话平台是用的高德地图坐标还是腾讯地图坐标,还是其它?

A: 订单信息中收货地址没有坐标字段,平台是用腾讯地图坐标。


2)    平台有货到付款的订单吗?

A:平台目前没有货到付款订单。


3)     处方药订单需要审核吗?

A:含处方药订单都需要商家审核。审核通过即接单,审核驳回后系统将自动取消订单。审核接口与接单接口为同一个,接口地址:https://open.jd.com/home/home#/doc/api?apiCateId=55&apiId=4326&apiName=jingdong.medicine.ds.order.confirmAcceptOrder


4)     商家可以给订单添加配送小费吗?

A:目前不支持添加配送小费。


5)     平台支持订单自提吗?如果支持需要相关验证码吗?

A:支持订单自提,相关提货码在接口指引里有说明。


6)     获取订单配送信息的接口中有快递员相关的信息返回给我们吗?比如快递员姓名、快递员电话。

A:订单查询接口中包含配送员信息。


7)     用户拒收的一定需要商家确认收货吗?如果没对接这个接口有什么影响,需要怎么操作?

A:用户拒收后需要商家确认收货,如果商家没有确认,骑手则无法继续接单,可能导致骑手与门店的矛盾。调用写入接口即可,接口地址:https://open.jd.com/home/home#/doc/api?apiCateId=55&apiId=4322&apiName=jingdong.medicine.ds.order.confirmReject4Jos


8)     订单转商家自配送,商家需要如何接入?

A:平台会推送没有骑手接单的消息;平台会依次呼叫三轮运力,第一轮没有骑手接单情况下允许商家转自送,可调用自配送接口写入。


9)     订单送达时间类型,1-立即送达,2-预约订单:用户可以选择配送时间?

A:是的,允许用户选择未来3天时间段的配送时间。


10)     "获取单笔订单配送信息数据接口":能一次获取订单配送的每一步信息?

A:是的,订单配送的每一步信息都可以查到。


4.    退款相关

1)     配送中/已签收的订单,用户是否可取消/申请售后?

A:配送中的订单不支持取消,也不支持申请售后。用户确认收货后可以申请售后(药品一概售出,非质量原因,不退不换);


2)     商家能通过接口取消订单吗?

A:京东平台目前不支持商家取消用户订单,只能由用户或客服发起取消,处方单审核不通过则系统会自动发起取消订单。后续允许在接单前因无货取消运单,但需要与用户提前沟通好,该功能正在开发中。


3)     所有的订单取消都需要审核吗?

A:是的,目前所有取消的订单都需要经过商家审核。


4)     取消订单消息和取消订单查询接口这两个的区别是什么?

A:建议监听取消订单消息,然后通过取消订单查询接口获取取消订单详情。


5)     平台支持部分退款吗?商家能申请订单调整吗?

A:不支持部分退款,也不支持商家申请订单调整。


6)     如果平台配送的快递员取消订单或者取货失败等需要商家进行审核吗?

A:不需要。


7)     用户取消/申请售后,什么情况系统自动退款?

A:取消自动审核通过条件:1.骑手未接单或未转为门店自送,超1天不处理(自然日);