# 接口说明

  • 1.查询酒店订单详情接口 通过该接口可以查询企业使用分贝通APP下的火车的订单详情信息
名称 描述
HTTP方法 POST
Content-Type application/x-www-form-urlencoded
method /openapi/func/orders/hotel/detail
字段 名称 类型 必填 描述
timestamp 时间戳 long Y 13位时间戳
sign 签名 string Y gaghegsgd535te3534
access_token token string Y 登录 token
employee_id 操作人id string Y 操作人id,调用接口人 id
employee_type 用户类型 string Y 类型,0为分贝用户,1为第三方用户
data 请求数据 jsonobject Y
data.order_id 订单编号 string N 订单编号精准匹配

请求示例:

	"access_token":"5747fbc10f0e60e0709d8d722",
	"sign":"oihfnlyeofdh98",
	"timestamp":124124325,
	"employee_id":"59b74c1323445f2d54dd07922",
	"employee_type":"1",
	"data":{"order_id":"OTA202007171639074190420"}

1
2
3
4
5
6
7

响应结果示例:

# 响应数据:
字段 名称 类型 必填 描述
code 响应码 integer Y 0:成功;1:失败
msg 响应信息 string N success
data 响应数据 jsonObject N
# 订单信息order_info:
字段 名称 类型 必填 描述
order_id 订单编号 string Y 5f117ab32798635a172e93b6
origin_order_id 原订单号 string Y 6041e36ce427af5ef3c7f3dd
pre_order_id 前一个订单id string Y 前一个订单id
supplier_order_id 供应商订单编号 string N 供应商订单编号
status 状态码 integer Y 2501
status_name 状态名称 string Y 已完成
supplier_name 供应商名称 string Y 千淘
supplier_id 供应商id string Y 供应商id
create_time 创建时间 string Y 2020-04-29 11:08:52
remark 备注 string Y 备注
remark_detail 备注描述 string Y 备注描述
# 下单人信息user_info:
字段 名称 类型 必填 描述
id 下单人id string Y 5d70ba9b23445f04bc031156
name 下单人姓名 string Y 张三
phone 下单人手机号 integer Y 18310480640
unit_id 下单人部门id string N 59a80dd92798630fd780babf
unit_name 下单人部门名称 string N 嘟嘟搞测试
employee_number 员工编号 string N 员工编号
apply_id 审批单id string N 审批单id
is_exceed 是否超规 Boolean N is_exceed
# 入住人信息guest_info:
字段 名称 类型 必填 描述
id 顾客的id string Y 顾客的id
name 顾客的名字 string Y 顾客的名字
phone 顾客的电话 string Y 顾客的电话
unit_name 顾客部门单位id string Y 顾客部门单位id
full_unit_name 顾客的部门单位全称 string Y 顾客的部门单位全称
live_with 同住人信息 jsonarray N
live_with.id 同住人的id string N 同住人的id
live_with.name 同住人的姓名 string N 同住人的姓名
live_with.phone_no 同住人的手机号 string N 同住人的手机号
live_with.org_unit 同住人的部门 string N 同住人的部门
live_with.full_org_unit 同住人的部门单位全称 string N 同住人的部门单位全称
id_number 同住人id string N 同住人id
id_number_type Object N
id_number_type.key Integer N
id_number_type.value string N
gender 性别 Object N
gender.key 性别类型 Integer N
gender.value 性别 string N 男 女
org_unit_id 部门id string N 部门id
# 订单金额信息price_info:
字段 名称 类型 必填 描述
total_price 支付总金额 double Y 1
personal_total_pay 个人支付金额 double N 0
order_price 订单总金额 double Y 1
company_total_pay 公司支付总金额 double N 0
red_envelope 红包券支付金额 double N 0
coupon_amount 订单优惠券金额 double N 0
insurance_price 保险费 double N 0
# 酒店信息hotel_info:
字段 名称 类型 必填 描述
hotel_name 酒店的名字 string Y 酒店的名字
hotel_phone 酒店的电话 string Y 酒店的电话
checkin_date 乘客的checkin时间 string Y 2020-07-17
checkout_date 乘客的checkout时间 string Y 2020-07-18
room_type 房间类型 string Y 卡哇伊房(部分有窗)
room_count 房间数 integer N 1
star_rate 星级 string N 0:"经济型",1:"舒适型"2:"高档型",3:"豪华型"
cross_day 间夜 integer N 1
per_room_night_prices 单价信息 jsonarray N
per_room_night_prices.day 单价/日期 string N 1
per_room_night_prices.price 单价/价格 double N 1
city_name 酒店城市 string N 酒店城市
hotel_address 酒店地址 string N 酒店地址
# 管控信息saas_info:
字段 名称 类型 必填 描述
remark 下单事由 string N
cost_category 费用类别 string N 市场活动费
cost_category_code 费用类别编码 string N 101
cost_attribution_list 管控费用信息 jsonArray Y 管控费用信息
cost_attribution_list.cost_attribution_category 费用归属类型1:部门;2:项目 integer N 1
cost_attribution_list.cost_attribution_id 费用归属id string N 59a80dd92798630fd780babf
cost_attribution_list.cost_attribution_name 费用归属名称 string N 嘟嘟搞测试
cost_attribution_list.cost_attribution_custom_ext 费用归属自定义字段 jsonArray N 费用归属自定义字段
cost_attribution_list.cost_attribution_custom_ext.custom_field_title 自定义字段名 string N 自定义字段名
cost_attribution_list.cost_attribution_custom_ext.custom_field_content 自定义字段值 string N 自定义字段值
cost_attribution 费用归属 jsonArray N 费用归属
cost_attribution.type 费用归属类型 integer N 费用归属类型枚举值:1,部门2,项目3,自定义档案
cost_attribution.archive_id 分贝通自定义档案ID string N 分贝通自定义档案ID
cost_attribution.third_archive_id 三方系统自定义档案ID string N 三方系统自定义档案ID
cost_attribution.archive_name 自定义档案名称 string N 自定义档案名称
cost_attribution.details 费用归属详情 jsonArray N 费用归属详情
cost_attribution.details.id 分贝通费用归属id string N 分贝通费用归属id
cost_attribution.details.third_id 三方系统费用归属id string N 当费用归属类(cost_attribution_type)为1时,需使用三方系统部门ID,为2时,为三方系统项目ID;为3时,为三方系统自定义档案项目ID。
cost_attribution.details.name 费用归属名称 string N 当费用归属类型(cost_attribution_type)为1时,需使用部门名称;为2时,为项目名称;为3时,为自定义档案项目名称。
cost_attribution.details.weight 费用归属权重 double N 费用归属的百分比
cost_attribution.details.amount 费用归属分摊金额 bigDecimal N 费用归属的分摊金额
# 第三方信息third_info:
字段 名称 类型 必填 描述
user_id 下单人三方人员id string Y manager4699
unit_id 下单人三方部门id string Y dinge78ced08591e110bf5bf40eda33b7ba0
cost_dept_id 三方费用归属部门id string N 337235423
cost_project_id 三方费用归属项目id string N 337235424
apply_id 三方行程审批单id string N a04d2547-9f9f-49f2-895f-124f5171b31d
guest_user_id 入住人三方人员id string N dinge78ced08591e110bf5bf40eda33b7ba0
guest_unit_id 入住人三方部门id string N 213464191737612274

