# 在途商旅

## Docs
- [关于本文档](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2253626.md): 
- API调用指南 [API列表](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2251005.md): 
- API调用指南 [接入流程](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2251014.md): 
- API调用指南 [接口通用说明](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2251046.md): 
- API调用指南 [通用错误码](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2251052.md): 
- 服务端接口 > 一、鉴权管理 > 2、单点登录 [a、目标页概述](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2253025.md): 
- 服务端接口 > 二、企业信息 [1、概述](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2251107.md): 
- 服务端接口 > 二、企业信息 > 2、组织单位 [a、概述](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2247243.md): 
- 服务端接口 > 二、企业信息 > 2、组织单位 [b、常见问题](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2247266.md): 
- 服务端接口 > 二、企业信息 > 2、组织单位 [c、场景说明](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2247269.md): 
- 服务端接口 > 二、企业信息 > 3、员工信息 [概述](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2248520.md): 
- 服务端接口 > 二、企业信息 > 3、员工信息 [场景说明](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2248529.md): 
- 服务端接口 > 二、企业信息 > 3、员工信息 [常见问题](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2248527.md): 
- 服务端接口 > 二、企业信息 > 3、员工信息 [手机号国家编码表](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-4740718.md): 
- 服务端接口 > 二、企业信息 > 4、成本中心 [概述](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2248551.md): 
- 服务端接口 > 二、企业信息 > 4、成本中心 [常见问题](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2248553.md): 
- 服务端接口 > 二、企业信息 > 4、成本中心 [场景说明](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2248559.md): 
- 服务端接口 > 二、企业信息 > 5、项目 [概述](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2248596.md): 
- 服务端接口 > 二、企业信息 > 5、项目 [常见问题](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2248597.md): 
- 服务端接口 > 二、企业信息 > 5、项目 [场景说明](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2248601.md): 
- 服务端接口 > 二、企业信息 > 6、法人 [概述](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2248612.md): 
- 服务端接口 > 二、企业信息 > 6、法人 [常见问题](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2248614.md): 
- 服务端接口 > 三、业务数据 > 1.出行前 [概述](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2253275.md): 
- 服务端接口 > 三、业务数据 > 2.出行中 > 订单 [客票状态](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2267763.md): 
- 服务端接口 > 三、业务数据 > 3.出行后 > 票据 [订单开票信息](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2846916.md): 
- 服务端接口 > 三、业务数据 > 3.出行后 > 票据 [个付电子发票查询](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2969747.md): 
- 服务端接口 > 四、事件订阅 [1、概述](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2255119.md): 
- 服务端接口 > 四、事件订阅 [2、事件列表](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-3388021.md): 
- 服务端接口 > 四、事件订阅 [3、数据推送](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2261776.md): 
- 服务端接口 > 四、事件订阅 [4、示例代码](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2255339.md): 
- 服务端接口 > 四、事件订阅 [5、需求单服务类型](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2609117.md): 
- 服务端接口 > 四、事件订阅 [8、openapi-sdk](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-5981181.md): 
- 服务端接口 > 五、通用数据 [国家编码对照表](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-3198732.md): 

