此接口用于更新一个酒店商品,根据传入的gid更新商品信息,该商品必须为对应的发布者才能执行更新操作。如果对应的商品在酒店系统中不存在,则会返回错误提示。
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
gid | Number | 可选 | 100000 | 废弃,使用out_rid | |
out_rid | String | 可选 | 123321 |
|
卖家房型ID |
vendor | String | 可选 | taobao |
|
系统商,一般不填写,使用须申请 |
title | String | 可选 | aaa |
|
废弃,宝贝名称展示在店铺里 |
guide | String | 可选 | aaa |
|
废弃,房型购买须知展示在PC购物路径 |
desc | String | 可选 | bbb |
|
废弃,宝贝描述展示在宝贝详情页面 |
pic | byte[] | 可选 | 我是被上传的文件内容 |
|
废弃,宝贝图片,没有默认使用标准酒店房型图片 |
has_receipt | Boolean | 可选 | true | 废弃,房型是否提供发票 | |
receipt_type | String | 可选 | A | 废弃,房型发票类型。A,B。分别代表: A:酒店住宿发票,B:其他 | |
receipt_other_type_desc | String | 可选 | aaa |
|
废弃,房型发票类型为其他时的发票描述,不能超过30个字 |
receipt_info | String | 可选 | bbb |
|
废弃,房型发票说明,不能超过100个字 |
inventory | String | 可选 | [ { "date": "2017-01-28", "quota": 10, "al_quota": 2, "sp_quota": 3 }, { "date": "2017-01-29", "quota": 10, "al_quota": 2, "sp_quota": 3 } ] | 房型共享库存日历。quota物理库存;al_quota保留房库存;sp_quota超预定库存。其中保留房库存和超预定库存需要向运营申请权限示例:[{"date":2011-01-28,"quota":10,"al_quota":2,"sp_quota":3}] | |
room_switch_cal | String | 可选 | [{"date":"yyyy-MM-dd","room_status":2},{"date":"yyyy-MM-dd","room_status":1}] | 房型库存开关。 1,开;2,关 | |
superbook_end_time | String | 可选 | 20:00:00 | 超预定库存截止时间 | |
superbook_start_time | String | 可选 | 08:00:00 | 超预定库存开始时间 | |
allotment_end_time | String | 可选 | 20:00:00 | 保留房库存截止时间 | |
allotment_start_time | String | 可选 | 08:00:00 | 保留房库存截止时间 | |
status | Number | 可选 | 1 | 宝贝状态,1上架。 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
gid | Number | 200000 | gid酒店商品id |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); XhotelRoomUpdateRequest req = new XhotelRoomUpdateRequest(); req.setGid(100000L); req.setOutRid( "123321" ); req.setVendor( "taobao" ); req.setTitle( "aaa" ); req.setGuide( "aaa" ); req.setDesc( "bbb" ); req.setPic( new FileItem( "/tmp/file.txt" )); req.setHasReceipt( true ); req.setReceiptType( "A" ); req.setReceiptOtherTypeDesc( "aaa" ); req.setReceiptInfo( "bbb" ); req.setInventory( "[ { \"date\": \"2017-01-28\", \"quota\": 10, \"al_quota\": 2, \"sp_quota\": 3 }, { \"date\": \"2017-01-29\", \"quota\": 10, \"al_quota\": 2, \"sp_quota\": 3 } ]" ); req.setRoomSwitchCal( "[{\"date\":\"yyyy-MM-dd\",\"room_status\":2},{\"date\":\"yyyy-MM-dd\",\"room_status\":1}]" ); req.setSuperbookEndTime( "20:00:00" ); req.setSuperbookStartTime( "08:00:00" ); req.setAllotmentEndTime( "20:00:00" ); req.setAllotmentStartTime( "08:00:00" ); req.setStatus(1L); XhotelRoomUpdateResponse rsp = client.execute(req, sessionKey); System.out.println(rsp.getBody()); |
1 2 3 | < xhotel_room_update_response > < gid >200000</ gid > </ xhotel_room_update_response > |
1 2 3 4 5 6 | < error_response > < code >50</ code > < msg >Remote service error</ msg > < sub_code >isv.invalid-parameter</ sub_code > < sub_msg >非法参数</ sub_msg > </ error_response > |
错误码 | 错误描述 | 解决方案 |
---|---|---|
isv.remote-service:CONVERT_ERROR | 转换对象时出错 | 请检查输入参数 |
isv.invalid-parameter:ROOM_QUOTA_PARSE_ERROR | 商品房态不正确 | 请检查输入参数 |
isv.invalid-parameter:ROOMS_QUOTA_NUMBER_ERROR | 多个商品房态数量不能超过30个 | 请减少房态数量 |
isv.invalid-parameter: ERROR_SELLER_ROOM | 商品不属于卖家 | 请使用正确的卖家账号操作 |
isv.invalid-parameter: ERROR_ROOM_REPEAT | 一个房型下只允许发一个商品 | 请不要重复发商品 |
isv.invalid-parameter: ERROR_GUIDE | 购买须知超长 | 请控制购买须知长度 |
isv.invalid-parameter: ERROR_NO_FOUND_ROOM | 查询无此商品 | 请输入正确的参数 |
isv.invalid-parameter: ERROR_INVENTORY_NO_FOUND | 查询不到对应商品的库存 | 请检查商品库存 |
isv.invalid-parameter: ERROR_HOTEL | 酒店查询失败 | 请检查输入参数 |
isv.invalid-parameter: ERROR_ROOMTYPE | 房型查询失败 | 请检查输入参数 |
isv.invalid-parameter: ERROR_RECEIPT | 发票错误 | 请检查发票输入 |
isv.invalid-parameter: ERROR_SPU | 生成spu失败 | 请检查输入参数 |
isv.invalid-parameter: ERROR_SHOTEL | 标准酒店查询失败 | 请检查输入参数 |
isv.invalid-parameter: ERROR_PIC | 图片参数错误 | 请检查图片参数 |
isv.invalid-parameter: ERROR_DESC | 商品详情不能为空 | 商品详情不能为空 |
isv.invalid-parameter: ERROR_CHECK_INVENTORY | 库存校验错误 | 请检查库存参数 |
isv.invalid-parameter: ERROR_TITILE | 商品标题不能为空 | 商品标题不能为空 |
isv.invalid-parameter: ERROR_PIC_UP | 图片上传错误 | 请检查图片参数并重新上传图片 |
isv.invalid-parameter: ERROR_PIC_POWER | 图片权限错误 | 请检查图片参数 |
isv.invalid-parameter: ERROR_SHOTEL_STATUS | 标准酒店状态错误 | 请检查输入参数 |
isv.permission-error:NO_PERMISSIONS_ERROR | 权限不够、非法访问 | 请申请权限或者使用正确的卖家操作 |
isv.invalid-parameter: ERROR_HOTEL_POWER | 酒店不属于该卖家 | 请使用正确的卖家操作 |
isv.invalid-parameter: ERROR_HOTEL_MATCH | 酒店匹配状态错误 | 请检查酒店匹配状态 |
isv.invalid-parameter: ERROR_HOTEL_STATUS | 酒店状态错误 | 请检查酒店状态 |
isv.invalid-parameter: ERROR_HOTEL_ROOMTYPE | 房型不属于该酒店 | 请检查输入参数 |
isv.invalid-parameter: ERROR_ROOMTYPE_POWER | 房型不属于该卖家 | 请使用正确的卖家操作 |
isv.invalid-parameter: ERROR_ROOMTYPE_STATUS | 房型状态错误 | 请检查房型状态 |
isv.invalid-parameter: ERROR_ROOMTYPE_MATCH | 房型匹配状态错误 | 请检查房型匹配状态 |
isv.invalid-parameter:FORMAT_ERROR | 参数格式错误 | 参数格式错误,请检查参数 |