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

  • 点击前往QQ分享

  • 点击前往微博分享

  • 点击复制链接

云交易技术对接全景

  • wa****
  • 2024-11-27
  • IP归属:北京
  • 4990浏览
    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:京东登录账号