申请单同步接口

  • 接口：第三方提供
  • 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
amount BigDecimal 管控金额（整单管控） N
flightAmount BigDecimal 机票管控金额（产品管控） N
hotelAmount BigDecimal 酒店管控金额（产品管控） N
trainAmount BigDecimal 火车管控金额（产品管控） N
taxiAmount BigDecimal 用车管控金额（产品管控） 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
V1.2 2024.07.15 申请单行上增加扩展字段extraInfo
V1.3 2024.12.17 申请单头添加金额管控字段amount,flightAmount,hotelAmount,trainAmount,taxiAmount

results matching ""

    No results matching ""