订单详情接口
一、接口名称:
getdltorderinfo
二、输入参数:
| 父节点 | 名称 | 编码 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| 请求者信息 | requestor | 是 | |||
| requestor | 版本号 | invoker | string | 是 | |
| requestor | 操作人名称 | operatorName | string | 是 | |
| requestor | 操作IP | opClientIP | string | 是 | |
| requestor | 用户ID | userId | int | 是 | |
| requestor | 语言 | languageType | string | 是 | |
| 供应商ID | supplierID | int | 是 | ||
| 代理通订单ID | dltOrderId | string | 是 | 旧版订单号:如果订单取消,会变化;请使用新版订单号,不会变化 | |
| 版本号 | version | String | 否 | 版本号(不传走老逻辑,传入2,走新逻辑,输入新版代理通订单号即可查询订单详情,如果接入直连订单,必须使用版本2) | |
| 新版代理通订单号 | newDltOrderId | String | 否 | 新版订单号:对应代理通后台代理通订单号,为代理通订单唯一标识,取自7.1接口中的newDltOrderId |
示例: 旧版请求:请转到新版本
{
"requestor": {
"invoker": "ZS",
"operatorName": "ZS",
"opClientIP": "127.0.0.1",
"userId": 1,
"languageType": "CN"
},
"supplierID": 2274,
"dltOrderId":"10254025"
}
新版请求:请使用新版本
{
"requestor": {
"invoker": "ZS",
"operatorName": "管理员",
"opClientIP": "39.107.56.116",
"userId": 1,
"languageType": "CN"
},
"supplierID": 16551,
"newDltOrderId": "123123456",
"version": "2"
}
三、输出参数:
| 父节点 | 名称 | 编码 | 类型 | 描述 |
|---|---|---|---|---|
| 状态信息 | responseStatus | 系统校验信息 | ||
| 状态信息 | resultStatus | 业务校验信息 | ||
| resultStatus | 错误码 | resultCode | 除了0是正确,别的都是错误 | |
| resultStatus | 错误信息 | resultMsg | 错误信息 | |
| 代理通订单ID列表 | dltOrderInfo | |||
| DltOrderInfo | 代理通订单ID | dltOrderId | string | |
| DltOrderInfo | 新版代理通订单号 | newDltOrderId | string | 对应代理通后台代理通订单号,为代理通订单唯一标识 |
| DltOrderInfo | 新版代理通订单主键 | newDltFormId | long | 代理通订单对应主键 |
| DltOrderInfo | 销售方订订单ID | orderId | string | |
| DltOrderInfo | 关联订单 | releationOrder | ||
| ReleationOrder | 上一个代理通订单号 | lastDltOrderId | string | |
| ReleationOrder | 上一个新代理通订单号 | newLastDltOrderId | string | |
| ReleationOrder | 下一个代理通订单号 | nextDltOrderId | string | |
| ReleationOrder | 下一个新代理通订单号 | newNextDltOrderId | string | |
| ReleationOrder | 上一个销售方订单号 | lastOrderId | string | |
| ReleationOrder | 下一个销售方订单号 | nextOrderId | string | |
| ReleationOrder | 上一关联单确认方式 | lastConfirmType | string | |
| ReleationOrder | 下一关联单确认方式 | nextConfirmType | string | |
| DltOrderInfo | 分销渠道 | channel | string | 见附录2 |
| DltOrderInfo | 分销子渠道 | childChannel | string | |
| DltOrderInfo | 变更时间 | updateTime | datetime | |
| DltOrderInfo | 下单时间 | orderDate | datetime | |
| DltOrderInfo | 订单币种 | orderCurrency | string | |
| DltOrderInfo | 订单总金额 | orderPrice | decimal | |
| DltOrderInfo | 订单类型 | formType | string | 默认N;N-新订;M-修改;C-取消;D-续住;S-(新)无效;T-(改)无效 |
| DltOrderInfo | 订单状态 | orderStatus | string | 见附录1.1 |
| DltOrderInfo | 新版订单状态 | newOrderStatus | string | 见附录1.2 |
| DltOrderInfo | 订单取消规则 | cancelRules | list | |
| CancelRules | 扣除类型 | deductType | int | 空;0不扣房费;1扣除百分比;2扣首晚 |
| CancelRules | 最晚取消时间 | lastCancelTime | datetime | |
| CancelRules | 扣除房费的百分比 | value | decimal | |
| DltOrderInfo | 付款方式 | paymentType | string | |
| DltOrderInfo | 确认号 | confirmno | string | |
| DltOrderInfo | 入住时间 | checkinDate | datetime | |
| DltOrderInfo | 离店时间 | checkoutDate | datetime | |
| DltOrderInfo | 城市ID | cityId | int | |
| DltOrderInfo | 城市名称 | cityName | string | |
| DltOrderInfo | 城市英文名称 | cityEName | string | |
| DltOrderInfo | 酒店ID | hotelId | string | |
| DltOrderInfo | 酒店名称 | hotelName | string | |
| DltOrderInfo | 酒店英文名称 | hotelEName | string | |
| DltOrderInfo | 房型ID | roomId | string | |
| DltOrderInfo | 房型名称 | roomName | string | |
| DltOrderInfo | 房型英文名称 | roomEName | string | |
| DltOrderInfo | 房间间数 | roomnum | int | |
| DltOrderInfo | 床型 | bedType | string | |
| DltOrderInfo | 是否保留房订单 | isHoldRoom | string | R-是保留房,空或其他都是非保留房 |
| DltOrderInfo | 是否风险订单 | isRiskyOrder | string | T-是,空或其他都是非 |
| DltOrderInfo | 入住人姓名 | customerName | string | |
| DltOrderInfo | 入住人数量 | customerQuantity | string | |
| DltOrderInfo | 联系人姓名 | contactName | string | |
| DltOrderInfo | 客人DID联系方式 | customerDid | string | (暂无) |
| DltOrderInfo | 附加服务 | additionalList | list | |
| DltOrderInfo | 客诉类型 | ccType | Int | 82到店无房 94到店无预订 |
| DltOrderInfo | 客诉状态 | ccStatus | Int | 0未处理1处理中2已处理 |
| DltOrderInfo | 客诉生成时间 | ccTime | Date | |
| DltOrderInfo | 客诉超时时间 | ccTimeoutTime | Date | |
| DltOrderInfo | 预警级别 | ccAlertLevel | String | |
| DltOrderInfo | 预警类型 | ccAlertType | Int | 82到店无房 94到店无预订7高风险订单 |
| DltOrderInfo | 预警状态 | ccAlertStatus | Int | -1超时0未处理1已处理 |
| DltOrderInfo | 预警时间 | ccAlertTime | Date | |
| DltOrderInfo | 预警关联订单号 | ccAlertReforderid | String | |
| DltOrderInfo | 事件列表 | ccEvents | List< DltEvent > | |
| DltEvent | 事件主键id | vid | Long | 事件主键id |
| DltEvent | 事件状态 | status | Int | 事件状态(0未处理1跟进2完成已解决3完成未解决4完成废弃) |
| DltEvent | 处理人 | processor | String | 处理人 |
| DltEvent | 事件处理内容 | content | String | 事件处理内容 |
| DltEvent | 接收人 | receiver | int | (1携程2仅供应商) |
| AdditionalService | 名称 | extraFareName | string | |
| AdditionalService | 金额 | extraFareAmount | decimal | |
| AdditionalService | 数量 | extraFareQuantity | int | |
| AdditionalService | 单位 | extraFareUnit | string | |
| AdditionalService | 币种 | extraFareCurrency | string | |
| DltOrderInfo | 特殊要求 | specialMemo | string | |
| DltOrderInfo | 订单备注 | orderMemo | string | |
| DltOrderInfo | 订单标签 | orderTags | List | instantconfirm:立即确认,holdroom:保留房,credit:闪住, isautoacceptorder:进单自动接,group:预售订单,riskverifyvalue=某个值(<100低风险,100-200中风险,>=200 高风险),coordinatemodify协商确认单(有此标记的订单,说明单据已经协调安排了,不能拒单,只能接单,备注中有协商确认的相关内容)100低风险,100-200中风险,> |
| DltOrderInfo | 采购单信息 | dltIssueOrder | ||
| PurchaseOrder | 发单单号 | issueOrderId | string | |
| PurchaseOrder | 发单状态 | issueStatus | int | 空白未发单;0 发单成功;1 ebk发单已读未处理;2 酒店已接受;3 酒店已拒绝;4 发单失败(ebk发单老逻辑中因为没有新酒店id发单失败,现在此逻辑已废弃);5 发单失败(发单失败);6 formstatus没有等于6的字段,null默认是6表示未发单;7 传真发单已回传未识别(传真回传了,但是没有识别出来是接受还是拒绝);8 发送中(传真 email等点击发送后不知道发送是否成功的一个中间状态) |
| PurchaseOrder | 酒店确认号 | hotelConfirmno | string | |
| PurchaseOrder | 发单方式 | issueType | string | 空白未发单;0 ebk发单,1 传真发单,2 email发单,3 qq/微信发单,4 ost发单,5 pms发单 |
| PurchaseOrder | 供应方Code | purchaseCode | string | |
| PurchaseOrder | 供应方名称 | purchaseName | string | |
| PurchaseOrder | 供应方联系方式 | purchaseTel | string | |
| PurchaseOrder | 订单采购价币种 | purchaseCurrency | string | |
| PurchaseOrder | 订单采购价总金额 | purchasePrice | decimal | |
| PurchaseOrder | 每日采购价列表 | roomPurchasePriceList | list | |
| DltOrderRoomPrice | 价格日期 | effectDate | datetime | |
| DltOrderRoomPrice | 餐食类型 | mealType | int | 默认4;4早餐 int转换二进制,第一位是早餐,第二位是午餐,第三位是晚餐 每一位1代表包含,0代表不包含) |
| DltOrderRoomPrice | 早餐描述 | breakfast | string | |
| DltOrderRoomPrice | 早餐数 | breakfastNum | int | |
| DltOrderRoomPrice | 币种 | currency | string | |
| DltOrderRoomPrice | 房价 | price | decimal | |
| DltOrderInfo | 每日房价列表 | roomPriceList | List | |
| DltOrderRoomPrice | 价格日期 | effectDate | datetime | |
| DltOrderRoomPrice | 餐食类型 | mealType | int | |
| DltOrderRoomPrice | 早餐描述 | breakfast | string | |
| DltOrderRoomPrice | 早餐数 | breakfastNum | int | |
| DltOrderRoomPrice | 币种 | currency | string | |
| DltOrderRoomPrice | 房价 | price | decimal | |
| DltOrderInfo | 品牌ID | brandId | int | Qunar品牌ID |
| DltOrderInfo | 我知道了处理结果 | isAutoAccept | int | 我知道了处理结果,1我知道了未处理 2我知道了已处理 |
| DltOrderInfo | 权益信息 | rightsInfo | string | 权益信息 |
| DltOrderInfo | 通知时间 | formDate | datetime | |
| DltOrderInfo | 折扣后价格 | afterDiscountPrice | decimal | |
| DltOrderInfo | 订单优惠信息 | dltOrderPromotionTypes | list | |
| DltOrderPromotionType | 优惠类型 | promotionType | string | |
| DltOrderPromotionType | 优惠金额 | promotionPrice | decimal | |
| DltOrderPromotionType | 币种 | currency | string | |
| DltOrderInfo | 订单每日优惠信息 | everyDayPromotions | list | |
| DltOrderInfo | 分销商订单号 | distributorOrderId | string | 分销订单会返回分销商订单号,否则返回空 |
| DltOrderInfo | 过时取消信息 | overTimeCancelInfo | OverTimeCancelInfo | 过时取消订单会返回相关取消收费信息 |
| DltOrderInfo | 套餐信息 | mealOrderSummary | DltMealOrderSummary | 如果是套餐订单会返回相关信息 |
| DltOrderEveryDayPromotionInfo | 价格日期 | effectDate | datetime | |
| DltOrderEveryDayPromotionInfo | 优惠类型 | promotionType | string | |
| DltOrderEveryDayPromotionInfo | 折前金额 | beforePromotePrice | decimal | |
| DltOrderEveryDayPromotionInfo | 折后金额 | afterPromotePrice | decimal | |
| DltOrderEveryDayPromotionInfo | 折扣金额 | promotePrice | decimal | |
| DltOrderEveryDayPromotionInfo | 币种 | currency | string | |
| LadderDeductPolicy | 扣款金额 | amount | decimal | |
| LadderDeductPolicy | 扣款币种 | currency | string | |
| LadderDeductPolicy | customerAmount | decimal | 暂时未返回 | |
| LadderDeductPolicy | customerCurrency | string | 暂时未返回 | |
| LadderDeductPolicy | 扣款比例 | deductionRatio | decimal | 暂时未返回 |
| LadderDeductPolicy | 开始扣款时间(北京时间) | startDeductTime | calendar | 在最早的startducttime之前为免费取消阶梯段(北京时间) |
| LadderDeductPolicy | 开始扣款时间(北京时间) | endDeductTime | calendar | 在最晚的enddeducttime之后为不可取消时间段(北京时间) |
| LadderDeductPolicy | 开始扣款时间(当地时间) | localStartDeductTime | calendar | 在最早的localStartDeductTime之前为免费取消阶梯段(当地时间) |
| LadderDeductPolicy | 开始扣款时间(当地时间) | localEndDeductTime | calendar | 在最晚的ocalEndDeductTime之后为不可取消时间段(当地时间) |
| LadderDeductPolicy | 原币种扣款金额 | originalAmount | decimal | 暂时未返回 |
| LadderDeductPolicy | 底价扣款金额 | originalCost | decimal | 暂时未返回 |
| LadderDeductPolicy | 原币种 | originalCurrency | string | 暂时未返回 |
| LadderDeductPolicy | 扣款类型 | ladderType | integer | 暂时未返回 |
| OverTimeCancelInfo | 取消原因 | reason | string | 过时取消时候返回 RESERVATION_ERROR 预定错误;SCHEDULE_CHANGE 行程改变;TRAFFIC_DELAY 交通延误;MALAISE 身体不适;HOTEL_REASON 酒店原因;LOWER_PRICE 有更低价; |
| OverTimeCancelInfo | 取消金额 | amount | decimal | 过时取消时候返回 |
| OverTimeCancelInfo | 结算取消金额 | settlementAmount | decimal | 过时取消时候返回 |
| OverTimeCancelInfo | 百分比 | percent | decimal | 过时取消时候返回 |
| DltMealOrderSummary | 套餐具体信息 | dltMealOrderInfos | list | 套餐具体信息 |
| DltMealOrderSummary | 套餐特殊要求 | specialRemark | string | 套餐特殊要求 |
| DltMealOrderInfo | 套餐具体信息 | categoryId | int | 策略id 200住的套餐 201食的套餐 203娱的套餐 |
| DltMealOrderInfo | 套餐具体信息 | categoryName | string | 策略名称 |
| DltMealOrderInfo | 套餐具体信息 | title | string | 套餐信息名称 |
| DltMealOrderInfo | 套餐具体信息 | itemInfoList | list | 住,食,娱的具体内容 |
| DltMealOrderItemInfo | 住食娱的具体内容 | productTitle | string | 产品标题 |
| DltMealOrderItemInfo | 住食娱的具体内容 | productName | string | 产品名称 |
| DltMealOrderItemInfo | 住食娱的具体内容 | productQuantity | string | 产品数量 |
| DltMealOrderItemInfo | 住食娱的具体内容 | receptionTime | string | 接待时间 |
| DltMealOrderItemInfo | 住食娱的具体内容 | usePerson | string | 使用人群 |
| DltMealOrderItemInfo | 住食娱的具体内容 | appointRule | string | 预约规则 |
| DltMealOrderItemInfo | 住食娱的具体内容 | phone | string | 联系方式 |
| DltMealOrderItemInfo | 住食娱的具体内容 | useRule | string | 使用规则 |
| DltMealOrderItemInfo | 住食娱的具体内容 | identifyInfo | string | 身份信息 |
| DltOrderInfo | 是否钟点房订单 | isHourRoom | bool | 是否终点房订单 true是 其他否 |
| DltOrderInfo | 钟点房入住开始时间 | hourroomstart | string | 钟点房入住开始时间例如:2022-03-15 14:30:00 |
| DltOrderInfo | 钟点房入住结束时间 | hourroomend | string | 钟点房入住结束时间例如:2022-03-15 18:30:00 |
| DltOrderInfo | 携程渠道对客订单号 | cusOrderId | string | 携程渠道对客订单号 |
| DltOrderInfo | 过时修改提醒话术 | overTimeModifyRemindDes | string | 过时修改提醒话术 |
| DltOrderInfo | 是否是过时修改单 | overTimeModifyStatus | int | 1是 其他否 接受过时修改申请单后,与之相关联的原单就会变无效 已改订,拒单修改申请单后,与之相关联的修改申请单就会恢复之前的订单状态(如果原单未处理可以继续处理,如果原单已确认无须处理) |
| DltOrderInfo | 订单改订状态 | overTimeModifyStage | int | 1改订中 2已改订 改订中的订单无法处理,必须先处理与此订单相关联的修改申请单,也就是overTimeModifyStatus=1的订单 |
| DltOrderInfo | 可入住人数 | roomPerson | int | 该订单可以入住的成人数 |
| DltOrderInfo | 携带儿童描述 | childrenInfo | string | 客人携带儿童情况描述 |
| DltOrderInfo | 小修改修改项 | changeItems | list | 小修改修改项目 |
| ChangeItem | 小修改修改项的key | itemKey | string | 小修改修改项的key |
| ChangeItem | 小修改修改项的名称 | name | string | 小修改修改项的名称 |
| ChangeItem | 小修改修改前值 | before | string | 小修改修改前值 |
| ChangeItem | 小修改修改后值 | after | string | 小修改修改后值 |
示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1638789250637+0800)/",
"Ack": "Success",
"Errors": [
],
"Build": null,
"Version": "v1",
"Extension": null
},
"resultStatus": {
"resultCode": 0,
"resultMsg": "success"
},
"dltOrderInfo": {
"dltOrderId": "123456EBK",
"orderId": "1111111",
"releationOrder": {
"lastDltOrderId": null,
"nextDltOrderId": null,
"lastOrderId": null,
"nextOrderId": null,
"lastConfirmType": null,
"nextConfirmType": null,
"newLastDltOrderId": null,
"newNextDltOrderId": null
},
"channel": "EBK",
"childChannel": "Ctrip",
"orderCurrency": "CNY",
"orderPrice": 143.99,
"formType": "C",
"orderStatus": "100",
"cancelRules": [
{
"deductType": null,
"lastCancelTime": "/Date(1552233600000+0800)/",
"value": null
}
],
"paymentType": "预付",
"updateTime": null,
"orderDate": "/Date(1638515716000+0800)/",
"confirmno": null,
"checkinDate": "/Date(1638460800000+0800)/",
"checkoutDate": "/Date(1638547200000+0800)/",
"cityId": 223,
"cityName": "东莞",
"cityEName": "Dongguan",
"hotelId": "111111",
"hotelName": "东莞桥陇公寓",
"hotelEName": null,
"roomId": "111111",
"roomName": "豪华双人房<无早><特惠专享>",
"roomEName": "豪华双人房<无早><特惠专享>",
"roomnum": 1,
"bedType": "",
"isHoldRoom": null,
"isRiskyOrder": null,
"contactName": "",
"customerDid": null,
"customerName": "",
"customerQuantity": 1,
"additionalList": null,
"specialMemo": "房费携程支付,无需返服务费(月结)。房价保密、请不要向客人透露。。",
"orderMemo": null,
"dltIssueOrder": {
"issueOrderId": null,
"issueStatus": 6,
"hotelConfirmno": null,
"issueType": null,
"purchaseCode": null,
"purchaseName": null,
"purchaseTel": null,
"purchaseCurrency": "CNY",
"purchasePrice": 0.00,
"roomPurchasePriceList": [
{
"effectDate": "/Date(1638460800000+0800)/",
"mealType": 4,
"breakfast": "无餐食",
"breakfastNum": 0,
"currency": "CNY",
"price": 0.00
}
]
},
"roomPriceList": [
{
"effectDate": "/Date(1638460800000+0800)/",
"mealType": 4,
"breakfast": "无餐食",
"breakfastNum": 0,
"currency": "CNY",
"price": 143.99
}
],
"brandId": 0,
"formDate": null,
"afterDiscountPrice": null,
"dltOrderPromotionTypes": null,
"everyDayPromotions": null,
"distributorOrderId": null,
"ladderDeductPolicies": null,
"certificateEntities": null,
"saleUseDiscount": null,
"newDltOrderId": "123123123",
"newDltFormId": 888555222,
"newOrderStatus": "201",
"orderTags": [
"paymenttype=pp",
"todaybook"
],
"ccType": null,
"ccStatus": null,
"ccTime": "/Date(0+0800)/",
"ccTimeoutTime": null,
"ccAlertLevel": null,
"ccAlertType": null,
"ccAlertStatus": 0,
"ccAlertTime": "/Date(0+0800)/",
"ccAlertReforderid": null,
"ccEvents": [
],
"thirdOrderId": null,
"overTimeCancelInfo": {
"reason": "SCHEDULE_CHANGE",
"amount": 39.6,
"settlementAmount": 33.66,
"percent": 20.00
}
}
}