滴滴企业版

该接口用于使用订单号查询酒店明细的信息。一般通过列表接口获取国内，国际对应的订单号。

接口说明

注意

详情接口只支持订单号+国内、国际查询的方式。
酒店订单数据只返回因公订单的数据，不包含手工补单数据。
酒店订单详情数据目前不包含异步服务费。
滴滴赔付不体现
difftax_fee税点服务费不包含在公式内。如果计算时需要，需要额外加上。
company_real_pay、personal_real_pay需要用户点完实际支付时有值。
订单数据不建议作为报销数据。

说明

操作	费用	公式（difftax_fee服务费需要单独计算）
预订	订单总价=房费+平台使用费（实时）	order_amount=price_info.room_amount+service_fee
	平台使用费（异步）	asynchronous_service_fee
	公司支付+个人支付	company_pay（包含异步服务费）+personal_pay=order_amount+asynchronous_service_fee-立减-优惠（公司+个人）
入住	订单总价=房费、平台使用费（实时）	order_amount=price_info.room_amount+service_fee
	平台使用费（异步）	asynchronous_service_fee
	订单应付=公司支付+个人支付	company_pay（包含异步服务费）+personal_pay=order_amount+asynchronous_service_fee-立减-优惠（公司+个人）
离店	订单实际实付=订单公司支付金额+订单个人支付金额	company_real_pay（包含异步服务费）+personal_real_pay=order_amount+asynchronous_service_fee-立减-优惠（公司+个人）
提前离店	order_amount=预订时的订单总价	order_amount与预订时保持一致提前离店不影响
	平台使用费（异步）	asynchronous_service_fee
	订单应付=公司支付+个人支付	company_pay（包含异步服务费）+personal_pay=order_amount+asynchronous_service_fee-立减-优惠（公司+个人）提前离店不影响
	订单实际实付=订单公司支付金额+订单个人支付金额	实际订单实付=company_real_pay（包含异步服务费）+ personal_real_pay- company_real_refund - personal_real_refund

基本信息

HTTP URL	/api-gateway/g/hotel/orderDetail
HTTP Method	POST
权限要求

请求头

参数名称	参数值
Content-Type	application/json

请求参数

字段名	字段说明	字段类型必填	必填
client_id	申请应用时分配的AppKey	string	Y
access_token	授权后的access token	string	Y
company_id	企业ID	string	Y
timestamp	当前时间戳(精确到秒级)	int	Y
sign	签名	string	Y
product_type	枚举数字：1 国内 2 国际	int	Y
order_ids	订单号，多个订单用英文逗号连接，最多支持查询100个订单	string	Y

请求示例

{
  "company_id": "1125922454507063",
  "sign": "3017c663914604ec44130ef5fd9bf0e2",
  "order_ids": "1125925571357038",
  "client_id": "3d21b32454a44222bd99c1a4e44fc4b0_test",
  "access_token": "NZGWODNJYMMTNZG0MY0ZZME4LWE0YTETMJC5ODZKMZRLZGY4",
  "product_type": 1,
  "timestamp": "1698755440"
}

响应参数

返回结构：

返回参数：

字段名	字段说明	字段类型	必填	备注
errno	错误，0表示成功，非0表示失败	int	Y
errmsg	成功返回"SUCCESS",失败返回对应的错误信息	string	Y
data	数据	object	Y
data.total	符合查询条件的数据总数	int	Y
data.domestichotel_data	国内酒店数据	object	N	国内订单返回有值
data.domestichotel_data.order_list	国内酒店数据-订单列表	array	N	国内订单返回有值
data.internationalhotel_data	国际酒店数据	object	N	国际订单返回有值
data.internationalhotel_data.order_list	国际酒店数据-订单列表	array	N	国际订单返回有值

orderlist国内酒店信息

字段名	字段说明	字段类型
data.domestichotel_data.order_list[0].order_info	订单信息	object
data.domestichotel_data.order_list[0].price_info	价格信息	object
data.domestichotel_data.order_list[0].base_info	酒店基本信息	object
data.domestichotel_data.order_list[0].passenger_list[0].passenger_info	出行人信息	object
data.domestichotel_data.order_list[0].sequence_list	入住房间列表	array
data.domestichotel_data.order_list[0].sequence_list.sequenceinfo	入住房间列表	object
data.domestichotel_data.order_list[0].rc_list	管控信息	array
data.domestichotel_data.order_list[0].rc_list[0].rc_info	管控信息	object

