企业用车申请单接口
1 企业用车申请单同步
1.1 接入说明
美团企业版为客户提供了用车申请、审批等功能，如果企业客户希望在内部系统完成用车申请，申请单内部审批通过后，在美团企业版进行用车消费，则可以通过本文档进行接口对接。流程如下
- 企业内部完成用车申请，在审批通过后，通过调用接口将用车申请信息同步给美团企业版
- 企业员工进入美团企业版首页，选择对应的用车申请单进行用车预订
- 美团企业版根据用车规则提供可用车型，预订时校验相关规则标准
1.2 接口说明
| 名称 | 描述 |
|---|
| 功能 | 同步用车申请单 |
| HTTP方法 | POST |
| 请求方 | 第三方渠道 |
| 响应方 | 美团企业版平台 |
| uri | /car/apply/sync |
| method | car.apply.sync |
1.3 公共参数
详见：公共参数说明-公共请求参数
1.4 业务请求参数
| 名称 | 类型 | 是否非空 | 说明 |
|---|
| outCarApplyList | List<OutCarApply> | 是 | 同步的用车申请列表，单次最多同步10单（默认同步的所有单据均为审批通过状态） |
OutCarApply 字段说明
| 名称 | 类型 | 是否非空 | 说明 |
|---|
| sceneType | Integer | 是 | 用车场景：2-企业用车 |
| outApplyNo | String | 是 | 外部申请单号 |
| rulePackNo | String | 是 | 规则包编码（需提前在企业后台进行用车规则配置） |
| applyType | Integer | 是 | 申请单类型：201-按次数申请；202-按日期申请 |
| submitStaff | StaffInfo | 是 | 提交人信息 |
| applyReason | String | 是 | 申请事由说明（限制：200个字符以内） |
| applyCount | Integer | 否 | 申请数量（用车次数） |
| applyAmount | Integer | 否 | 申请金额（分），示例：20000（200元） |
| scheduleList | List<ScheduleInfo> | 是 | 用车日程列表(当前仅支持单个日程) |
| costCenterList | List<CostCenterInfo> | 否 | 成本中心列表(当前仅支持单个成本中心) |
StaffInfo 字段说明
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|
| name | String | 否 | 张三 | 员工姓名 |
| entStaffNum | String | 是 | C20210322 | 企业对该员工的唯一标识 |
ScheduleInfo 字段说明
| 名称 | 类型 | 是否必填 | 说明 |
|---|
| startTime | Long | 是 | 开始时间（ms时间戳） |
| endTime | Long | 是 | 结束时间（ms时间戳） |
| scheduleType | Integer | 否 | 日程类型（默认0）：0-不限；1-单程；2-往返 |
| cityList | List<CityInfo> | 否 | 城市信息列表 |
CityInfo 字段说明
| 名称 | 类型 | 是否必填 | 说明 |
|---|
| cityType | Integer | 是 | 城市类型：10-不区分出发或到达的城市；11-出发地城市；12-目的地城市 |
| citySource | Integer | 否 | 城市数据来源（默认10）：10-境内location；20-境外city |
| cityId | String | 是 | 城市编号(国标code)，示例：110000 |
| cityName | String | 是 | 城市名称，示例：北京市 |
| address | String | 否 | 出发地址，示例：望京国际研发园 |
| lng | String | 否 | 出发地经度，示例：116.488634 |
| lat | String | 否 | 出发地纬度，示例：40.007064 |
CostCenterInfo 字段说明
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|
| costNo | String | 是 | CC01 | 成本中心编码(限制最多30个字符) |
| costName | String | 是 | 成本中心01 | 成本中心名称(限制最多128个字符) |
1.5 业务响应
| 名称 | 类型 | 说明 |
|---|
| status | Integer | 0: 调用成功，其他值均为: 调用失败 |
| msg | String | 失败时的错误描述 |
| data | List<ApplySyncResult.Body> | 请求成功时的响应数据 |
ApplySyncResult.Body 字段说明
| 名称 | 类型 | 是否非空 | 说明 |
|---|
| sqtApplyNo | String | 是 | 美团企业版申请单号 |
| outApplyNo | String | 是 | 外部申请单号 |
| result | Integer | 是 | 0: 同步成功，其他值均为: 同步失败 |
| msg | String | 是 | 同步成功或失败描述 |
2 查询用车申请详情列表
2.1 接入说明
美团企业版为客户提供了用车申请、审批等功能，如果企业客户希望在内部系统完成用车申请，但是需要通过接口查询用车申请单信息的功能，则可以通过本文档进行对接。流程如下：
- 企业内部系统发起对美团企业版的接口调用。
- 美团企业版组装用车申请业务数据，返回给企业。
2.2 接口说明
| 名称 | 描述 |
|---|
| 功能 | 查询用车申请详情列表 |
| HTTP方法 | POST |
| 请求方 | 第三方渠道 |
| 响应方 | 美团企业版平台 |
| uri | /car/apply/query/detail/page |
| method | car.apply.detail.query.page |
2.3 公共参数
详见：公共参数说明-公共请求参数
2.4 业务请求参数
| 名称 | 类型 | 是否非空 | 说明 |
|---|
| pageNum | Integer | 是 | 当前页数，限制[1,100] |
| pageSize | Integer | 是 | 每页条数，限制[1,20] |
| sqtApplyNoList | List | 否 | 美团企业版申请单号列表(限制最多20个单号) |
| outApplyNoList | List | 否 | 外部申请单号列表(限制最多20个单号) |
| createTimeFrom | Long | 否 | 创建时间查询开始（ms时间戳） |
| createTimeTo | Long | 否 | 创建时间查询终止（ms时间戳） |
2.5 业务响应
| 名称 | 类型 | 是否非空 | 说明 |
|---|
| status | Integer | 是 | 请求响应码 |
| msg | String | 是 | 请求响应信息 |
| data | String | 是 | 请求响应数据，内部是Json格式数据 |
Json格式数据说明
| 名称 | 类型 | 是否非空 | 说明 |
|---|
| pageNum | Integer | 是 | 当前页码 |
| pageSize | Integer | 是 | 当前页大小，限制(0,50) |
| totalPages | Integer | 是 | 结果集总页数 |
| totalCount | Long | 是 | 结果集数据总量 |
| result | List<SqtApplyDetail> | 否 | 申请单详情数据列表 |
SqtApplyDetail 字段说明
| 名称 | 类型 | 是否非空 | 说明 |
|---|
| sceneType | String | 是 | 用车场景：2-企业用车 |
| sqtApplyNo | String | 是 | 美团企业版申请单号 |
| outApplyNo | String | 否 | 外部申请单号 |
| rulePackNo | String | 是 | 规则包编码 |
| applyName | String | 是 | 申请单名称 |
| applyType | Integer | 是 | 申请单类型：201-按次数申请；202-按日期申请 |
| submitStaff | StaffInfo | 是 | 提交人信息 |
| applyReason | String | 否 | 申请事由说明（限制：200个字符以内） |
| applyCount | Integer | 否 | 申请数量（用车次数） |
| applyAmount | Long | 否 | 申请金额（分），示例：20000（200元） |
| scheduleList | List<ScheduleInfo> | 是 | 用车日程列表 |
| costCenterList | List<CostCenterInfo> | 否 | 成本中心列表 |
| workflowStatus | Integer | 是 | 流程状态：20-审批中；30-已撤回；40-已驳回；60-已完成（审批通过） |
| dataStatus | Integer | 是 | 数据状态：20-正式；30-废弃 |
| createTime | Long | 是 | 创建时间（ms时间戳） |
| sqtBizOrderIdList | List | 否 | 美团企业版订单ID列表 |
3 作废用车申请单
3.1 接入说明
美团企业版为客户提供了用车申请、报备、审批等功能，如果企业客户已经同步企业内部的申请单，但之后需要作废已导入的单据（作废单据可见但不可继续使用），则可以通过本文档进行接口对接。流程如下：
- 企业内部系统发起对美团企业版的接口调用。
- 美团企业版组返回单据作废结果给企业。
3.2 接口说明
| 名称 | 描述 |
|---|
| 功能 | 作废用车申请单 |
| HTTP方法 | POST |
| 请求方 | 第三方渠道 |
| 响应方 | 美团企业版平台 |
| uri | /car/apply/cancel |
| method | car.apply.cancel |
3.3 公共参数
详见：公共参数说明-公共请求参数
3.4 业务请求参数
| 名称 | 类型 | 是否非空 | 说明 |
|---|
| outApplyNoList | List | 是 | 外部关联申请单号列表，单次最多操作10单 |
3.5 业务响应
ApplyCancelResult.Body 字段说明
| 名称 | 类型 | 是否非空 | 说明 |
|---|
| sqtApplyNo | String | 是 | 美团企业版申请单号 |
| outApplyNo | String | 是 | 外部申请单号 |
| result | Integer | 是 | 0: 作废成功，其他值均为: 作废失败 |
| msg | String | 是 | 作废成功或失败描述 |