订单变化通知接口
一、接口名称:
getdltordernotify
二、输入参数:
| 父节点 | 名称 | 编码 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| 请求者信息 | requestor | 是 | |||
| requestor | 版本号 | invoker | string | 是 | |
| requestor | 操作人名称 | operatorName | string | 是 | |
| requestor | 操作IP | opClientIP | string | 是 | |
| requestor | 用户ID | userId | int | 是 | |
| requestor | 语言 | languageType | string | 是 | |
| 供应商ID | supplierID | int | 是 | ||
| 开始时间 | startTime | datetime | 是 | ||
| 结束时间 | endTime | datetime | 是 | ||
| 分销渠道 | channel | List |
否 | 不传是所有,可以指定多个渠道拉取 | |
| 订单类型 | formType | string | 否 | 不传是所有:N-新订;M-修改;C-取消;D-续住;S-(新)无效;T-(改)无效 | |
| 订单状态 | orderStatus | string | 否 | 默认不传是所有见附录1.1 | |
| 酒店Id | hotelId | List |
否 | 查指定酒店Id的订单通知,一次最多20个酒店ID | |
| 版本号 | version | String | 否 | 版本号(不传走以前逻辑,传入2走新逻辑,可以获取到代理通订单号,并且支持代理通订单号搜索,操作,查询,如果接入直连订单,必须使用版本2) | |
| 分页设置 | pagingType | 是 | |||
| pagingType | 每页数量 | pageSize | int | 是 | 每页最大100 |
| pagingType | 当前页码 | pageIndex | Int | 是 | 必须大于0 |
示例:
{
"requestor": {
"invoker": "ZS",
"operatorName": "ZS",
"opClientIP": "127.0.0.1",
"userId": 1,
"languageType": "CN"
},
" pagingType": {
"pageSize": 10,
" pageIndex": 1
},
"supplierID": 2274,
"startTime":"/Date(1520352000000+0800)/",
"endTime":"/Date(1520352000000+0800)/",
"channel": ["EBK","DirectConn","TC"],
"formType": "N",
"orderStatus": "1",
"hotelId": ["1111","1111"]
}
三、输出参数:
| 父节点 | 名称 | 编码 | 类型 | 描述 |
|---|---|---|---|---|
| 状态信息 | responseStatus | 系统校验信息 | ||
| 状态信息 | resultStatus | 业务校验信息 | ||
| resultStatus | 错误码 | resultCode | 除了0是正确,别的都是错误 | |
| resultStatus | 错误信息 | resultMsg | 错误信息 | |
| 代理通订单ID列表 | dltOrderIds | List |
||
| 代理通新订单ID列表(对应代理通后台代理通订单号) | newDltOrderIds | List |
||
| 代理通订单列表 | dltOrderList | |||
| dltOrderList | 代理通订单ID | dltOrderId | string | |
| dltOrderList | 销售方订订单ID | orderId | string | |
| dltOrderList | 分销渠道 | channel | string | 见附录2 |
| dltOrderList | 分销子渠道 | childChannel | string | |
| dltOrderList | 变更时间 | updateTime | datetime | |
| dltOrderList | 下单时间 | orderDate | datetime | |
| dltOrderList | 订单类型 | formType | string | 默认N;N-新订;M-修改;C-取消;D-续住;S-(新)无效;T-(改)无效 |
| dltOrderList | 订单状态 | orderStatus | string | 见附录1.1 |
| DltOrderInfo | 入住时间 | checkinDate | datetime | |
| DltOrderInfo | 离店时间 | checkoutDate | datetime | |
| DltOrderInfo | 新代理通订单号 | newDltOrderId | string | |
| DltOrderInfo | 新代理通订单主键 | newDltFormId | string | |
| DltOrderInfo | 新代理通订单状态 | dltOrderStatus | int | 见附录1.2 |
| DltOrderInfo | 酒店ID | hotelId | string | |
| DltOrderInfo | 酒店名称 | hotelName | string | |
| DltOrderInfo | 房型ID | roomId | string | |
| DltOrderInfo | 房型名称 | roomName | string | |
| DltOrderInfo | Md5唯一Key | md5Key | string | 关键属性唯一验证:(formid,channel,orderstatus,channelstatus,confirmno,isriskyconfirmed,ordertags,issueorderid,issueconfirmno,issuetype,issuestatus) 可根据各自场景来判断是否重复拉取 |
| 分页信息 | pagingType | |||
| pagingType | 当前页 | pageIndex | int | |
| pagingType | 每页大小 | pageSize | int | |
| pagingType | 总页数 | totalPages | int | |
| pagingType | 总记录数 | totalRecords | int |
示例:
{
"resultStatus": {
"resultCode": 0,
"resultMsg": "success"
},
"pagingType": {
"pageSize": 2,
"pageIndex": 1,
"totalRecords": 17,
"totalPages": 9
},
"dltOrderIds": [
"129024TC",
"129294TC"
],
"dltOrderList": [
{
"dltOrderId": "129024TC",
"orderId": "139024",
"channel": "TC",
"childChannel": null,
"updateTime": null,
"orderDate": "/Date(1484669220000+0800)/",
"formType": "N",
"orderStatus": "1",
"checkinDate": "/Date(1514736420000+0800)/",
"checkoutDate": "/Date(1514909220000+0800)/",
"hotelId": null,
"hotelName": null,
"roomId": null,
"roomName": null,
"md5Key": "l7knXeRnkJvZRDKA9zlWKg=="
},
{
"dltOrderId": "129294TC",
"orderId": "139294",
"channel": "TC",
"childChannel": null,
"updateTime": null,
"orderDate": "/Date(-62135798340000+0800)/",
"formType": "N",
"orderStatus": "1",
"checkinDate": "/Date(1516377960000+0800)/",
"checkoutDate": "/Date(1516464360000+0800)/",
"hotelId": null,
"hotelName": null,
"roomId": null,
"roomName": null,
"md5Key": "S3Sh8TH7s222kspPESo90w=="
}
]
}