在途商旅
  1. 差旅申请
在途商旅
  • 关于本文档
  • API调用指南
    • API列表
    • 接入流程
    • 接口通用说明
    • 通用错误码
  • 服务端接口
    • 一、鉴权管理
      • 1、接口鉴权
        • a、获取token
      • 2、单点登录
        • a、目标页概述
        • b、单点登录
    • 二、企业信息
      • 1、概述
      • 2、组织单位
        • a、概述
        • b、常见问题
        • c、场景说明
        • d、组织同步
        • f、负责人同步
      • 3、员工信息
        • 概述
        • 场景说明
        • 常见问题
        • 手机号国家编码表
        • 员工同步
        • 员工直属主管同步
        • 员工常住地同步
        • 获取职级列表
        • 获取证件类型
        • 员工信息查询
      • 4、成本中心
        • 概述
        • 常见问题
        • 场景说明
        • 成本中心(部门所属)
        • 成本中心(员工所属)
      • 5、项目
        • 概述
        • 常见问题
        • 场景说明
        • 项目同步
      • 6、法人
        • 概述
        • 常见问题
        • 法人同步
    • 三、业务数据
      • 1.出行前
        • 概述
        • 差旅申请
          • 申请单同步
            POST
          • 申请单变更前校验
            POST
          • 取消申请单提前验证
            GET
          • 申请单状态变更
            POST
          • 获取申请单
            GET
          • 获取申请单使用状态
            GET
          • 获取申请单出行概况
            POST
          • 获取差旅类型
            GET
          • 获取费用类型
            GET
      • 2.出行中
        • 订单
          • 客票状态
          • 订单查询(全量)
          • 订单查询(分页)
          • 订单确认-V1
          • 订单确认-V2
      • 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
POST
/tmc/v1/order/queryTravelDays
用于查询申请单在出行过程中的商旅预订情况
bookingCycle:实际预订周期,代表在出行中实际有哪些天发生了差旅预订业务及天数之和
travelCycle:出行周期,代表本次出行什么时候发生的第一次预订和最后一次预订的时间及间隔天数

请求参数

Query 参数
access_token
string 
可选
示例值:
a4a06a1b63715b509e143dde8fadcf77_gray_env_1
Body 参数application/json
travelPlanNoList
array[string]
出差申请单号集合
必需
示例
{
    "travelPlanNoList": [
        "XSCC2023091402"
    ]
}

返回响应

🟢200成功
application/json
Body
error
string 
必需
data
array [object {3}] 
返回结果
必需
travelPlanNo
string 
申请单号
必需
bookingCycle
object 
实际预订周期
必需
travelCycle
object 
出行周期
必需
error_description
string 
必需
示例
{
    "error": "0",
    "data": [
        {
            "bookingCycle": {
                "businessDayNum": 3,
                "businessDays": [
                    "2024-05-29",
                    "2024-05-28",
                    "2024-05-30"
                ]
            },
            "orderRoomNightsList": [
                {
                    "empCode": "146195",
                    "name": "张三",
                    "orderId": 119814650786966,
                    "roomNights": 1
                },
                {
                    "empCode": "146195",
                    "name": "张三",
                    "orderId": 119814648886466,
                    "roomNights": 1
                }
            ],
            "travelCycle": {
                "dayNum": 2,
                "endDate": "2024-05-30 09:45:00",
                "endDateOrderNo": 109814640105472,
                "startDate": "2024-05-28 00:00:00",
                "startDateOrderNo": 119813917013120
            },
            "travelPlanNo": "HR19-2024-05-1253"
        },
        {
            "bookingCycle": {
                "businessDayNum": 8,
                "businessDays": [
                    "2023-08-18",
                    "2023-08-17",
                    "2023-10-31",
                    "2023-09-14",
                    "2023-11-01",
                    "2023-10-12",
                    "2023-10-29",
                    "2023-10-18"
                ]
            },
            "orderRoomNightsList": [
                {
                    "empCode": "159228",
                    "name": "ABC",
                    "orderId": 119007974751616,
                    "roomNights": 1
                },
                {
                    "empCode": "159228",
                    "name": "ABC",
                    "orderId": 119007905905280,
                    "roomNights": 1
                }
            ],
            "travelCycle": {
                "dayNum": 76,
                "endDate": "2023-11-01 13:55:00",
                "endDateOrderNo": 109222308894208,
                "startDate": "2023-08-17 00:00:00",
                "startDateOrderNo": 119007974751616
            },
            "travelPlanNo": "HR19-2023-08-0835"
        }
    ],
    "error_description": "成功"
}
上一页
获取申请单使用状态
下一页
获取差旅类型
Built with