在途商旅
  1. 订单
在途商旅
  • 关于本文档
  • API调用指南
    • API列表
    • 接入流程
    • 接口通用说明
    • 通用错误码
  • 服务端接口
    • 一、鉴权管理
      • 1、接口鉴权
        • a、获取token
      • 2、单点登录
        • a、目标页概述
        • b、单点登录
    • 二、企业信息
      • 1、概述
      • 2、组织单位
        • a、概述
        • b、常见问题
        • c、场景说明
        • d、组织同步
        • f、负责人同步
      • 3、员工信息
        • 概述
        • 场景说明
        • 常见问题
        • 手机号国家编码表
        • 员工同步
        • 员工直属主管同步
        • 员工常住地同步
        • 获取职级列表
        • 获取证件类型
        • 员工信息查询
      • 4、成本中心
        • 概述
        • 常见问题
        • 场景说明
        • 成本中心(部门所属)
        • 成本中心(员工所属)
      • 5、项目
        • 概述
        • 常见问题
        • 场景说明
        • 项目同步
      • 6、法人
        • 概述
        • 常见问题
        • 法人同步
    • 三、业务数据
      • 1.出行前
        • 概述
        • 差旅申请
          • 申请单同步
          • 申请单变更前校验
          • 取消申请单提前验证
          • 申请单状态变更
          • 获取申请单
          • 获取申请单使用状态
          • 获取申请单出行概况
          • 获取差旅类型
          • 获取费用类型
      • 2.出行中
        • 订单
          • 客票状态
          • 订单查询(全量)
            GET
          • 订单查询(分页)
            GET
          • 订单确认-V1
            POST
          • 订单确认-V2
            POST
      • 3.出行后
        • 账单
          • 获取账单主信息
          • 分页获取账单主信息
          • 获取账单订单明细
          • 账单中疑异订单通知
          • 确认账单通知
        • 票据
          • 订单开票信息
          • 个付电子发票查询
          • OCR票据查询
          • 订单数电票
      • 4.工作流
        • 查询审批记录
        • 审批结束通知
        • 审批记录同步
    • 四、事件订阅
      • 1、概述
      • 2、事件列表
      • 3、数据推送
      • 4、示例代码
      • 5、需求单服务类型
      • 8、openapi-sdk
      • 6、事件订阅接口
        • a、订阅事件
        • b、删除订阅
        • c、查询订阅
    • 五、通用数据
      • 国家编码对照表
      • 获取城市列表(废弃)
      • 获取城市列表V2
    • 六、其他
      • 补贴查询
      • 自定义补贴场景明细同步
  1. 订单

订单查询(分页)

测试环境
https://openapi-uat.z-trip.cn
测试环境
https://openapi-uat.z-trip.cn
GET
/tmc/v1/order/queryListByPage
功能描述:此接口用于获取在途系统订单数据,返回结果为分页的订单数据数组。
注意:时间范围、订单号、差旅计划号,必须传一个。

请求参数

Query 参数
page
integer 
页码
必需
示例值:
1
size
integer 
必需
每页条数(最大25)
示例值:
25
access_token
string 
接口请求秘钥
必需
bizType
string 
可选
要查询的业务类型,10-机票;11-酒店;12-火车票;13-国际酒店;14-需求单;15-保险;16-打车;17-国际机票;20-服务费订单。此参数为非必需项,无值时查询所有业务的订单,多值以逗号分隔
beginDate
string 
可选
查询时间范围开始,格式 yyyy-MM-dd HH:mm:ss
endDate
string 
可选
查询时间范围结束,格式 yyyy-MM-dd HH:mm:ss,时间范围差不能大于31天
timeType
string 
可选
查询的时间类型,completeTime-订单完成时间;updateTime-订单更新时间;travelEndTime-出行结束时间。此参数为非必需项,无值时默认为完成时间
orderType
integer 
可选
订单类型,1-正向订单;2-改签订单;9-退单
orderId
number 
订单号
可选
travelPlanNo
string 
差旅计划号
可选
empCode
string 
出行人员工编码
可选
userName
string 
可选
非员工时,才用出行人姓名查询 否

返回响应

