weaver-work-cli 0.1.25 → 0.1.26

package/skills/weaver-e10-yepiaotong/references/reim-api-reference.md

@@ -1,7 +1,8 @@
 # 报销 CLI operation 参考文档
 
-> 本文件说明各报销 CLI operation 的入参、返回字段和填单用法。
+> 本文件说明报销**数据准备**阶段各 CLI operation 的入参、返回字段和填单用法。
 > 实际调用必须通过 `weaver-work-cli --json invoice run <operation>` 执行。认证由 `weaver-work-cli auth` 管理，不要手动传 token / eteamsId。
+> 报销单的创建与修改不在本文件：统一走 `weaver-e10-workflow` 的 `workflow.createForm` / `workflow.createRequest` / `workflow.edit*`，见第 6 节。
 
 ---
 
@@ -296,8 +297,8 @@ CLI 信封中列表在 `data.items`。下面是单条发票的票面结构（对
 
 | 分类 | type 值 | 说明 | 填单位置 |
 | --- | --- | --- | --- |
-| **发票** | 除 17/18/57/58 以外的所有值 | 正式发票，每张独立成一行明细 | `EinvoiceComponent` + `single=false`（相关发票字段） |
-| **相关凭证** | 17, 18, 57, 58 | 行程单、小票/水单、电子支付凭证、其他支付凭证，不能独立成行 | `EinvoiceComponent` + `single=true`（相关凭证字段） |
+| **发票** | 除 17/18/57/58 以外的所有值 | 正式发票，每张独立成一行明细 | 明细「相关发票」（`EinvoiceComponent`） |
+| **相关凭证** | 17, 18, 57, 58 | 行程单、小票/水单、电子支付凭证、其他支付凭证，不能独立成行 | 明细「相关凭证」（`EinvoiceComponent`），每行最多 1 张 |
 
 **关键规则：相关凭证必须与发票配对，放在同一行明细中，不能单独成行。**
 
@@ -363,6 +364,33 @@ CLI 信封中列表在 `data.items`。下面是单条发票的票面结构（对
 
 ---
 
+## 1b. 报销候选发票分类
+
+CLI operation：`invoice.reim.candidates.list`（read）
+
+自动翻页拉取未报销（sreim=3）发票，并按 `oreim.list_reim` / 红冲状态分组，**不再需要手动翻页和逐条剔重**。
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json invoice run invoice.reim.candidates.list --input-json '{"date_begin":"2026-09-14","date_end":"2026-09-21"}'
+```
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.reim.candidates.list --input-json '{"date_begin":"2026-09-14","date_end":"2026-09-21"}'
+```
+
+- 入参（全部可选）：`date_begin`/`date_end`（YYYY-MM-DD，开票日期范围）、`page_size`（10-200，默认 50）、`max_items`（1-500，默认 200，超出截断并产生 warning）、`include_red_reversed`（默认 `false`）。
+- **红冲票默认已过滤**：全额红冲发票（`status=8`）不出现在任何一组，被过滤的张数由 `summary.filteredRedReversedCount` 告知。需要看红冲票时传 `include_red_reversed: true`，此时它们进 `redReversed` 组。
+- 输出：`available` / `assigned` / `redReversed` 三组，每组元素含 `fid`、`number`、`date`、`total`、`buyer`、`payer`、`typeName`、`status`、`valid`、`reimRequests`；`summary` 给出三组的张数与金额合计；`warnings` 含截断与金额解析告警。
+- **报销范围永远从 `available` 里选**；`assigned` 是已挂在报销单上的（再报 = 重复报销）。
+- `sreim="3"`（未报销）**不会**排除已挂单的发票，判断是否已挂单必须看分组结果（即 `list_reim`）。
+- 两次查询之间发票从 `assigned` 翻到 `available`，通常是原报销单被删除、发票被真实释放，分类本身是准的；只有对某张票的归属存疑时，才用 `weaver-work-cli workflow run workflow.detail --input-json '{"requestId":"<id>"}'` 核实原单是否还在，不要每次报销都逐张复核。
+
+---
+
 ## 2. 查询事前申请流程列表
 
 CLI operation：`invoice.reim.requests.list`