order_info

字段名	字段说明	字段类型	必填	备注
order_id	订单号	string	Y	主单号
company_name	企业名称	string	Y	在滴滴注册的企业名称
company_id	企业ID	string	Y	滴滴企业ID
booker_name	预订人姓名	string	Y	下单人
booker_employee_id	预订人员工编号	string	N	客户维护或者外部对接的数据
booker_member_id	预订人滴滴ID	string	Y	内部员工
booker_phone	预订人手机号	string	Y	脱敏展示
department_name	预订人部门名称	string	N	部门链路
department_id	预订人部门ID	string	N	末级部门ID
institution_name	制度名称	string	Y	滴滴制度名称
institution_id	制度ID	string	Y
approval_id	差旅申请单ID	string	N	滴滴申请单ID
out_approval_id	外部申请单ID	string	N	系统对接外部的申请单号
order_status	订单状态	string	Y	枚举英文code: Submitted 已提交 Booking 已提交预订 Confirming 商家确认中 Booked 预订成功 Checkedin 已入住 Completed 已完成 Cancelledbeforepay 支付前取消 Cancelledafterpay 支付后取消 Noshow 预订未到 Unknow 未知
is_pay	支付状态	int	Y	枚举数字：0 未支付 1 已支付
is_early_checkout	提前离店	int	Y	枚举数字： 0 非提前离店 1 提前离店
pay_type	订单支付类型	int	Y	枚举数字： 0 企业支付 1 个人支付 2 混合支付
create_time	订单创建时间	string	Y	格式：yyyy-MM-dd HH:mm:ss
complete_time	完单时间	datetime	N	格式：yyyy-MM-dd HH:mm:ss
cancel_time	取消时间	datetime	N	格式：yyyy-MM-dd HH:mm:ss
refund_time	退款时间	datetime	N	格式：yyyy-MM-dd HH:mm:ss
change_time	订单更新时间	string	N	格式：yyyy-MM-dd HH:mm:ss 查询条件
cancel_reason	取消原因	string	Y	用户取消原因
budget_center_list	多成本中心	array	N	参考budget_center_list对象

budget_center_list

字段	字段说明	字段类型	必填	备注
app_name	字段员工侧展示名称	string	Y
sequence	字段序号	int	Y	字段序号支持从1到9
id	滴滴主键	string	N	sequence为1时，生效
value	对应成本中心的值	string	N	对应成本中心的值。sequence为1时与name字段一致，sequence为2时，对应extend_field_01，sequence为3时，对应extend_field_02，sequence为4时，对应extend_field_03
code	对应成本中心的编码	string	N	对应成本中心的编码。sequence为1时与out_budget_id字段一致 sequence为2到9时，CODE无效。

price_info

字段名	字段说明	字段类型	必填	备注
order_amount	订单总价	int	Y	酒店预订时的费用，不包含离店后的结算信息 =公司支付金额+个人支付金额=房费总额+平台使用费（实时），不包含立减优惠，税点服务费
company_pay	公司应付支付金额	int	Y	单位：分
personal_pay	员工应付支付金额	int	Y	单位：分
personal_pay_detail	员工支付金额明细	object	Y
cut_fee	立减金	int	Y	单位：分
company_coupon	公司优惠券	int	Y	单位：分退款时，该字段不更新
personal_coupon	个人优惠券	int	Y	单位：分退款时，该字段不更新
service_fee	平台使用费	int	Y	单位：分实时随单收取平台使用费
asynchronous_service_fee	出票平台使用费（异步）	int	Y	单位：分
difftax_fee	税点服务费	int	Y	单位：分发生退款时，会变更为最终值金额
room_amount	房费总额	int	Y	单位：分
company_real_pay	订单公司实际支付金额	int	Y	单位：分
personal_real_pay	订单个人实际支付金额	int	Y	单位：分
personal_real_pay_detail	订单员工实际支付金额明细	object	Y
company_real_refund	公司实际退款金额	int	Y	单位：分发生退款款时有值
personal_real_refund	员工实际退款金额	int	Y	单位：分发生退款款时有值
personal_real_refund_detail	员工退款金额明细	object	Y
currency	币种	string	Y	默认 CNY

