weaver-work-cli 0.1.28 → 0.1.31

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

@@ -81,7 +81,7 @@ weaver-work-cli --json invoice run invoice.reim.file-ocr.preview --input-json '{
 
 利用发票的 `invoiceDate`（2026-07-28 ~ 2026-07-29）筛选事前申请：
 - `cusCreateDateStart` = "2026-04-29"（往前推90天）
-- `cusCreateDateEnd` = "2026-07-29"
+- `cusCreateDateEnd` = "2026-07-29"（业务结束日；CLI 再 + 1 天后发给接口）
 
 → 继续 Step 1B → Step 2 匹配 → Step 2.5 → Step 3 → Step 4 → Step 5（流程同示例1/2）
 
@@ -101,8 +101,8 @@ AI 直接计算（UTC+8）：begin = 今天00:00:00秒时间戳 - 7*86400, end =
 {
   "page_size": 10,
   "start_pos": 0,
-  "date_begin": 1786291200,
-  "date_end": 1786982399
+  "consumption_tm_begin": 1786291200,
+  "consumption_tm_end": 1786982399
 }
 ```
 
@@ -111,13 +111,13 @@ AI 直接计算（UTC+8）：begin = 今天00:00:00秒时间戳 - 7*86400, end =
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"date_begin":1786291200,"date_end":1786982399}'
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"consumption_tm_begin":1786291200,"consumption_tm_end":1786982399}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"date_begin":1786291200,"date_end":1786982399}'
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"consumption_tm_begin":1786291200,"consumption_tm_end":1786982399}'
 ```
 
 **返回（CLI 信封中列表在 `data.items`，下面是单条票面结构）：**
@@ -186,7 +186,7 @@ weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"s
 ### Step 1B: 获取事前申请（基于发票日期预筛选）
 
 > 已知发票 invoiceDate = "2026-07-30"
-> 事前申请日期一定在开票日期之前 → cusCreateDateEnd = "2026-07-30"
+> 事前申请日期一定在开票日期之前 → cusCreateDateEnd = "2026-07-30"（业务结束日；CLI 再 + 1 天后发给接口）
 > 往前推90天 → cusCreateDateStart = "2026-05-01"
 
 **命令：**
@@ -194,13 +194,13 @@ weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"s
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":20,"cusCreateDateStart":"2026-05-01","cusCreateDateEnd":"2026-07-30"}'
+weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":100,"cusCreateDateStart":"2026-05-01","cusCreateDateEnd":"2026-07-30"}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":20,"cusCreateDateStart":"2026-05-01","cusCreateDateEnd":"2026-07-30"}'
+weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":100,"cusCreateDateStart":"2026-05-01","cusCreateDateEnd":"2026-07-30"}'
 ```
 
 **返回：**
@@ -213,28 +213,18 @@ weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pa
       "requestid": "1298294241967177729",
       "workflowid": "1181057526276915214",
       "requestname": "交通费报销-后端开发111-2026-07-25",
-      "requestnametitle": "交通费报销-后端开发111-2026-07-25 (相关客户:, 相关项目:, 承担主体: , 流程编号:Weaver-FYBX202607000069, 报销总金额:14.47 , 费用承担公司:)",
       "flowStatus": 6,
       "creatorId": "1201729946891231232",
       "creatorName": "后端开发111",
-      "creatorDepartmentId": "1201729461554241537",
-      "nodeid": "1181057741029220917",
       "createTime": "2026-07-25 10:30:00"
     }
   ]
 }
 ```
 
-### Step 2: 匹配绑定
+### Step 2: 按时间关联
 
-根据匹配规则分析（硬约束：invoiceDate >= createTime）：
-- 时间硬约束：invoiceDate "2026-07-30" >= createTime "2026-07-25" → ✅ 满足
-- 费用类型匹配：发票 expenseType="市内交通" ↔ 事前申请 requestname 含"交通费" → +40
-- 时间匹配：invoiceDate 在 createTime 后 5 天（7天内） → +30
-- 同一申请人 → +10
-- 总分 80 → confidence = "high"
-
-匹配结果：
+只看日期：invoiceDate `2026-07-30` 晚于 createTime `2026-07-25`，并且在 90 天内。本次只有这一条事前申请，直接绑定，不问用户。
 
 ```json
 {
@@ -243,16 +233,17 @@ weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pa
       "invoiceId": "1295366637717012482",
       "preApprovalId": "1298294241967177729",
       "preApprovalWorkflowId": "1181057526276915214",
-      "matchConfidence": "high",
-      "matchScore": 80,
-      "matchReasons": ["费用类型匹配：交通费", "时间匹配：开票日期在事前申请后5天内", "同一申请人"]
+      "preApprovalName": "交通费报销-后端开发111-2026-07-25",
+      "matchReason": "开票日期 2026-07-30 只落在 2026-07-25 这一条的 90 天内"
     }
   ],
-  "unmatchedInvoices": [],
-  "unmatchedApprovals": []
+  "pendingChoice": [],
+  "unmatchedInvoices": []
 }
 ```
 
