weaver-work-cli 0.1.25 → 0.1.28

package/skills/weaver-e10-yepiaotong/references/invoice-reim.md

@@ -6,27 +6,34 @@
 
 ## Operation
 
-| 意图 | Operation | 风险 |
-| --- | --- | --- |
-| E10 fileId 转发票识别结果 | `invoice.reim.file-ocr.preview` | read-with-upload |
-| 查询事前申请 | `invoice.reim.requests.list` | read |
-| 获取报销工作流 ID | `invoice.reim.workflow.resolve` | read |
-| 获取报销表单结构 | `invoice.reim.form.structure` | read |
-| 获取单张发票明细行预填信息 | `invoice.reim.row-info` | read |
-| 获取当前人员及上级 | `invoice.reim.employee-superiors` | read |
-| 搜索表单关联字段值 | `invoice.reim.field.search` | read |
-| 准备/确认创建报销单 | `invoice.reim.flow.create.prepare/apply` | read-before-write / high-risk-write |
-| 准备/确认更新报销单 | `invoice.reim.flow.update.prepare/apply` | read-before-write / high-risk-write |
+本技能负责报销的**数据准备**；报销单的**创建与修改**统一调用 `weaver-e10-workflow` 技能的发起/修改能力。
+
+| 意图 | Operation | 所属技能 | 风险 |
+| --- | --- | --- | --- |
+| E10 fileId 转发票识别结果 | `invoice.reim.file-ocr.preview` | yepiaotong | read-with-upload |
+| 报销候选发票分类（可报 / 已挂单 / 红冲） | `invoice.reim.candidates.list` | yepiaotong | read |
+| 查询事前申请 | `invoice.reim.requests.list` | yepiaotong | read |
+| 获取报销工作流 ID 与名称 | `invoice.reim.workflow.resolve` | yepiaotong | read |
+| 获取发票明细行预填信息 | `invoice.reim.row-info` / `invoice.reim.row-info-batch` | yepiaotong | read |
+| 取发票字段对象 | `invoice.browse-field.data` | yepiaotong | read |
+| 获取当前人员及上级（兜底） | `invoice.reim.employee-superiors` | yepiaotong | read |
+| 载入报销表单 | `workflow.createForm` | workflow | read |
+| 创建报销单（固定存草稿） | `workflow.createRequest` | workflow | high-risk-write |
+| 修改已创建的报销单 | `workflow.editLoad` / `workflow.editPrepare` / `workflow.editApply` | workflow | read / read-before-write / high-risk-write |
+
+> workflow 侧命令的入参、返回处置以 [`../../weaver-e10-workflow/references/workflow-create.md`](../../weaver-e10-workflow/references/workflow-create.md)、[`workflow-edit.md`](../../weaver-e10-workflow/references/workflow-edit.md) 为准。`weaver-e10-workflow` 技能不可用时停止并告知用户需要安装该技能，不要改用其他方式创建报销单。
 
 ## 处理链
 
-1. 获取发票：已有 `fid` 时可用 `invoice.get` 或 `invoice.browse-field.data`；已有 E10 `fileId` 时用 `invoice.reim.file-ocr.preview`；需要查票夹时用 `invoice.list`，默认未报销发票。
+1. 获取发票：已有 `fid` 时可用 `invoice.get`；已有 E10 `fileId` 时用 `invoice.reim.file-ocr.preview`；按日期批量报销用 `invoice.reim.candidates.list`（只取 `available`），按关键词/号码筛选用 `invoice.list`，默认未报销发票。
 2. 展示发票汇总，让用户确认哪些发票进入报销。
 3. 用 `invoice.reim.requests.list` 获取事前申请，再按时间、费用类型和标题做匹配；原始 ID、日期、金额必须逐字符保留。
 4. 用 `invoice.reim.workflow.resolve` 得到报销工作流，必要时按工作流分组。
-5. 对每组并行读取 `invoice.reim.form.structure`、`invoice.reim.row-info` 和 `invoice.reim.employee-superiors`；只有需要用户修正关联字段时才用 `invoice.reim.field.search`。
-6. Agent 按表单结构组装报销单 JSON，先调用 `invoice.reim.flow.create.prepare`，展示标题、主表字段数、明细行数、发票和风险；用户明确确认后再调用 `.apply`。命中「话费补贴标准审批流程」或「话费报销」时，必须先读 [`reim-phone-subsidy-rules.md`](reim-phone-subsidy-rules.md)，按月度标准核算实报金额，不能直接用发票金额填单。
-7. 报销单创建成功后，后续修正使用 `invoice.reim.flow.update.prepare/apply`，不要重复创建同一组发票的报销单。
+5. 对每组并行调用 `workflow.createForm`（`workflow` 传 `{workFlowName}({workFlowId})`）、`invoice.reim.row-info-batch`、`invoice.browse-field.data`（发票 + 配对凭证的 `fid`）。
+6. 按 [`reim-form-fill-rules.md`](reim-form-fill-rules.md) 组装 `createRequest` 的 `data`，直接调用 `workflow.createRequest` 存草稿（`action` 固定 `"draft"`，不问用户），结果原样粘贴 `finalMarkdown`。命中「话费补贴标准审批流程」或「话费报销」时，必须先读 [`reim-phone-subsidy-rules.md`](reim-phone-subsidy-rules.md)，按月度标准核算实报金额，不能直接用发票金额填单。
+7. 报销单创建成功后，后续修正使用 `workflow.editLoad` → `workflow.editPrepare` → 用户确认 → `workflow.editApply`，不要重复创建同一组发票的报销单。
+
+完整编排见 [`reim-workflow.md`](reim-workflow.md)。
 
 ## 命令
 