personal_pay_detail

字段名	字段说明	字段类型	必填	备注
reimburse_fee	可报销金额	int	Y
no_reimburse_fee	不可报销金额	int	Y

personal_real_pay_detail

字段名	字段说明	字段类型	必填	备注
reimburse_fee	可报销金额	int	Y
no_reimburse_fee	不可报销金额	int	Y

personal_real_refund_detail

字段名	字段说明	字段类型	必填	备注
reimburse_fee	可报销金额	int	Y
no_reimburse_fee	不可报销金额	int	Y

base_info

字段名	字段说明	字段类型	必填	备注
details_amount	每日价格	array	Y
date	日期	string	Y	格式：yyyy-MM-dd
price	价格	int	Y	单位：分
pay_time	用户支付时间	datetime	Y	格式：yyyy-MM-dd HH:mm:ss
checkin_time	预订入住时间	datetime	Y	格式：yyyy-MM-dd
checkout_time	预订离店时间	datetime	Y	格式：yyyy-MM-dd
confirm_time	预订成功时间	datetime	Y	格式：yyyy-MM-dd HH:mm:ss
real_checkin_time	实际入住时间	datetime	Y	最晚按照预订离店时间+1天更新格式：yyyy-MM-dd
real_checkout_time	实际离店时间	datetime	Y	最晚按照预订离店时间+1天更新格式：yyyy-MM-dd
city_name	城市	string	Y	城市中文名
city_id	城市ID	string	Y	滴滴城市ID
county_name	区、县名	string	Y
county_id	区、县id	string	Y
hotel_name	酒店中文名称	string	Y
hotel_english_name	酒店英文名称	string	Y
room_name	房型名称	string	Y
room_num	预订房间数	int	N	预订房间数不包含提前离店
room_night	预订间夜数	int	N	不包含提前离店
real_room_number	实际房间数	int	N	最晚按照预订离店时间+1天更新
real_room_night	实际间夜数	int	N	最晚按照预订离店时间+1天更新
invoice_type	酒店发票类型	string	Y	枚举值：增专，增普

passenger_list.passenger_info

字段名	字段说明	字段类型	必填	备注
passenger_name	入住人姓名	string	Y
passenger_phone	入住人手机号	string	Y
passenger_traveler_id	入住人唯一值	string	Y	内部等于memberId
passenger_employee_id	入住人员工编号	string	N
is_traveler	外部员工标记	int	Y	枚举值数字：1 外部员工 0 内部员工
budget_center_name	成本中心名称	string	N	建议使用budget_center_list
budget_center_code	成本中心code	string	N	外部项目或部门code，建议使用budget_center_list
budget_center_id	成本中心id	string	N	滴滴内部主键，建议使用budget_center_list
budget_center_list	多成本中心	array	N	参考budget_center_list对象

sequence_list.sequenceinfo

字段名	字段说明	字段类型	必填	备注
sequence	房间序号	string	Y	分房在订单下标记房间的唯一性
passenger_traveler_id	入住人唯一标记	array	Y	入住人关联信息
real_checkin_time	实际入住时间	datetime	N	格式：yyyy-MM-dd HH:mm:ss
real_checkout_time	实际离店时间	datetime	N	格式：yyyy-MM-dd HH:mm:ss

rc_list.rc_info

字段名	字段说明	字段类型	必填	备注
rc_id	RC审批单ID	datetime	N
rc_type	RC类型	string	N	枚举值文本：房费RC，星级RC，提前预定RC,协议价RC
rc_code	RCcode	string	N
rc_reason	RC原因	string	N
sequences	适用的房间序号	list	Y	适用对应RC的房间序号

orderlist国际酒店信息