+若同一天还能对上另一条发起日也在 90 天内的事前申请，先把两条列给用户选，选定后再继续。
+
 ### Step 2.5: 获取报销单工作流
 
 **命令：**
@@ -353,28 +344,25 @@ weaver-work-cli --json invoice run invoice.reim.row-info-batch --input-json '{"i
 
 **③ 交通类发票取行程：** `invoice.get`（`{"fid":"1295366637717012482"}`）→ `from`=「仁济医院南院区门诊部(南门)南侧」、`to`=「浦江瑞和城柒街区30号」。
 
-**④ 取发票对象：** 发票 + `itinerary` 返回的凭证一起传。
+**④ 取发票对象：** 只传发票。`itinerary` 返回的凭证 `1298798990831518001` 不传，明细「相关凭证」由发票联动带出。
 
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1298798990831518001"]}'
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482"]}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1298798990831518001"]}'
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482"]}'
 ```
 
-> `itinerary` 与 `browse-field.data` 同时发起时还不知道凭证 ID：先只传发票 `fid`，`row-info-batch` 返回新的凭证 ID 后再补调一次只传凭证。
-
 ### Step 4: 组装 `data`
 
 ```json
 {
   "main": {
-    "1256786432515129369": "交通费报销-后端开发111-2026-07-25(1298294241967177729)",
     "100003720000000088": "上海市内交通费（滴滴出行）",
     "100003720000000687": "泛微上海(100504500000311504)"
   },
@@ -385,10 +373,8 @@ weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fid
         "100003720000016373": "108.2",
         "100003720000052200": "人民币(100001050000000001)",
         "100003720000000360": "市内交通费(100502270000000006)",
-        "100003720000000361": "仁济医院南院-浦江瑞和城",
         "100003720000000684": "交通费报销-后端开发111-2026-07-25(1298294241967177729)",
-        "100003720000077896": [{"optionId": "1295366637717012482", "id": "1295366637717012482", "fid": "1295366637717012482", "content": "增值税电子普通发票-36901189", "...": "browse-field.data 返回的其余键原样保留"}],
-        "100003720000079682": [{"optionId": "1298798990831518001", "id": "1298798990831518001", "fid": "1298798990831518001", "content": "滴滴行程单-...", "...": "browse-field.data 返回的其余键原样保留"}]
+        "100003720000077896": [{"optionId": "1295366637717012482", "id": "1295366637717012482", "fid": "1295366637717012482", "content": "增值税电子普通发票-36901189", "...": "browse-field.data 返回的其余键原样保留"}]
       }
     ]
   }
@@ -430,27 +416,29 @@ weaver-work-cli --json workflow run workflow.createRequest --input ./reim-create
 
 **场景**：2 张发票（交通+住宿）均匹配到同一条出差事前申请。
 
-**出差拦截**：`workFlowName` 含「差旅」或事前申请名称含「出差」→ **必须先提醒用户填写相关客户**。
+**出差拦截**：`workFlowName` 含「差旅」或事前申请名称含「出差」→ **一次**请用户一起填写相关客户和相关项目。问清之前禁止 `createRequest`。不要另问合同号。
+**相关流程**：差旅 / 外出报销每一行明细「相关流程」必须是 `{requestname}({requestid})`。没有事前申请就先让用户选，不能空着建单。
 **话费拦截**：`workFlowName` 含「话费补贴标准审批流程」或「话费报销」→ **必须先按 [reim-phone-subsidy-rules.md](reim-phone-subsidy-rules.md) 核对账单截图、账单构成和岗位上限，再按标准计算实报金额**。
 
 ```markdown
-当前为出差报销，必须填写相关客户。请提供本次出差对应的具体客户名称，否则无法继续报销。
+当前为出差报销。请一起填写：
+相关客户（必须是具体客户名称）、相关项目（没有可以说「不填」）。
+合同号不用填。
 ```
 
