供应链开放平台
  1. API文档
供应链开放平台
  • API文档
    • 使用说明
    • 更新说明
    • 回调说明
    • 参考资料
    • 1 登录授权
      • 1.1 获取access_token
      • 1.2 刷新access_token
    • 2 商品
      • 2.1 商品分类
      • 2.2 商品列表
      • 2.3 商品详情
      • 2.4 商品变动事件
    • 3 订单
      • 3.1 运费计算
      • 3.2 订单确认
      • 3.3 订单创建
      • 3.4 取消订单
      • 3.5 订单收货
    • 4 售后订单
      • 4.1 创建售后订单
    • 5 用户信息
      • 5.1 商品价格变动
      • 5.2 基本信息
      • 5.3 设置回调地址
  1. API文档

回调说明

回调通知#

当订单发货、售后审核、用户商品变动事件时,系统会自动发送对应的通知,为明文方式,公共请求参数包括 app_key time event_key event_desc,收到后在业务系统做相应的逻辑处理;
当同一个业务变更推送三次连续失败后,当前业务变更请求不再通知;
调用 设置回调地址 接口设置通知地址;

请求及响应#

通知请求方式为 POST
通知、响应内容数据格式及编码:Content-Type: application/json; charset=utf-8

请求示例#

发货通知#

请求数据格式
{"app_key":"ehobuy","time":1747388761,"event_key":"ORDER_DELIVERY","event_desc":"订单发货事件","content":{"order_id":"440182793457106944","details":[{"product_id":190,"sku":"红色","ship_name":"顺丰快运","ship_sn":"SF9878613663207","ship_code":"SF"},{"product_id":230,"sku":"中号","ship_name":"中通快递","ship_sn":"983115522692978","ship_code":"ZTO"}]}}
参数解释
参数说明
app_key授权appid
time时间
event_key事件
event_desc事件名称
content.order_id业务侧订单号
content.details.*.product_id商品ID
content.details.*.skuSKU名称
content.details.*.ship_name快递名称
content.details.*.ship_sn快递单号,多个单号以“,”英文逗号分隔
content.details.*.ship_code快递公司编码
响应数据格式
{"status":200,"msg":"SUCCESS"}

售后审核通知#

请求数据格式
{"app_key":"ehobuy","time":1747388761,"event_key":"REFUND_AUDIT","event_desc":"售后审核事件","content":{"service_id":"438662232750490564","type":1,"status":2,"refuse_reason":"审核备注信息"}}
参数解释
参数说明
app_key授权appid
time时间
event_key事件
event_desc事件名称
content.service_idtype=1则是订单id,2则是售后订单id
content.type1=取消订单,2=售后
content.status1=审核拒绝,2=审核通过
content.refuse_reason审核备注信息
响应数据格式
{"status":200,"msg":"SUCCESS"}

用户商品变动事件通知#

请求数据格式
{"app_key":"ehobuy","time":1747388761,"event_key":"PRODUCT_CHANGE_EVENTS","event_desc":"商品变动事件","content":{}}
参数解释
参数说明
app_key授权appid
time时间
event_key事件
event_desc事件名称
响应数据格式
{"status":200,"msg":"SUCCESS"}
PS: 收到通知后,异步主动调用商品价格变动事件API获取事件详情
修改于 2026-02-09 10:08:15
上一页
更新说明
下一页
参考资料
Built with