字段名	字段说明	字段类型
data.internationalhotel_data.order_list[0].order_info	订单信息	object
data.internationalhotel_data.order_list[0].price_info	价格信息	object
data.internationalhotel_data.order_list[0].base_info	酒店基本信息	object
data.internationalhotel_data.order_list[0].passenger_list[0].passenger_info	出行人信息	object
data.internationalhotel_data.order_list[0].sequence_list	入住房间列表	array
data.internationalhotel_data.order_list[0].sequence_list.sequenceinfo	入住房间列表	object
data.internationalhotel_data.order_list[0].rc_list	管控信息	array
data.internationalhotel_data.order_list[0].rc_list[0].rc_info	管控信息	object

order_info

字段名	字段说明	字段类型	必填	备注
order_id	订单号	string	Y	主单号
company_name	企业名称	string	Y	在滴滴注册的企业名称
company_id	企业ID	string	Y	滴滴企业ID
booker_name	预订人姓名	string	Y	下单人
booker_employee_id	预订人员工编号	string	N	客户维护或者外部对接的数据
booker_member_id	预订人滴滴ID	string	Y	内部员工
booker_phone	预订人手机号	string	Y	脱敏展示
department_name	预订人部门名称	string	N	部门链路
department_id	预订人部门ID	string	N	末级部门ID
institution_name	制度名称	string	Y	滴滴制度名称
institution_id	制度ID	string	Y
approval_id	差旅申请单ID	string	N	滴滴申请单ID
out_approval_id	外部申请单ID	string	N	系统对接外部的申请单号
order_status	订单状态	string	Y	枚举英文code: Submitted 已提交 Booking 已提交预订 Confirming 商家确认中 Booked 预订成功 Checkedin 已入住 Completed 已完成 Cancelledbeforepay 支付前取消 Cancelledafterpay 支付后取消 Noshow 预订未到 Unknow 未知
is_pay	支付状态	int	Y	枚举数字：0 未支付 1 已支付
is_early_checkout	提前离店	int	Y	枚举数字： 0 非提前离店 1 提前离店
pay_type	订单支付类型	int	Y	枚举数字： 0 企业支付 1 个人支付 2 混合支付
create_time	订单创建时间	string	Y	格式：yyyy-MM-dd HH:mm:ss
complete_time	完单时间	datetime	N	格式：yyyy-MM-dd HH:mm:ss
cancel_time	取消时间	datetime	N	格式：yyyy-MM-dd HH:mm:ss
refund_time	退款时间	datetime	N	格式：yyyy-MM-dd HH:mm:ss
change_time	订单更新时间	string	N	格式：yyyy-MM-dd HH:mm:ss 查询条件
cancel_reason	取消原因	string	Y	用户取消原因
budget_center_list	多成本中心	array	N	参考budget_center_list对象

budget_center_list

字段	字段说明	字段类型	必填	备注
app_name	字段员工侧展示名称	string	Y
sequence	字段序号	int	Y	字段序号支持从1到9
id	滴滴主键	string	N	sequence为1时，生效
value	对应成本中心的值	string	N	对应成本中心的值。sequence为1时与name字段一致，sequence为2时，对应extend_field_01，sequence为3时，对应extend_field_02，sequence为4时，对应extend_field_03
code	对应成本中心的编码	string	N	对应成本中心的编码。sequence为1时与out_budget_id字段一致 sequence为2到9时，CODE无效。

price_info

字段名	字段说明	字段类型	必填	备注
order_amount	订单总价	int	Y	酒店预订时的费用，不包含离店后的结算信息 =公司支付金额+个人支付金额=房费总额+平台使用费（实时），不包含立减优惠，税点服务费
company_pay	公司应付支付金额	int	Y	单位：分
personal_pay	个人应付支付金额	int	Y	单位：分
cut_fee	立减金	int	Y	单位：分
company_coupon	公司优惠券	int	Y	单位：分
personal_coupon	个人优惠券	int	Y	单位：分
service_fee	平台使用费	int	Y	单位：分实时随单收取平台使用费
asynchronous_service_fee	出票平台使用费（异步）	int	Y	单位：分
difftax_fee	税点服务费	int	Y	单位：分发生退款时，会变更为最终值金额
room_amount	房费总额	int	Y	单位：分
company_real_pay	订单公司实际支付金额	int	Y	单位：分
personal_real_pay	订单个人实际支付金额	int	Y	单位：分
company_real_refund	公司实际退款金额	int	Y	单位：分发生退款款时有值
personal_real_refund	个人实际退款金额	int	Y	单位：分发生退款款时有值
currency	币种	string	Y	默认 CNY

