开发者中心

同步用车申请单

同步用车申请单

  • 企业自有审批系统申请的用车申请单同步到差旅平台
  • 目前只支持日常用车、加班打车申请单，差旅用车申请请使用出差申请单同步
  • 用车管控规则优先按企业申请单同步标准执行；若出行人为企业外部客户，则管控标准不限
  • 若企业有修改诉求，可通过该接口进行再次同步，系统会对同单号下全部信息做覆盖处理。

基本信息

请求方式：POST

请求地址：/napi/enterprise/approval/car/sync

请求参数定义

参数名参数说明必选参数类型长度值举例备注
msgId消息idYString1281000120150511190411000001企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode企业账号YString501000企业账号
tenantUserId租户用户idYString200HW_000001租户用户id
scene用车场景YString50NORMAL_CARNORMAL_CAR:日常用车
OVER_TIME_CAR:加班打车
applyTime申请时间NString1420241123154622yyyyMMddHHmmss，默认当前时间
approveTime审批时间NString1420241123164622yyyyMMddHHmmss，默认当前时间
outApprovalNo外部审批单号YString32HT20230423154622企业自有审批单号
remark用车事由NString1000客户现场
extendInfo扩展字段NString{"字段1":"值1","字段2":"值2"}扩展字段-JsonObject
cityList用车城市Y[City]200
benefitList受益信息N[Benefit]200
travellerList出行人N[Traveller]200出行人为空，默认tenantUserId作为出行人

City

参数名参数说明必填参数类型长度值举例备注
cityId城市IdYString9156310100
cityName城市名称NString上海
startDate用车开始日期NString820241123日常用车、加班打车仅支持一天，为空默认当天

Benefit

参数名参数说明必填参数类型长度值举例备注
benefitType受益类型YString50COST_CENTERCOST_CENTER:成本中心
PROJECT:项目
DEPARTMENT:部门
costcenterCode成本中心编码NString505678
costcenterName成本中心名称NString200
projectCode项目编码NString501234
projectName项目名称NString200
departmentCode部门编号NString501234
departmentName部门名称NString200
percentage分摊比例YString6501-100之间的数字。所有受益分摊比例相加必须等于100
extendInfo扩展信息NString5120{"data":"123"}JSON串，企业定制扩展信息

Traveller

参数名参数说明必填参数类型长度值举例备注
tenantUserId租户用户idNString200HW_000001
name名称NString100李某
mobile手机号NString1613012345678出行人手机号
carRuleList用车规则集合N[CarRule]10优先使用指定规则，若不传则按平台的企业配置管控

CarRule

参数名参数说明必填参数类型长度值举例备注
useType用车类型YStringNORMALNORMAL 打车AIR_TRANSFER 接送机，加班打车不支持接送机
rideTypeList名称NStringECONOMYECONOMY 经济 COMFORTABLE 舒适 BUSINESS 商务 LUXURY 豪华
amountLimitList金额限制N[AmountLimit]不传则金额不限

AmountLimit

参数名参数说明必填参数类型长度值举例备注
limitType限制类型YStringSINGLESINGLE 单次
amount金额NBigDecimal100金额
currency币种NStringCNY币种固定CNY

响应参数定义

参数名参数说明必填参数类型长度值举例备注
resultCode返回码YString00表示成功，其他值为失败。
description描述YString操作成功描述信息，出错时为错误信息即错误原因。
data数据YResult

Result

参数名参数说明必填参数类型长度值举例备注
approvalNo慧通审批单号YString12TA0612275920

样例

请求

{
  "msgId": "0008120220929071248283828",
  "corpCode": "0008",
  "tenantUserId": "26215236521",
  "scene": "NORMAL_CAR",
  "applyTime": "20241123154622",
  "approveTime": "20241123164622",
  "outApprovalNo": "TR2022092907124864692",
  "remark": "用车事由",
  "extendInfo": {"responsibilityCenter": "001", "responsibilityCode": "002"},
  "cityList": [
    {
      "cityId": "156320100",
      "cityName": "南京",
      "startDate": "20241123"
    }
  ],
  "benefitList": [
    {
      "benefitType": "COST_CENTER",
      "costcenterCode": "001",
      "costcenterName": "信息管理本部",
      "projectCode": "项目编码",
      "projectName": "项目名称",
      "departmentCode": "部门编码",
      "departmentName": "部门名称",
      "percentage": "100",
      "extendInfo": "{\"settlementUnitCode\":\"3000006\"}"
    }
  ],
  "travellerList": [
    {
      "tenantUserId": "HW_000001",
      "name": "李某",
      "mobile": "13012345678",
      "carRuleList": [
        {
          "useType": "NORMAL",
          "rideTypeList": [
            "ECONOMY",
            "COMFORTABLE"
          ],
          "amountLimitList": [
            {
              "limitType": "SINGLE",
              "amount": 15,
              "currency":"CNY"
            },
            {
              "limitType": "DAY",
              "amount": 180,
              "currency":"CNY"
            },
            {
              "limitType": "MONTH",
              "amount": 250,
              "currency":"CNY"
            }
          ]
        },
        {
          "useType": "AIR_TRANSFER",
          "rideTypeList": [
            "ECONOMY",
            "COMFORTABLE",
            "BUSINESS"
          ],
          "amountLimitList": [
            {
              "limitType": "SINGLE",
              "amount": 30,
              "currency":"CNY"
            },
            {
              "limitType": "DAY",
              "amount": 150,
              "currency":"CNY"
            },
            {
              "limitType": "MONTH",
              "amount": 220,
              "currency":"CNY"
            }
          ]
        }
      ]
    }
  ]
}

返回

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "approvalNo": "TA0612275920"
  }
}