云交易技术对接全景

作者：京东零售 王英杰

1.云交易简介

简介：对外开放平台，通过对接各种流量场，输出京东商品供应链能力。主要业务模式： 1、官方旗舰店：京东以旗舰店方式入驻各大流量平台。 2、一件代发：为品牌商、商家在流量平台或者私域流量内的订单提供履约服务。

1.对接全景图

全程保姆式 一站式服务

以下章节图例解释

1.B 客户业务操作流程

1.B 客户技术对接流程

1.宙斯 token 与渠道配置下单 pin

客户下单常见问题之： 下单 PIN 与渠道配置 PIN 不一致

举例说明：客户调宙斯传的 token 是从宙斯平台通过 pin 获取的，调接口时会传给宙斯再传给云交易，如果云交易解析 token 得到的 pin 与当前的渠道配置中的下单 pin 不一致则接口不通

异常错误案例：京东创建订单接口失败，渠道订单号:17221922317409*** 失败原因:parameter check：ApiSubmitOrderParam.pin error, channelConfig pin is z 小*****, token pin is 张武 1****【ApiSubmitOrderParam 类的 pin 入参和渠道配置的 token pin 不匹配,请传入正确】

两种解决方案：

•方案一：在云交易管理端配置下单 pin：pin-XXX

•方案二：JOS 管理端为：使用 pin-XXX 申请权限

1.商品信息流程

商品、价格、促销、库存相关的接口及消息处理流程

1.订单正向流程

注意📢：因提单参数较为复杂，故提供：提单参数说明-辅助开发 供参考

1.订单逆向流程

2.逆向包含 2 条链路：订单取消、订单售后

注意📢：售后服务单 Id 是由创建售后服务单 mq 返回的，创建售后服务单申请接口只会返回申请 Id，非售后服务单 Id

1.以快手直连对接云交易的售后为案例，详细流程如下图所示：

1.正逆向资金流程

资金流、代扣、发票等

1.全球购业务特化流程

2.B 客户若需要售卖全球购的商品，在系统对接的过程中需要额外对接如下订单、商品相关的接口，无全球购的商品售卖需求可忽略该小结，接口可不对接！

1.全球购清关流程

1.消息 Topic 接口清单

2.消息管理端地址：

https://jcq-console.jdcloud.com/topics

https://yd-jcq-console.jdcloud.com/topics

1.基于以上管理端可以查看消息的出队、入队、积压情况

1.对外 API 接口清单

API 接口文档 详见： 2.11. API 接口族文档

1.API 接口族文档

2.云交易 API 接口族，详见如下截图，根据自己需要对接的接口查看接口文档细节。

3.云交易 API 接口入参： 协议参数 特需说明****如下：

1.案例接口文档地址：

https://jos.jd.com/apilist?apiGroupId=881&apiId=16479&apiName=jingdong.ctp.order.getChildAreaList&apiGroupName=云交易API