获取企业商旅酒店订单数据

说明

调用本接口获取商旅酒店订单数据。
服务地址：https://oapi.dingtalk.com

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。详情请参考权限申请。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	是	开发者后台申请	调试
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

调用服务端接口的授权凭证。企业内部应用可通过调用access_token接口获得。第三方企业应用可通过调用get_corp_token接口获得。

示例值:

dc73axxxx

Body 参数application/json

object

请求对象。

必需

start_time

string

开始时间。

可选

apply_id

number

商旅审批单ID。

可选

page

number

页数，从1开始。

可选

userid

string

可选

用户的userid。

page_size

number

可选

每页数量，默认10，最大50

deptid

string

部门ID。

可选

end_time

string

结束时间。

可选

corpid

string

必需

企业的corpid。

update_end_time

string

更新开始时间。

可选

update_start_time

string

更新结束时间。

可选

all_apply

boolean

可选

false：搜索未报销订单。

thirdpart_apply_id

string

第三方申请单ID。

可选

示例

{
  "rq": {
    "update_end_time": "2017-05-01 00:00:00",
    "start_time": "2017-05-01 00:00:00",
    "update_start_time": "2017-05-01 00:00:00",
    "corpid": "corp1",
    "all_apply": "true",
    "thirdpart_apply_id": "123",
    "deptid": "dept1",
    "end_time": "2017-05-01 00:00:00",
    "apply_id": "12345",
    "page": "1",
    "userid": "user1",
    "page_size": "10"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

success

boolean

操作是否成功。

可选

errmsg

string

返回码描述。

可选

errcode

number

返回码。

可选

module

array [object {30}]

酒店订单列表。

可选

number

订单ID。

可选

gmt_create

string

创建时间。

可选

gmt_modified

string

更新时间。

可选

corpid

string

可选

企业的corpid。

corp_name

string

企业名称。

可选

userid

string

可选

用户的userid。

user_name

string

用户名称。

可选

deptid

string

部门ID。

可选

dept_name

string

部门名称。

可选

apply_id

number

商旅申请单ID。

可选

contact_name

string

联系人姓名。

可选

city

string

酒店所在城市。

可选

hotel_name

string

酒店名称。

可选

check_in

string

入住时间。

可选

check_out

string

离店时间。

可选

room_type

string

房型。

可选

room_num

number

房间数。

可选

night

number

总共住几晚。

可选

guest

string

可选

入住顾客，多个用','分割。

order_type_desc

string

订单类型描述。

可选

order_status_desc

string

订单状态描述。

可选

cost_center

object

成本中心对象。

可选

invoice

object

发票对象。

可选

price_info_list

array [object {6}]

价目详情列表。

可选

thirdpart_itinerary_id

string

第三方行程ID。

可选

order_status

number

可选

订单状态：1：等待确认2：等待付款3：预订成功4：申请退款5：退款成功6：已关闭7：结账成功8：支付成功

order_type

number

可选

订单类型：1：预付5：面付6：信用住

user_affiliate_list

array [object {2}]

入住人列表。

可选

thirdpart_apply_id

string

第三方申请单ID。

可选

btrip_title

string

申请单名称。

可选

示例

{
  "success": true,
  "errmsg": "string",
  "errcode": 0,
  "module": [
    {
      "id": 0,
      "gmt_create": "string",
      "gmt_modified": "string",
      "corpid": "string",
      "corp_name": "string",
      "userid": "string",
      "user_name": "string",
      "deptid": "string",
      "dept_name": "string",
      "apply_id": 0,
      "contact_name": "string",
      "city": "string",
      "hotel_name": "string",
      "check_in": "string",
      "check_out": "string",
      "room_type": "string",
      "room_num": 0,
      "night": 0,
      "guest": "string",
      "order_type_desc": "string",
      "order_status_desc": "string",
      "cost_center": {
        "id": 0,
        "corpid": "string",
        "number": "string",
        "name": "string"
      },
      "invoice": {
        "id": 0,
        "title": "string"
      },
      "price_info_list": [
        {
          "price": "string",
          "type": 0,
          "category": "string",
          "pay_type": 0,
          "gmt_create": "string",
          "passenger_name": "string"
        }
      ],
      "thirdpart_itinerary_id": "string",
      "order_status": 0,
      "order_type": 0,
      "user_affiliate_list": [
        {
          "userid": "string",
          "user_name": "string"
        }
      ],
      "thirdpart_apply_id": "string",
      "btrip_title": "string"
    }
  ]
}

获取企业商旅酒店订单数据

说明#

权限#

请求参数

示例代码

返回响应

说明

权限