🟢200成功
application/json
Body
error
string 
必需
data
object 
必需
currentPage
integer 
当前页码
必需
list
array [object {43}] 
数据集合
必需
size
integer 
每页条数
必需
start
integer 
第几条开始
必需
total
integer 
数据总条数
必需
totalPage
integer 
总页数
必需
error_description
string 
必需
示例
{
  "error": "0",
  "data": {
    "currentPage": 1,
    "list": [
      {
        "bizType": "10",
        "bpBearAmount": 705,
        "bpPayAmount": 705,
        "completeTime": "2023-07-27 17:17:30",
        "contacterName": "麟",
        "costBreaks": [
          {
            "chief": true,
            "corpCode": "YH27000000000000",
            "corpName": "卧牛山建筑节能有限公司",
            "costUnitCode": "YH10E00295",
            "costUnitName": "集团数字中心",
            "empCode": "159228",
            "empName": "麟",
            "orgCode": "50022380",
            "orgName": "数字中心",
            "percent": 100,
            "totalAmount": 705
          }
        ],
        "createTime": "2023-07-27 17:13:27",
        "dealFee": 0,
        "departureTax": 50,
        "fuelTax": 30,
        "id": 108948482283264,
        "illegalInfos": [
          {
            "empCode": "159228",
            "empName": "麟",
            "issueCode": "O004",
            "issueInfo": "订单与申请存在地点差异"
          }
        ],
        "orderOriginType": "CC_H5",
        "orderStatus": "COMPLETED",
        "orderSummary": "上海-天津 2023-08-03 06:35起飞经济舱3.6折  麟",
        "orderType": 1,
        "originalOrderId": 108948482283264,
        "paymentMethod": "BP_ACCOUNT",
        "paymentTime": "2023-07-27 17:14:16",
        "personalPayAmount": 0,
        "productInfos": [
          {
            "cabinCode": "S",
            "cabinFullPrice": 1760,
            "cabinLevelCode": "Y",
            "cabinName": "经济舱",
            "discountRate": "3.6",
            "flightNo": "HO1135",
            "fromAirport": "PVG",
            "fromAirportName": "浦东国际机场",
            "fromCity": "上海",
            "fromCityId": "10801",
            "fromDate": "2023-08-03 06:35:00",
            "fromTerminal": "T2",
            "price": 625,
            "product": "HO1135",
            "serviceProvider": "吉祥航空",
            "toAirport": "TSN",
            "toAirportName": "滨海国际机场",
            "toCity": "天津",
            "toCityId": "10020",
            "toDate": "2023-08-03 08:55:00",
            "toTerminal": "T2"
          }
        ],
        "receivedAmount": 705,
        "refundFee": 0,
        "salePrice": 625,
        "serviceChargeAmount": 0,
        "taxFee": 80,
        "tmcName": "系统集成接口对接TMC",
        "totalAmount": 705,
        "travelPlanNo": "HR19-2023-07-0747",
        "travelPlans": {
          "consumedAmount": 2010,
          "costUnitCode": "YH10E00295",
          "costUnitName": "集团数字中心",
          "expense": 0,
          "extend2": "{\"extendField8\":\"卧牛山建筑节能有限公司\",\"extendField2\":\"127417\",\"extendField1\":\"2023-07-27 16:08:00\",\"extendField3 \":\"婷婷\"}",
          "planNo": "HR19-2023-07-0747",
          "travelReason": "拜访客户",
          "travelType": "90",
          "travelTypeName": "其他"
        },
        "travelReason": "拜访客户",
        "travelStartTime": "2023-08-03 06:35:00",
        "travelType": "90",
        "travellers": [
          {
            "bpBearAmount": 705,
            "bpPayAmount": 705,
            "credentialNo": "130430200112090543",
            "credentialType": "IDENTITY",
            "dealFee": 0,
            "departureTax": 50,
            "empCode": "159228",
            "empName": "麟",
            "empUniqueId": "73C7562FBCA8B55A3212592CF296D248",
            "employee": true,
            "facePrice": 625,
            "fuelTax": 30,
            "mobile": "13000006332",
            "personalPayAmount": 0,
            "product": "123-3123134123",
            "refundFee": 0,
            "salePrice": 625,
            "serviceChargeAmount": 0,
            "settlementStatus": "UN_SETTLEMENT",
            "standardAmount": 1840,
            "status": "REFUNDED",
            "taxFee": 80,
            "totalAmount": 705
          }
        ],
        "userCode": "159228",
        "userName": "麟"
      }
    ],
    "size": 25,
    "start": 0,
    "total": 1,
    "totalPage": 1
  },
  "error_description": "成功"
}
上一页
订单查询(全量)
下一页
订单确认-V1
Built with