base_info

字段名	字段说明	字段类型	必填	备注
details_amount	每日价格	array	Y
date	日期	string	Y	格式：yyyy-MM-dd
price	价格	int	Y	单位：分
pay_time	用户支付时间	datetime	Y	格式：yyyy-MM-dd HH:mm:ss
checkin_time	预订入住时间	datetime	Y	格式：yyyy-MM-dd
checkout_time	预订离店时间	datetime	Y	格式：yyyy-MM-dd
confirm_time	预订成功时间	datetime	Y	格式：yyyy-MM-dd HH:mm:ss
real_checkin_time	实际入住时间	datetime	Y	最晚按照预订离店时间+1天更新格式：yyyy-MM-dd
real_checkout_time	实际离店时间	datetime	Y	最晚按照预订离店时间+1天更新格式：yyyy-MM-dd
country	国家	string	N	国家中文名
city_name	城市	string	Y	城市中文名
city_id	城市ID	string	Y	滴滴城市ID
hotel_name	酒店中文名称	string	Y
hotel_english_name	酒店英文名称	string	Y
room_name	房型名称	string	Y
room_num	房间数	int	N	预订房间数不包含提前离店
room_night	间夜数	int	N	不包含提前离店
real_room_number	实际房间数	int	N	最晚按照预订离店时间+1天更新
real_room_night	实际间夜数	int	N	最晚按照预订离店时间+1天更新
invoice_type	酒店发票类型	string	Y	枚举值：增专，增普

passenger_list.passenger_info

字段名	字段说明	字段类型	必填	备注
passenger_name	入住人姓名	string	Y
passenger_phone	入住人手机号	string	Y
passenger_traveler_id	入住人唯一值	string	Y	内部等于memberId
passenger_employee_id	入住人员工编号	string	N
is_traveler	外部员工标记	int	Y	枚举值数字：1 外部员工 0 内部员工
budget_center_name	成本中心名称	string	N	建议使用budget_center_list
budget_center_code	成本中心code	string	N	外部项目或部门code，建议使用budget_center_list
budget_center_id	成本中心id	string	N	滴滴内部主键，建议使用budget_center_list
budget_center_list	多成本中心	array	N	参考budget_center_list对象

sequence_list.sequenceinfo

字段名	字段说明	字段类型	必填	备注
sequence	房间序号	string	Y	分房在订单下标记房间的唯一性
passenger_traveler_id	入住人唯一标记	array	Y	入住人关联信息
real_checkin_time	实际入住时间	datetime	N	格式：yyyy-MM-dd HH:mm:ss
real_checkout_time	实际离店时间	datetime	N	格式：yyyy-MM-dd HH:mm:ss

rc_list.rc_info

字段名	字段说明	字段类型	必填	备注
rc_id	RC审批单ID	datetime	N
rc_type	RC类型	string	N	枚举值文本：房费RC，星级RC，提前预定RC,协议价RC
rc_code	RCcode	string	N
rc_reason	RC原因	string	N
sequences	适用的房间序号	list	Y	适用对应RC的房间序号

响应示例

正常示例

