推送用车申请单

  • 接口（建议后缀）：/approval/car/save
  • Method：POST
  • 数据格式：Json
  • 调用方：每刻
  • 接口说明：员工提交用车申请单，经过每刻转换成申请单推送给第三方

请求参数

字段 类型 必填 描述
approvalNo String Y 申请单号
prevApprovalNo String N 变更上一个申请单号（只有变更后的申请单有）
originalApprovalNo String N 原始申请单号（只有变更后的申请单有）
formCode String Y 单据编码（由多个申请单组成的大单据的编码）
prevFormCode String N 变更上一个单据编码（只有变更后的申请单有）
originalFormCode String N 原始单据编码（只有变更后的申请单有）
formBizCode String Y 单据业务编码（通常为大单据在客户系统的编码）
prevFormBizCode String N 变更上一个单据业务编码（只有变更后的申请单有）
externalCorpCode String Y 企业在第三方中唯一编码
externalEmployeeCode String Y 下单人在第三方中唯一编码
purpose String N 出差事由
clientList List<Client> Y 乘车人列表 [1]
subsidiary Subsidiary N 申请单所属子公司
dept Department N 申请单所属部门
invTitle InvoiceTitle N 申请单开票抬头
departureCityList List<City> Y 出发城市列表
arrivalCityList List<City> Y 目的城市列表
cityCtrlLv int N 城市管控级别
allowCrossCity bool N 是否允许跨城
allowFlightPickUp bool N 是否允许接送机
flightPickUpTimes int N 每个城市接送机次数，默认2（依赖于是否开启接送机开关）
allowTrainPickUp bool N 是否允许接送火车
trainPickUpTimes int N 每个城市接送机次数，默认2（依赖于是否允许接送火车开关）
startDate Date Y 开始用车时间(yyyy-MM-dd HH:mm:ss)
endDate Date Y 结束用车时间(yyyy-MM-dd HH:mm:ss)
dateCtrlLv int N 日期管控级别
approvalCurrency String N 币种默认 CNY
approvalAmount BigDecimal N 申请单总额
amountCtrlLv int N 申请单总额管控级别
dailyAmount BigDecimal N 申请单每日限额
dailyAmountCtrlLv int N 申请单每日限额管控级别
occupyLimit bool N 是否占用员工每日限额（若员工有设置每日限额）
perOrderAmount BigDecimal N 每单限额
perOrderAmountCtrlLv int N 每单限额管控级别
carTypes List<String> N 可预定车型列表，车型
carTypeCtrlLv int N 车型管控级别
regulationId String N 用车规则ID，可按详见规则查询 [2]
approvers List<Approver> N 超标审批人列表
costCenterList List<CostCenter> N 成本中心列表
custField1 String [3] 自定义字段1
custField2 String [3] 自定义字段2
custField3 String [3] 自定义字段3
custField4 String [3] 自定义字段4
custField5 String [3] 自定义字段5
custField6 String [3] 自定义字段6
custField7 String [3] 自定义字段7
custField8 String [3] 自定义字段8

[info] 说明：
[1] 如果该列表为空时，只允许为自己预订。
[2] 若TMC能提供规则查询模式，则申请单的管控将按照TMC制度的管控内容管控；若没有则根据申请单的管控内容进行管控。
[3] 企业可能会有多个自定义字段，最多有8个。该字段需要提前固定含义，若要使用该字段，请先和每刻沟通。

车型枚举

code 定义
TAXI 出租车
ECONOMY 经济
PRIVILEGED 优享
PREMIER 舒适
BUSINESS 商务
LUXURY 豪华
DESIGNATED 代驾
ELECTRICAL 电动车
ENTRY_LIMOUSINE 入门高端轿车
LIMOUSINE 高端轿车
ELITE 精英型
SMALL_MPV 小型MPV
MIDSIZE_MPV 中型MPV
SMALL_SUV 小型SUV
MIDSIZE_SUV 中型SUV
LARGE_SUV 大型SUV
LUXURY_SUV 高端SUV
ELITE_SUV 精英型SUV
ELECTRICAL_SUV 电动SUV
BLINDBOX_ECONOMY 盲盒·经济型
BLINDBOX_PREMIER 盲盒·舒适型
BLINDBOX_SUV 盲盒·SUV型

Approver

