供应链API
  1. 6 回调通知
供应链API
  • 使用说明
  • 帮助中心
  • 更新说明
  • V1
    • 1 账号信息
      • 1.1 获取 TOKEN
      • 1.2 重置 TOKEN
      • 1.3 账号基本信息
      • 1.4 设置回调地址
    • 2 基础信息
      • 2.1 省市区列表
      • 2.2 省市区详情
      • 2.3 商品分类
      • 2.4 商品品牌
      • 2.5 所有运输方式
    • 3 商品
      • 3.1 商品列表
      • 3.2 商品详情
      • 3.3 商品运输方式
      • 3.4 商品库存
      • 3.5 全部在售商品
    • 4 订单
      • 4.1 运费计算
      • 4.2 订单预览
      • 4.3 订单创建
      • 4.4 订单支付
      • 4.5 订单取消
      • 4.6 订单详情
      • 4.7 确认收货
      • 4.8 运输方式运费
    • 5 售后
      • 5.1 预约服务类型
      • 5.2 上传资源
      • 5.3 创建预约服务
      • 5.4 取消预约服务
      • 5.5 预约服务列表
      • 5.6 预约服务详情
      • 5.7 订单售后详情
    • 6 回调通知
      • 回调通知
  1. 6 回调通知

回调通知

回调通知#


当商品信息变更、订单状态变更时,系统会自动发送对应的通知,通知分两类:商品,订单;

注意事项#


1.
回调通知为明文方式
2.
订单通知,当同一个订单推送三次连续失败后,以后的状态变更将不再通知
3.
用户收到通知后,应主动调用我司对应的详情接口,来更新自己业务侧数据
4.
用户可自定义一些策略,来主动获取善品、订单的相关信息,例如:每周更新一遍所有商品、超过24小时没有收到订单回调通知时主动查询订单状态等

请求及响应#


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

请求示例#


订单通知#

注意
注:用户接收到订单通知后,请根据order_sn,主动调用我司 4.6 订单详情 ,根据接口返回的数据,更新业务系统订单信息
请求数据格式
{
	"content": {
		"base": {
			"time": 1699697041,
			"project": 1,
			"source": 0,
			"equipment": "b2bwap",
			"token": ""
		},
		"data": {
			"version": "1.0.0",
			"url": "",
			"fahuo_status": 1,
			"order_sn": "23003140164401",
			"goods_id": 318706,
			"spec_id": 5362925,
			"ship_sn": ["112233"],
			"ship_name": "顺丰快递",
			"ship_time": 1699696959
		}
	},
	"lock": "0",
	"time": 1699697041,
	"app_key": "d4a0a34f-9004-4073-af61-63ba300e9645"
}
响应数据格式
{
    "status": "200",
    "msg": "OK",
    "content": {
            "msg": "更新成功"
       }
}

商品通知#

注意
注:收到订单信息变更时,应根据goods_id,主动调用 3.2 商品详情,此时商品信息为最新信息,以此为依据,更新业务系统数据
请求数据格式
{
    "goodsId": 318719,
    "timestamp": 1703207510
}
响应数据格式
{
    "status": 200,
    "msg": "OK"
}
修改于 2024-07-05 03:11:38
上一页
5.7 订单售后详情
Built with