酒景直连
一、发品方式
手工发品+api价库更新
蓝色标识api调用，绿色表示手工
商品模型说明
二、价库变更方案
方案1：系统商推送飞猪变更通知，飞猪主动拉取变更详情。优先推荐
方案2：系统商推送飞猪变更通知和详情，飞猪更新后，推送处理结果。
三、流程图
四、接口说明
4.1批量拉取产品价格信息
接口方法定义：com.alitrip.travel.gateway.client.GwHotelTicketProductAdminService#pullProductPriceStock
飞猪调用接入方
接口注意：拉取n(n>0)个产品的日历价格信息
请求参数：Array
HotelTicketProductRequestDTO
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| productId | String | 是 | 接入方产品编码 |
| startDate | String | 是 | 开始时间；yyyy-MM-dd |
| endDate | String | 是 | 结束时间；yyyy-MM-dd |
| sessionIds | List<String> | 否 | 场次列表 |
响应数据
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| code | Integer | 是 | 返回码 0-success |
| message | String | 否 | 返回信息 失败必须返回相应信息 |
| data | List<HotelTicketProductPriceStock> | 否 | 查询成功返回价格数据集合 |
产品日历价格：HotelTicketProductPriceStock
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| productId | String | 是 | 接入方产品编码 |
| priceStocks | List<ProductPriceStock> | 是 | 日历价格 |
单日价格信息：ProductPriceStock
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| date | String | 是 | 日期。yyyy-MM-dd |
| wholesalePrice | Long | 否 | B2B分销结算价。单位：分结算价和销售价二传一 |
| retailPrice | Long | 否 | 产品销售单价。单位：分 |
| canSell | Boolean | 是 | 是否可售卖；true：可售卖 |
| sessions | List<ProductSession> | 否 | 场次价格信息 |
场次价格：ProductSession
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| sessionId | String | 是 | 场次ID |
| startTime | String | 是 | 开始时间。HH:mm |
| endTime | String | 是 | 结束时间。HH:mm |
| wholesalePrice | Long | 否 | B2B分销结算价。单位：分结算价和销售价二传一 |
| retailPrice | Long | 否 | 产品场次销售单价。单位：分 |
请求示例
1 2 3 4 5 6 7 8 9 | [{ "endDate": "2022-05-10", "productId": "abc111", "startDate": "2022-05-09"}, { "endDate": "2022-05-10", "productId": "def222", "startDate": "2022-05-09"}] |
响应示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 | { "code": 0, "data": [ { "priceStocks": [{ "canSell": true, "date": "2022-05-09", "wholesalePrice": 10000 }, { "canSell": true, "date": "2022-05-10", "wholesalePrice": 20000 }], "productId": "abc111" }, { "priceStocks": [{ "canSell": true, "date": "2022-05-09", "wholesalePrice": 10000 }, { "canSell": true, "date": "2022-05-10", "wholesalePrice": 20000 }], "productId": "def222" } ], "message": "OK"} |
4.2批量拉取产品库存信息
接口方法定义：com.alitrip.travel.gateway.client.GwHotelTicketProductAdminService#pullProductPriceStock
飞猪调用接入方
接口注意：拉取n(n>0)个产品的日历库存信息
请求参数：Array
HotelTicketProductRequestDTO
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| productId | String | 是 | 接入方产品编码 |
| startDate | String | 是 | 开始时间；yyyy-MM-dd |
| endDate | String | 是 | 结束时间；yyyy-MM-dd |
| sessionIds | List<String> | 否 | 场次列表 |
响应数据
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| code | Integer | 是 | 返回码 0-success |
| message | String | 否 | 返回信息 失败必须返回相应信息 |
| data | List<HotelTicketProductPriceStock> | 否 | 查询成功返回价格数据集合 |
产品日历价格：HotelTicketProductPriceStock
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| productId | String | 是 | 接入方产品编码 |
| priceStocks | List<ProductPriceStock> | 是 | 日历库存 |
单日库存信息：ProductPriceStock
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| date | String | 是 | 日期。yyyy-MM-dd |
| stock | Integer | 是 | 库存。 |
| sessions | List<ProductSession> | 否 | 场次价格信息 |
场次库存：ProductSession
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| sessionId | String | 是 | 场次ID |
| startTime | String | 是 | 开始时间。HH:mm |
| endTime | String | 是 | 结束时间。HH:mm |
| stock | Integer | 是 | 库存 |
请求示例
1 2 3 4 5 6 7 8 9 | [{ "endDate": "2022-05-10", "productId": "abc111", "startDate": "2022-05-09"}, { "endDate": "2022-05-10", "productId": "def222", "startDate": "2022-05-09"}] |
响应示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | { "code": 0, "data": [{ "priceStocks": [{ "date": "2022-05-09", "stock": 99 }, { "date": "2022-05-10", "stock": 98 }], "productId": "abc111" }, { "priceStocks": [{ "date": "2022-05-09", "stock": 99 }, { "date": "2022-05-10", "stock": 98 }], "productId": "def222" } ], "message": "OK"} |
4.3拉取单个产品价格库存信息
接口方法定义：com.alitrip.travel.gateway.client.GwHotelTicketProductAdminService#pullProductPriceStock
飞猪调用接入方
接口注意：本接口只拉取单个产品的日历库存价格信息
请求参数：
HotelTicketProductRequestDTO
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| productId | String | 是 | 接入方产品编码 |
| startDate | String | 是 | 开始时间；yyyy-MM-dd |
| endDate | String | 是 | 结束时间；yyyy-MM-dd |
响应数据
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| code | Integer | 是 | 返回码 0-success |
| message | String | 否 | 返回信息 失败必须返回相应信息 |
| data | List<HotelTicketProductPriceStock> | 否 | 查询成功返回价格数据集合 |
产品价格库存信息：HotelTicketProductPriceStock
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| productId | String | 是 | 接入方产品编码 |
| priceStocks | List<ProductPriceStock> | 是 | 日历库存 |
当日价格库存信息：ProductPriceStock
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| date | String | 是 | 日期。yyyy-MM-dd |
| stock | Integer | 是 | 库存。 |
| wholesalePrice | Long | 否 | B2B分销结算价。单位：分.结算价和销售价二传一 |
| retailPrice | Long | 否 | 产品销售单价。单位：分 |
| canSell | Boolean | 是 | 是否可售卖。 |
| sessions | List<ProductSession> | 否 | 场次价格信息 |
场次价格库存：ProductSession
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| sessionId | String | 是 | 场次ID |
| startTime | String | 是 | 开始时间。HH:mm |
| endTime | String | 是 | 结束时间。HH:mm |
| wholesalePrice | Long | 是 | B2B分销结算价。单位：分.结算价和销售价二传一 |
| retailPrice | Long | 否 | 产品销售单价。单位：分 |
| stock | Integer | 是 | 库存 |
请求示例
1 2 3 4 5 | { "endDate": "2022-05-10", "productId": "abc111", "startDate": "2022-05-09"} |
响应示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | { "code": 0, "data": { "priceStocks": [ { "canSell": true, "date": "2022-05-09", "wholesalePrice": 10000, "stock": 99 }, { "canSell": true, "date": "2022-05-10", "wholesalePrice": 20000, "stock": 98 }], "productId": "abc111" }, "message": "OK"} |
4.4产品批量变更通知（TOP）
接入方调用飞猪
释义：通知飞猪对应的产品更新，飞猪主动调用系统商相关接口(4.1, 4.2, 4.3 接口)进行更新
接口：alitrip.travel.hotelticket.product.productupdate
4.5产品批量变更通知(TOP)
接入方调用飞猪
释义：系统商将变更的信息推送给飞猪
接口：alitrip.travel.hotelticket.product.productupdatepush
4.6库价更新结果（涉及二次预约商品必接入）
飞猪调用接入方接口
请求参数：
| 字段 | 类型 | 是否必填 | 说明 | 备注 |
|---|---|---|---|---|
| code | Integer | 是 | 变更结果：0：成功。1：失败。 | |
| msg | String | 否 | 失败原因 | |
| requestId | String | 是 | 变更请求的ID | 推送api必传参数 |
返回参数
| 字段 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| code | Integer | 是 | 返回码。0为成功，其他为失败 |
| message | String | 否 | 失败需要返回具体错误信息 |
