京东外卖餐饮新商开放平台对接——MVP版

京东外卖餐饮开放平台流程方案






1.订单类

1.1业务流程

正向订单流程





达达专送



商家自送






到店自提



用户取消订单



1.2功能介绍

订单包含接单、出餐完成、订单取消审核、部分退款等功能，订单流程与接口逻辑与其他平台基本一致




1.3常用接口




接口名称	功能描述	API接口文档
创建新订单消息【MQ】	当用户在京东外卖平台下单后，平台会发送MQ通知服务商	创建新订单消息【MQ】
订单列表查询接口【order/es/query】	接收到平台订单的MQ通知后，查询订单信息。	订单列表查询接口【order/es/query】
出餐完成接口【bm/open/api/order/OrderJDZBDelivery】	达达专送需要对接，出餐完成并呼叫骑手，达达专送商家使用	出餐完成接口【bm/open/api/order/OrderJDZBDelivery】
商家审核用户取消申请接口【ocs/orderCancelOperate】	用户发起订单取消申请，商家侧确认或驳回用户取消接口（用户申请取消订单后，商家需在15分钟内审核，超过时间系统默认同意申请）	商家审核用户取消申请接口【ocs/orderCancelOperate】
用户取消消息【MQ】	用户取消订单消息	用户取消消息【MQ】
订单运单状态消息【MQ】	订单运单状态发生变化后,推送订单运单状态消息。	订单运单状态消息【MQ】

---

2.门店信息类

2.1业务流程






2.2功能介绍

	商家功能介绍	开放平台对应接口
创建门店		创建无资质门店接口
上传资质		提交资质接口 资质审核结果消息




2.3应用场景




(1) 获取商家城市服务列表，查询区域信息

(2) 新建不带资质门店，通过门店ID上传资质并感知审核结果。

(3) 修改门店基础信息。

2.4常用接口

接口名称	功能描述	API接口文档
修改门店基础信息接口	修改门店信息接口，如门店名称、电话、地址、营业时间、营业状态、配送范围等	修改门店基础信息接口
修改门店运费起送价及满免接口	修改门店运费、起送价、满免	修改门店运费起送价及满免接口
新增或修改门店消息（门店状态变更通知）【MQ】	京东到家门店发生新增、修改、删除操作时，推送此消息，商家依据此消息回调门店详情接口获取明细	新增或修改门店消息（门店状态变更通知）【MQ】
反查门店基本信息接口	收到门店状态变更MQ后通过此接口反查门店信息	反查门店基本信息接口

3.商品&库存类

3.1功能简介

商品数据支撑品牌商总部统一建品，也支持单店建品两种模式，其中核心的商品创建、修改、价格、售卖状态同步接口，对标行业，进行了四合一改造，方便各位合作伙伴高效对接。

3.2常用接口




接口名称	功能描述	API接口文档
新增商家店内分类信息接口【pms/addShopCategory】	创建店内分类/菜单	新增商家店内分类信息接口【pms/addShopCategory】
修改商家店内分类信息接口【pms/updateShopCategory】	修改店内分类/菜单	修改商家店内分类信息接口【pms/updateShopCategory】
新增/修改SPU信息接口【PmsLightFoodSpuService/saveSpu】	新建/修改多规格商品接口	新增/修改SPU信息接口【PmsLightFoodSpuService/saveSpu】
查询商家下spu列表【OpenSpuService/querySpuInfoList】	查询商家下spu列表	查询商家下spu列表【OpenSpuService/querySpuInfoList】
修改可用库存接口【stock/batchUpdateUsableQtyByOutsideCode】	修改门店商品库存	修改可用库存接口【stock/batchUpdateUsableQtyByOutsideCode】
根据到家商品编码和到家门店编码批量修改门店商品可售状态接口【stock/updateVendibility】	修改门店商品可售状态	根据到家商品编码和到家门店编码批量修改门店商品可售状态接口【stock/updateVendibility】
根据到家商品编码和到家门店编码修改门店价格接口【price/updateStationPrice】	修改门店商品价格	根据到家商品编码和到家门店编码修改门店价格接口【price/updateStationPrice】

4.售后类

4.1业务流程





4.2功能简介

4.2.1从商家侧发起售后：

商家售后只能申请仅退款

申请后无需审核，直接进入退款流程



4.2.2从平台客服或者用户侧发起售后：

流转到商家或者平台客服审核

审核驳回，会给商家发送审核不通过的消息，此节点下，用户端可以继续申诉，申诉后售后单会再变成待审核状态（如果商家无法对接此流程，需要平台特殊处理）






4.3常用接口

接口名称	功能描述	API接口文档
商家自主申请售后退款	查询订单是否可售后，并发起售后退款申请	查询订单是否可售后接口【afsInner/checkCanApply】 查询订单申请售后详情接口【afsInner/getOrderAfsApplyInfo】 商家自主发起售后接口【afs/submit】
商家审核售后退款	对售后单进行审核，包括同意、拒绝等操作	商家审核售后退款
查询订单下的售后退款单	根据“订单号”查询订单下所有售后退款单信息	查询订单下的售后退款单
查询某个退款售后单的详情	根据“售后退款单号”查询售后退款详情	查询某个退款售后单的详情
售后退款创建消息	用户申请售后退款时，平台发送此消息通知商家	售后退款创建消息
售后单审核消息	平台客服审核通过售后单后，会发送此消息	售后单审核消息
售后单状态消息	售后单状态有任何变化，会通过此消息推送	售后单状态消息

5.财务类

5.1业务流程

秒送订单完成当日，会发起结算动作，次日产生对账单，并据此给商家按合同约定的T+N日打款，打款基于每天对账单的聚合-结算单发起，最终体现在付款流水-付款单上。

5.2功能简介

对账单查询接口:

可查询对账单信息，包含：（订单号、订单类型、结算状态）等信息

订单应结金额查询接口:

可查询订单应结金额信息，包含应结金额、佣金、基础配送费等信息

5.3应用场景

对账单查询接口：

需要在订单和售后单完成时间后次日早8点开始查询获取

订单应结金额查询接口：

在商家获取到订单后即可查询

5.4常用接口




接口名称	功能描述	API接口文档
【分页查询对账单接口】	账单信息查询接口，T+1维度	【分页查询对账单接口】
【订单应结金额接口】	实时查询订单的本单预计收入	【订单应结金额接口】
【新版订单金额拆分接口】	查询订单商品优惠明细、分摊比例等信息	【新版订单金额拆分接口】