开发者社区 > 博文 > 云交易技术对接全景
分享
  • 打开微信扫码分享

  • 点击前往QQ分享

  • 点击前往微博分享

  • 点击复制链接

云交易技术对接全景

  • wa****
  • 2024-11-27
  • IP归属:北京
  • 100浏览
    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
    消息名称
    消息接口文档
    是否必须
    是否全球购特化接口
    商品
    skuChange
    ct_sku_change
    云交易商品信息变更
    https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=178
    商品
    skuStatus
    ct_sku_status
    云交易商品上下架变更消息
    https://open.jd.com/home/home/#/doc/msgApi?apiCateId=92&apiId=301按需
    库存
    wareHouse_change
    ct_wareHouse_change
    云交易指定仓覆盖范围变更消息
    https://open.jd.com/home/home/#/doc/msgApi?apiCateId=92&apiId=270按需
    促销
    promoChange_pro
    ct_sku_promo_change
    商品赠品促销变更消息
    https://open.jd.com/home/home/#/doc/msgApi?apiCateId=92&apiId=263按需
    价格
    skuPriceChange
    ct_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_ghost3
    ct_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_enough
    ct_order_balance_not_enough
    账户余额不足报警mq
    https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=221按需
    订单
    ctp_jos_bd_create_waybill
    ct_order_stockout
    云交易订单出库MQ
    https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=177
    订单
    ctp_jos_delivery_modified
    ct_order_stockout_modified
    云交易订单运单号变更
    https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=220按需
    订单
    ctp_jos_bd_dlok_flag_ghost
    ct_order_delivered
    云交易订单妥投
    https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=173按需
    订单
    ctp_jos_ODC_COMPLETE
    ct_order_finish
    云交易订单完成MQ
    https://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_CANCEL
    ct_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
    售后
    afsCreate
    ct_afs_create
    售后服务单创建成功
    https://open.jd.com/home/home#/doc/msgApi?apiCateId=92&apiId=194
    售后
    afsStepResult
    ct_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接口入参:协议参数 特需说明如下:
    名称
    类型
    必须
    示例值
    描述
    ctpProtocol
    com.jd.tpcc.base.api.protocol.CtpProtocol

    协议参数(非必填字段建议传值,尤其是traceId要传请求唯一标识)
    traceId
    String

    d8298e5a-7a94-49d8-8043-ebd7e253f8c5
    客户每次请求的唯一标识,用于单纯标识一次请求,是接口联调、后期运维排查线上日志的重要线索,建议客户使用有业务语义的唯一值亦或使用UUID
    opName
    String

    test0316
    操作人账号
    clientIp
    String

    127.0.0.1
    客户端请求ip
    customerId
    Number

    186224628
    http://yjy.jd.com
    clientPort
    String

    8080
    客户端请求端口
    appKey
    String

    0e4d960d7e57ed33d208b22226202073
    客户应用唯一标识
    channelId
    Number

    187118347
    http://yjy.jd.com
    1. 案例接口文档地址:

    https://jos.jd.com/apilist?apiGroupId=881&apiId=16479&apiName=jingdong.ctp.order.getChildAreaList&apiGroupName=%E4%BA%91%E4%BA%A4%E6%98%93API



    1. 技术对接手册
    系统接口对接前请细读、精读对接手册,会提高对接效率,解答你的困惑!!!


    云交易系统对接手册V4.2


    【自动回复】JDO问题提交工单进群咨询:10206518823

    开放接口:开放平台接口能力使用指南

    开放消息:开放平台消息推送能力使用指南

    了解京东商家开放平台看这一篇文章就够啦

    1. 名词解释
    2. pin:京东登录账号