@@ -44,50 +51,66 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":20,"requestname":"交通","cusCreateDateStart":"2026-07-01","cusCreateDateEnd":"2026-07-31"}'
 ```
 
-创建报销单建议用 UTF-8 JSON 文件传入完整报销单 JSON。
+载入报销表单（拿 `continuation` 与可写字段 `fields`）：
 
 Windows PowerShell：
 
 ```powershell
-Set-Content -Encoding utf8 -LiteralPath .\reim-create.json -Value @'
+weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["总部费用报销(100003460000000060)"]}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["总部费用报销(100003460000000060)"]}'
+```
+
+创建报销单：`data` 含发票对象、体积较大，先写入 UTF-8 JSON 文件再传入。
+
+Windows PowerShell：
+
+```powershell
+Set-Content -Encoding utf8 -LiteralPath .\reim-create-request.json -Value @'
 {
-  "work_flow_id": "1181057526276915214",
-  "mainFormId": "1181057741029226975",
-  "request_name": "交通费报销-示例-2026-08-04",
-  "main_fields": [],
-  "detail_rows": [{"dataIndex":1,"subFormId":"1181057741029227992","invoiceId":"12345","fields":[]}]
+  "context": "<createForm 返回的 continuation>",
+  "requestName": "示例7月上海交通费报销",
+  "action": "draft",
+  "data": {
+    "main": {"100003720000000088": "上海市内交通费（滴滴出行）"},
+    "details": {"100003690000000011": [{"100003720000016373": "108.2", "100003720000052200": "人民币(100001050000000001)"}]}
+  }
 }
 '@
-weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input .\reim-create.json
+weaver-work-cli --json workflow run workflow.createRequest --input .\reim-create-request.json
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-cat > ./reim-create.json <<'JSON'
+cat > ./reim-create-request.json <<'JSON'
 {
-  "work_flow_id": "1181057526276915214",
-  "mainFormId": "1181057741029226975",
-  "request_name": "交通费报销-示例-2026-08-04",
-  "main_fields": [],
-  "detail_rows": [{"dataIndex":1,"subFormId":"1181057741029227992","invoiceId":"12345","fields":[]}]
+  "context": "<createForm 返回的 continuation>",
+  "requestName": "示例7月上海交通费报销",
+  "action": "draft",
+  "data": {
+    "main": {"100003720000000088": "上海市内交通费（滴滴出行）"},
+    "details": {"100003690000000011": [{"100003720000016373": "108.2", "100003720000052200": "人民币(100001050000000001)"}]}
+  }
 }
 JSON
-weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input ./reim-create.json
+weaver-work-cli --json workflow run workflow.createRequest --input ./reim-create-request.json
 ```
 
-确认后把 prepare 返回的 continuation 原样放入 apply 输入，并在同一个顶层 JSON 中加入 `"confirm": true`。`invoice.reim.flow.create.*` 的 `inputSchema` 会逐字段暴露 `work_flow_id`、`mainFormId`、`request_name`、`main_fields`、`detail_rows`、`need_user_confirm` 和 `unable_to_fill`，不要再包一层通用 `payload`。
+示例里的字段 id 来自「总部费用报销」，实际一律以本次 `createForm` 返回的 `fields` 为准；明细行的「相关发票」「相关凭证」要放 `invoice.browse-field.data` 返回的发票对象数组。
 
 ## 输出处理
 
-`invoice.reim.flow.create.apply` 成功返回 `requestId`、`requestName` 和 `viewUrl`。给用户展示报销单标题、总金额、发票摘要和链接。若返回 `partial/write_uncertain`，停止，不要重放 `.apply`；最多做一次只读查询或请用户在 E10 页面核对。
-
-`invoice.reim.flow.update.apply` 若服务端返回删除或更新部分失败，CLI 会按 `partial/write_uncertain` 报告，Agent 不要继续连环重试。
+`workflow.createRequest` 在成功（`CREATED` / `CREATED_SUBMITTED`）、提交失败（`CREATED_SUBMIT_FAILED`）和缺必填（`NEEDS_INPUT`）时返回 `finalMarkdown`，**原样粘贴给用户**，不要自己重拼表格；链接只出现在回复文本里，不要主动打开。若返回 `partial/write_uncertain`，停止，不要重放；最多做一次只读查询或请用户在 E10 页面核对。
 
 ## 注意
 
-报销单创建和更新都是高风险写入，必须走 `prepare -> 用户确认 -> apply`。同一组发票 `invoice.reim.flow.create.apply` 成功后禁止再次创建；要修改已创建的报销单只能走 `invoice.reim.flow.update.prepare/apply`。
+载入表单的 `workflow.createForm` **不传 `userQuestion`**、也不用 `workflow.createRequestDirect`：报销的 `data` 由本技能规则组装，不用流程侧智能填参。AI 报销**一律存草稿**（`action:"draft"`），组装完直接调用 `workflow.createRequest`，不让用户选「存草稿 / 提交审批」；草稿由用户在 E10 里核对后自己提交。同一组发票创建成功后禁止再次创建，修改只能走 `workflow.edit*`。
 
-出差/差旅流程需要具体相关客户。未拿到用户提供的客户并完成关联字段搜索前，不要调用 `invoice.reim.flow.create.prepare/apply`。
+出差/差旅流程需要具体相关客户。未拿到用户提供的客户前，不要调用 `workflow.createRequest`。
 
 `invoice.reim.file-ocr.preview` 会让 E10 侧文件进入发票识别流程；如果 fileId 来自用户新上传或附件解析，先提醒用户文件内容可能进入大模型上下文，也可能发送到 E10/OCR 服务，并等待明确确认。