推送用车申请单

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

请求参数

字段	类型	必填	描述
approvalNo	String	Y	申请单号
originalApprovalNo	String	N	原始申请单号（只有变更后的申请单有）
formCode	String	Y	单据编码（由多个申请单组成的大单据的编码）
formBizCode	String	Y	单据业务编码（通常为大单据在客户系统的编码）
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 ""