-用户给出客户名称（如「XX科技」）→ 直接把 `"XX科技"` 填进「相关客户」，由 `createRequest` 解析；唯一命中即可，多候选按 `ambiguities` 让用户选。用户不提供 → **不允许报销，不创建报销单**。
+用户给出客户名称（如「XX科技」）→ 先 `invoice.reim.field.search`：`match=unique` 直接填 `名称(ID)`，`match=multiple` 把候选列给用户选，`match=none` 请用户换名称。**不要**把未消歧简称直接丢给 `createRequest`。用户不提供客户 → **不允许报销，不创建报销单**。
 
 **`data` 关键点**：
 
 ```json
 {
   "main": {
-    "<事前申请流程id>": "北京出差申请-张三-2026-07-20(1299854672520364033)",
     "<相关客户id>": "XX科技"
   },
   "details": {
     "<费用明细subFormId>": [
-      {"<申请金额id>": "76.80", "<币种id>": "人民币(100001050000000001)", "<相关发票id>": [{"fid": "INV001", "...": "..."}]},
-      {"<申请金额id>": "480.00", "<币种id>": "人民币(100001050000000001)", "<相关发票id>": [{"fid": "INV002", "...": "..."}]}
+      {"<申请金额id>": "76.80", "<币种id>": "人民币(100001050000000001)", "<相关流程id>": "北京出差申请-张三-2026-07-20(1299854672520364033)", "<相关发票id>": [{"fid": "INV001", "...": "..."}]},
+      {"<申请金额id>": "480.00", "<币种id>": "人民币(100001050000000001)", "<相关流程id>": "北京出差申请-张三-2026-07-20(1299854672520364033)", "<相关发票id>": [{"fid": "INV002", "...": "..."}]}
     ]
   }
 }
@@ -458,7 +446,7 @@ weaver-work-cli --json workflow run workflow.createRequest --input ./reim-create
 
 **要点**：
 - 一张发票一行，数组顺序就是明细行顺序（行程单有多段行程也不拆，见示例13）
-- 两行都绑定同一个事前申请（明细「相关流程」同值）
+- 两行都绑定同一个事前申请（明细「相关流程」同值）；主表「事前申请流程」不赋值
 - 每行「相关发票」只放该行发票的 1 个对象
 
 ---
@@ -469,7 +457,7 @@ weaver-work-cli --json workflow run workflow.createRequest --input ./reim-create
 
 **差异点**：
 - 候选只有1个 → 直接使用；多个 → 自动匹配最相关的
-- 「事前申请流程」「相关流程」不传
+- 明细「相关流程」不传（主表「事前申请流程」任何情况都不赋值）。若选定的工作流是差旅 / 外出，不能走这条：必须先让用户选定事前申请，再给每一行明细「相关流程」赋值
 - 其他流程与示例1 一致
 
 ---
@@ -579,8 +567,8 @@ weaver-work-cli --json workflow run workflow.editApply --input-json '{"context":
 
 | 轮次 | 用户 | AI 操作 |
 |------|------|---------|
-| 1 | "查下我的事前申请" | 调用 `invoice.reim.requests.list`，展示列表 |
-| 2 | "查下对应的发票" | 复用事前申请日期，`date_begin` = 最早 createTime 的秒级时间戳，调用 `invoice.list` 展示 |
+| 1 | "查下我的事前申请" | 调用 `invoice.reim.requests.list`（不传 `cusCreateDateEnd`，CLI 按东八区当天 + 1 天填入；若传入结束日，CLI 再 + 1 天后发给接口），展示列表 |
+| 2 | "查下对应的发票" | 复用事前申请日期，`consumption_tm_begin` = 最早 createTime 的秒级时间戳，调用 `invoice.list` 展示 |
 | 3 | "报销吧" | 上下文已有两组数据 → 跳过 1A/1B，直接 Step 2 → 2.5 → 3 → 4 → 5 |
 
 ### 示例9：查询后选部分报销
@@ -631,9 +619,11 @@ AI 操作：
 用户说："帮我报销一下去重庆的发票，承担主体：边宝，合同编号：20250104933"
 
 - 流程标题：`"龚为明8月去重庆交通费报销"`（「去重庆」取用户原话，没说从哪出发就不写出发城市；月份取发票费用日期 2026-08-19）
-- 合同号传 `"20250104933"`；**承担主体、相关客户、相关项目都不传**（「边宝」也不传），直接存草稿
-- 创建后 `linkageResult` 返回（2026-10-21 真机）：`字段联动带出：…实报金额=50.07、承担主体=朱洪磊、相关客户=中国航空集团有限公司、合同号=20250104933、相关项目=中航集团办公平台改造及升级项目。`
-- 原样粘贴 `finalMarkdown` 后补一句：「承担主体、相关客户、相关项目已按合同 20250104933 联动带出：朱洪磊 / 中国航空集团有限公司 / 中航集团办公平台改造及升级项目；你提到的承担主体「边宝」与合同不一致，已按合同联动为准。」
+- 合同号传 `"20250104933"`；**承担主体不传**（「边宝」也不传，等合同联动）
+- **相关客户、相关项目还没确认 → 一次请用户一起填写，禁止直接存草稿，也不要再问合同号。** 这是出差，「去重庆」必须给具体客户；项目可以说「不填」。用户给出名称后先 `invoice.reim.field.search` 消歧，写入 `data` 再 `createRequest`。明细「费用说明」不传，由发票联动带出
+- 若用户已确认客户 / 项目，创建后 `linkageResult` 返回（2026-10-21 真机，合同本身带出客户项目时）：`字段联动带出：…实报金额=50.07、承担主体=朱洪磊、相关客户=中国航空集团有限公司、合同号=20250104933、相关项目=中航集团办公平台改造及升级项目。`
+- 原样粘贴 `finalMarkdown` 后补一句：「承担主体已按合同 20250104933 联动带出：朱洪磊；你提到的承担主体「边宝」与合同不一致，已按合同联动为准。」客户 / 项目若被联动改写，同样如实告诉用户
+- 联动把已确认的客户 / 项目冲空了 → 用已确认值 `workflow.edit*` 写回，不要再问、不要另建一张单
 
 ---
 
@@ -653,11 +643,11 @@ AI 操作：
 }
 ```
 
