在途商旅
  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
GET
/tmc/v1/travel-plan/list
功能描述:此接口用于获取在途系统差旅计划数据,返回结果为差旅计划数据。
可根据差旅申请单号或时间范围查询申请单信息

请求参数

Query 参数
access_token
string 
请求token
必需
示例值:
{{openApiToken}}
planNo
string 
可选
差旅单号,单号和时间,两者必须有一其一
示例值:
123456789
beginDate
string 
可选
查询时间范围开始,格式yyyy-MM-dd
示例值:
2019-03-01
endDate
string 
可选
查询时间范围结束,格式yyyy-MM-dd,时间范围差不能大于31天
示例值:
2019-03-31

返回响应

🟢200成功
application/json
Body
error
string 
必需
data
array [object {18}] 
必需
planNo
string 
差旅单号
必需
status
string 
99:审批通过
必需
travelType
string 
在途系统的差旅类型编码,参见获取差旅类型列表
可选
strokeType
integer 
行程类型 1:单程 2:往返 3:多程
必需
applicantName
string 
申请人员工姓名
必需
applyDate
string 
申请时间,格式 yyyy-MM-dd HH:mm:ss
必需
costUnitName
string 
费用归属成本中心名字
必需
expend
integer 
差旅预算总金额,精确分
可选
projectCode
string 
费用归属的项目编码
可选
projectName
string 
费用归属的项目名称
可选
paymentCorp
string 
费用支付公司
必需
extend2
object 
扩展字段
可选
支持多个 extendField1 .... extendField10
orgCode
string 
发起人所在组织单位名字
必需
orgName
string 
发起人所在组织单位编码
必需
travelReason
string 
出差事由
必需
expenseItems
array [object {3}] 
可选
travelItems
array [object {9}] 
可选
travellers
array [object {2}] 
可选
示例
{
  "error": "0",
  "data": [
    {
      "planNo": "201901100012",
      "status": "99",
      "travelType": "10",
      "strokeType": 1,
      "applicantName": "赵",
      "applyDate": "2019-01-10 18:17:48",
      "costUnitName": "销售部一组",
      "expend": 0,
      "projectCode": "P0001",
      "projectName": "XXX",
      "paymentCorp": "A0001",
      "extend2": {
        "extendField1": "xxx",
        "extendField2": "xxx"
      },
      "orgCode": "11",
      "orgName": "技术部",
      "travelReason": "34",
      "expenseItems": [
        {
          "amount": 0,
          "expenseCode": "AIR_TRAIN_TRAFFIC_FEE",
          "expenseName": "交通费(机票、火车)"
        },
        {
          "amount": 0,
          "expenseCode": "CITY_TRAFFIC_FEE",
          "expenseName": "交通费(市内交通)"
        },
        {
          "amount": 0,
          "expenseCode": "ACCOMODATE_HOTEL_FEE",
          "expenseName": "住宿费(酒店)"
        },
        {
          "amount": 0,
          "expenseCode": "IN_FILGHT",
          "expenseName": "用车查询用车查询用车查询11"
        }
      ],
      "travelItems": [
        {
          "arrivalTime": "2019-01-10",
          "departureTime": "2019-01-10",
          "destination": "沈阳",
          "origin": "北京",
          "trafficType": "UNKNOW"
        },
        {
          "arrivalTime": "2019-01-11",
          "departureTime": "2019-01-10",
          "destination": "沈阳",
          "origin": "沈阳",
          "trafficType": "HOTEL"
        }
      ],
      "travellers": [
        {
          "fullname": "赵"
        }
      ]
    }
  ]
}
上一页
申请单状态变更
下一页
获取申请单使用状态
Built with