## API Docs
- 服务端接口 > 一、鉴权管理 > 1、接口鉴权 [a、获取token](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928159.md): access_token 是全局唯一的接口调用凭据，调用各接口时都需使用 access_token，对接方需妥善保存。access_token 需确保留有100个字符的存储空间。
- 服务端接口 > 一、鉴权管理 > 2、单点登录 [b、单点登录](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928156.md): 此接口用于获取指定编号员工登录到在途系统的自动登录链接。登录后可根据需要跳转到不同的目标页面，可查看 “目标页概述” 中的详细定义
- 服务端接口 > 二、企业信息 > 2、组织单位 [d、组织同步](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928164.md): 功能描述：此接口用于同步企业的组织单位数据至在途系统中，接口通过组织编码来作为组织的唯一标识。
- 服务端接口 > 二、企业信息 > 2、组织单位 [f、负责人同步](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-125569654.md): >> 功能描述：用于同步基础数据对应的负责人。适用于部门、成本中心负责人的同步；
- 服务端接口 > 二、企业信息 > 3、员工信息 [员工同步](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928161.md): > 功能描述：此接口用于同步企业的员工数据至在途系统中，此接口通过员工编号或邮箱来作为员工的唯一标识。
- 服务端接口 > 二、企业信息 > 3、员工信息 [员工直属主管同步](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-71562413.md): 功能描述：此接口用于同步员工的直属主管，
- 服务端接口 > 二、企业信息 > 3、员工信息 [员工常住地同步](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-92556598.md): > 功能描述：同步员工所属常住地到商旅系统，若一个用户有多个常驻地，则对应传多条数据；常驻地没有状态控制，根据员工号进行常住地覆盖操作
- 服务端接口 > 二、企业信息 > 3、员工信息 [获取职级列表](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-71557638.md): 功能描述：此接口用于获取企业在在途系统中配置的职级列表数据。
- 服务端接口 > 二、企业信息 > 3、员工信息 [获取证件类型](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-71561426.md): 功能描述：此接口用于获取在途系统中定义的证件类型数据
- 服务端接口 > 二、企业信息 > 3、员工信息 [员工信息查询](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-143617022.md): 
- 服务端接口 > 二、企业信息 > 4、成本中心 [成本中心（部门所属）](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928165.md): > 功能描述：同步某个组织和成本中心之间的关系，不同的组织下面可以有相同的成本中心
- 服务端接口 > 二、企业信息 > 4、成本中心 [成本中心（员工所属）](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-279438003.md): > 功能描述：同步某个部门下面的某个成本中心 和 员工之间的关系，即人员所属的成本中心；不同的部门下面可能会存在相同的成本中心，如果该部门下没有对应的成本中心，调用该接口同步员工所属成本中心会报错，提示没有该成本中心；一个员工可以有多个成本中心
- 服务端接口 > 二、企业信息 > 5、项目 [项目同步](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928167.md): > 功能描述：此接口用于同步项目信息至在途系统中，接口通过code来作为项目的唯一标识。
- 服务端接口 > 二、企业信息 > 6、法人 [法人同步](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928166.md): > 功能描述：此接口用于同步企业的法人信息至在途系统中，接口通过社会信用代码来作为法人的唯一标识。
- 服务端接口 > 三、业务数据 > 1.出行前 > 差旅申请 [申请单同步](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928158.md): > 功能描述：外部系统推送差旅申请单给在途系统，提交的差旅申请单如果不指定状态则默认设置为[有效]。对于编号相同的差旅申请单将作修改操作。
- 服务端接口 > 三、业务数据 > 1.出行前 > 差旅申请 [申请单变更前校验](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-242184950.md): > 使用前提：需要管控开启变更验证开关后此校验接口才会生效，不开启此接口无效
- 服务端接口 > 三、业务数据 > 1.出行前 > 差旅申请 [取消申请单提前验证](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-172814055.md): > 注意事项：如果需要验证申请单是否可以取消，那么在管控有个验证开关，开启后此接口才生效，这个是前提；
- 服务端接口 > 三、业务数据 > 1.出行前 > 差旅申请 [申请单状态变更](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-71405502.md): > 功能描述：此接口用于修改差旅申请单状态
- 服务端接口 > 三、业务数据 > 1.出行前 > 差旅申请 [获取申请单](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-71400469.md): > 功能描述：此接口用于获取在途系统差旅计划数据，返回结果为差旅计划数据。
- 服务端接口 > 三、业务数据 > 1.出行前 > 差旅申请 [获取申请单使用状态](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-71406525.md): > 功能描述：此接口用于查询差旅申请单是否已经使用过
- 服务端接口 > 三、业务数据 > 1.出行前 > 差旅申请 [获取申请单出行概况](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-119106695.md): > 用于查询申请单在出行过程中的商旅预订情况
- 服务端接口 > 三、业务数据 > 1.出行前 > 差旅申请 [获取差旅类型](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928155.md): > 功能描述：此接口用于获取企业在在途系统中配置的差旅类型数据。
- 服务端接口 > 三、业务数据 > 1.出行前 > 差旅申请 [获取费用类型](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-71393090.md): > 功能描述：此接口用于获取企业在在途系统中配置的差旅申请中的差旅预算管控可用的费用类型。例如：住宿费、交通费，可自定义
- 服务端接口 > 三、业务数据 > 2.出行中 > 订单 [订单查询（全量）](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928160.md): > 功能描述：此接口用于获取在途系统订单数据，返回结果为订单数据数组。
- 服务端接口 > 三、业务数据 > 2.出行中 > 订单 [订单查询（分页）](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-67416860.md): > 功能描述：此接口用于获取在途系统订单数据，返回结果为分页的订单数据数组。
- 服务端接口 > 三、业务数据 > 2.出行中 > 订单 [订单确认-V1](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-76811725.md): > 功能描述：适用于外部系统对当前订单已确认无误，并通知商旅系统。根据在途订单中的出行人的ID（travellerId）确认状态修改为已确认。
- 服务端接口 > 三、业务数据 > 2.出行中 > 订单 [订单确认-V2](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-203903005.md): > 功能描述：适用于外部系统对当前订单已确认无误，并通知商旅系统。根据在途订单号确认状态修改为已确认。
- 服务端接口 > 三、业务数据 > 3.出行后 > 账单 [获取账单主信息](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928168.md): > 功能描述：根据 账单号 或 账单时间 生成时间获取账单主信息
- 服务端接口 > 三、业务数据 > 3.出行后 > 账单 [分页获取账单主信息](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-246706861.md): > 功能描述：根据 账单号 或 账单时间 生成时间 分页获取账单主信息
- 服务端接口 > 三、业务数据 > 3.出行后 > 账单 [获取账单订单明细](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928169.md): > 功能描述：此接口用于分页查询账单关联订单信息
- 服务端接口 > 三、业务数据 > 3.出行后 > 账单 [账单中疑异订单通知](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928171.md): > 功能描述：若对账在客户方系统中确认，可调用此接口用于账单对账结果信息反馈给在途
- 服务端接口 > 三、业务数据 > 3.出行后 > 账单 [确认账单通知](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928170.md): > 功能描述：此接口用于确认账单且通知在途开票
- 服务端接口 > 三、业务数据 > 3.出行后 > 票据 [OCR票据查询](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-166275022.md): > 通过账单号查询 OCR电子扫描后的映像文件地址，出行人纬度的电子影像件
- 服务端接口 > 三、业务数据 > 3.出行后 > 票据 [订单数电票](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-284894615.md): > 功能描述：根据 订单号 或 账单号 获取相关票据
- 服务端接口 > 三、业务数据 > 4.工作流 [查询审批记录](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-60150621.md): 接口调用请求说明
- 服务端接口 > 三、业务数据 > 4.工作流 [审批结束通知](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928173.md): > 功能描述：使用外部系统进行业务审批后，通知在途系统审批结果。
- 服务端接口 > 三、业务数据 > 4.工作流 [审批记录同步](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-82777819.md): > 功能描述：OA系统将审批记录同步到商旅系统
- 服务端接口 > 四、事件订阅 > 6、事件订阅接口 [a、订阅事件](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-49928172.md): > 功能描述：可订阅多个。若想删除或者新增事件，需先删除已订阅的事件列表后，重新调用订阅事件接口进行注册。
- 服务端接口 > 四、事件订阅 > 6、事件订阅接口 [b、删除订阅](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-71658467.md): > 功能描述：删除已订阅的事件列表，不可删除部分事件
- 服务端接口 > 四、事件订阅 > 6、事件订阅接口 [c、查询订阅](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-71660063.md): > 功能描述：查询已订阅商旅系统的所有事件
- 服务端接口 > 五、通用数据 [获取城市列表(废弃)](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-71642207.md): 接口调用请求说明
- 服务端接口 > 五、通用数据 [获取城市列表V2](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-121033152.md): 接口调用请求说明 请求方法：POST 功能描述：此接口用于获取在途系统城市数据，返回结果为城市数据。新增了包含国内外的城市数据。
- 服务端接口 > 六、其他 [补贴查询](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-73163703.md): 
- 服务端接口 > 六、其他 [自定义补贴场景明细同步](https://apifox.com/apidoc/shared/dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/api-213879549.md):