> ## Documentation Index
> Fetch the complete documentation index at: https://adp-doc.laiye.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 业务工作流模板接入

> 查询财务应付、费用报销和金融财报模板，并通过共用工作流接口上传材料、运行和查询结果。

ADP 提供财务应付、费用报销和金融财报三个业务工作流模板。你可以查询模板的可运行状态，并通过同一套工作流接口处理材料。

## 模板目录

| 模板应用 | 应用类型 | `template_key` | 适用场景 |
| - | - | - | - |
| 财务应付 | 工作流 | `finance_payable` | 识别付款申请、合同、发票、入库、结算和验收材料，审核并交付应付业务结果。 |
| 费用报销 | 工作流 | `expense_reimbursement` | 识别报销申请、票据、出差审批、网约车行程和餐饮小票，按费用类型审核。 |
| 金融财报 | 工作流 | `financial_report_extraction` | 拆分财报，提取基础信息、利润表、资产负债表和现金流量表，并汇总结果。 |

## 查询模板和运行状态

使用[查询业务工作流模板](/api-reference/adp-api/workflows/list-business-workflow-templates)接口：

```http theme={null}
GET /open/agentic_engine/laiye/v1/app/templates?offset=0&size=20
X-API-Key: <你的 API Key>
```

从返回的 `data.list` 中按 `template_key` 选择模板。接口支持 `search` 按名称搜索，以及 `offset`、`size` 分页。

| 返回字段 | 使用方式 |
| - | - |
| `template_key` | 标识业务模板，用于在目录中精确选择目标方案。 |
| `application_id` | 用于文件上传和运行请求的稳定公开应用 ID。 |
| `is_added` | 当前 API Key 所属账号是否已添加该模板。 |
| `application_status` | 当前账号对应应用的状态，可能为 `draft`、`published` 或 `null`。 |
| `can_run` | 当前账号是否可以运行该模板；只有 `true` 时才提交运行请求。 |

<Info>
  模板可用性以实时查询结果为准。`can_run=false` 时，请先到 [ADP 工作台](https://adp.laiye.com/?utm_source=apidoc)添加、配置并发布对应应用，再重新查询。仅有 `application_id` 或 `is_added=true` 不代表可运行。
</Info>

## 准备材料

本地文件先通过[文件上传](/api-reference/adp-api/workflow-files/upload-doc-flow-file)接口上传。使用 `multipart/form-data`，将文件放入 `chunk`，`application_id` 使用模板查询返回的值，`sharing_scope` 使用 `application`。

将上传响应中的 `data.download_url` 填入运行请求的 `files[].url`，`data.file_name` 填入 `name`，`data.content_type` 填入 `mime_type`。每份材料对应一个文件项；已有可访问的公网 HTTP(S) 文件地址时，也可以直接填写 `url`、`name` 和 `mime_type`。

## 使用共用接口运行

三个模板使用相同的接口路径和请求结构，通过 `application_id` 区分目标模板应用：

| 操作 | 接口 |
| - | - |
| [同步运行](/api-reference/adp-api/workflows/run-doc-flow-app) | `POST /open/agentic_engine/laiye/v1/app/run` |
| [创建异步运行任务](/api-reference/adp-api/workflows/create-doc-flow-run-task) | `POST /open/agentic_engine/laiye/v1/app/run/create/task` |
| [查询运行结果](/api-reference/adp-api/workflows/query-doc-flow-run-task) | `GET /open/agentic_engine/laiye/v1/app/run/query/task/{run_id}` |

以下以金融财报为例。先确认该模板的 `can_run=true`，将文件信息替换为实际材料后，把相同的 JSON 请求体提交到同步或异步运行接口：

```json theme={null}
{
  "application_id": "wftp_app_y6p2m8q4v1c9t3x7n5r0h2k6",
  "files": [
    {
      "url": "https://example.com/annual-report.pdf",
      "name": "annual-report.pdf",
      "mime_type": "application/pdf"
    }
  ]
}
```

示例中的 `application_id` 是金融财报模板的稳定公开 ID。调用财务应付或费用报销时，使用对应模板返回的 `application_id` 和材料文件。

`files` 每项必填 `url`、`name`、`mime_type`，可选 `size`、`metadata`。`inputs` 按目标工作流已发布版本的实际入参配置填写；不需要额外参数时可省略。`release_version_id` 可省略，由服务选择已发布版本。

同步接口等待执行结束后返回。异步接口返回 `data.run_id` 后，使用结果查询接口获取状态和结果。确认 HTTP 请求成功、顶层 `code` 成功，且 `data.status=succeeded` 后，读取 `data.output`；运行失败时查看 `data.error`。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.