# 创建用车审批流程实例接口

## 接口说明

该接口用于外部系统向 E10 发起用车审批流程实例。

## 前置条件

### 获取 access_token

E10 OpenAPI 使用 OAuth2 code 换取 access_token 的方式。业务接口调用时，`access_token` 作为请求体参数传入，不通过 HTTP `Authorization` Header 传入。

#### Step 1: 获取 code

- **URL**: `POST https://<E10_BASE>/papi/openapi/oauth2/authorize`
- **Content-Type**: `application/json`

| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| `corpid` | 是 | String | 企业 corpId。 |
| `response_type` | 是 | String | 固定为 `code`。 |
| `state` | 是 | String | 自定义参数。 |

#### Step 2: code 换 access_token

- **URL**: `POST https://<E10_BASE>/papi/openapi/oauth2/access_token`
- **Content-Type**: `application/json`

| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| `app_key` | 是 | String | 应用 key。 |
| `app_secret` | 是 | String | 应用密钥。 |
| `grant_type` | 是 | String | 固定为 `authorization_code`。 |
| `code` | 是 | String | 授权 code。 |

## 身份标识转换

外部系统应使用工号和部门编号等外部稳定标识传值。人员字段使用 `userType: "JOB_NUM"`，部门字段使用 `deptType: "DEPT_CODE"`。

## 请求信息

- **URL**: `POST https://<E10_BASE>/papi/openapi/<WORKFLOW_INSTANCE_PATH>`
- **Content-Type**: `application/json`

## 请求示例

### 最小请求

```bash
curl -X POST "https://<E10_BASE>/papi/openapi/<WORKFLOW_INSTANCE_PATH>" \
  -H "Content-Type: application/json" \
  -d '{
    "access_token": "<ACCESS_TOKEN>",
    "userType": "JOB_NUM",
    "deptType": "DEPT_CODE",
    "formData": {
      "dataDetails": [
        {
          "dataKey": "applicant",
          "dataOptions": [
            {"type": "resource", "value": "EMP001", "userType": "JOB_NUM"}
          ]
        },
        {
          "dataKey": "vehicleDate",
          "content": "2026-06-01"
        }
      ]
    }
  }'
```

## 流程字段说明

### 申请信息

| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 申请人 | Employee | 需确认 | 人员字段，通过 `dataOptions` 传值，建议使用工号。 |
| 申请部门 | Department | 需确认 | 部门字段，通过 `dataOptions` 传值，建议使用部门编号。 |

### 用车信息

| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 用车日期 | Date | 需确认 | 日期字符串。 |
| 用车事由 | TextArea | 需确认 | 用车原因说明。 |