{
  "code": 0,
  "msg": "success",
  "data": {
    "order_info": {
      "order_id": "5f117ab32798635a172e93b6",
      "origin_order_id": "5f117ab3279863760a0954b7",
      "status": 2501,
      "status_name": "订房成功",
      "supplier_id": 201,
      "supplier_order_id": "BD202007172273424",
      "supplier_name": "千淘",
      "create_time": "2020-07-17 18:17:23"
    },
    "price_info": {
      "total_price": 182,
      "order_price": 182,
      "personal_total_pay": 0,
      "company_total_pay": 182,
      "red_envelope": 0,
      "coupon_amount": 0
    },
    "user_info": {
      "id": "5e1ed56e23445f5b4018ef9e",
      "name": "张三",
      "phone": "13512322270",
      "unit_id": "58c21a365f281a7e6f810ae6",
      "unit_name": "X部门"
    },
    "hotel_info": {
      "city_name":"",
      "hotel_name": "汉庭海友酒店(上海人民广场店)",
      "hotel_phone": "021-63226675",
      "checkin_date": "2020-08-06",
      "checkout_date": "2020-08-07",
      "room_type": "单床房(部分有窗)",
      "room_count": 1,
      "star_rate": "经济型",
      "cross_day": 1,
      "per_room_night_prices": [{
        "day": "2021-01-10",
        "price": 200
      }]

    },
    "saas_info": {
      "apply_id": "xcsp-2020081000010",
      "cost_category": "市场活动费",
      "cost_category_code": "10009",
      "cost_attribution_list": [{
        "cost_attribution_id": "58c21a365f281a7e6f810ae6",
        "cost_attribution_category": 1,
        "cost_attribution_name": "X部门",
        "cost_attribution_custom_ext": [{
          "custom_field_title": "都发发发",
          "custom_field_content": "呜呜呜呜呜呜"
        },
          {
            "custom_field_title": "阿斯顿发",
            "custom_field_content": "阿萨阿啊阿"
          },
          {
            "custom_field_title": "县城",
            "custom_field_content": "选项4"
          }
        ]
      }],
      "cost_attribution":[
        {
          "type":1,
          "archive_id":"",
          "third_archive_id":"",
          "archive_name":"",
          "details":[
            {
              "name":"部门二",
              "weight":33.33,
              "amount":7,
              "third_id":"bumen2",
              "id":"5bfca57dbfd57c0523d83ce0"
            },
            {
              "name":"部门一",
              "weight":33.33,
              "amount":7,
              "third_id":"bumenyi",
              "id":"5bfb58a7bfd57c3d9d01c713"
            },
            {
              "name":"部门三",
              "weight":33.34,
              "amount":7,
              "third_id":"bumen3",
              "id":"5bfca584bfd57c0523d83ce1"
            }
          ]
        },
        {
          "type":2,
          "details":[
            {
              "name":"财务项目004",
              "weight":33.34,
              "amount":7,
              "third_id":"cwxm004",
              "id":"5f717ce3aa42278ee8a11c8e"
            },
            {
              "name":"财务项目003",
              "weight":33.33,
              "amount":7,
              "third_id":"cwxm003",
              "id":"5f717ce3aa42278ee8a11c8d"
            },
            {
              "name":"财务项目002",
              "weight":33.33,
              "amount":7,
              "third_id":"cwxm002",
              "id":"5f717ce3aa42278ee8a11c8c"
            }
          ]
        }
      ]
    },
    "guest_info": [{
      "id": "5ef8041c23445f02927e3bed",
      "name": "张三",
      "phone": "13572367471",
      "unit_name": "X部门",
      "full_unit_name": "北京分贝金服科技有限公司/X部门"
    }],
    "third_info": {
      "user_id": "manager4699",
      "unit_id": "dinge78ced08591e110bf5bf40eda33b7ba0",
      "cost_dept_id": "337235423",
      "apply_id": "54a7d0a0-2037-44f8-a712-f4e1aef7fc3e",
      "guest_unit_id": "dinge78ced08591e110bf5bf40eda33b7ba0",
      "guest_user_id": "213464191737612274"
    }
  },
  "request_id": "kHfFXREygqJ4m2Id"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
lastUpdate: 6/28/2022, 2:14:28 PM