在途商旅
  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/queryList
功能描述:此接口用于获取在途系统订单数据,返回结果为订单数据数组。
限流说明:最大并发3次/分,超过返回错误码:RATE_LIMITED
注意:时间范围、订单号、差旅计划号,必须传一个。
如果查询出数据大于1000条则返回报错,建议接入分页查询订单

请求参数

Query 参数
access_token
string 
必需
示例值:
{{openApiToken}}
orderId
number 
订单号
可选
示例值:
118033289268352
bizType
string 
可选
要查询的业务类型,10-机票;11-酒店;12-火车票;13-国际酒店;15-保险;14-需求单;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-退单
travelPlanNo
string 
差旅计划号
可选
empCode
string 
出行人员工编码
可选
userName
string 
可选
非员工时,才用出行人姓名查询

返回响应

🟢200成功
application/json
Body
error
string 
状态码,0表示正确,其他值表示错误
必需
error_description
string 
错误信息描述
必需
data
array [object {44}] 
返回的业务数据
必需
id
integer 
订单id
必需
userCode
string 
预定人工号
必需
userName
string 
预定人姓名
必需
bizType
string 
必需
业务订单类型,10-机票;11-酒店;12-火车票;13-国际酒店;15-保险;14-需求单;16-打车;17-国际机票;20-服务费订单
orderType
integer 
订单类型
必需
1-正向订单;2-改签订单;3-抢票订单;9-退单
bizOrderTypeEnum
string 
业务线订单类型
可选
ROUTINE:常规出票;CHANGE:直接改签;REFUND_TICKET_REPURCHASE:退票重出;GRAB:抢票单; REFUND:退单
orderOriginType
string 
订单来源类型
可选
WWW("官网"),
CC_WWW("客服代订"),
CC_H5("H5客服代订"),
CC_MANUAL("客服手工录单"),
CC("客服后台代订"),
ANDROID("安卓"),
IOS("IOS"),
WEIXIN("微信公众号"),
H5("H5端"),
WEIXIN_APP("微信小程序"),
OPEN_API("渠道分销商");
orderStatus
string 
订单状态
可选
COMPLETED-已完成/已退票;CANCELED-已取消(目前订单查询接口无法查询已取消订单)
contacterName
string 
联系人姓名
可选
originalOrderId
integer 
原始订单号
可选
本订单的关联订单中最原始的订单
parentOrderId
integer 
关联订单号
可选
比如退单关联的正单,改签单关联的原单
bizOrderId
integer 
可选
关联业务订单号,需求单火车票代打所关联的业务单号
salePrice
number 
订单销售价
可选
serviceChargeAmount
number 
订单服务费总金额
可选
totalAmount
number 
订单应付总金额
可选
receivedAmount
number 
订单已实收金额
可选
bpPayAmount
number 
企业账户支付金额
可选
bpBearAmount
number 
企业应承担金额
可选
personalPayAmount
number 
个人支付金额
可选
dealFee
number 
手续费
可选
taxFee
number 
税费
可选
refundFee
number 
退票费
可选
agreementCode
string 
大客户编码
可选
travelStartTime
string 
行程开始时间
可选
只有机酒火用车有值
travelEndTime
string 
行程结束时间
可选
只有机酒火用车有值
createTime
string 
创建订单时间
可选
travelPlanNo
string 
差旅计划号
可选
travelType
string 
出行类别
可选
travelReason
string 
差旅事由
可选
feeCode
string 
费用类型编码
可选
feeName
string 
费用类型名称
可选
invoiceMode
string 
发票类型
可选
只针对酒店业务的,其它业务可以配置成行程单;酒店对应的枚举类型如下:
HOTEL_SPECIAL_INVOICE("酒店开专用发票") HOTEL_GENERAL_INVOICE("酒店开普通发票") SUPPLIER_SPECIAL_INVOICE("供应商开专用发票") SUPPLIER_GENERAL_INVOICE("供应商开普通发票")
travelPlans
object 
差旅计划信息
可选
illegalInfos
array [object {4}] 
违规项
可选
costBreaks
array [object {13}] 
订单成本分摊信息
必需
travellers
array [object {28}] 
订单出行人
必需
productInfos
array[string]
多态的产品集
可选
可能是["flightProductInfo","hotelProductInfo","trainProductInfo","insuranceProductInfo","universalProductInfo","carProductInfo"]中的一种
flightProductInfo
object 
飞机产品集
可选
hotelProductInfo
object 
酒店产品集
可选
trainProductInfo
object 
火车产品集
可选
insuranceProductInfo
object 
保险产品集
可选
universalProductInfo
object 
通用产品集
可选
carProductInfo
object 
用车产品集
可选
workflowAssigneeInfos
array [object {5}] 
可选
已经审批的任务和审批人
示例
{
    "error": "0",
    "data": [
        {
            "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": "130430199712090543",
                    "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": "张三"
        }
    ],
    "error_description": "成功"
}
上一页
客票状态
下一页
订单查询(分页)
Built with