概述 - 雅仓开放平台

订阅设置

1、见接口订阅设置
2、订阅地址（外网可访问，POST请求），选择相应的业务类型

订阅通知

参数解析

参数名	解析
id	资源id
type	业务类型
status	资源状态码
status_name	资源状态名称
tm	商品资料条码
batch_number	入库批次号
order_number	订单号

业务类型type

type	product_status	warehousing_status	order_status
type_name	商品资料状态	入库单状态	订单状态

通知示例

商品资料状态

status	0	1	2
status_name	未审核	审核通过	拒绝

{
    "id": "43841",
    "type": "product_status",
    "status": "1",
    "status_name": "审核通过",
    "tm": "2023101020268226"
}

入库单状态通知

status	0	1	2
status_name	待入仓	已入仓	部分入仓

goods_items

参数名	解析
stock_id	商品资料id
goods_num	入仓数量
original_goods_num	原始数量
status	审核状态，0:未审核，1:已审核
check	上架状态，0:未上架，1:已上架
goods_name	商品资料名称
goods_sku	商品资料sku
tm	商品资料条码
image	商品资料图片
added_time	上架时间

{
    "id": "3550",
    "type": "warehousing_status",
    "status": "1",
    "status_name": "已入仓",
    "batch_number": "PH-2306122042",
    "goods_items": [
        {
            "id": "41144",
            "goods_id": "780",
            "stock_id": "780",
            "goods_name": "2022宽时尚休闲男装",
            "image": "http://1688vipcomcn.oss-cn-shenzhen.aliyuncs.com/upload/20220702/48be3c25bd8b4670c5e8bab397d90fc4.png",
            "goods_sku": "TL0012-Red-M",
            "tm": "2022082917212277",
            "goods_num": "100",
            "original_goods_num": "100",
            "status": "1",
            "check": "1",
            "added_time":"2024-03-19 10:32:16"
        }
    ]
}

订单状态通知

status	1	2	3	4	5	6	7	8	9	10	11	12	13
status_name	待审核	已审核	待交运	交运中	待配货	配货中	待出仓	完成	取消	异常	缺货	已出仓	包裹异常

{
    "id": "9951056",
    "type": "order_status",
    "status": "5",
    "status_name": "待配货",
    "order_number": "SF35780257361891"
}

注：已出仓和完成，为仓库扫描并完结订单状态，不代表快递揽收状态；快递揽收状态需要自行同步平台订单状态或等待平台下发订单状态

响应请求

1、当响应成功则不再推送
2、失败后，下发 6次通知，若响应成功，则不再推送
3、当收到请求后，需要在 2秒内完成相关业务并响应接口
4、无法在 2秒内完成相关业务，请采用异步处理方式
5、重试时间表

重试次数	1	2	3	4	5	6
间隔时间	30s	1m	3m	5m	10m	15m

响应示例

开发平台可以返回一个json数据，来作为响应内容

{
    "status": 200,
    "message": "success"
}

概述

订阅设置#

订阅通知#

参数解析#

业务类型type#

通知示例#

商品资料状态#

入库单状态通知#

订单状态通知#

响应请求#

响应示例#