获取企业火车票订单数据

说明

调用本接口获取企业火车票订单数据。
服务地址：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": "123",
    "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

操作是否成功。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

train_order_list

array [object {32}]

火车票订单列表。

可选

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

联系人姓名。

可选

dep_station

string

出发站。

可选

arr_station

string

到达站。

可选

dep_time

string

出发时间。

可选

arr_time

string

到达时间。

可选

train_number

string

车次。

可选

train_type

string

车次类型。

可选

seat_type

string

座位类型。

可选

run_time

string

运行时长。

可选

ticket_no_12306

string

12306票号。

可选

dep_city

string

出发城市。

可选

arr_city

string

到达城市。

可选

rider_name

string

乘客姓名。

可选

ticket_count

number

票的数量。

可选

status

number

可选

订单状态：0：待支付1：出票中2：已关闭3：改签成功4：退票成功5：出票完成6：退票申请中7：改签申请中8：已出票/已发货9：出票失败10：改签失败11：退票失败

invoice

object

发票对象。

可选

cost_center

object

成本中心对象。

可选

price_info_list

array [object {6}]

价目信息。

可选

thirdpart_itinerary_id

string

第三方行程ID。

可选

user_affiliate_list

array [object {2}]

乘车人列表。

可选

thirdpart_apply_id

string

第三方申请单ID。

可选

btrip_title

string

申请单名称。

可选

示例

{
  "success": true,
  "errcode": 0,
  "errmsg": "string",
  "train_order_list": [
    {
      "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",
      "dep_station": "string",
      "arr_station": "string",
      "dep_time": "string",
      "arr_time": "string",
      "train_number": "string",
      "train_type": "string",
      "seat_type": "string",
      "run_time": "string",
      "ticket_no_12306": "string",
      "dep_city": "string",
      "arr_city": "string",
      "rider_name": "string",
      "ticket_count": 0,
      "status": 0,
      "invoice": {
        "id": "string",
        "title": "string"
      },
      "cost_center": {
        "id": "string",
        "corpid": "string",
        "number": "string",
        "name": "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"
        }
      ],
      "thirdpart_apply_id": "string",
      "btrip_title": "string"
    }
  ]
}

获取企业火车票订单数据

说明#

权限#

请求参数

示例代码

返回响应

说明

权限