供应链开放平台
  1. API文档
供应链开放平台
  • API文档
    • 使用说明
    • 更新说明
    • 回调说明
    • 参考资料
    • 登录授权
      • 获取access_token
      • 刷新access_token
    • 商品
      • 商品分类
      • 商品列表
      • 商品详情
      • 商品变动事件
      • 分类列表
      • 商品列表
      • 商品详情
    • 订单
      • 运费计算
      • 订单确认
      • 订单创建
      • 取消订单
      • 订单收货
    • 售后订单
      • 创建售后订单
    • 用户信息
      • 商品价格变动
      • 基本信息
      • 设置回调地址
  1. API文档

回调说明

回调通知#

当订单发货、售后审核、用户商品变动事件时,系统会自动发送对应的通知,为明文方式;
调用 设置回调地址 接口设置通知地址;

请求及响应#

通知请求方式为 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获取事件详情
修改于 2025-11-03 10:46:35
上一页
更新说明
下一页
参考资料
Built with