-`itineraryData` 有 3 段，**仍然只填 1 行**：费用日期取外层 `date`，金额取发票金额，费用说明取 `invoice.get` 的起止点（from=`大道|重庆财经学院-西门`，to=`鱼胡路-地铁站`），取不到时才用 `itineraryData` 第一段起点 - 最后一段终点。
+`itineraryData` 有 3 段，**仍然只填 1 行**：费用日期取外层 `date`，金额取发票金额，科目取外层科目。「费用说明」不传，不要把 `fysm` 或 `invoice.get` 的起止点写进去。「相关凭证」也不传，`itinerary` 的行程单由发票联动带出。
 
 ```json
 "100003690000000011": [
-  {"100003720000000419": "2026-08-19", "100003720000016373": "50.07", "100003720000000360": "5301滴滴车票(100502270000000177)", "100003720000000361": "重庆财经学院-鱼胡路站", "100003720000052200": "人民币(100001050000000001)", "100003720000077896": [<发票对象>], "100003720000079682": [<行程单对象>]}
+  {"100003720000000419": "2026-08-19", "100003720000016373": "50.07", "100003720000000360": "5301滴滴车票(100502270000000177)", "100003720000052200": "人民币(100001050000000001)", "100003720000077896": [<发票对象>]}
 ]
 ```
 
@@ -679,6 +669,34 @@ AI 操作：
 
 ---
 
+## 示例15：总部费用报销按项目带出合同号
+
+用户说「帮我报销」，发票已确认，工作流是「总部费用报销」。`historyRequestData` 最近一条：相关客户「中国航空集团有限公司」，相关项目「中航集团办公平台改造及升级项目」，合同号 `20250104933`。
+
+一次问用户：
+
+> 请一起填写相关客户和相关项目。上次是：中国航空集团有限公司 / 中航集团办公平台改造及升级项目。回复「用上次的」，或直接写下客户和项目。合同号不用填。
+
+- 用户说「用上次的」→ 写入历史客户和项目；合同号用同一条历史的 `20250104933`，不问。承担主体不传。然后存草稿，建单后告诉用户带出的合同号。
+- 用户写下新的客户和项目 → 先 `invoice.reim.field.search` 消歧。合同号按这个项目在历史里最近一条带出；历史没有这个项目就用 `20260999`，不问。
+- 不要把合同号列进提问，也不要再 `workflow.search` / `workflow.detail`。
+
+---
+
+## 示例16：草稿落库后检查客户、项目和相关凭证
+
+`workflow.createRequest` 返回 `CREATED`。先原样贴出 `finalMarkdown`，再看 `previewDetails` / `linkageResult`。看不清时用返回的 `requestId` 调一次 `workflow.editLoad`。
+
+本单是出差。第 1 行是火车票，「相关凭证」落库后为空。主表「相关客户」有值（建单前已确认）。主表「相关项目」为空，但用户建单前已说「不填」→ 项目不算缺项。
+
+在 `finalMarkdown` 后面只补一句：
+
+> 第 1 行「相关凭证」发票联动没有带出，需要的话可以在表单里自己挂。
+
+不补写「相关凭证」，也不向用户要行程单，不要再建一张报销单。若联动把建单前已确认的客户冲空了，用已确认的 `名称(ID)` 直接 `editPrepare` → `editApply`，不要再问。`editPrepare` 返回多个候选时，才让用户选一个。
+
+---
+
 ## 关键检查清单
 
 调用 `workflow.createRequest` 前确认：