@@ -477,241 +505,6 @@ weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pa
 | `nodeid`              | 当前节点ID                 |
 
 
----
-
-## 3. 获取报销单表单字段结构
-
-CLI operation：`invoice.reim.form.structure`
-
-### 入参
-
-
-| 参数           | 类型     | 必填  | 说明           |
-| ------------ | ------ | --- | ------------ |
-| `workflowId` | String | 是   | 工作流ID        |
-| `nodeId`     | String | 否   | 节点ID，默认 `1` |
-
-
-### 命令
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.reim.form.structure --input-json '{"workflowId":"1181057526276915214"}'
-```
-
-macOS/Linux（bash/zsh）：
-
-```bash
-weaver-work-cli --json invoice run invoice.reim.form.structure --input-json '{"workflowId":"1181057526276915214"}'
-```
-
-### 返回示例
-
-```json
-{
-  "code": 200,
-  "msg": "接口返回成功",
-  "status": true,
-  "data": {
-    "mainFormId": "1181057741029226975",
-    "mainFields": [
-      {
-        "fieldId": "1181057741029227445",
-        "fieldName": "申请人",
-        "fieldType": "Employee",
-        "single": true,
-        "marked": true
-      },
-      {
-        "fieldId": "1181057741029227446",
-        "fieldName": "部门",
-        "fieldType": "Department",
-        "single": true,
-        "marked": true
-      },
-      {
-        "fieldId": "1181057741029227447",
-        "fieldName": "报销日期",
-        "fieldType": "DateComponent",
-        "single": true,
-        "marked": false
-      },
-      {
-        "fieldId": "1181057741029227448",
-        "fieldName": "相关人员",
-        "fieldType": "Text",
-        "single": true,
-        "marked": false
-      },
-      {
-        "fieldId": "1181057741029227454",
-        "fieldName": "报销方式",
-        "fieldType": "Select",
-        "single": true,
-        "marked": false,
-        "options": [
-          {"optionId": "1181057741029227903", "optionName": "银行（个人报销）", "optionValue": "7"},
-          {"optionId": "1181057741029227900", "optionName": "冲销借款", "optionValue": "4"},
-          {"optionId": "1181057741029227904", "optionName": "银行（付公司）", "optionValue": "6"}
-        ]
-      },
-      {
-        "fieldId": "1181057741029227456",
-        "fieldName": "报销事由",
-        "fieldType": "TextArea",
-        "single": false,
-        "marked": false
-      },
-      {
-        "fieldId": "1181057741029227470",
-        "fieldName": "相关流程",
-        "fieldType": "Workflow",
-        "single": false,
-        "marked": true
-      }
-    ],
-    "subTables": [
-      {
-        "subFormId": "1181057741029227992",
-        "subFormName": "费用明细",
-        "subFields": [
-          {
-            "fieldId": "1181057741029227449",
-            "fieldName": "相关客户",
-            "fieldType": "Ebuilder",
-            "single": true,
-            "marked": true
-          },
-          {
-            "fieldId": "1181057741029227450",
-            "fieldName": "相关项目",
-            "fieldType": "Ebuilder",
-            "single": true,
-            "marked": true
-          },
-          {
-            "fieldId": "1181057741029227459",
-            "fieldName": "实报金额",
-            "fieldType": "Money",
-            "single": true,
-            "marked": false
-          },
-          {
-            "fieldId": "1181057741029227463",
-            "fieldName": "费用类型（科目）",
-            "fieldType": "RelateBrowser",
-            "single": true,
-            "marked": true
-          },
-          {
-            "fieldId": "1181057741029227464",
-            "fieldName": "费用说明",
-            "fieldType": "Text",
-            "single": false,
-            "marked": false
-          },
-          {
-            "fieldId": "1181057741029227465",
-            "fieldName": "附件数",
-            "fieldType": "NumberComponent",
-            "single": true,
-            "marked": false
-          },
-          {
-            "fieldId": "1181057741029227467",
-            "fieldName": "费用日期",
-            "fieldType": "DateComponent",
-            "single": true,
-            "marked": false
-          }
-        ]
-      }
-    ]
-  },
-  "fail": false
-}
-```
-
-### 字段类型对照表
-
-
-| fieldType         | 说明         | fieldValue 格式 | 示例                      |
-| ----------------- | ---------- | ------------- | ----------------------- |
-| `Employee`        | 员工选择       | 用户ID          | `"1201729946891231232"` |
-| `Department`      | 部门选择       | 部门ID          | `"1201729461554241537"` |
-| `DateComponent`   | 日期         | yyyy-MM-dd    | `"2026-08-04"`          |
-| `Text`            | 单行文本       | 文本字符串         | `"差旅报销"`                |
-| `TextArea`        | 多行文本       | 文本字符串         | `"详细说明..."`             |
-| `Select`          | 下拉选择       | optionValue 值 | `"7"`                   |
-| `Money`           | 金额         | 数字字符串         | `"820.00"`              |
-| `NumberComponent` | 数字         | 数字字符串         | `"5"`                   |
-| `Workflow`        | 关联流程       | 流程requestId   | `"1298294241967177729"` |
-| `RelateBrowser`   | 关联浏览       | 关联数据ID        | `"2087459027187551811"` |
-| `Ebuilder`        | Ebuilder关联 | 关联数据ID        | `"2087459027187551811"` |
-
-
----
-
-## 4. 模糊搜索字段关联值
-
-CLI operation：`invoice.reim.field.search`
-
-用于 `marked = true` 的字段，通过名称关键词查找对应的数据ID。
-
-### 入参
-
-
-| 参数             | 类型     | 必填  | 说明            |
-| -------------- | ------ | --- | ------------- |
-| `keywords`     | String | 是   | 搜索关键词         |
-| `fieldId`      | String | 是   | 目标字段的 fieldId |
-| `workflowId`   | String | 是   | 工作流ID         |
-| `nodeId`       | String | 否   | 默认由 CLI 填充 |
-
-
-### 命令
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.reim.field.search --input-json '{"keywords":"强","fieldId":"1250065066476052720","workflowId":"1250064959163990031"}'
-```
-
-macOS/Linux（bash/zsh）：
-
-```bash
-weaver-work-cli --json invoice run invoice.reim.field.search --input-json '{"keywords":"强","fieldId":"1250065066476052720","workflowId":"1250064959163990031"}'
-```
-
-### 返回示例
-
-```json
-{
-  "code": 200,
-  "msg": "接口返回成功",
-  "status": true,
-  "data": [
-    {
-      "name": "袁强强",
-      "id": "2765669800318484102",
-      "value": "2765669800318484102"
-    }
-  ],
-  "fail": false
-}
-```
-
-### 使用策略
-
-
-| 返回结果数 | 处理方式                                   |
-| ----- | -------------------------------------- |
-| 1个    | 直接使用 `value` 作为 `fieldValue`           |
-| 多个    | 展示候选列表让用户选择                            |
-| 0个    | 缩短关键词重试；仍无结果则 `fieldValue` 留空，提示用户手动填写 |
-
-
 ---
 
 ## 5. 获取报销单工作流ID
