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

说明

调用本接口获取商旅酒店订单数据。
服务地址：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"
        }
    ]
}

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

说明#

权限#

请求参数

示例代码

返回响应

说明

权限