在途商旅
  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": "成功"
}
修改于 2025-04-24 03:21:19
上一页
订单查询(全量)
下一页
订单确认-V1
Built with