# 接口说明

  • 1.查询酒店订单列表接口 通过该接口可以查询企业使用分贝通APP下的酒店的订单信息
  • 2.该接口一次最多可查询50条数据,如订单数超过50,则需要分页查询
名称 描述
HTTP方法 POST
Content-Type application/x-www-form-urlencoded
method /openapi/func/orders/hotel/list
字段 名称 类型 必填 描述
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 订单编号精准匹配
data.status 订单状态 string N 2501:订房成功 详细见文档14.7 酒店状态码表
data.page_index 起始页 int N 默认为1
data.page_size 每页显示的条数 int N 默认为30 最大为500
data.user_name 下单人电话 string N 下单人电话
data.user_phone 下单人名字 string N 下单人名字
data.guest_name 入住人名字 string N 入住人名字
data.create_time_begin 订单预定时间从 string Y 订单的开始时间 格式:"2020-05-27"
data.create_time_end 订单预定时间到 string N 格式:"2020-05-29"
data.user_id 下单人用户ID string N 如果下单人用户ID不为空则下单人用户类型必填
data.user_type 下单人用户类型 integer N 0为分贝通,1为第三方审批单
data.apply_type 审批单类型 integer N 0为分贝通审批单,1为第三方审批单
data.apply_id 审批单id string N 审批单id
data.order_type 订单类别 integer N 1:因公 2:因私

请求示例:

	"access_token":"5747fbc10f0e60e0709d8d722",
	"sign":"oihfnlyeofdh98",
	"timestamp":124124325,
	"employee_id":"59b74c1323445f2d54dd07922",
	"employee_type":"1",
	"data":{"order_id":"","status":2501, "user_name":"闵文超","user_phone":"13261635230", "create_time_begin":"2020-07-17", "create_time_end":"2020-07-17", "page_index":1,"page_size":30}

1
2
3
4
5
6
7

响应结果示例:

# 响应数据:
字段 名称 类型 必填 描述
code 响应码 integer Y 0:成功;1:失败
msg 响应信息 string N success
data 响应数据 jsonObject N
data.total_count 总行数 integer Y 1 3
data.total_pages 总页数 integer Y 1
data.page_index 当前页码 integer Y 1
data.page_size 每页大小 integer Y 10
data.results 订单列表 jsonArray N
# 订单列表results:
字段 名称 类型 必填 描述
results.order_info 订单信息 jsonobject Y 订单信息
results.user_info 下单人信息 jsonobject Y 下单人信息
results.guest_info 入住人信息 jsonArray Y 入住人信息
results.price_info 订单金额信息 jsonobject Y 订单金额信息
results.hotel_info 酒店信息 jsonobject Y 酒店信息
results.saas_info 管控信息 jsonobject Y 管控信息
# 订单信息order_info:
字段 名称 类型 必填 描述
order_id 订单编号 string Y 5f117ab32798635a172e93b6
origin_order_id 原始订单id string Y 原始订单id
supplier_order_id 供应商订单编号 string N 供应商订单编号
status 状态码 integer Y 2501
status_name 状态名称 string Y 已完成
supplier_name 供应商名称 string Y 千淘
create_time 创建时间 string Y 2020-04-29 11:08:52
# 下单人信息user_info:
字段 名称 类型 必填 描述
id 下单人id string Y 5d70ba9b23445f04bc031156
name 下单人姓名 string Y 张三
phone 下单人手机号 integer Y 18310480640
unit_id 下单人部门id string N 59a80dd92798630fd780babf
unit_name 下单人部门名称 string N 嘟嘟搞测试
# 入住人信息guest_info:
字段 名称 类型 必填 描述
id 顾客的id string Y 顾客的id
name 顾客的名字 string Y 顾客的名字
phone 顾客的电话 string Y 顾客的电话
unit_name 顾客部门单位id string Y 顾客部门单位id
full_org_unit 顾客的部门单位全称 string Y 顾客的部门单位全称
# 订单金额信息price_info:
字段 名称 类型 必填 描述
total_price 订单总金额 double Y 1
personal_total_pay 个人支付金额 double N 0
total_pay 销售价,订单总金额 double N 0
actual_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 卡哇伊房(部分有窗)
# 管控saas_info:
字段 名称 类型 必填 描述
cost_attribution_list 费用归属 jsonArray Y 费用归属
cost_attribution_list.cost_attribution_id 费用归属id string Y 费用归属id
cost_attribution_list.cost_attribution_category 费用归属类别 string Y 费用归属类别
cost_attribution_list.cost_attribution_name 费用归属名称 string Y 费用归属名称
# 管控guest_info:
字段 名称 类型 必填 描述
guest_info 同住人信息 jsonArray Y 同住人信息
guest_info.id_number string Y
guest_info.id_number_type string Y
guest_info.id_number_type.key string Y
guest_info.id_number_type.value string Y
gender 性别 Object Y 性别
gender.key 性别枚举 Integer Y 性别枚举
gender.value 性别名称 string Y 性别名称

{
  "code": 0,
  "msg": "success",
  "data": {
    "total_count": 4,
    "page_index": 1,
    "total_pages": 4,
    "results": [
      {
        "order_info": {
          "order_id": "5f117ab32798635a172e93b6",
          "status": 2501,
          "status_name": "订房成功",
          "supplier_order_id": "BD202007172273424",
          "supplier_name": "千淘",
          "create_time": "2020-07-17 18:17:23"
        },
        "price_info": {
          "total_price": 182,
          "personal_total_pay": 0,
          "total_pay_price": 182,
          "actual_price": 187
        },
        "user_info": {
          "id": "5e1ed56e23445f5b4018ef9e",
          "name": "张三",
          "phone": "13511367471",
          "unit_id": "58c21a365f281a7e6f810ae6",
          "unit_name": "X部门"
        },
        "hotel_info": {
          "hotel_name": "汉庭海友酒店(上海人民广场店)",
          "hotel_phone": "021-63226675",
          "checkin_date": "2020-08-06",
          "checkout_date": "2020-08-07",
          "room_type": "单床房(部分有窗)"
        },
        "saas_info": {
          "cost_attribution_list": [
            {
              "cost_attribution_id": "58c21a365f281a7e6f810ae6",
              "cost_attribution_category": 1,
              "cost_attribution_name": "X部门"
            }
          ]
        },
        "guest_info": [
          {
            "id": "5ef8041c23445f02927e3bed",
            "name": "张三",
            "phone": "13572367471",
            "unit_name": "X部门",
            "full_unit_name": "北京分贝金服科技有限公司/X部门"
          }
        ]
      }
    ],
    "page_size": 1
  },
  "request_id": "BwfkWTujJWZJs8dK"
}

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
lastUpdate: 10/27/2022, 4:23:04 PM