获取用车订单数据

说明

调用本接口获取企业用车订单数据。
服务地址：https://oapi.dingtalk.com

权限

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

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

请求参数

Query 参数

access_token

string

必需

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

示例值:

dc73axxxx

Body 参数application/json

object

请求对象。

必需

start_time

string

创建开始时间。

可选

update_end_time

string

更新结束时间。

可选

apply_id

number

商旅审批单ID。

可选

page

number

页数，从1开始。

可选

userid

string

用户userid。

可选

page_size

number

可选

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

deptid

string

部门ID。

可选

end_time

string

创建结束时间。

可选

update_start_time

string

更新开始时间。

可选

corpid

string

必需

企业的corpid。

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": "123",
        "page": "1",
        "userid": "user1",
        "page_size": "10"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

success

boolean

操作是否成功。

可选

vehicle_order_list

array [object {47}]

订单列表。

可选

number

订单ID。

可选

gmt_create

string

订单创建时间。

可选

gmt_modified

string

订单更新时间。

可选

passenger_name

string

乘客名称。

可选

corpid

string

可选

企业的corpid。

corp_name

string

企业名称。

可选

user_name

string

预定人姓名。

可选

userid

string

可选

预定人userid。

dept_name

string

部门名称。

可选

deptid

string

部门ID。

可选

apply_show_id

string

可选

商旅审批单展示ID。

apply_id

number

可选

商旅系统审批单ID。

real_from_city_name

string

实际出发城市。

可选

real_to_city_name

string

实际到达城市。

可选

from_address

string

出发地。

可选

to_address

string

目的地。

可选

from_city_name

string

出发城市。

可选

to_city_name

string

目的城市。

可选

memo

string

打车事由。

可选

order_status

number

可选

订单状态：0：初始状态1：已超时2：派单成功3：派单失败4：已退款5：已支付6：已取消

car_level

string

可选

类型级别：1：经济型2：舒适型3：豪华型

car_info

string

车辆类型。

可选

estimate_price

string

订单预估价格。

可选

publish_time

string

乘客发布用车时间。

可选

taken_time

string

乘客上车时间。

可选

driver_confirm_time

string

可选

司机到达目的地时间。

cancel_time

string

取消时间。

可选

travel_distance

string

行驶公里数。

可选

pay_time

string

支付时间。

可选

service_type

number

可选

打车服务类型：1：出租车2：专车3：快车

business_category

string

可选

用车原因：TRAVEL: 差旅TRAFFIC: 市内交通WORK: 加班OTHER: 其它

cost_center_id

number

商旅成本中心ID。

可选

cost_center_number

string

成本中心编号。

可选

cost_center_name

string

成本中心名称。

可选

invoice_id

number

商旅发票ID。

可选

invoice_title

string

发票抬头。

可选

project_code

string

项目编号。

可选

project_title

string

项目名称。

可选

price_info_list

array [object {6}]

价目详情列表。

可选

thirdpart_itinerary_id

string

第三方行程ID。

可选

user_affiliate_list

array [object {2}]

出行人列表。

可选

user_confirm

number

可选

用户确认状态：0：未确认1：已确认2：有异议3：系统检查不合理

provider

number

可选

服务商：2：滴滴3：曹操4：首汽5：阳光

real_from_address

string

真实出发地。

可选

real_to_address

string

真实到达地。

可选

thirdpart_apply_id

string

第三方申请单ID。

可选

btrip_title

string

申请单名称。

可选

示例

{
    "errcode": 0,
    "errmsg": "string",
    "success": true,
    "vehicle_order_list": [
        {
            "id": 0,
            "gmt_create": "string",
            "gmt_modified": "string",
            "passenger_name": "string",
            "corpid": "string",
            "corp_name": "string",
            "user_name": "string",
            "userid": "string",
            "dept_name": "string",
            "deptid": "string",
            "apply_show_id": "string",
            "apply_id": 0,
            "real_from_city_name": "string",
            "real_to_city_name": "string",
            "from_address": "string",
            "to_address": "string",
            "from_city_name": "string",
            "to_city_name": "string",
            "memo": "string",
            "order_status": 0,
            "car_level": "string",
            "car_info": "string",
            "estimate_price": "string",
            "publish_time": "string",
            "taken_time": "string",
            "driver_confirm_time": "string",
            "cancel_time": "string",
            "travel_distance": "string",
            "pay_time": "string",
            "service_type": 0,
            "business_category": "string",
            "cost_center_id": 0,
            "cost_center_number": "string",
            "cost_center_name": "string",
            "invoice_id": 0,
            "invoice_title": "string",
            "project_code": "string",
            "project_title": "string",
            "price_info_list": [
                {
                    "price": "string",
                    "type": 0,
                    "category": "string",
                    "pay_type": 0,
                    "gmt_create": "string",
                    "passenger_name": "string"
                }
            ],
            "thirdpart_itinerary_id": "string",
            "user_affiliate_list": [
                {
                    "userid": "string",
                    "user_name": "string"
                }
            ],
            "user_confirm": 0,
            "provider": 0,
            "real_from_address": "string",
            "real_to_address": "string",
            "thirdpart_apply_id": "string",
            "btrip_title": "string"
        }
    ]
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限