日历套餐价库信息拉取更新(SPI)
使用场景
商家在来客后台创建商品成功后,通过接口调整日历套餐的价格库存信息。使用场景如下图
接口说明
抖音 ->商家
请求参数
接口入参 | | |||
参数 | 名称 | 是否必填 | 参数类型 | 备注 |
product_id | 抖音平台商品ID | 否 | string | 和商家商品预售券ID二选一 |
out_id | 商家商品ID | 是 | string | 和抖音平台商品预售券ID二选一 |
account_id | 商家ID | 是 | string | 商家在抖音平台的id |
请求json示例
{ "product_id": "0", "out_id": "qlltest商品编码0123", "account_id": "7124319264303286286" }
响应参数
接口入参 | | | |||
一级参数 | 二级参数 | 名称 | 是否必填 | 参数类型 | 备注 |
data | | | | | |
| product_id | 抖音平台商品ID | 否 | string | 和商家商品日历商品ID二选一 |
| out_id | 商家商品ID | 是 | string | 和抖音平台日历商品ID二选一 |
| booking_calendar_stock | 商品的日历价格库存 | 是 | list<struct> | 日历库存最大支持360天.目前仅为单个 |
| - calendar_list | 日历结构体 | 是 | list<struct> | 日历库存最大支持360天,单次最多90个结构体,不可出现重叠日期 |
| --calendar_value | 日历值 | 是 | list<struct> | 可设置批量,1到10个 (包含10)(预计3.18号支持到90个) |
| --- start_date | 开始日期 | 是 | string | 设置日历范围开始日期(不传默认未来90天) |
| --- end_date | 结束日期 | 是 | string | 设置日历范围结束日期 (start_data end_date可为同一天) |
| ---available_weekday_list | 具体周几 | 否 | int | 周1、2、3、4、5、6、7 |
| --calendar_status | 是否可销售 | 是 | int | 1可购买,2不可购买 |
| --available_qty | 剩余库存 | 否 | int | 如果可销售则必填 |
| --actual_amount | 实际售卖价格 | 否 | int | 如果可销售则必填,单位分 |
| error_code | 返回码 | 是 | int | 0代表成功,非0代表失败 |
| description | 描述信息 | 否 | string | 描述信息 |
响应json示例
{ "data": { "product_id": "123", "out_id": "456", "booking_calendar_stock": [ { "calendar_list": [ { "calendar_value": [ { "start_date": "2024-02-08", "end_date": "2024-02-28", "available_weekday_list": [ 1, 2, 3, 4, 5, 6, 7 ] } ], "calendar_status": 1, "available_qty": 777, "actual_amount": 777 } ] } ], "error_code": 0, "description": "success" } }