{
    "errno": 0,
    "errmsg": "SUCCESS",
    "data": {
        "total": 1,
        "domestichotel_data": {
            "order_list": [
                {
                    "order_info": {
                        "out_approval_id": "",
                        "order_status": "Cancelledafterpay",
                        "pay_type": 0,
                        "cancel_time": "2024-02-28 19:25:37",
                        "cancel_reason": "",
                        "booker_name": "一九",
                        "company_id": "1125921568028686",
                        "booker_member_id": "1125921568030627",
                        "booker_phone": "111****2019",
                        "department_id": "1125921568024720",
                        "institution_id": "1125923136591427",
                        "company_name": "天文测试公司",
                        "institution_name": "预订审批模式",
                        "is_early_checkout": 0,
                        "create_time": "2024-02-28 17:44:26",
                        "complete_time": "2024-02-28 19:25:37",
                        "refund_time": "2024-02-28 19:25:39",
                        "change_time": "2024-02-28 19:25:37",
                        "order_id": "1125929373984474",
                        "department_name": "天文测试公司",
                        "approval_id": "",
                        "is_pay": 1,
                        "booker_employee_id": ""
                    },
                    "price_info": {
                        "service_fee": 0,
                        "currency": "CNY",
                        "personal_coupon": 0,
                        "room_amount": 10800,
                        "difftax_fee": 0,
                        "order_amount": 10800,
                        "personal_pay": 0,
                        "cut_fee": 1300,
                        "company_coupon": 0,
                        "asynchronous_service_fee": 1000,
                        "company_real_pay": 10500,
                        "personal_real_pay": 0,
                        "company_real_refund": 9500,
                        "company_pay": 10500,
                        "personal_real_refund": 0
                    },
                    "base_info": {
                        "country": "中国",
                        "city_name": "北京",
                        "room_name": "批量房间五店一房",
                        "real_room_number": 1,
                        "pay_time": "2024-02-28 17:44:29",
                        "confirm_time": "2024-02-28 17:44:29",
                        "invoice_type": "增专",
                        "real_checkin_time": "",
                        "hotel_english_name": "",
                        "real_checkout_time": "2024-02-27",
                        "real_room_night": 19780,
                        "details_amount": [
                            {
                                "price": 5400,
                                "date": "2024-02-28"
                            },
                            {
                                "price": 5400,
                                "date": "2024-02-29"
                            }
                        ],
                        "checkin_time": "2024-02-27",
                        "checkout_time": "2024-02-27",
                        "city_id": "1",
                        "hotel_name": "预发测试批量北京五号店",
                        "room_num": 1,
                        "room_night": 1
                    },
                    "sequence_list": [
                        {
                            "passenger_traveler_id": [
                                "1125921568030627"
                            ],
                            "real_checkin_time": "",
                            "real_checkout_time": "2024-02-27 16:00:00",
                            "sequence_id": "1"
                        }
                    ],
                    "passenger_list": [
                        {
                            "passenger_phone": "111****2019",
                            "passenger_employee_id": "",
                            "is_traveler": 0,
                            "budget_center_name": "",
                            "budget_center_id": "0",
                            "budget_center_code": "",
                            "passenger_traveler_id": "1125921568030627",
                            "passenger_name": "一九"
                        }
                    ],
                    "rc_list": [
                        {
                            "rc_reason": "",
                            "sequences": [
                                
                            ],
                            "rc_id": "",
                            "rc_type": "",
                            "rc_code": ""
                        }
                    ]
                }
            ]
        }
    },
    "request_id": "202402281925550a4ac23565df1843a227cb781f14d002"
}

异常示例

{
    "errno": 401,
    "errmsg": "access_token不合法或已过期",
    "request_id": "202311010956450ab68d336541b05d4add9cabab572002"
}

错误码

通用错误解决方案

版本记录

日期	更新人	更新内容	上线时间
2023.10.24	陈继诗	新建文档	2023.11.01
2023.12.19	陈继诗	国内国际增加：priceinfo增加difftax_fee税点服务费，baseinfo增加invoice_type酒店发票类型，orderinfo增加cancel_reason取消原因	2024.04.09
2023.12.20	陈继诗	人员信息内增加budget_center_codebudget_center_id成本中心code和成本中心id，修改RC数据结构	2024.04.09
2023.12.21	陈继诗	priceinfo增加asynchronous_service_fee	2024.04.09
2023.12.22	陈继诗	priceinfo增加company_real_pay，personal_real_pay，company_real_refund，personal_real_refund，baseinfo增加real_checkin_time实际入住时间，和real_checkout_time离店时间，real_room_number实际入住房间数，real_room_night实际入住间夜数	2024.04.09
2023.12.25	陈继诗	orderinfo增加change_time	2024.04.09
2024.09.02	陈继诗	增加orderinfo passenger info下budget_center_list信息	2024.09.13
2024.11.27	陈继诗	增加个垫明细明细，对应detai信息	2024.11.27
2025.02.21	陈继诗	国内酒店baseinfo增加county_id，county_name	2025.05.14