@@ -769,7 +562,7 @@ weaver-work-cli --json invoice run invoice.reim.workflow.resolve --input-json '{
 | 字段                                           | 说明                                              |
 | -------------------------------------------- | ----------------------------------------------- |
 | `requestWorkflowMap`                         | 事前申请ID → 对应报销单工作流的映射                            |
-| `requestWorkflowMap[requestId].workFlowId`   | 对应的报销单工作流ID（用于 `invoice.reim.form.structure` 和 work_flow_id） |
+| `requestWorkflowMap[requestId].workFlowId`   | 对应的报销单工作流ID（与 `workFlowName` 拼成 `名称(ID)` 传给 `workflow.createForm`） |
 | `requestWorkflowMap[requestId].workFlowName` | 报销单流程名称                                         |
 
 
@@ -839,7 +632,7 @@ weaver-work-cli --json invoice run invoice.reim.workflow.resolve --input-json '{
 
 CLI operation：`invoice.reim.employee-superiors`
 
-获取当前登录人员的基本信息及其所有上级人员列表。**用于填写表单中"报销人上级"、"承担人直接上级"和"承担人所有上级"字段（均为必填）。**
+获取当前登录人员的基本信息及其所有上级人员列表。**兜底用**：承担主体、报销人上级、承担人直接上级、承担人所有上级通常由报销表单默认值带出；只有 `workflow.createForm` 的 `fields` 里这些字段没有 `initialValue`，或 `createRequest` 的 `missingFields` 列出它们时才调用（见 [reim-workflow.md](reim-workflow.md) Step 3.7）。
 
 ### 命令
 