@@ -689,17 +707,23 @@ AI 操作：
 4. [ ] `data` 的键全部来自本次 `createForm` 的 `fields[].id`，没有 `fields` 之外的字段（实报金额、附件数、承担人所有上级等不传）
 5. [ ] 带 `initialValue` 且不需改写的字段没有重复传；**例外：每行明细都显式传了「币种」`人民币(100001050000000001)`**（不传会让「申请金额」联动失效）
 6. [ ] 浏览按钮写 `名称(ID)`，没有裸 ID；Select 写选项名，不是 optionValue
-7. [ ] 每行「相关发票」是 `invoice.browse-field.data` 返回的 1 个发票对象；有凭证时「相关凭证」也是 1 个对象，无凭证不传
-8. [ ] 相关凭证（17/18/57/58）没有单独成行；行程单有多段行程也是一张发票一行；**有行程单 / 交通类 / 出差报销的明细，费用说明是精简后的 `起点-终点`：**整串最多 1 个 `-`、没有 `|` 和空格**，不是原样抄的 `from` / `to` / `fysm`
-9. [ ] 每行「费用类型（科目）」有值，匹配不到填 `其他-管理费用(100502270000000104)`
-10. [ ] 文本字段没有 `*` 号
-11. [ ] **出差/差旅流程：相关客户已由用户提供具体名称；未提供则不允许调用 `workflow.createRequest`**
-12. [ ] 非出差流程：相关客户填 `泛微上海(100504500000311504)`；**用户给了合同号时承担主体 / 相关客户 / 相关项目都不传，以合同联动为准**
-13. [ ] 话费报销：金额字段填的是核算后的实报金额
-14. [ ] `action` 是 `"draft"`，没有问用户「存草稿 / 提交审批」，也没有传 `"submit"`
+7. [ ] 每行「相关发票」是 `invoice.browse-field.data` 返回的 1 个发票对象；`browse-field.data` 只传了发票，没有传凭证
+8. [ ] 明细「费用说明」「费用明细」「相关凭证」都没有写入 `data`，留给「相关发票」联动带出
+9. [ ] 相关凭证（17/18/57/58）没有单独成行；行程单有多段行程也是一张发票一行。没有用 `fysm`、起止点或账单说明生成费用说明
+10. [ ] 每行「费用类型（科目）」有值，匹配不到填 `其他-管理费用(100502270000000104)`
+11. [ ] 文本字段没有 `*` 号
+12. [ ] **相关客户、相关项目已在同一次提问里确认**（客户有消歧后的 `名称(ID)` 或非出差默认「泛微上海」；项目有名称或用户已说「不填」）。没确认不允许调用 `workflow.createRequest`。没有向用户要合同号
+13. [ ] 合同号按已确认项目从历史带出；对不上或项目「不填」用 `20260999`。不是 `20260999` 时承担主体不传，客户 / 项目仍写入 `data`
+14. [ ] 总部费用报销没有把合同号列进提问。用户自己说了合同号才用用户的
+15. [ ] 话费报销：金额字段填的是核算后的实报金额
+16. [ ] `action` 是 `"draft"`，没有问用户「存草稿 / 提交审批」，也没有传 `"submit"`
+
+草稿落库后确认：
+
+17. [ ] 明细「费用说明」「费用明细」「相关凭证」仍空时已告诉用户是发票联动没带出，没有补写，也没有向用户要行程单，也没有向用户要起点和终点。客户 / 项目被冲空则写回。没有另建报销单，也没有补问合同号
 
 修改报销单前确认：
 
-15. [ ] `requestId` 来自 `workflow.createRequest` 的返回结果
-16. [ ] 走 `workflow.editLoad` → `workflow.editPrepare` → 用户确认 → `workflow.editApply`，只传要改的字段
-17. [ ] 只改 `editableFields` 里的字段，遇 `notEditable` 如实转述，不换字段 id 绕过
+18. [ ] `requestId` 来自 `workflow.createRequest` 的返回结果
+19. [ ] 走 `workflow.editLoad` → `workflow.editPrepare` → 用户确认 → `workflow.editApply`，只传要改的字段。Step 5.3 里用户刚给的值不再二次确认
+20. [ ] 只改 `editableFields` 里的字段，遇 `notEditable` 如实转述，不换字段 id 绕过。明细「费用说明」「费用明细」「相关凭证」不在修改范围内