文档中心 > API类目 > 旅行度假API

qimen.alitrip.travel.item.sku.price.modify.result (价库信息消费结果消息订阅)

当发送方大量发送价库更新请求时，后台通过异步方式消费，并将消费结果通过队列方式回调给订阅方

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
item_id	Number	可选	111		商品id。itemId和outProductId至少填写一个
out_product_id	String	可选	123		商品外部商家编码。itemId和outProductId至少填写一个
skus	PontusTravelItemSkuInfo []	可选		最大列表长度：999	商品日历价格库存套餐
└ outer_sku_id String 必须 1111 套餐的外部商家编码。注意：如果没有为该商品设置过套餐商家编码，则无法调用本接口更新该套餐的日历价格。请手动去网页端后台编辑下该商品：为该商品的每个套餐添加设置一个商家编码；或者调用sku.override接口给每个套餐设置一个商家编码。 prices PontusTravelPrices [] 必须商品日历价格库存相关信息 └ operation Number 可选 1 日历价格库存的操作有以下三种：1-新增;2-增量更新;3-覆盖更新;4-删除。其中新增时成人价格和库存都必须大于0；增量更新只能对库存数进行修改，表示对某一天的成人或儿童新增或减少几个库存。覆盖更新能对库存和价格进行修改，表示用传入的值覆盖原有的库存和价格。删除支持删除单房差、儿童价格库存、成人价格库存，如果删除成人价格库存，则同时会把单房差和儿童价格库存也删除。 └ price_type Number 必须 1 价格类型。price_type 取：1-成人价，2-儿童价，3-单房差 └ stock Number 可选 123 库存 └ price Number 可选 123 价格 └ date String 必须 2015-09-19 09:42:24 日期。对于普通商品必填，对于预约商品该字段不填 └ outer_price_id String 可选 123 外部商家团期id，可选字段，仅供商家自己使用，用来标识每一天的价格库存
modify_type	Number	必须	0		价库变更类型，0=更新价格&库存，1=仅更新价格，2=仅更新库存
modify_result	Boolean	必须	true		更新结果

响应参数

名称	类型	示例值	描述
item_id	String	111	商品id
error_code	String	isv.request-failed	请求失败错误码
error_message	String	请求失败	请求失败消息
success	Boolean	true	请求成功标志

请求示例

{"skus":[{"outer_sku_id":"1111","prices":[{"date":"2015-09-19 09:42:24","price":123,"price_type":1,"stock":123,"operation":1,"outer_price_id":"123"}]}],"item_id":111,"modify_result":true,"modify_type":0,"out_product_id":"123"}

响应示例

{
    "item_id":"111",
    "error_code":"isv.request-failed",
    "error_message":"请求失败",
    "success":true
}

验签示例

{"error_message":"Illegal request","success":"false","error_code":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

旅行度假API

qimen.alitrip.travel.item.sku.price.modify.result (价库信息消费结果消息订阅)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