文档中心 > 酒景直连

酒景价库更新

更新时间：2022/08/05 访问次数：3656

一、发品方式

手工发品+api价库更新
image
蓝色标识api调用，绿色表示手工

商品模型说明

image

二、价库变更方案

方案1：系统商推送飞猪变更通知，飞猪主动拉取变更详情。优先推荐
方案2：系统商推送飞猪变更通知和详情，飞猪更新后，推送处理结果。

三、流程图

image

四、接口说明

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 否 产品场次销售单价。单位：分

请求示例

[{
	"endDate": "2022-05-10",
	"productId": "abc111",
	"startDate": "2022-05-09"
}, {
	"endDate": "2022-05-10",
	"productId": "def222",
	"startDate": "2022-05-09"
}]

响应示例

{
	"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 是 库存

请求示例

[{
	"endDate": "2022-05-10",
	"productId": "abc111",
	"startDate": "2022-05-09"
}, {
	"endDate": "2022-05-10",
	"productId": "def222",
	"startDate": "2022-05-09"
}]

响应示例

{
	"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 是 库存

请求示例

{
	"endDate": "2022-05-10",
	"productId": "abc111",
	"startDate": "2022-05-09"
}

响应示例

{
	"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 否 失败需要返回具体错误信息

FAQ

关于此文档暂时还没有FAQ
有用(0) 我要提问
返回
顶部
阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号