摘要：简介：对外开放平台，通过对接各种流量场，输出京东商品供应链能力。主要业务模式： 1、官方旗舰店：京东以旗舰店方式入驻各大流量平台。 2、一件代发：为品牌商、商家在流量平台或者私域流量内的订单提供履约服务。
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.基于以上管理端可以查看消息的出队、入队、积压情况
模块京东内部 JMQ Topic宙斯JOS对外topic消息名称消息接口文档是否必须是否全球购特化接口商品skuChangect_sku_change云交易商品信息变更https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=178是商品skuStatusct_sku_status云交易商品上下架变更消息https://open.jd.com/home/home/#/doc/msgApi?apiCateId=92&apiId=301按需
库存wareHouse_changect_wareHouse_change云交易指定仓覆盖范围变更消息https://open.jd.com/home/home/#/doc/msgApi?apiCateId=92&apiId=270按需
促销promoChange_proct_sku_promo_change商品赠品促销变更消息https://open.jd.com/home/home/#/doc/msgApi?apiCateId=92&apiId=263按需
价格skuPriceChangect_sku_price_change云交易商品价格变更https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=196是
地址
jd_address_change四级地址变更消息https://open.jd.com/home/home#/doc/msgApi?apiCateId=90&apiId=166按需
订单ctp_jos_OrderPipe_ghost3ct_order_create云交易订单创建成功https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=171是
订单
ctp_jos_PS_Duizhang_Success_ghost
ct_order_pay
云交易支付成功MQ
https://open.jd.com/home/home/#/doc/msgApi?apiCateId=92&apiId=172
是
订单ctp_jos_acc_balance_not_enoughct_order_balance_not_enough账户余额不足报警mqhttps://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=221按需订单ctp_jos_bd_create_waybillct_order_stockout云交易订单出库MQhttps://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=177是
订单ctp_jos_delivery_modifiedct_order_stockout_modified云交易订单运单号变更https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=220按需
订单ctp_jos_bd_dlok_flag_ghostct_order_delivered云交易订单妥投https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=173按需
订单ctp_jos_ODC_COMPLETEct_order_finish云交易订单完成MQhttps://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=175是
订单
ctp_jos_clearance_result
ct_clearance_result
清关结果消息
https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=223
非全球购渠道不接
是
订单ctp_jos_ODC_CANCELct_order_cancel云交易订单取消成功https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=174是售后
ctp_jos_RefundFinishMessage
ct_order_refund
云交易订单退款成功
https://open.jd.com/home/home/#/doc/msgApi?apiCateId=92&apiId=176
是
售后afsCreatect_afs_create售后服务单创建成功https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=194是售后afsStepResultct_afs_step_result售后服务单全流程https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=195是
1.对外API接口清单
API接口文档 详见： 2.11. API接口族文档
模块接口名称接口说明是否必须是否全球购特化接口备注商品jingdong.ctp.ware.sku.getSkuDetail获取商品详情信息API是商品jingdong.ctp.ware.sku.getSkuList获取渠道商品列表API按需
商品jingdong.ctp.ware.sku.getBrotherList获取兄弟商品列表API按需
商品jingdong.ctp.ware.skupool.getSkuPoolList公共商品池列表查询API按需
商品jingdong.ctp.ware.skupool.addSkuIntoChannel将公共商品池sku批量添加到渠道下API按需
商品jingdong.ctp.ware.sku.getSkuCustomsRecords全球购商品备案基本信息API非全球购渠道不接是
商品jingdong.ctp.ware.sku.getSkuCustomsPatterns全球购商品备案模式信息API非全球购渠道不接是
商品jingdong.ctp.ware.sku.getXnztSkuList查询虚拟组套子商品API按需
价格jingdong.ctp.ware.price.getSkuPriceInfoList批量获取sku价格API是
促销jingdong.ctp.ware.sku.getSkuPromoForJos查询渠道促销赠品信息API按需
库存jingdong.ctp.ware.stock.queryAreaStockState获取库存状态API是
库存jingdong.ctp.ware.stock.querySpecifyWareHouse指定仓信息查询API按需
订单jingdong.ctp.order.getFreightFee获取运费API是
订单jingdong.ctp.order.getChildAreaList获取京标四级地址API按需
订单jingdong.ctp.order.getShipmentType获取配送方式API是
订单jingdong.ctp.order.getTaxInfo获取税费信息API按需
订单jingdong.ctp.order.submitOrder订单创建API是
订单jingdong.ctp.order.querySubmitOrder反查下单京东订单号API按需
订单jingdong.ctp.order.getLogistics获取订单物流轨迹API是
订单jingdong.ctp.order.cancelOrder订单取消API是
订单jingdong.ctp.order.cancelVirtualOrder虚拟订单取消API按需
订单jingdong.ctp.order.applyClearance申请清关API按需
订单jingdong.ctp.order.pushOrder订单推送API按需
订单jingdong.ctp.order.confirmDelivery订单确认收货API按需
订单jingdong.ctp.order.getOrderDetail获取订单详情信息API按需
订单jingdong.ctp.order.getOrderPayInfo查询订单支付信息API按需
订单jingdong.ctp.finance.getInvoiceDetail查询发票详情API按需
售后jingdong.ctp.afs.operate.apply.getIsCanApplyInfo查询订单是否可申请售后API是
售后jingdong.ctp.afs.operate.apply.createAfsApply售后服务单申请API是
售后jingdong.ctp.afs.operate.apply.getApplyReason获取售后申请原因列表API是
售后jingdong.ctp.afs.operate.apply.getReturnType获取商品返件方式API按需
售后jingdong.ctp.afs.logistics.getLogisticsAddress获取售后服务单回寄地址API是
售后jingdong.ctp.afs.logistics.postBackLogisticsBillParam回传客户发货信息API是
售后jingdong.ctp.afs.servicenbill.getAfsServiceDetail获取售后服务单详情API是
售后jingdong.ctp.afs.servicenbill.cancelAfsService售后服务单取消API是
1.API接口族文档
2.云交易API接口族，详见如下截图，根据自己需要对接的接口查看接口文档细节。
3.云交易API接口入参：协议参数 特需说明如下：
名称类型必须示例值描述ctpProtocolcom.jd.tpcc.base.api.protocol.CtpProtocol是协议参数（非必填字段建议传值，尤其是traceId要传请求唯一标识）
traceId
String
是
d8298e5a-7a94-49d8-8043-ebd7e253f8c5
客户每次请求的唯一标识，用于单纯标识一次请求，是接口联调、后期运维排查线上日志的重要线索，建议客户使用有业务语义的唯一值亦或使用UUID
opNameString是test0316操作人账号clientIpString否127.0.0.1客户端请求ipcustomerIdNumber是186224628clientPortString否8080客户端请求端口appKeyString是0e4d960d7e57ed33d208b22226202073客户应用唯一标识channelIdNumber是1871183471.案例接口文档地址：
https://jos.jd.com/apilist?apiGroupId=881&apiId=16479&apiName=jingdong.ctp.order.getChildAreaList&apiGroupName=云交易API
来源：京东云开发者