@@ -904,9 +697,9 @@ weaver-work-cli --json invoice run invoice.reim.employee-superiors --input-json
 
 | 表单字段 | 取值方式 |
 | --- | --- |
-| 报销人上级 | `directSuperior.id`（直接上级 ID，直接赋值；**不是 `allSuperiors[0]`**） |
-| 承担人直接上级 | `directSuperior.id`（同上） |
-| 承担人所有上级 | `allSuperiors` 中所有 `id` 用逗号拼接（如 `"id1,id2,id3"`） |
+| 承担主体 / 申请人 | `{currentEmployee.name}({currentEmployee.id})` |
+| 报销人上级 / 承担人直接上级 | `{directSuperior.name}({directSuperior.id})`（**不是 `allSuperiors[0]`**） |
+| 承担人所有上级 | `allSuperiors` 每项写成 `名称(ID)` 组成的数组 |
 
 ---
 
@@ -947,8 +740,9 @@ weaver-work-cli --json invoice run invoice.reim.row-info --input-json '{"invoice
 | ----------- | ---------------- | ---------------------------------------- |
 | `date`      | 费用日期             | 费用日期/发生日期                                |
 | `fysm`      | 费用说明             | 费用说明/摘要                                  |
-| `itinerary` | 关联凭证 ID（多个用逗号拼接） | 相关凭证（`EinvoiceComponent`, `single=true`） |
+| `itinerary` | 关联凭证 ID（多个用逗号拼接） | 相关凭证（`EinvoiceComponent`，每行最多 1 张） |
 | `subjectId` | 费用科目 ID          | 费用类型（科目）                                 |
+| `subjectName` | 费用科目名称        | 与 `subjectId` 拼成 `名称(ID)`                    |
 
 
 ### 返回示例
@@ -971,7 +765,7 @@ weaver-work-cli --json invoice run invoice.reim.row-info --input-json '{"invoice
 - **调用时机**：Step 4 组装明细行时，对每张发票调用 `invoice.reim.row-info`
 - **优先级**：此 CLI 返回的 `date`、`fysm`、`itinerary`、`subjectId` 四个值**优先于 AI 自行推断的值**
 - **容错**：如果某个字段为空/null，则回退到 AI 推断逻辑
