申请单同步接口

  • 接口：第三方提供
  • Method：POST
  • 数据格式：JSON
  • 接口说明：该接口用于同步申请单
  • 文档末尾有文档版本记录

参数:

请求参数

ApprovelHeader

字段名称 字段类型 字段描述 是否必填
userNo String 申请单申请人对接关键字 Y
userId Integer 申请单申请人的云简员工号（优先传userNo，个别旧项目传userId，userId和userNo二选一） Y
account String 公司账户 Y
sessionId String 会话标识 Y
documentNum String 申请单号 Y
companyId Integer 申请单的云简公司编号 Y
employNumber String 申请人员工号 N
payUserId Integer 实际预定人的云简员工号 N
payEmployNumber String 实际预定人的云简员工号 N
startDatetime String 申请开始时间 Y
endDatetime String 申请结束时间 Y
status String 申请单状态，approved：审批通过，对应有效closed：关闭，对应无效 Y
statusName String 申请单状态的释义，以status为准 N
expiredTime String 申请单失效时间 N
description String 申请单备注 N
destinationCity Integer 出发城市编号 N
destinationCityName String 出发城市名 N
destinationCityTo Integer 到达城市编号 N
destinationCityToName String 到达城市名 N
fromCities List<Integer> 出发城市编号集 N
fromCityNames List<String> 出发城市名集 N
toCities List<Integer> 到达城市编号集 N
toCityNames List<String> 到达城市名集 N
costCenterCode String 成本中心代码 N
costCenterName String 成本中心名 N
departmentCode String 部门代码 N
departmentName String 部门名字 N
branchCode String 分公司代码 N
branchName String 分公司名字 N
projectCode String 项目代码 N
projectName String 项目名字 N
extraInfo JSONObject 扩展信息 N
lineInfoList List<ApprovelLine> 行信息 N

ApprovelLine

字段名称 字段类型 字段描述 是否必填
internalType String 行程类型(flight,hotel,train,taxi) Y
tripType Integer 1是单程，2是往返 Y
startDatetime String 申请开始时间（时间格式 yyyy-MM-dd HH:mm:ss） N
endDatetime String 申请结束时间（时间格式 yyyy-MM-dd HH:mm:ss） N
description String 申请单备注。 N
destinationCity Integer 出发城市编号 N
destinationCityName String 出发城市名 N
destinationCityTo Integer 到达城市编号 N
destinationCityToName String 到达城市名 N
fromCities List<Integer> 出发城市编号集 N
fromCityNames List<String> 出发城市名集 N
toCities List<Integer> 到达城市编号集 N
toCityNames List<String> 到达城市名集 N
amount decimal 总金额上限 N
price decimal 每日价格上限 N
averagePrice decimal 平均价的上限 N
discount decimal 机票折扣 N
quantity Integer 预定数量 N
currency String CNY N
seat String 云简的仓位编号 N
cabin String 仓位的名字（经济舱） N
cabinCode String F，Y，C，CY N
costCenterCode String 成本中心代码 N
costCenterName String 成本中心名 N
departmentCode String 部门代码 N
departmentName String 部门名字 N
branchCode String 分公司代码 N
branchName String 分公司名字 N
projectCode String 项目代码 N
projectName String 项目名字 N
extraInfo JSONObject 扩展信息 N
passengerList List<passenger> 出行人 N

passenger

字段名称 字段类型 字段描述 是否必填
passengerId Integer 出行人云简员工Id N
passengerNo String 出行人的对接key Y
passengerName String 出行人名字 N
employNumber String 出行人的员工号 N
passengerType String 出行人类型 N
passengerTypeId Integer 出行人的类型编号 N
nationality String 国籍 N
gender String 性别 N
carType String 证件类型 N
carTypeId Integer 证件类型编号 N
cardNo String 证件号码 N

返回参数

字段名称 字段类型 字段描述
resCode Integer 10000是成功
resMsg String success是成功，如果失败，则这里描述错误原因。

示例：

请求数据

{
 "documentNum": "",
 "userId": 1,
 "companyId": 11,
 "employNumber": "",
 "payUserId": 1,
 "payEmployNumber": "",
 "startDatetime": "",
 "endDatetime": "",
 "status": "",
 "statusName": "",
 "expiredTime": "",
 "description": "",
 "destinationCity": "",
 "destinationCityTo": "",
 "fromCities": "",
 "toCities": "",
 "costCenterCode": "",
 "costCenterName": "",
 "departmentCode": "",
 "departmentName": "",
 "branchCode": "",
 "branchName": "",
 "projectCode": "",
 "projectName": "",
 "lineInfoList": [
 {
 "internalType": "",
 "tripType": 1,
 "startDatetime": "",
 "endDatetime": "",
 "description": "",
 "destinationCity": "",
 "destinationCityTo": "",
 "fromCities": "",
 "toCities": "",
 "amount": "",
 "price": "",
 "averagePrice": "",
 "discount": "",
 "quantity": 1,
 "currency": "CNY",
 "seat": 1,
 "cabin": "经济舱",
 "cabinCode": "",
 "costCenterCode": "",
 "costCenterName": "",
 "departmentCode": "",
 "departmentName": "",
 "branchCode": "",
 "branchName": "",
 "projectCode": "",
 "projectName": "",
 "description": "",
 "passengerList": [
 {
 "passengerId": 1,
 "passengerName": "aa",
 "employNumber": "aa"
 }
 ]
 }
 ]
}

返回数据

{
    "resCode": 10000,
    "resMsg": "success"
}

文档版本记录

版本号 编写日期 更改内容
V1.0 2020.06.06 初稿
V1.1 2022.06.01 将userId调整为userNo
V1.2 2024.05.20 增加扩展字段extraInfo

results matching ""

    No results matching ""