方法名称

hotel.order.detail

使用说明

根据订单id获取单个订单的详细信息，可以传入艺龙订单号或分销商自己的订单号。仅能搜索半年内的订单。用于向用户展示订单状态。


须使用https访问本接口。

输入参数

响应结果

根节点

GuaranteeRule节点

PrepayRule节点

PrepayResult节点

GuaranteeResult节点

Invoice节点

Recipient节点

DayPromotion节点

Promotion节点

OrderDetailDayRoomPromotion节点

PromotionDayRoom节点

PromotionDayRoomItem节点

Contact节点

CreditCard节点

NightlyRate节点

ExtendInfo节点

OrderRoom节点

Customer节点

OrderHotel节点

BoardInfo节点

BasePrepayRule节点

BoardDetail节点

GiftPackage节点

XProduct节点

Picture节点

DayMeal节点

RefundDetail节点

Refund节点

输入参数示例

https://api-test.elong.com/rest?timestamp=1489648630&format=json
&method=hotel.order.detail&signature=759daf8670f20ac4a274f7981264765d
&user={userid}&data={"Version":"1.28","Local":"zh_CN","Request":{"OrderId":"400002545"}}

输出参数示例

{
    "Code":"0",
    "Result":{
        "ElongCardNo":"190000002101111111",
        "Contact":{
            "Name":"李海",
            "Email":"",
            "Mobile":"13800138000",
            "Phone":"",
            "Fax":"",
            "Gender":"Unknown"
        },
        "NightlyRates":[
            {
                "Member":179.0,
                "Cost":-1.0,
                "Status":false,
                "AddBed":0.0,
                "Date":"2016-01-26T00:00:00 08:00",
                "BreakfastCount":0
            }
        ],
        "OrderRooms":[
            {
                "Customers":[
                    {
                        "Name":"李海",
                        "Email":"",
                        "Mobile":"",
                        "Phone":"",
                        "Fax":"",
                        "Gender":"Unknown"
                    }
                ]
            },
            {
                "Customers":[
                    {
                        "Name":"张江",
                        "Email":"",
                        "Mobile":"",
                        "Phone":"",
                        "Fax":"",
                        "Gender":"Unknown"
                    }
                ]
            }
        ],
        "refundDetail": {
            "refundAmount": 720.0,
            "refundDetails": [
                {
                    "refundAmount": 700.0,
                    "refundTime": "2022-03-29T17:04:43+08:00"
                },
                {
                    "refundAmount": 10.0,
                    "refundTime": "2022-03-29T15:06:42+08:00"
                },
                {
                    "refundAmount": 10.0,
                    "refundTime": "2022-03-29T15:05:23+08:00"
                }
            ]
        },
        "OrderId":400002545,
        "Status":"V",
        "ShowStatus":4,
        "PenaltyToCustomer":0.0000,
        "PenaltyCurrencyCode":"RMB",
        "CancelTime":"2016-01-27T00:00:00 08:00",
        "HasInvoice":false,
        "InvoiceMode":"Hotel",
        "ValueAdds":[
            "不含早餐"
        ],
        "HotelName":"海友酒店(北京苹果园店)",
        "RoomTypeName":"高级大床房",
        "RatePlanName":"不含早",
        "IsCancelable":true,
        "CreationDate":"2014-02-07T00:00:00 08:00",
        "TotalPriceExchanged":358.0,
        "TotalCostPriceExchanged":-2.0,
        "OrderHotel":{
            "HotelId":"90209610",
            "Name":"海友酒店(北京苹果园店)",
            "Address":"北京市石景山区西井路19号院1号楼",
            "Phone":"0780-6354396",
            "CityName":"北京"
        },
        "IsInstantConfirm":false,
        "HotelId":"90209610",
        "RoomTypeId":"0003",
        "RatePlanId":448254,
        "ArrivalDate":"2016-01-26T00:00:00 08:00",
        "DepartureDate":"2016-01-27T00:00:00 08:00",
        "CustomerType":"All",
        "PaymentType":"SelfPay",
        "NumberOfRooms":2,
        "NumberOfCustomers":2,
        "EarliestArrivalTime":"2016-01-26T12:00:00 08:00",
        "LatestArrivalTime":"2016-01-26T15:00:00 08:00",
        "CurrencyCode":"RMB",
        "TotalPrice":358.0,
        "CustomerPrice":0.0,
        "ConfirmationType":"SMS_cn",
        "NoteToHotel":""
    }
    "Guid":"196d84d9-19b1-4aa2-8891-1c699e806a3c"
}

注意事项

预付订单罚金和退款金额说明：

当客人还没有入住这个订单需要进行取消的时候，根据规则需要产生罚金，则订单将取消变成删除状态，并将罚金设置到PenaltyToCustomer属性中；

当客人已经入住了这个订单，但入住的间夜需要减少，酒店同意退款的情况(如果不同意那就是没必要进行操作)，订单将保持“已结账”状态，订单总金额不变化，并将退款的金额写入到RefundAmount属性中。

臻选特惠和同程促销的差别说明：

“同程促销”是我们同程供应商的促销   ， “臻选特惠”是酒店自己的促销活动，同程作为参与方的促销。 

1. 礼包套餐（GiftPackage节点）使用说明：

2. 在房型产品中取GiftPackage.PkgProductname作为礼包套餐标题展示，在礼包套餐标题前取PkgType字段展示类型（如0，展示为礼包）。
   在礼包套餐详情页中，按类别（TypeName）分别展示每个类别中X产品（XProduct）具体信息:
   取该类型中的每个X产品的XProductName+Qunatity进行拼接作为该类别X产品标题，如"X产品A 1份/天+X产品B 1份一天"；在X产品标题前可展示X产品类型（TypeName)。在该类别X产品标题分别展示所含X产品信息，取"XProductName使用说明"作为每个X产品的副标题，如"X产品A使用说明"，在每个X产品的副标题下展示其具体内容："预约规则：AppointPolicy 预约时间： ReceptionTimes 适用人数：Capacity 预约电话：BookingPhone"等内容。如果这些字段返回都为空，则无需展示该X产品
3. 在X产品展示完之后可取礼包套餐的特别说明（GiftPackage.RuleDescriptionAdditional）进行展示，标题为"特别说明"，取图片GiftPackage.Pictures中的ImgUrl字段展示图片，标题为"图文说明"，图片按Picture.ImgIndex的大小按顺序展示。

常见错误码