-- **itinerary 处理**：如果 `itinerary` 有值（可能逗号分隔多个 ID），直接填入相关凭证字段（`EinvoiceComponent`+`single=true`），**替代原有的凭证配对逻辑**
+- **itinerary 处理**：如果 `itinerary` 有值，直接作为该行的配对凭证，**替代原有的凭证配对逻辑**；先用 `invoice.browse-field.data` 取凭证对象再填入「相关凭证」。逗号分隔返回多个时，每行只挂最匹配的 1 张（规则见 [reim-form-fill-rules.md](reim-form-fill-rules.md#3-凭证与发票配对)）
 
 ---
 
@@ -1045,8 +839,6 @@ weaver-work-cli --json invoice run invoice.reim.row-info-batch --input-json '{"i
 
 - **手工组装报销单时**（Step 3.5），用 `row-info-batch` 替代 N 次 `row-info` 调用
 - 部分失败不影响其他发票，失败的回退到 AI 推断逻辑
-- 快速路径（`template.build`/`auto-prepare`）内部已自带批量获取，无需额外调用
-
 ---
 
 ## 5.7 获取发票详情（交通类发票行程信息）
@@ -1139,281 +931,34 @@ weaver-work-cli --json invoice run invoice.get --input-json '{"fid":"13019569599
 
 ---
 
-## 6. 生成报销单流程
+## 5.8 取发票字段对象
 
-CLI operation：`invoice.reim.flow.create.prepare` → 用户确认 → `invoice.reim.flow.create.apply`
+CLI operation：`invoice.browse-field.data`（read）
 
-> **⚠️ 禁止重复创建：同一组发票数据只能创建一次。创建成功后，修改报销单请用 `invoice.reim.flow.update.prepare/apply`，不要再次调用 create。**
-
-将填单结构化 JSON 作为 operation 顶层入参提交到 CLI，生成报销单流程。不要再包一层通用 `payload`。
-
-### 入参
-
-入参即 Step 4 组装的完整填单 JSON（结构定义见 [form-fill-rules.md](reim-form-fill-rules.md#最终输出结构)），字段会在 `inputSchema.properties` 中逐项暴露，并作为请求体（JSON Body）提交到 E10。
-
-
-| 字段                  | 类型     | 必填  | 说明                               |
-| ------------------- | ------ | --- | -------------------------------- |
-| `work_flow_id`      | String | 是   | 目标报销流程的工作流ID                     |
-| `mainFormId`        | String | 是   | 报销单主表formId（来自 `invoice.reim.form.structure`） |
-| `request_name`      | String | 是   | 流程标题                             |
-| `main_fields`       | Array  | 是   | 主表字段值列表                          |
-| `detail_rows`       | Array  | 是   | 明细表行数据                           |
-| `need_user_confirm` | Array  | 否   | 需用户确认的字段                         |
-| `unable_to_fill`    | Array  | 否   | 无法自动填写的字段                        |
-
-
-### 命令
-
-将 Step 4 的 JSON 作为 operation 顶层输入写入文件，先 prepare，用户确认后再 apply。
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input .\reim-create.json
-```
+报销单明细的「相关发票」「相关凭证」都是 `EinvoiceComponent`，**只接受发票对象，不接受文本或裸 ID**。一次传入本组全部发票与配对凭证的 `fid`，按 `fid` 把返回对象放进对应行。入参与对象结构见 [invoice-browse-field-data.md](invoice-browse-field-data.md)。
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input ./reim-create.json
-```
-
-顶层输入示例：
-
-```json
-{
-  "work_flow_id": "1181057526276915214",
-  "mainFormId": "1181057741029226975",
-  "request_name": "交通费报销-后端开发111-2026-08-04（共1笔）",
-  "main_fields": [
-    {"fieldId": "1181057741029227445", "value": "1201729946891231232", "fieldName": "申请人"},
-    {"fieldId": "1181057741029227447", "value": "2026-08-04", "fieldName": "报销日期"},
-    {"fieldId": "1181057741029227454", "optionValue": "7", "fieldName": "报销方式"}
-  ],
-  "detail_rows": [
-    {
-      "dataIndex": 1,
-      "subFormId": "1181057741029227992",
-      "invoiceId": "1295366637717012482",
-      "fields": [
-        {"fieldId": "1181057741029227459", "value": "108.2", "fieldName": "实报金额"},
-        {"fieldId": "1181057741029227467", "value": "2026-07-30", "fieldName": "费用日期"}
-      ]
-    }
-  ],
-  "need_user_confirm": [],
-  "unable_to_fill": []
-}
-```
-
-### 返回示例
-
-```json
-{
-  "code": 200,
-  "msg": "接口返回成功",
-  "status": true,
-  "data": {
-    "requestId": "1300266422434136064"
-  }
-}
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1298798990831518001"]}'
 ```
 
-### 返回字段说明
-
-
-| 字段               | 说明                   |
-| ---------------- | -------------------- |
-| `data.requestId` | 创建成功的报销单流程 requestId |
-
-
-### 创建成功后
-
-`invoice.reim.flow.create.apply` 返回 `requestId`、`requestName` 和 `viewUrl`。用 Markdown 链接展示给用户，锚文本用流程标题，链接用 CLI 返回的 `viewUrl`，不要自己拼接地址。
+Windows PowerShell：
 
-```markdown
-报销单已创建成功！点击查看：[交通费报销-后端开发111-2026-08-04（共1笔）](viewUrl)
+```powershell
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1298798990831518001"]}'
 ```
 
 ---
 
-## 7. 更新报销单流程
-
-CLI operation：`invoice.reim.flow.update.prepare` → 用户确认 → `invoice.reim.flow.update.apply`
-
-更新已创建的报销流程表单。支持三种操作的任意组合，互不阻断：
-
-- **修改主表字段** — 更新主表中的字段值
-- **修改/新增明细行字段** — 更新或新增明细表中的行数据
-- **删除指定明细行** — 按明细表ID + 行号删除
-
-### 入参
-
-
-| 字段                 | 类型          | 必填  | 说明                                            |
-| ------------------ | ----------- | --- | --------------------------------------------- |
-| `requestId`        | Long        | 是   | 要更新的流程 requestId（`invoice.reim.flow.create.apply` 返回的 requestId） |
-| `mainFormId`       | String      | 是   | 报销单主表ID（来自 `invoice.reim.form.structure` 返回的 `mainFormId`） |
-| `deleteDetailRows` | Array       | 否   | 要删除的明细行，见下方格式                                 |
-| `main_fields`      | ArrayObject | 否   | 需要更新的主表字段列表                                   |
-| `detail_rows`      | ArrayObject | 否   | 需要更新/新增的明细行数据                                 |
-
-
-#### deleteDetailRows 格式
-
-**推荐使用对象数组**（精确指定明细表）：
-
-```json
-"deleteDetailRows": [
-  {"subFormId": "1169534588649275663", "dataIndex": 1},
-  {"subFormId": "1169534588649275663", "dataIndex": 3}
-]
-```
-
-
-| 字段          | 类型      | 说明                             |
-| ----------- | ------- | ------------------------------ |
-| `subFormId` | String  | 明细表ID，指定从哪个明细表删除               |
-| `dataIndex` | Integer | 行号（1-based），传 `-1` 表示删除该明细表全部行 |
-
-
-也支持**简写整数数组**（删除所有明细表中对应行）：`[1, 3]` 或 `[-1]`（删全部）
-
-#### 字段对象（main_fields / detail_rows.fields 通用）
-
-
-| 字段               | 类型      | 必填  | 说明                           |
-| ---------------- | ------- | --- | ---------------------------- |
-| `fieldId`        | String  | 是   | 字段ID                         |
-| `fieldName`      | String  | 否   | 字段名称（便于理解，不参与逻辑）             |
-| `value`          | String  | 否   | 字段值（与 optionValue 二选一）       |
-| `optionValue`    | String  | 否   | 选项型字段的 optionId（与 value 二选一） |
-| `unable_to_fill` | Boolean | 否   | `true` 表示该字段无法填写，跳过          |
-| `need_search`    | Boolean | 否   | `true` 表示该字段需要搜索确认，跳过        |
+## 6. 创建 / 修改报销单（`weaver-e10-workflow`）
 
+报销单创建与修改不再使用本技能的 operation，统一调用 `weaver-e10-workflow` 技能：
 
-#### detail_rows 行对象
-
-
-| 字段          | 类型          | 必填  | 说明                |
-| ----------- | ----------- | --- | ----------------- |
-| `subFormId` | String      | 是   | 明细表ID，表示该行属于哪个明细表 |
-| `dataIndex` | Long        | 是   | 明细行号（1-based），第几行 |
-| `fields`    | ArrayObject | 是   | 该行中要更新的字段列表       |
-
-
-### 执行顺序
-
-> **删除操作先于表单更新执行，但删除失败不会阻断表单更新。**
-
-### 命令
-
-将以下 JSON 作为 operation 顶层输入写入文件，先 `invoice.reim.flow.update.prepare`，用户确认后再 `.apply`。
-
-### 顶层输入示例
-
-#### 场景1：同时删除明细第2行 + 修改主表 + 更新第1行明细
-
-```json
-{
-  "requestId": 1300266422434136064,
-  "mainFormId": "1169534588649275463",
-  "deleteDetailRows": [
-    {"subFormId": "1169534588649275663", "dataIndex": 2}
-  ],
-  "main_fields": [
-    {"fieldId": "1169534588649275901", "fieldName": "申请日期", "value": "2026-08-05"}
-  ],
-  "detail_rows": [
-    {
-      "subFormId": "1169534588649275663",
-      "dataIndex": 1,
-      "fields": [
-        {"fieldId": "1169534588649275988", "fieldName": "货物或应税劳务、服务名称", "value": "1297537820896575492"},
-        {"fieldId": "1169534588649275989", "fieldName": "金额", "value": "500.00"}
-      ]
-    }
-  ]
-}
-```
-
-#### 场景2：仅删除某个明细表的第1行和第3行
-
-```json
-{
-  "requestId": 1300266422434136064,
-  "mainFormId": "1169534588649275463",
-  "deleteDetailRows": [
-    {"subFormId": "1169534588649275663", "dataIndex": 1},
-    {"subFormId": "1169534588649275663", "dataIndex": 3}
-  ]
-}
-```
-
-#### 场景3：删除某个明细表全部行
-
-```json
-{
-  "requestId": 1300266422434136064,
-  "mainFormId": "1169534588649275463",
-  "deleteDetailRows": [
-    {"subFormId": "1169534588649275663", "dataIndex": -1}
-  ]
-}
-```
-
-#### 场景4：仅修改明细行
-
-```json
-{
-  "requestId": 1300266422434136064,
-  "mainFormId": "1169534588649275463",
-  "detail_rows": [
-    {
-      "subFormId": "1169534588649275663",
-      "dataIndex": 1,
-      "fields": [
-        {"fieldId": "1169534588649275988", "fieldName": "货物或应税劳务、服务名称", "value": "1297537820896575492"}
-      ]
-    }
-  ]
-}
-```
-
-### 返回示例
-
-```json
-{
-  "code": 200,
-  "status": true,
-  "msg": "更新成功",
-  "data": {
-    "requestId": "1300266422434136064",
-    "deleteDetailSuccess": true,
-    "updateFormSuccess": true
-  }
-}
-```
-
-### 返回字段说明
-
-
-| 字段                         | 说明                                        |
-| -------------------------- | ----------------------------------------- |
-| `data.requestId`           | 流程 requestId                              |
-| `data.deleteDetailSuccess` | 明细行删除结果（仅当传了 deleteDetailRows 时返回）        |
-| `data.deleteDetailMsg`     | 删除失败原因（仅失败时返回）                            |
-| `data.updateFormSuccess`   | 表单更新结果（仅当有 main_fields 或 detail_rows 时返回） |
-| `data.updateFormMsg`       | 更新失败原因（仅失败时返回）                            |
-
-
-### 注意事项
+| 动作 | 命令 | 契约 |
+| --- | --- | --- |
+| 载入报销表单 | `workflow.createForm`（`workflow` 传 `{workFlowName}({workFlowId})`） | [`workflow-create.md`](../../weaver-e10-workflow/references/workflow-create.md) |
+| 创建报销单（存草稿 / 提交审批） | `workflow.createRequest`（`context` + `data` + `action` + `requestName`） | 同上 |
+| 修改已创建的报销单 | `workflow.editLoad` → `workflow.editPrepare` → `workflow.editApply` | [`workflow-edit.md`](../../weaver-e10-workflow/references/workflow-edit.md) |
 
-- `mainFormId` 来自 `invoice.reim.form.structure` 返回的 `mainFormId`，每次调用 `invoice.reim.flow.update.prepare/apply` 必传
-- `dataIndex` 是 **1-based**（从1开始），对应明细表中的第1行、第2行...
-- `subFormId` 是明细表ID，一个流程表单可能有多个明细表，需准确指定
-- 删除操作先于表单更新执行，删除失败不阻断表单更新
-- `fieldName` 仅用于可读性，不参与业务逻辑
-- 如果只删除不修改，只传 `requestId` + `deleteDetailRows` 即可
-- `value` 为空、`unable_to_fill=true`、`need_search=true` 的字段会被自动跳过
+`data` 的组装规则见 [reim-form-fill-rules.md](reim-form-fill-rules.md)，编排顺序与创建前确认见 [reim-workflow.md](reim-workflow.md) Step 3 ~ Step 6。