字段 类型 必填 描述
externalEmployeeCode String Y 审批人在第三方中唯一标识
approverType OrderType Y 审批人管控的预定类型

OrderType

code 定义
ORDER 预订

响应结构

字段 类型 必填 描述
success bool Y 请求是否成功
errorMessage String N 失败信息(当 success 为 false 时，失败信息为必填)
data ExternalApproval N 关联申请单

ExternalApproval

目的是关联第三方系统中的申请单号，接下来所有使用到申请单号的地方，都将使用第三方提供的申请单号。

字段 类型 必填 描述
approvalNo String Y 每刻的申请单号
externalApprovalNo String Y 第三方系统中申请单的唯一标识 [5]

[info] 说明：
[5] 如果第三方不生成新的申请单号，使用每刻提供的 approvalNo，则按照 externalApprovalNo == approvalNo 返回。

示例

[warning] 重要：
示例维护并非和文档字段维护一样频繁，如果遇到示例和文档不一致，请以文档为准

请求头:

{
    "tokenId": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJtYXljdXJfand0X2Rldl9pZCIsInN1YiI6IlBGMjAwNjIwMTI1NU5GTk8iLCJpYXQiOjE2MDQ2MzA5NjYsImF1ZCI6IlBMQVRGT1JNIiwiZXhwIjoxNjA0NjM0NTY2LCJwcm9kdWN0TGluZSI6IkRBVEFfSFVCIn0.AyNIwPtGUXxFMuHO8Bx-4XeXNyWYRcot40MfsL1swr4"
}

请求示例:

{
  "approvalNo": "AE2007091BAZ2FWG",
  "formCode": "PC96136422941",
  "formBizCode": "ABC2406B01",
  "originalApprovalNo": null,
  "externalCorpCode": "0123456",
  "externalEmployeeCode": "f715c1xxx",
  "purpose": "青岛歌剧院探访 & 沟通",
  "cityCtrlLv": 1,
  "clientList": [
    {
      "name": "xxx",
      "externalEmployeeCode": "f715c1xxx",
      "phone": "139xxxxxxxx"
    }
  ],
  "dateCtrlLv": 0,
  "approvalAmount": 0.0000,
  "approvalCurrency": "CNY",
  "amountCtrlLv": 0,
  "amountCtrlType": 0,
  "orderIADays": 0,
  "orderIADaysCtrlLv": 0,
  "plusDaysAhead": 0,
  "plusDaysLater": 0,
  "subsidiary": {
    "subsidiaryCode": "SIxxxxxxxxxxxxxxx",
    "subsidiaryName": "天津歌剧营销有限公司",
    "isDefault": false
  },
  "dept": {
    "departmentCode": "DHDI42803480284",
    "departmentName": "芭蕾编舞推广事业组",
    "departmentHeirCode": "DHDI12341433214.DHDI123132154234152.DHDI12342143245432.DHDI7890452797592.DHDI42803480284",
    "departmentHeirName": "天津歌剧有限公司/天津歌剧营销有限公司/芭蕾舞部/芭蕾编舞事业部/芭蕾编舞推广事业组"
  },
  "invTitle": {
    "invoiceTitleCode": "SIyyyyyyyyyyyyyyyy",
    "invoiceTitleName": "天津歌剧营销有限公司",
    "taxNo": "913112334234236867687686674423N",
    "isDefault": true
  },
  "startDate": "2024-06-20 00:00:00",
  "endDate": "2024-06-20 23:59:59",
  "departureCityList": [
    {
      "code": "CF310115",
      "name": "浦东新区",
      "adminDivCode": "310115",
      "heirCode": "CHN001/CT310000/CF310115",
      "heirName": "中国/上海/浦东新区"
    }
  ],
  "arrivalCityList": [
    {
      "code": "CF310115",
      "name": "浦东新区",
      "adminDivCode": "310115",
      "heirCode": "CHN001/CT310000/CF310115",
      "heirName": "中国/上海/浦东新区"
    }
  ],
  "regulationId": "",
  "dailyAmount": 0,
  "perOrderAmount": 0,
  "carTypes": [
    "ECONOMY"
  ]
}

响应示例:

{
    "success":true,
    "errorMessage": null,
    "data": {
        "approvalNo" : "AE2007091BAZ2FWG",
        "externalApprovalNo" : "20200727090023001"

    }
}

results matching ""

    No results matching ""