- 关于本文档
- API 调用指南
- 服务端接口
- 一、鉴权管理
- 二、企业信息
- 三、业务数据
- 四、事件订阅
- 五、通用数据
- 六、其他
订单查询(全量)
测试环境
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
可选
beginDate
string
可选
endDate
string
可选
timeType
string
可选
orderType
integer
可选
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
必需
orderType
integer
订单类型
bizOrderTypeEnum
string
业务线订单类型
orderOriginType
string
订单来源类型
CC_WWW("客服代订"),
CC_H5("H5客服代订"),
CC_MANUAL("客服手工录单"),
CC("客服后台代订"),
ANDROID("安卓"),
IOS("IOS"),
WEIXIN("微信公众号"),
H5("H5端"),
WEIXIN_APP("微信小程序"),
OPEN_API("渠道分销商");
orderStatus
string
订单状态
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
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": "成功"
}