API列表
概述
列表
鉴权管理
API名称 | 请求方式 | 请求地址 | 说明 |
|---|---|---|---|
| 获取/刷新access_token | POST | /bin/token | 根据密钥获取 access_token,有效期目前为30分钟，需定时刷新，建议在 access_token 剩余有效期小于5分钟时重新获取 access_token |
| 单点登录 | POST | /tmc/v1/sso-url | 此接口用于获取指定编号员工登录到在途系统的自动登录链接。浏览器访问该链接将能自动免密登录到在途系统。 |
企业信息
API名称 | 请求方式 | 请求地址 | 说明 |
|---|---|---|---|
| 组织单位 | POST | /tmc/v1/org/sync | 组织编码作为组织的唯一标识。组织单位编码（code）不存在,做新增操作，若存在则做更新操作。 |
| 员工同步 | POST | /tmc/v1/user/sync | 员工号作为员工的唯一标识，员工号不存在,做新增操作，若存在则做更新操作。 |
| 获取职级列表 | GET | /tmc/v1/user/level-list | 获取在途系统中员工职级列表 |
| 获取证件类型 | GET | /tmc/v1/user/cert-type | 接口用于获取在途系统中定义的证件类型数据。 |
| 上级审批人同步 | POST | /tmc/v1/user/relation/sync | 同步员工的直接汇报人信息到商旅系统，在员工信息中体现。 |
| 用户角色同步 | POST | /tmc/v1/user/role/sync | 同步更新员工的角色信息到商旅系统。 |
| 成本中心同步 | POST | /tmc/v1/cost-center/sync | 成本中心是对成本和费用承担控制、考核责任的中心；成本中心编码及成本中心所属组织编码组成联合主键，企业内应保证唯一。 |
| 项目数据同步 | POST | /tmc/v1/project/sync | 同步项目信息至在途系统中，接口通过项目代码（code）来作为项目的唯一标识 |
| 法人信息同步 | POST | /tmc/v1/corp/sync | 同步企业的法人信息至在途系统中，接口通过社会信用代码或自定义编码作为为题标识，企业内保证唯一。 |
业务数据
API名称 | 请求方式 | 请求地址 | 说明 |
|---|---|---|---|
| 出行前 | |||
| 差旅申请同步 | POST | /tmc/v1/travel-plan/save | 外部OA系统推送差旅申请单给在途系统，提交的差旅申请单如果不指定状态则默认设置为[有效]。对于编号相同的差旅申请单将作修改操作 |
| 修改申请单状态 | POST | /v1/travel-plan/status | 根据差旅计划单号，修改差旅申请单的状态。 |
| 获取出差申请单使用状态 | GET | /tmc/v1/travel-plan/applyStatus | 根据差旅计划单号查询差旅申请单是否已预定业务订单 |
| 获取差旅申请单 | GET | /tmc/v1/travel-plan/list | 根据差旅单编码或者时间范围来获取在途系统中的出差申请单数据列表。 |
| 获取差旅类型 | GET | /tmc/v1/travel-plan/travel-type | 获取企业在在途 系统中配置的差旅类型数据。（eg:售前支持、培训） |
| 获取费用类型 | GET | /tmc/v1/travel-plan/expense-list | 获取企业在在途系统中配置的差旅申请中可用的费用类型（eg:交通费、住宿费） |
| 出行中 | |||
| 订单查询（全量） | GET | /tmc/v1/order/queryList | 根据时间范围获取在途系统中业务订单数据列表 |
| 订单查询（分页） | GET | /tmc/v1/order/queryList | 根据时间范围分页获取在途系统中业务订单数据列表 |
| 出行后 | |||
| 账单 - 查询账单主信息 | GET | /tmc/v1/bill/info | 根据账单code或时间范围查询账单数据列表。 |
| 账单 - 账单关联订单明细 | GET | /tmc/v1/bill/order | 根据账单code分页查询账单中包含的订单数据列表。 |
| 账单 - 确认账单通知 | POST | /tmc/v1/bill/confirmInvoice | OA系统确认获取到的账单信息无误后，通知商旅系统确认结果确认账单 |
| 账单 - 账单对账结果反馈 | POST | /tmc/v1/bill/billErrorInfo | OA系统核对账单后，通知商旅系统哪些订单有异议 |
事件订阅
API名称 | 请求方式 | 请求地址 | 说明 |
|---|---|---|---|
| 订阅事件 | POST | /tmc/v1/callback/register | 注册新的回调事件通知 |
| 删除订阅 | POST | /tmc/v1/callback/delete | 删除已注册的回调事件 |
| 查询订阅 | POST | /tmc/v1/callback | 查询已订阅的回调事件 |
通用数据
API名称 | 请求方式 | 请求地址 | 说明 |
|---|---|---|---|
| 国家编码对照表 | GET | /tmc/v1/basis/district | 国家码表 |
| 城市列表 | GET | /tmc/v1/basis/district | 获取在途系统中的标准城市数据列表 |