获取子酒店接口
一、接口名称:
getdlthotellist
调用频次:10次/s,根据查询出来的总量控制页码,禁止尝试分页,例如一共100页,传参数200页是不对的
测试环境 http://m.fat.ctripqa.com/restapi/soa2/13353/getdlthotellist
生产环境 http://m.ctrip.com/restapi/soa2/13353/getdlthotellist
二、输入参数:
| 父节点 | 名称 | 编码 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| 请求者信息 | requestor | 是 | |||
| requestor | 版本号 | invoker | string | 是 | |
| requestor | 操作人名称 | operatorName | string | 是 | |
| requestor | 操作IP | opClientIP | string | 是 | |
| requestor | 用户ID | userId | int | 是 | |
| requestor | 语言 | languageType | string | 是 | |
| 供应商ID | supplierID | int | 是 | ||
| 城市ID | cityID | int | 是 | 增加按城市查询,限制页码最大为300,城市id 取自2.2接口 | |
| 子酒店列表 | hotelIDs | list |
否 | 子酒店为供应商用母酒店创建出来的酒店,请移除原单酒店字段hotelID,见示例 | |
| 酒店名称 | hotelName | string | 否 | 左模糊匹配 | |
| Ctrip渠道状态 | cBookable | int | 否 | 0.停售 1.在售 2.下线 3.定时售卖 移除节点代表全部状态 |
|
| Qunar渠道状态 | qBookable | int | 否 | 0.停售 1.在售 2.下线 3.定时售卖 移除节点代表全部状态 |
|
| ChannelA渠道状态 | channelaBookable | int | 否 | 0.停售 1.在售 2.下线 3.定时售卖 移除节点代表全部状态 |
|
| B2B渠道状态 | b2bBookable | int | 否 | 0.停售 1.在售 2.下线 3.定时售卖 移除节点代表全部状态 |
|
| pager | 每页数量 | pageSize | int | 是 | 每页最大200 |
| pager | 当前页 | pageIndex | int | 是 | 必须大于0,不能大于300, |
| pager | 是否返回总数量 | isReturnTotalCount | bool | 否 | 需要返回,调用时计算总体的调用次数 |
示例1:
{
"requestor": {
"invoker": "String",
"operatorName": "String",
"opClientIP": "String",
"userId": 0,
"languageType": "String"
},
"supplierID": 0,
"cityID": 1, // 此条件必传
"hotelID": 0, // 请移除此字段,若传此字段,以此处理此字段传的单子酒店id为准
"hotelIDs": [ // 单酒店查询,多酒店查询统一使用此字段
444
],
"hotelName": "",
"cBookable": 0,
"qBookable": 0,
"channelaBookable": 0,
"b2bBookable": 0,
"pager": {
"pageSize": 0,
"pageIndex": 0,
"isReturnTotalCount": false
}
}
示例1:不用某个条件查询,就渠道改节点,例如,不用渠道状态查询
{
"requestor": {
"invoker": "ZS",
"operatorName": "ZS",
"opClientIP": "127.0.0.1",
"userId": 1,
"languageType": "CN"
},
"supplierID":2274,
"cityID":1, // 此条件必传
"pager": {
"pageSize": 1,
"pageIndex": 1,
"isReturnTotalCount": true
}
}
三、输出参数:
| 父节点 | 名称 | 编码 | 类型 | |
|---|---|---|---|---|
| 状态信息 | responseStatus | 系统校验信息 | ||
| 状态信息 | resultStatus | 业务校验信息 | ||
| resultStatus | 错误码 | resultCode | 除了0是正确,别的都是错误 | |
| resultStatus | 错误信息 | resultMsg | 错误信息 | |
| 子酒店列表 | dltHotelEntityList | |||
| dltHotelEntityList | 城市ID | cityID | int | |
| dltHotelEntityList | 城市名称 | cityName | string | |
| dltHotelEntityList | 母酒店ID | masterHotelID | int | |
| dltHotelEntityList | 酒店ID | hotelID | int | |
| dltHotelEntityList | 酒店名称 | hotelName | string | |
| dltHotelEntityList | 酒店英文名称 | hotelEName | string | |
| dltHotelEntityList | 当前Ctrip渠道售卖状态 | cBookable | int | 0-停售 1-在售 2-下线 |
| dltHotelEntityList | 当前Qunar渠道售卖状态挂牌星级 | qBookable | int | 0-停售 1-在售 2-下线 |
| dltHotelEntityList | 当前ChannelA渠道售卖状态 | channelaBookable | int | 0-停售 1-在售 2-下线 |
| dltHotelEntityList | 当前B2B渠道售卖状态 | b2bBookable | int | 0-停售 1-在售 2-下线 |
| dltHotelEntityList | Ctrip渠道最晚预定时间小时数 | cReserveTime | string | |
| dltHotelEntityList | Ctrip渠道最晚预定时间天数 | cReserveDay | int | |
| dltHotelEntityList | Qunar渠道最晚预定时间小时数 | qReserveTime | string | T-可以添加子酒店,F-不可添加子酒店 |
| dltHotelEntityList | Qunar渠道最晚预定时间天数 | qReserveDay | int | |
| dltHotelEntityList | 当前发单方式 | issueOrderTypeInfo | ||
| issueOrderTypeInfo | 发单方式 | issueType | int | 0-EBK 1-传真 2-Email 3-QQ和微信 4-OST 5-PMS 6-直连 255-其他 |
| issueOrderTypeInfo | 传真模板号 | faxFormatNo | int | |
| issueOrderTypeInfo | 发单名称 | sendOrderName | string | |
| issueOrderTypeInfo | 发单邮箱 | sendOrderEmail | string | |
| issueOrderTypeInfo | 接单传真号 | fax | string | |
| issueOrderTypeInfo | 接单邮箱 | string | ||
| issueOrderTypeInfo | 结算周期 | settlementCycle | int | |
| issueOrderTypeInfo | 是否自动发单 | isAutoSend | int | 0-否,1-是 |
| issueOrderTypeInfo | 是否自动接单 | isAutoReceive | int | 0-否,1-是 |
| issueOrderTypeInfo | 是否自动拒单 | isAutoReject | int | 0-否,1-是 |
| issueOrderTypeInfo | 自动发单语言 | autoSendLanguage | string | |
| issueOrderTypeInfo | 取消单自动发单 | cancelAutoSend | int | 0-否,1-是 |
| issueOrderTypeInfo | 是否PMS自动发单 | isAutoSendPMS | string | 0-否,1-是 |
| issueOrderTypeInfo | 供应商id | supplierId | int | |
| issueOrderTypeInfo | 主题编号 | contractNo | int | |
| issueOrderTypeInfo | 子酒店ID | hotelID | int | |
| issueOrderTypeInfo | 发单房费相关默认选项 | sendPriceOption | int | 0-房费发单 1-隐藏 2-价格代码 |
| issueOrderTypeInfo | 发单时默认附加的备注 | sendAttachRemark | string | |
| issueOrderTypeInfo | 服务外包自动发单 | isVcrsAutoSend | int | 0-否,1-是 |
| issueOrderTypeInfo | 服务外包自动接单 | isVcrsAutoRecive | int | 0-否,1-是 |
| issueOrderTypeInfo | 母酒店发单黑名单 | isBlackMasterHotel | int | 0-否,1-是 |
| issueOrderTypeInfo | 供应商发单黑名单 | isBlackSupplier | int | 0-否,1-是 |
| issueOrderTypeInfo | 子酒店发单黑名单 | isBlackHotel | int | 0-否,1-是 |
| issueOrderTypeInfo | 发单币种 | sendOrderCurrency | string | |
| issueOrderTypeInfo | 分时发单发单信息 | issueTypeInfoEntityList | 暂时没用 | |
| pager | 总记录数 | totalRecords | int | |
| pager | 每页数量 | pageSize | int | |
| pager | 当前页 | pageIndex | int | |
| pager | 总页数 | totalPages | int | 总页数 |
示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1517991507751+0800)/",
"Ack": "Success",
"Errors": [],
"Build": null,
"Version": "v1",
"Extension": null
},
"resultStatus": {
"resultCode": 0,
"resultMsg": "success"
},
"dltHotelEntityList": [
{
"cityID": 2,
"cityName": "上海[Shanghai]",
"masterHotelID": 643564,
"hotelID": 43829,
"hotelName": "Hundred Centuries Hotel",
"hotelEName": "Hundred Centuries Hotel",
"cBookable": 1,
"qBookable": 0,
"channelaBookable": 1,
"b2bBookable": 1,
"cReserveTime": "21:00",
"cReserveDay": 3,
"qReserveTime": "23:00",
"qReserveDay": 2,
"issueOrderTypeInfo": {
"issueType": 0,
"faxFormatNo": 2,
"sendOrderName": "123",
"sendOrderEmail": "hw@vipdlt.com",
"fax": "",
"email": "qh@ctrip.com ",
"settlementCycle": 1,
"isAutoSend": 1,
"isAutoReceive": 1,
"isAutoReject": 0,
"autoSendLanguage": "KR",
"cancelAutoSend": 0,
"isAutoSendPMS": "N",
"supplierId": null,
"contractNo": 3,
"hotelID": 43829,
"sendPriceOption": 2,
"sendAttachRemark": "",
"isVcrsAutoSend": 1,
"isVcrsAutoRecive": 1,
"isBlackMasterHotel": 0,
"isBlackSupplier": null,
"isBlackHotel": 0,
"sendOrderCurrency": "AUD",
"issueTypeInfoEntityList": null
}
}
],
"pager": {
"pageSize": 1,
"pageIndex": 1,
"totalRecords": 706,
"totalPages": 706
}
}