在途商旅
  1. 5、项目
在途商旅
  • 关于本文档
  • API调用指南
    • API列表
    • 接入流程
    • 接口通用说明
    • 通用错误码
  • 服务端接口
    • 一、鉴权管理
      • 1、接口鉴权
        • a、获取token
      • 2、单点登录
        • a、目标页概述
        • b、单点登录
    • 二、企业信息
      • 1、概述
      • 2、组织单位
        • a、概述
        • b、常见问题
        • c、场景说明
        • d、组织同步
        • f、负责人同步
      • 3、员工信息
        • 概述
        • 场景说明
        • 常见问题
        • 手机号国家编码表
        • 员工同步
        • 员工直属主管同步
        • 员工常住地同步
        • 获取职级列表
        • 获取证件类型
        • 员工信息查询
      • 4、成本中心
        • 概述
        • 常见问题
        • 场景说明
        • 成本中心(部门所属)
        • 成本中心(员工所属)
      • 5、项目
        • 概述
        • 常见问题
        • 场景说明
        • 项目同步
          POST
      • 6、法人
        • 概述
        • 常见问题
        • 法人同步
    • 三、业务数据
      • 1.出行前
        • 概述
        • 差旅申请
          • 申请单同步
          • 申请单变更前校验
          • 取消申请单提前验证
          • 申请单状态变更
          • 获取申请单
          • 获取申请单使用状态
          • 获取申请单出行概况
          • 获取差旅类型
          • 获取费用类型
      • 2.出行中
        • 订单
          • 客票状态
          • 订单查询(全量)
          • 订单查询(分页)
          • 订单确认-V1
          • 订单确认-V2
      • 3.出行后
        • 账单
          • 获取账单主信息
          • 分页获取账单主信息
          • 获取账单订单明细
          • 账单中疑异订单通知
          • 确认账单通知
        • 票据
          • 订单开票信息
          • 个付电子发票查询
          • OCR票据查询
          • 订单数电票
      • 4.工作流
        • 查询审批记录
        • 审批结束通知
        • 审批记录同步
    • 四、事件订阅
      • 1、概述
      • 2、事件列表
      • 3、数据推送
      • 4、示例代码
      • 5、需求单服务类型
      • 8、openapi-sdk
      • 6、事件订阅接口
        • a、订阅事件
        • b、删除订阅
        • c、查询订阅
    • 五、通用数据
      • 国家编码对照表
      • 获取城市列表(废弃)
      • 获取城市列表V2
    • 六、其他
      • 补贴查询
      • 自定义补贴场景明细同步
  1. 5、项目

项目同步

测试环境
https://openapi-uat.z-trip.cn
测试环境
https://openapi-uat.z-trip.cn
POST
/tmc/v1/project/sync
功能描述:此接口用于同步项目信息至在途系统中,接口通过code来作为项目的唯一标识。
入参数据量不能大于100条,大小不能超过10M
限流说明:同一时刻最多处理100条数据同步(如果单次请求携带100条数据,则只能并发1个请求;如果单次请求携带1条数据,则最多并发100个请求),超过返回错误码:RATE_LIMITED

请求参数

Query 参数
access_token
string 
请求token
必需
示例值:
{{openApiToken}}
Body 参数application/json
array of:
code
string 
项目代码
必需
<= 50 字符
name
string 
项目名称
必需
<= 200 字符
orgCode
string 
项目所属部门代码
必需
<= 50 字符
status
enum<integer> 
可选
状态(0、正常,1、停用,默认0)
枚举值:
01
默认值:
0
pCode
string 
上级项目代码
可选
<= 50 字符
empCode
string 
项目责任人编码
可选
<= 50 字符
costCenterCode
string 
成本中心编码
可选
<= 50 字符
orgCodes
array[string]
权限部门
可选
所属权限的部门列表;若不传则是所有部门都有权限;若传了具体部门,则只有所传部门有权限选择;权限部门和权限人员根据企业配置只会生效一个。
empCodes
array[string]
权限人员
可选
所属权限的人员列表;若不传则是所有人员都有权限;若传了具体人员,则只有所传人员有权限选择;权限部门和权限人员根据企业配置只会生效一个。
projectType
string 
可选
项目类型(由在途提供 项目类型code)
<= 100 字符
containChildOrgAuthStatus
boolean 
必需
权限部门是否包含下级部门,如果包含,则当前部门下的子部门也有权限选择;
包含:true;
不包含:false;
默认false
companyCode
string 
可选
项目所属法人自定义编码
示例
[
  {
    "code": "ABC",
    "name": "项目部",
    "orgCode": "DEF",
    "status": 0,
    "pCode": "BCD",
    "costCenterCode": "A1",
    "orgCodes": [
      "DEF",
      "CJD"
    ],
    "projectType": "f5c70aca-6939-4128-ae16-b375d5d1234",
    "companyCode": "10001"
  }
]

返回响应

🟢200成功
application/json
Body
object {0}
示例
{
  "error": "0",
  "data": "同步成功!",
  "error_description": "成功"
}
上一页
场景说明
下一页
概述
Built with