weaver-work-cli 0.1.40 → 0.1.44

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

@@ -2,7 +2,7 @@
 
 > 本文件说明报销**数据准备**阶段各 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 节。
+> 报销单的创建与修改不在本文件：统一走 `weaver-e10-workflow` 的 `workflow.createForm` / `workflow.createRequest` / `workflow.edit*`，见第 8 节。
 
 ---
 
@@ -57,26 +57,22 @@ weaver-work-cli --json invoice run invoice.reim.file-ocr.preview --input-json '{
 
 ### 返回字段说明
 
-
-| 字段                | 说明                          |
-| ----------------- | --------------------------- |
-| `fileId`          | 原始文件/附件ID                   |
-| `fileName`        | 文件名                         |
-| `status`          | 识别状态：`"success"` 或 `"fail"` |
-| `errorMsg`        | 识别结果消息                      |
-| `invoiceId`       | 发票唯一ID（后续匹配和填单使用）           |
-| `invoiceType`     | 发票类型名称                      |
-| `invoiceTypeCode` | 发票类型编码                      |
-| `amount`          | 发票金额（价税合计）                  |
-| `consumeContent`  | 消费内容/商品名称                   |
-| `invoiceDate`     | 开票日期（yyyy-MM-dd）            |
-| `invoiceNumber`   | 发票号码                        |
-| `buyerName`       | 购方公司名称                      |
-| `sellerName`      | 销方公司名称                      |
-| `expenseType`     | 费用类型名称                      |
-
-
-> 返回的发票数据结构与 `invoice.list` 一致，可直接用于后续匹配和填单流程。
+| 字段 | 说明 |
+| --- | --- |
+| `fileId` | 原始文件/附件ID |
+| `fileName` | 文件名 |
+| `status` | 识别状态：`"success"` 或 `"fail"` |
+| `errorMsg` | 识别结果消息 |
+| `invoiceId` | 发票唯一ID（后续匹配和填单使用） |
+| `invoiceType` | 发票类型名称 |
+| `invoiceTypeCode` | 发票类型编码 |
+| `amount` | 发票金额（价税合计） |
+| `consumeContent` | 消费内容/商品名称 |
+| `invoiceDate` | 开票日期（yyyy-MM-dd） |
+| `invoiceNumber` | 发票号码 |
+| `buyerName` | 购方公司名称 |
+| `sellerName` | 销方公司名称 |
+| `expenseType` | 费用类型名称 |
 
 ### 多 fileId 处理
 
@@ -84,12 +80,10 @@ weaver-work-cli --json invoice run invoice.reim.file-ocr.preview --input-json '{
 
 ### 异常处理
 
-
-| 场景                        | 处理方式             |
-| ------------------------- | ---------------- |
+| 场景 | 处理方式 |
+| --- | --- |
 | 某个文件识别失败（`status="fail"`） | 跳过该文件，用成功的发票继续流程 |
-| 全部文件识别失败                  | 提示用户识别失败，无法继续    |
-
+| 全部文件识别失败 | 提示用户识别失败，无法继续 |
 
 ---
 
@@ -105,211 +99,114 @@ CLI 已固定 `flag`（个人票夹=0 / 企业票夹=6），默认 `sreim="3"`
 | --- | --- | --- | --- |
 | `page_size` | Integer | 否 | 每页条数，默认 `10`，建议不超过 `20` |
 | `start_pos` | Integer | 否 | 分页起始位置，默认 `0` |
-| `consumption_tm_begin` / `consumption_tm_end` | Integer \| String | 否 | **消费日期范围（报销默认）**。可传秒级时间戳，也可直接传 `"YYYY-MM-DD"`（CLI 转成秒级时间戳：起始日东八区零点，结束日当天 `23:59:59`）。用户未指定日期时，默认最近一周 |
-| `date_begin` / `date_end` | Integer \| String | 否 | 开票日期范围。可传秒级时间戳，也可直接传 `"YYYY-MM-DD"`（0.1.15 起 CLI 按东八区零点换算）。仅用户明确说开票日期时使用 |
-| `create_tm_begin` / `create_tm_end` | Integer \| String | 否 | 录入/创建日期范围，写法同上。仅用户明确说录入/创建日期时使用 |
+| `consumption_tm_begin` / `consumption_tm_end` | String | 否 | **消费日期范围（报销默认）**。直接传 `"YYYY-MM-DD"`：起始日按东八区零点，结束日按当天 `23:59:59`，CLI 换算成秒级时间戳。用户未指定日期时，默认最近一周 |
+| `date_begin` / `date_end` | String | 否 | 开票日期范围，传 `"YYYY-MM-DD"`（起止都按东八区零点换算）。仅用户明确说开票日期时使用 |
+| `create_tm_begin` / `create_tm_end` | String | 否 | 录入/创建日期范围，写法同开票日期。仅用户明确说录入/创建日期时使用 |
 | `content` | String | 否 | 消费内容关键词（如 `"滴滴"`、`"住宿"`） |
 | `number` | String | 否 | 发票号码精确匹配 |
 | `types` | Array\<Integer\> | 否 | 发票类型 ID 数组（见下方映射表） |
 
-不支持 `fylxs`。报销日期筛选默认用 `consumption_tm_begin` / `consumption_tm_end`，不要和开票日期混用。
-
-### 时间戳计算
-
-> **所有日期参数的秒级时间戳由 AI 按内联公式直接计算（UTC+8 时区）。**
-> 0.1.15 起日期字段也直接接受 `"YYYY-MM-DD"`（CLI 转成秒级时间戳）。`consumption_tm_end` 按东八区当天 `23:59:59` 换算，其余按零点。日期区间不跨时区歧义时优先写 `"YYYY-MM-DD"`；已经算好的秒级时间戳可原样传入。
-> 完整公式和 Fallback 见 [reim-workflow.md - 时间戳内联计算](reim-workflow.md#时间戳内联计算零工具调用)。
-
-示例（最近一周，只传必要字段）：
-
-```json
-{
-  "page_size": 10,
-  "start_pos": 0,
-  "consumption_tm_begin": 1785513600,
-  "consumption_tm_end": 1786982399
-}
-```
-
-> 上方示例中的时间戳仅为示意，实际使用时由 AI 按内联公式动态计算。
+日期一律写 `"YYYY-MM-DD"`，不要自己算时间戳；已有的秒级时间戳也可以原样传。不支持 `fylxs`。报销日期筛选默认用 `consumption_tm_begin` / `consumption_tm_end`，不要和开票日期混用。
 
 ### 命令
 
+示例：最近一周（今天 2026-08-04）。
+
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"consumption_tm_begin":1785513600,"consumption_tm_end":1786982399}'
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"consumption_tm_begin":"2026-07-28","consumption_tm_end":"2026-08-04"}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"consumption_tm_begin":1785513600,"consumption_tm_end":1786982399}'
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"consumption_tm_begin":"2026-07-28","consumption_tm_end":"2026-08-04"}'
 ```
 
-### 预筛选入参（先获取到事前申请时使用）
+要给人看或按城市 / 行程逐张判断就加 `--view summary`，见 [invoice-output-view.md](invoice-output-view.md)。
 
-> **前提：消费日期一定不早于事前申请日期。** CLI 用 `consumption_tm_begin` / `consumption_tm_end`（消费日期，秒级时间戳）筛选。
+### 预筛选入参（先获取到事前申请时使用）
 
-如果已有事前申请数据，利用事前申请的 `createTime` 来缩小查询范围：
+消费日期一定不早于事前申请日期。已有事前申请时：
 
-- `consumption_tm_begin` = 最早事前申请 createTime 对应的秒级时间戳
-- `consumption_tm_end` = 当前日期 23:59:59 对应的秒级时间戳
+- `consumption_tm_begin` = 最早事前申请 `createTime` 的日期部分
+- `consumption_tm_end` = 今天
 
 ### 返回示例
 
-CLI 信封中列表在 `data.items`。下面是单条发票的票面结构（对应 `items[]` 元素，不是顶层 `infos`）：
+CLI 信封中列表在 `data.items`，每项是**平铺**的发票对象（`invoice.get` 才是 `infos[].info` 包装）。下面是一条精简后的 `items[]` 元素：
 
 ```json
 {
-  "infos": [
-    {
-      "info": {
-        "id": "1301239558731259905",
-        "fid": "1301239558731259905",
-        "code": "",
-        "number": "26467000000088899841",
-        "ext": "{\"ttax\":\"54\",\"trate\":\"6.0\",\"pcontact\":\"海南省三亚市海棠区海棠北路36号亚特兰蒂斯酒店 0898-88986666\",\"totalBig\":\"玖佰伍拾肆\",\"title\":\"电子发票（普通发票）\",\"bbank\":\"\",\"content\":\"*生产生活服务*水上乐园门票\",\"issuer\":\"张怡\",\"products\":[{\"tprice\":\"54\",\"taxClassifyCode\":\"3070101000000000000\",\"price\":\"900.00\",\"qty\":\"1\",\"name\":\"*生产生活服务*水上乐园门票\",\"no\":\"1\",\"trate\":\"6.0\",\"amount\":\"900\",\"smodel\":\"\",\"muint\":\"张\"}],\"province\":\"海南省\",\"bcontact\":\"上海市闵行区三鲁公路3419号021-52262600\",\"pbank\":\"462601500018800030539\",\"comment\":\"0808+5737268\",\"category\":\"电子发票（普通发票）\",\"corp_seal\":\"1\"}",
-        "rb": { "trace": "", "ret": 0, "lang": "53512" },
-        "fylx": "897092516517920775",
-        "total": 0,
-        "currency": "CNY",
-        "currencyName": "人民币",
-        "empId": "9080972482706531342",
-        "province": "海南省",
-        "modify_info": {
-          "ctm": 1786168444,
-          "utm": 1786168444,
-          "cstm": 1786118400,
-          "source": 4
-        },
-        "comm_info": {
-          "pro": {
-            "cname": "电子发票（普通发票）",
-            "type": 33,
-            "date": "2026-08-08",
-            "status": 0
-          },
-          "price": {
-            "amount": "900",
-            "total": "954",
-            "treim": ""
-          },
-          "buyer": {
-            "tcode": "9131000070322836XD",
-            "company": "上海泛微网络科技股份有限公司"
-          },
-          "payer": {
-            "tcode": "91460200348073438U",
-            "company": "海南亚特兰蒂斯商旅发展有限公司亚特兰蒂斯酒店"
-          }
-        },
-        "relative_fids": [],
-        "bill_type": 0
-      },
-      "ret": { "trace": "", "ret": 0, "message": "执行成功", "lang": "53512" },
-      "is_valid": 0
-    }
-  ],
-  "res_base": { "trace": "", "ret": 0, "message": "执行成功", "lang": "53512" }
+  "fid": "1301239558731259905",
+  "number": "26467000000088899841",
+  "code": "",
+  "detailUrl": "https://e10.example.com/sp/inc/incDetail?fid=1301239558731259905",
+  "ext": "{\"content\":\"*生产生活服务*水上乐园门票\",\"province\":\"海南省\",\"comment\":\"0808+5737268\",\"issuer\":\"张怡\",\"products\":[...]}",
+  "extInfo": {
+    "content": "*生产生活服务*水上乐园门票",
+    "province": "海南省",
+    "comment": "0808+5737268"
+  },
+  "fylx": "897092516517920775",
+  "province": "海南省",
+  "modify_info": { "ctm": 1786168444, "utm": 1786168444, "cstm": 1786118400, "source": 4 },
+  "comm_info": {
+    "pro": { "cname": "电子发票（普通发票）", "type": 33, "date": "2026-08-08", "status": 0 },
+    "price": { "amount": "900", "total": "954" },
+    "buyer": { "tcode": "9131000070322836XD", "company": "上海泛微网络科技股份有限公司" },
+    "payer": { "tcode": "91460200348073438U", "company": "海南亚特兰蒂斯商旅发展有限公司亚特兰蒂斯酒店" }
+  },
+  "relative_fids": [],
+  "bill_type": 0
 }
 ```
 
 ### 返回字段说明
 
-> **⚠️ `ext` 是 JSON 字符串，使用前需先 `JSON.parse(ext)` 解析。**
-
-| 字段路径 | 对应标准字段名 | 说明 |
+| 字段路径（`items[]`） | 对应标准字段名 | 说明 |
 | --- | --- | --- |
-| `info.fid` | `invoiceId` | 发票唯一 ID（后续匹配和填单使用） |
-| `info.number` | `invoiceNumber` | 发票号码 |
-| `info.code` | — | 发票代码 |
-| `info.comm_info.pro.cname` | `invoiceType` | 发票类型名称 |
-| `info.comm_info.pro.type` | `invoiceTypeCode` | 发票类型编码（见下方分类说明） |
-| `info.comm_info.pro.date` | `invoiceDate` | 开票日期（yyyy-MM-dd） |
-| `info.comm_info.pro.status` | — | 发票状态（**8=全额红冲，必须过滤掉**） |
-| `info.comm_info.price.total` | `amount` | **价税合计（发票金额）**——报销金额一律用它 |
-| `info.comm_info.price.amount` | — | 不含税金额，**不要拿来填报销金额**（字段名虽叫 `amount`） |
-
-> ⚠️ 原始返回里叫 `amount` 的字段**不一定是价税合计**：`invoice.list` / `invoice.get` 的 `price.amount`、`invoice.get` 里的 `amount` 都是**不含税**金额（实测滴滴票 `price.amount=48.61`、`price.total=50.07`）。本技能文档里说的「发票 `amount`」专指上表映射后的**价税合计 `price.total`**。
-| `info.comm_info.buyer.company` | `buyerName` | 购方公司名称 |
-| `info.comm_info.payer.company` | `sellerName` | 销方公司名称 |
-| `info.fylx` | — | 费用类型 ID（需根据 ID 查找对应 `expenseType` 名称） |
-| `info.province` | — | 省份 |
-| `info.modify_info.cstm` | — | 消费日期（秒级时间戳） |
-| `info.modify_info.source` | — | 来源（4=邮箱等） |
-| `ext`（解析后）`.content` | `consumeContent` | 消费内容/商品名称 |
-| `ext`（解析后）`.products` | — | 商品明细列表 |
-| `ext`（解析后）`.province` | — | 省份 |
-| `ext`（解析后）`.comment` | — | 备注 |
-| `ext`（解析后）`.issuer` | — | 开票人 |
-| `ext`（解析后）`.pcontact` | — | 销售方地址及电话 |
-| `ext`（解析后）`.bcontact` | — | 购买方地址及电话 |
-
-### ext 字段详细结构
-
-`ext` 是 JSON 字符串，解析后结构如下：
-
-```json
-{
-  "ttax": "54",
-  "trate": "6.0",
-  "pcontact": "海南省三亚市海棠区海棠北路36号亚特兰蒂斯酒店 0898-88986666",
-  "totalBig": "玖佰伍拾肆",
-  "title": "电子发票（普通发票）",
-  "bbank": "",
-  "content": "*生产生活服务*水上乐园门票",
-  "issuer": "张怡",
-  "products": [
-    {
-      "tprice": "54",
-      "taxClassifyCode": "3070101000000000000",
-      "price": "900.00",
-      "qty": "1",
-      "name": "*生产生活服务*水上乐园门票",
-      "no": "1",
-      "trate": "6.0",
-      "amount": "900",
-      "smodel": "",
-      "muint": "张"
-    }
-  ],
-  "province": "海南省",
-  "bcontact": "上海市闵行区三鲁公路3419号021-52262600",
-  "pbank": "462601500018800030539",
-  "comment": "0808+5737268",
-  "category": "电子发票（普通发票）"
-}
-```
-
-### 数据过滤规则（重要，前置处理）
-
-> **⚠️ 获取到发票数据后，必须先过滤掉不允许报销的发票，再进行后续分类和填单。**
-
-| 过滤条件 | 字段路径 | 值 | 说明 |
-| --- | --- | --- | --- |
-| **全额红冲发票** | `info.comm_info.pro.status` | `8` | 该发票已被全额红冲，**必须过滤掉，不允许报销** |
-
-过滤后的发票才进入后续的 invoiceTypeCode 分类和填单流程。
-
----
-
-### invoiceTypeCode 分类（重要）
-
-返回的 `info.comm_info.pro.type` 按值分为两类，**填单时处理方式完全不同**：
+| `fid` | `invoiceId` | 发票唯一 ID（后续匹配和填单使用） |
+| `number` | `invoiceNumber` | 发票号码 |
+| `code` | — | 发票代码 |
+| `detailUrl` | — | 发票详情页链接，展示发票号码时做成超链接 |
+| `comm_info.pro.cname` | `invoiceType` | 发票类型名称 |
+| `comm_info.pro.type` | `invoiceTypeCode` | 发票类型编码（见下方分类说明） |
+| `comm_info.pro.date` | `invoiceDate` | 开票日期（yyyy-MM-dd） |
+| `comm_info.pro.status` | — | 发票状态 |
+| `comm_info.price.total` | `amount` | **价税合计（发票金额）**——报销金额一律用它 |
+| `comm_info.price.amount` | — | 不含税金额，**不要拿来填报销金额**（字段名虽叫 `amount`） |
+| `comm_info.buyer.company` | `buyerName` | 购方公司名称 |
+| `comm_info.payer.company` | `sellerName` | 销方公司名称 |
+| `fylx` | — | 费用类型 ID |
+| `province` | — | 省份 |
+| `modify_info.cstm` | — | 消费日期（秒级时间戳）。`--view summary` 和 `candidates.list` 都不带，需要时用 `--fields fid,modify_info.cstm` 取 |
+| `modify_info.source` | — | 来源（4=邮箱等） |
+| `extInfo.content` | `consumeContent` | 消费内容（没有时取商品名称） |
+| `extInfo.expenseNote` | — | 票面费用说明（`ext.expenseDesc`，如「上海-武汉」），只用来判断行程，不写进报销单 |
+| `extInfo.city` / `extInfo.province` | — | 开票方所在城市 / 省份 |
+| `extInfo.comment` | — | 备注，常写出差地和行程（如「2026/10/25上海-武汉 CZ3580」） |
+| `extInfo.from` / `extInfo.to` | — | 起止地（打车、火车、机票） |
+| `extInfo.stationGetOn` / `extInfo.stationGetOff` | — | 上下车站点 |
+
+> `ext` 是 JSON 字符串。`invoice.list` 已默认取回完整 `ext`，并解析成上面的 `extInfo`（空值不出现），直接读 `extInfo` 或用 `--view summary`，不要自己解析 `ext`。
+> ⚠️ 原始返回里叫 `amount` 的字段**不一定是价税合计**：`price.amount`、`invoice.get` 里的 `amount` 都是**不含税**金额（实测滴滴票 `price.amount=48.61`、`price.total=50.07`）。本技能文档里说的「发票 `amount`」专指价税合计 `price.total`。
+
+### invoiceTypeCode 分类
+
+`comm_info.pro.type` 按值分为两类，**填单时处理方式完全不同**：
 
 | 分类 | type 值 | 说明 | 填单位置 |
 | --- | --- | --- | --- |
 | **发票** | 除 17/18/57/58 以外的所有值 | 正式发票，每张独立成一行明细 | 明细「相关发票」（`EinvoiceComponent`） |
 | **相关凭证** | 17, 18, 57, 58 | 行程单、小票/水单、电子支付凭证、其他支付凭证，不能独立成行 | 明细「相关凭证」不赋值，由发票联动带出 |
 
-**关键规则：相关凭证不能单独成行，也不写入明细「相关凭证」，由「相关发票」联动带出。**
-
-详细规则见 [form-fill-rules.md](reim-form-fill-rules.md#3-相关凭证不赋值由联动带出)
+详细规则见 [reim-form-fill-rules.md](reim-form-fill-rules.md#1-发票与相关凭证分类)。
 
 ### 发票类型 ID 映射表
 
-> 用于 `types` 入参筛选，`info.comm_info.pro.type` 返回值也对应此表。
+> 用于 `types` 入参筛选，`comm_info.pro.type` 返回值也对应此表。
 
 | ID | 名称 |
 | --- | --- |
@@ -363,72 +260,50 @@ CLI 信封中列表在 `data.items`。下面是单条发票的票面结构（对
 | 57 | 支付凭证 |
 | 58 | 其他票据凭证 |
 
-> **相关凭证类型**（不能独立成行，也不写入"相关凭证"字段，由发票联动带出）：17（小票/水单）、18（滴滴行程单——注意：滴滴开具的增值税电子普通发票 type=3，是正式发票可独立成行；type=18 仅指滴滴的支付行程凭证）、57（支付凭证）、58（其他票据凭证）
+> **相关凭证类型**：17（小票/水单）、18（滴滴行程单）、57（支付凭证）、58（其他票据凭证）。滴滴开具的增值税电子普通发票 type=3，是正式发票，可独立成行；type=18 仅指滴滴的支付行程凭证。
 
 ---
 
-## 1b. 报销候选发票分类
+## 2. 报销候选发票分类
 
 CLI operation：`invoice.reim.candidates.list`（read）
 
-自动翻页拉取未报销（sreim=3）发票，并按 `oreim.list_reim` / 红冲状态分组，**不再需要手动翻页和逐条剔重**。
+自动翻页拉取未报销（sreim=3）发票，并按 `oreim.list_reim` 分组，**不再需要手动翻页和逐条剔重**。
 
-macOS/Linux（bash/zsh）：
+Windows PowerShell：
 
-```bash
+```powershell
 weaver-work-cli --json invoice run invoice.reim.candidates.list --input-json '{"consumption_tm_begin":"2026-09-14","consumption_tm_end":"2026-09-21"}'
 ```
 
-Windows PowerShell：
+macOS/Linux（bash/zsh）：
 
-```powershell
+```bash
 weaver-work-cli --json invoice run invoice.reim.candidates.list --input-json '{"consumption_tm_begin":"2026-09-14","consumption_tm_end":"2026-09-21"}'
 ```
 
-- 入参（全部可选）：`consumption_tm_begin`/`consumption_tm_end`（消费日期范围，报销默认）、`date_begin`/`date_end`（开票日期范围，仅用户明确说开票日期时用）、`page_size`（10-200，默认 50）、`max_items`（1-500，默认 200，超出截断并产生 warning）、`include_red_reversed`（默认 `false`）。日期字段接受 `YYYY-MM-DD` 或秒级时间戳。
-- **红冲票默认已过滤**：全额红冲发票（`status=8`）不出现在任何一组，被过滤的张数由 `summary.filteredRedReversedCount` 告知。需要看红冲票时传 `include_red_reversed: true`，此时它们进 `redReversed` 组。
-- 输出：`available` / `assigned` / `redReversed` 三组，每组元素含 `fid`、`number`、`date`、`total`、`buyer`、`payer`、`typeName`、`status`、`valid`、`reimRequests`；`summary` 给出三组的张数与金额合计；`warnings` 含截断与金额解析告警。
+- 入参（全部可选）：`consumption_tm_begin`/`consumption_tm_end`（消费日期范围，报销默认）、`date_begin`/`date_end`（开票日期范围，仅用户明确说开票日期时用）、`page_size`（10-200，默认 50）、`max_items`（1-500，默认 200，超出截断并产生 warning）。日期字段传 `YYYY-MM-DD`。
+- 输出：`available` / `assigned` 两组，每组元素含 `fid`、`number`、`date`、`total`、`buyer`、`payer`、`typeName`、`status`、`valid`、`reimRequests`；`summary` 给出两组的张数与金额合计；`warnings` 含截断与金额解析告警。分组元素不带 `ext`，要按城市 / 行程判断时改用 `invoice.list --view summary`。
 - **报销范围永远从 `available` 里选**；`assigned` 是已挂在报销单上的（再报 = 重复报销）。
 - `sreim="3"`（未报销）**不会**排除已挂单的发票，判断是否已挂单必须看分组结果（即 `list_reim`）。
 - 两次查询之间发票从 `assigned` 翻到 `available`，通常是原报销单被删除、发票被真实释放，分类本身是准的；只有对某张票的归属存疑时，才用 `weaver-work-cli workflow run workflow.detail --input-json '{"requestId":"<id>"}'` 核实原单是否还在，不要每次报销都逐张复核。
 
 ---
 
-## 2. 查询事前申请流程列表
+## 3. 查询事前申请流程列表
 
 CLI operation：`invoice.reim.requests.list`
 
 ### 入参
 
-#### 分页参数
-
-
-| 参数         | 类型      | 必填  | 默认值 | 说明      |
-| ---------- | ------- | --- | --- | ------- |
-| `pageNo`   | Integer | 是   | 1   | 页码，从1开始 |
-| `pageSize` | Integer | 否   | 100 | 每页条数。不传时 CLI 默认 100，显式传入则覆盖 |
-
-
-#### 筛选条件
-
-
-| 参数                   | 类型     | 说明                   | 示例              |
-| -------------------- | ------ | -------------------- | --------------- |
-| `requestname`        | String | 流程标题模糊搜索             | `"差旅"`, `"交通费"` |
-| `cusCreateDateStart` | String | 发起日期-开始 (yyyy-MM-dd)。不传则不限开始日期 | `"2026-07-01"`  |
-| `cusCreateDateEnd`   | String | 发起日期结束 (yyyy-MM-dd)。**不传时 CLI 按东八区当天 + 1 天填入；传入时 CLI 用该日期再 + 1 天后发给接口。** 调用方传业务结束日本身，不要自己再加 1 天 | `"2026-07-31"`  |
-
-
-### 推荐默认入参
-
-查事前申请、用户没有指定结束日期时，用下面这份入参。不传 `pageSize` 时 CLI 也按 100 填入。不要自己计算或传入 `cusCreateDateEnd`，CLI 会按东八区当天 + 1 天写入。如果传了 `cusCreateDateEnd`，CLI 会用传入日期再 + 1 天后发给接口，调用方不要自己先加 1 天。
-
-```json
-{
-  "pageNo": 1,
-  "pageSize": 100
-}
-```
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNo` | Integer | 是 | 1 | 页码，从1开始 |
+| `pageSize` | Integer | 否 | 100 | 每页条数 |
+| `requestname` | String | 否 | — | 流程标题模糊搜索，如 `"差旅"`、`"交通费"` |
+| `cusCreateDateStart` | String | 否 | 结束日前 7 天，查不到放宽到前 1 个月；话费前 90 天 | 发起日期开始（yyyy-MM-dd）。**用户没指定开始日期时不要传**，由 CLI 按下方「默认日期窗口」取值 |
+| `cusCreateDateEnd` | String | 否 | 东八区当天 + 1 天 | 发起日期结束（yyyy-MM-dd）。**传入时 CLI 用该日期再 + 1 天后发给接口**，调用方传业务结束日本身，不要自己再加 1 天；用户没指定结束日期时不要传 |
+| `scene` | String | 否 | — | 话费报销传 `"phone"`，默认开始日改为结束日前 90 天；其他场景不传 |
 
 ### 命令
 
@@ -444,29 +319,24 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":100}'
 ```
 
-### 预筛选入参（先获取到发票时使用）
+### 默认日期窗口（CLI 内置）
 
-> **前提：事前申请日期一定在开票日期之前。**
+日期由 CLI 算，Agent 不要自己推算 `cusCreateDateStart` / `cusCreateDateEnd`，只在用户明确说了日期时传。
 
-如果已有发票数据，利用发票的 `invoiceDate` 来缩小事前申请查询范围：
-
-```json
-{
-  "pageNo": 1,
-  "pageSize": 100,
-  "cusCreateDateStart": "2026-04-21",
-  "cusCreateDateEnd": "2026-07-30"
-}
-```
+| 情况 | 开始日 | 结束日（发给接口时 CLI 再 + 1 天） |
+| --- | --- | --- |
+| 默认 | 结束日前 7 天；第 1 页一条都没有时，CLI 自动放宽到结束日前 1 个月再查一次 | 用户指定的日期，没指定为东八区当天 |
+| 话费报销（`scene="phone"`） | 结束日前 90 天，不再放宽 | 同上 |
+| 用户指定了开始日 | 用户指定的日期，不再放宽 | 同上 |
 
-- `cusCreateDateEnd` = 最晚发票 invoiceDate（事前申请不会晚于开票日期）。CLI 会再 + 1 天后发给接口；不需要按开票日收窄时不要传，交给「东八区当天 + 1 天」默认值
-- `cusCreateDateStart` = 最早发票 invoiceDate 往前推 90 天（合理的事前申请窗口期）
-- **话费报销例外**：话费补贴事前申请可能在很早以前审批，`cusCreateDateStart` 需往前推 **1095 天（3 年）**，并加 `requestname="话费"` 缩小结果。详见 [reim-phone-subsidy-rules.md](reim-phone-subsidy-rules.md)。
-- 取回列表后，发票和事前申请**只按时间关联**：开票日期落在发起日之后 90 天内（话费不设 90 天上限）。正好 1 条就绑定；2 条及以上先问用户。见 [reim-matching-rules.md](reim-matching-rules.md)。
+- 返回的 `data.query` 写明本次实际用的窗口：`cusCreateDateStart`、`cusCreateDateEnd`（业务结束日，未加 1 天）、`widened`（是否放宽到 1 个月）。
+- 翻页（`pageNo` ≥ 2）时把第 1 页 `data.query.cusCreateDateStart` 原样传回，保证各页窗口一致。
+- 放宽后仍为空：告诉用户「最近一个月（话费为最近 90 天）没有查到事前申请」，请用户给出发起时间范围后按指定日期再查。
+- 取回列表后只按时间关联：开票日期落在发起日之后 90 天内（话费不设上限）。正好 1 条就绑定；2 条及以上先问用户。见 [reim-matching-rules.md](reim-matching-rules.md)。
 
 ### 返回示例
 
-CLI 只保留下面 7 个字段，接口原文里的 `requestnametitle`、部门、节点、URL 等不再输出。
+CLI 只保留下面 7 个字段。
 
 ```json
 {
@@ -488,39 +358,70 @@ CLI 只保留下面 7 个字段，接口原文里的 `requestnametitle`、部门
 }
 ```
 
-### 返回字段说明
+| 字段 | 说明 |
+| --- | --- |
+| `requestid` | 事前申请流程ID（用于匹配绑定和填单） |
+| `workflowid` | 事前申请自己的工作流ID |
+| `requestname` | 流程标题 |
+| `flowStatus` | 流程状态（6=已完成） |
+| `creatorId` | 发起人ID |
+| `creatorName` | 发起人姓名 |
+| `createTime` | 发起时间 |
 
+列表里没有出差起止日期，`createTime` 是发起时间，常常晚于出差（先出差后补单）。按出差流程查票时，用下面的 `workflow.summary` 读表单。
 
-| 字段            | 说明                  |
-| ------------- | ------------------- |
-| `requestid`   | 事前申请流程ID（用于匹配绑定和填单） |
-| `workflowid`  | 工作流ID（用于获取表单结构）     |
-| `requestname` | 流程标题                |
-| `flowStatus`  | 流程状态（6=已完成）         |
-| `creatorId`   | 发起人ID               |
-| `creatorName` | 发起人姓名               |
-| `createTime`  | 发起时间                |
+### 读取出差流程的起止日期（`workflow.summary`）
 
+调用 `weaver-e10-workflow` 的 `workflow.summary`（只读，**不标记已读**；不要用 `workflow.detail`，它会把流程标成已读）。多条出差流程时并行调用：
 
----
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json workflow run workflow.summary --input-json '{"requestId":"1331357089254367304","summaryFields":20}'
+```
 
-## 5. 获取报销单工作流ID
+macOS/Linux（bash/zsh）：
 
-CLI operation：`invoice.reim.workflow.resolve`
+```bash
+weaver-work-cli --json workflow run workflow.summary --input-json '{"requestId":"1331357089254367304","summaryFields":20}'
+```
 
-根据事前申请流程ID获取对应的报销单工作流ID；若无事前申请则返回候选报销单工作流列表。
+返回（2026-10-30 真机，「出差/外出流程」节选）：
 
-### 入参
+```json
+{
+  "basicInfo": { "requestTitle": "出差/外出流程-龚为明-2026-10-26(测试)", "createdAt": "2026-10-28 17:46:49", "flowStatus": "审批中" },
+  "summaryFields": [
+    { "fieldName": "起始日期", "componentKey": "DateComponent", "value": "2026-10-26 00:00" },
+    { "fieldName": "结束日期", "componentKey": "DateComponent", "value": "2026-10-26 23:56" },
+    { "fieldName": "出差城市", "componentKey": "City", "value": "中国/湖北/武汉" },
+    { "fieldName": "出差原因", "componentKey": "TextArea", "value": "武汉星辰项目关于违规数据处理方案的沟通" }
+  ]
+}
+```
 
+| 取值 | 字段 |
+| --- | --- |
+| 出差开始日 | `summaryFields` 里 `fieldName` 是「起始日期」（或「开始日期」「出差开始日期」）的 `value`，只取日期部分 `YYYY-MM-DD` |
+| 出差结束日 | `fieldName` 是「结束日期」（或「出差结束日期」）的 `value`，只取日期部分 |
+| 出差城市 | `fieldName` 是「出差城市」的 `value`，取最后一级（`中国/湖北/武汉` → 武汉） |
+| 状态 | `basicInfo.flowStatus`（中文，原样展示） |
 
-| 参数           | 类型          | 必填  | 说明                         |
-| ------------ | ----------- | --- | -------------------------- |
-| `requestIds` | ArrayString | 是   | 事前申请流程ID列表。无事前申请时传空数组 `[]` |
+起止日期任一取不到 → 不猜，按 [reim-workflow.md](reim-workflow.md)「按出差流程查票」第 3 步处理。
+
+---
 
+## 4. 获取报销单工作流
 
-### 场景A：有事前申请
+CLI operation：`invoice.reim.workflow.resolve`
+
+根据事前申请流程ID获取对应的报销单工作流；无事前申请时返回候选报销单工作流列表。
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `requestIds` | Array\<String\> | 是 | 事前申请流程ID列表。无事前申请时传空数组 `[]` |
 
-**命令：**
+### 有事前申请
 
 Windows PowerShell：
 
@@ -534,38 +435,25 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli --json invoice run invoice.reim.workflow.resolve --input-json '{"requestIds":["1299854672520364033"]}'
 ```
 
-**返回：**
+返回：
 
 ```json
 {
   "code": 200,
-  "msg": "接口返回成功",
-  "status": true,
   "data": {
     "requestWorkflowMap": {
       "1299854672520364033": {
-        "workFlowId": "1250064959163990031",
-        "workFlowName": "差旅事前申请"
+        "workFlowId": "100003460000000060",
+        "workFlowName": "总部费用报销"
       }
     }
-  },
-  "fail": false
+  }
 }
 ```
 
-**返回字段说明：**
-
-
-| 字段                                           | 说明                                              |
-| -------------------------------------------- | ----------------------------------------------- |
-| `requestWorkflowMap`                         | 事前申请ID → 对应报销单工作流的映射                            |
-| `requestWorkflowMap[requestId].workFlowId`   | 对应的报销单工作流ID（与 `workFlowName` 拼成 `名称(ID)` 传给 `workflow.createForm`） |
-| `requestWorkflowMap[requestId].workFlowName` | 报销单流程名称                                         |
-
+`requestWorkflowMap[requestId]` 的 `workFlowName` 和 `workFlowId` 拼成 `{workFlowName}({workFlowId})` 传给 `workflow.createForm`。
 
-### 场景B：无事前申请
-
-**命令：**
+### 无事前申请
 
 Windows PowerShell：
 
@@ -579,59 +467,36 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli --json invoice run invoice.reim.workflow.resolve --input-json '{"requestIds":[]}'
 ```
 
-**返回：**
+返回：
 
 ```json
 {
   "code": 200,
-  "msg": "接口返回成功",
-  "status": true,
   "data": {
     "candidateWorkflows": [
-      {
-        "workFlowId": "1255675973064196097",
-        "workFlowName": "报销流程666【活动版本V1】"
-      },
-      {
-        "workFlowId": "1250064959163990031",
-        "workFlowName": "差旅事前申请"
-      }
+      { "workFlowId": "100003460000000060", "workFlowName": "总部费用报销" },
+      { "workFlowId": "1250064959163990031", "workFlowName": "差旅费用报销" }
     ]
-  },
-  "fail": false
+  }
 }
 ```
 
-**返回字段说明：**
-
-
-| 字段                                  | 说明         |
-| ----------------------------------- | ---------- |
-| `candidateWorkflows`                | 候选报销单工作流列表 |
-| `candidateWorkflows[].workFlowId`   | 报销单工作流ID   |
-| `candidateWorkflows[].workFlowName` | 报销单流程名称    |
-
-
 ### 使用策略
 
-
-| 场景                              | 处理方式                           |
-| ------------------------------- | ------------------------------ |
-| 有事前申请 → 所有事前申请对应同一 workFlowId   | 创建 1 个报销单                      |
-| 有事前申请 → 事前申请对应不同 workFlowId     | 按 workFlowId 分组，**每组各创建一个报销单** |
-| 无事前申请 → candidateWorkflows 只有1个 | 创建 1 个报销单                      |
-| 无事前申请 → candidateWorkflows 有多个  | 将发票按匹配分配到各工作流，**每组各创建一个报销单**   |
-
+| 场景 | 处理方式 |
+| --- | --- |
+| 有事前申请 → 所有事前申请对应同一 workFlowId | 创建 1 个报销单 |
+| 有事前申请 → 事前申请对应不同 workFlowId | 按 workFlowId 分组，**每组各创建一个报销单** |
+| 无事前申请 → candidateWorkflows 只有1个 | 创建 1 个报销单 |
+| 无事前申请 → candidateWorkflows 有多个 | 将发票按 [reim-workflow.md](reim-workflow.md) Step 2.5 的规则分配到各工作流，**每组各创建一个报销单** |
 
 ---
 
-## 5.5 获取当前人员及上级信息
+## 5. 获取当前人员及上级信息（兜底）
 
 CLI operation：`invoice.reim.employee-superiors`
 
-获取当前登录人员的基本信息及其所有上级人员列表。**兜底用**：承担主体、报销人上级、承担人直接上级、承担人所有上级通常由报销表单默认值带出；只有 `workflow.createForm` 的 `fields` 里这些字段没有 `initialValue`，或 `createRequest` 的 `missingFields` 列出它们时才调用（见 [reim-workflow.md](reim-workflow.md) Step 3.7）。
-
-### 命令
+承担主体、报销人上级、承担人直接上级、承担人所有上级通常由报销表单默认值带出；只有 `workflow.createForm` 的 `fields` 里这些字段没有 `initialValue`，或 `createRequest` 的 `missingFields` 列出它们时才调用（见 [reim-workflow.md](reim-workflow.md) Step 3.6）。无入参。
 
 Windows PowerShell：
 
@@ -645,367 +510,97 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli --json invoice run invoice.reim.employee-superiors --input-json '{}'
 ```
 
-### 入参
-
-无。
-
-### 返回示例
+返回：
 
 ```json
 {
   "code": 200,
-  "msg": "接口返回成功",
-  "status": true,
   "data": {
-    "currentEmployee": {
-      "id": "1201729946891231232",
-      "name": "后端开发111"
-    },
-    "directSuperior": {
-      "id": "1201729946891231233",
-      "name": "直属主管王五"
-    },
+    "currentEmployee": { "id": "1201729946891231232", "name": "后端开发111" },
+    "directSuperior": { "id": "1201729946891231233", "name": "直属主管王五" },
     "allSuperiors": [
-      {
-        "id": "1201729946891231111",
-        "name": "分管领导熊总"
-      },
-      {
-        "id": "1201729946891231233",
-        "name": "直属主管王五"
-      }
+      { "id": "1201729946891231111", "name": "分管领导熊总" },
+      { "id": "1201729946891231233", "name": "直属主管王五" }
     ]
-  },
-  "fail": false
+  }
 }
 ```
 
-### 返回字段说明
-
-| 字段 | 说明 |
-| --- | --- |
-| `currentEmployee.id` | 当前人员 ID（**字符串**，避免雪花 ID 超过 JS 安全整数精度） |
-| `currentEmployee.name` | 当前人员名称 |
-| `allSuperiors` | 所有上级列表（直接上级 + 间接上级，按层级从高到低排列），每项含 `id` 和 `name` |
-| `directSuperior` | **直接上级**（对象，含 `id` 和 `name`）。⚠️ **与 `allSuperiors[0]` 不是同一人**：`allSuperiors[0]` 是上级链中最高层（如分管领导），直接上级必须取 `directSuperior` |
-| `allSuperiors[].id` | 上级人员 ID（**字符串**） |
-
-### 填单字段对应关系
+ID 都是**字符串**（避免雪花 ID 超过 JS 安全整数精度）。`allSuperiors` 按层级从高到低排列。
 
 | 表单字段 | 取值方式 |
 | --- | --- |
 | 承担主体 / 申请人 | `{currentEmployee.name}({currentEmployee.id})` |
-| 报销人上级 / 承担人直接上级 | `{directSuperior.name}({directSuperior.id})`（**不是 `allSuperiors[0]`**） |
+| 报销人上级 / 承担人直接上级 | `{directSuperior.name}({directSuperior.id})`（⚠️ **不是 `allSuperiors[0]`**，后者是上级链最高层） |
 | 承担人所有上级 | `allSuperiors` 每项写成 `名称(ID)` 组成的数组 |
 
 ---
 
-## 5.6 获取发票明细行预填信息
-
-CLI operation：`invoice.reim.row-info`
-
-根据发票 ID 获取该发票在明细行中应填写的费用日期、关联凭证、费用科目。`fysm` 只作返回字段，**不要写入明细「费用说明」**，该列由发票联动带出。关联凭证 `itinerary` 也不写入「相关凭证」，`subjectId` / `subjectName` 也不写入「费用类型（科目）」，`date` 也不写入「费用日期」。**报销建单不再调用本 operation**：明细只写「相关发票」（及「相关流程」），其余列都由发票联动带出。
-
-### 入参
-
-
-| 参数          | 类型     | 必填  | 说明                 |
-| ----------- | ------ | --- | ------------------ |
-| `cdzt`      | String | 否   | 当前用户/人员 ID，不传则 CLI 使用当前登录用户 |
-| `requestid` | String | 否   | 事前申请流程 ID（无可不传或留空） |
-| `invoiceId` | String | 是   | 发票 ID |
-
-
-### 命令
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.reim.row-info --input-json '{"invoiceId":"1297093330645237792","requestid":""}'
-```
-
-macOS/Linux（bash/zsh）：
-
-```bash
-weaver-work-cli --json invoice run invoice.reim.row-info --input-json '{"invoiceId":"1297093330645237792","requestid":""}'
-```
-
-### 返回字段
-
-
-| 字段          | 说明               | 对应明细行字段                                  |
-| ----------- | ---------------- | ---------------------------------------- |
-| `date`      | 费用日期             | **建单不写入**，明细「费用日期」由发票联动带出 |
-| `fysm`      | 费用说明原文           | **不写入**明细「费用说明」。该列由发票联动带出 |
-| `itinerary` | 关联凭证 ID（多个用逗号拼接） | **不写入**，明细「相关凭证」由发票联动带出 |
-| `subjectId` | 费用科目 ID          | **建单不写入**，明细「费用类型（科目）」由发票联动带出 |
-| `subjectName` | 费用科目名称        | 同上；用户明确要求改科目时，与 `subjectId` 拼成 `名称(ID)` 走修改链 |
-| `sqje` / `sbje` | 整张发票的申请金额 | 仅参考；明细金额不写，由发票联动带出 |
-| `containsItinerary` | 是否关联了行程单 | — |
-| `itineraryData` | **行程单逐段明细**数组，每段含 `date`、`sqje`（该段金额）、`fysm`、`subjectId` / `subjectName`、`itinerary`（凭证 ID）、`invoiceId` | **暂不拆行**，也不要用其中的 `fysm` 生成费用说明。见 [reim-form-fill-rules.md](reim-form-fill-rules.md#4-行程单多段行程暂不拆行) |
-
-
-### 返回示例
-
-```json
-{
-  "code": 200,
-  "status": true,
-  "data": {
-    "date": "2026-07-29",
-    "fysm": "交通运输服务",
-    "itinerary": "1298798990831518001",
-    "subjectId": "100502270000000006"
-  }
-}
-```
-
-### 使用场景与优先级
-
-- **调用时机**：报销建单不调用；只在用户单独要查某张发票的预填信息时调用
-- **报销建单不调用**：返回的 `date`、`fysm`、`subjectId`、`itinerary` 都不写入明细，对应列由发票联动带出
-- 只在用户单独要查某张发票的预填信息时使用
-- **itinerary 处理**：不用来写「相关凭证」，也不拿它去 `invoice.browse-field.data` 取凭证对象。明细「相关凭证」由发票联动带出（见 [reim-form-fill-rules.md](reim-form-fill-rules.md#3-相关凭证不赋值由联动带出)）
-- **itineraryData 处理**：暂不拆行，不管几段都是一张发票一行。不要拿第一段和最后一段去写费用说明
-
----
-
-## 5.6b 批量获取发票预填信息（0.1.19 新增）
-
-CLI operation：`invoice.reim.row-info-batch`
-
-一次调用获取多张发票的预填信息，内部并行处理（并发度 4），避免 Agent 逐张串行调用 `invoice.reim.row-info` 导致 N-1 次额外 CLI 启动与网络往返。
-
-### 入参
-
-| 参数 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `invoiceIds` | Array\<String\> | 是 | 发票 ID 列表，1-100 个 |
-| `requestid` | String | 否 | 事前申请流程 ID（无可不传或留空） |
-| `cdzt` | String | 否 | 当前用户/人员 ID，不传则 CLI 使用当前登录用户 |
-
-### 命令
-
-macOS/Linux（bash/zsh）：
-
-```bash
-weaver-work-cli --json invoice run invoice.reim.row-info-batch --input-json '{"invoiceIds":["1297093330645237792","1297093330645237793"]}'
-```
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.reim.row-info-batch --input-json '{"invoiceIds":["1297093330645237792","1297093330645237793"]}'
-```
-
-### 返回示例
-
-```json
-{
-  "results": [
-    {
-      "invoiceId": "1297093330645237792",
-      "status": "success",
-      "data": {
-        "date": "2026-07-29",
-        "fysm": "交通运输服务",
-        "itinerary": "1298798990831518001",
-        "subjectId": "100502270000000006"
-      }
-    },
-    {
-      "invoiceId": "1297093330645237793",
-      "status": "fail",
-      "error": "获取发票 1297093330645237793 行预填失败"
-    }
-  ],
-  "succeeded": 1,
-  "failed": 1,
-  "total": 2,
-  "workflow": { "workflow": "invoice.reim.row-info-batch", "version": 1, "state": "PARTIAL" }
-}
-```
-
-### 返回字段说明
-
-| 字段 | 说明 |
-| --- | --- |
-| `results[].invoiceId` | 对应的发票 ID |
-| `results[].status` | `"success"` 或 `"fail"` |
-| `results[].data` | 成功时返回，结构与单张 `row-info` 一致（`date`、`fysm`、`itinerary`、`subjectId`） |
-| `results[].error` | 失败时返回错误信息 |
-| `succeeded` / `failed` / `total` | 成功/失败/总数统计 |
+## 6. 取发票字段对象
 
-### 使用场景
-
-- 报销建单不调用；需要一次查多张发票的预填信息时，用 `row-info-batch` 替代 N 次 `row-info` 调用
-- 部分失败不影响其他发票，失败的回退到 AI 推断逻辑
----
-
-## 5.7 获取发票详情（交通类发票行程信息）
-
-CLI operation：`invoice.get`
-
-根据发票 ID 获取发票完整详情。报销填单时不要为了生成费用说明去取出发地、目的地。
+CLI operation：`invoice.browse-field.data`（read）
 
-### 命令
+报销单明细的「相关发票」是 `EinvoiceComponent`，**只接受发票对象，不接受文本或裸 ID**。一次传入本组全部发票的 `fid`（不传凭证，「相关凭证」由发票联动带出），按 `fid` 把返回对象放进对应行。入参与对象结构见 [invoice-browse-field-data.md](invoice-browse-field-data.md)。
 
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.get --input-json '{"fid":"1301956959986835460"}'
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1295366637717012483"]}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.get --input-json '{"fid":"1301956959986835460"}'
-```
-
-| 参数 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `fid` | String | 与 `number` 二选一 | 发票 fid |
-| `number` | String | 与 `fid` 二选一 | 发票号码 |
-
-
-### 调用时机
-
-**仅当发票为交通类时调用**。判断条件（满足任一）：
-
-- `expenseType` 包含"交通"、"出行"、"打车"、"出租车"
-- `consumeContent` 包含"客运服务费"、"运输服务"
-- `invoiceTypeCode` 为 17（行程单）或 57（客运凭证）等交通相关类型
-- `sellerName` 包含"滴滴"、"享道"、"高德"、"曹操"等出行平台
-
-### 返回值关键字段
-
-从 `infos[].info` 中提取：
-
-
-| 字段路径                                                  | 说明      | 示例                   |
-| ----------------------------------------------------- | ------- | -------------------- |
-| `from`                                                | 出发地     | `"仁济医院南院区门诊部(南门)南侧"` |
-| `to`                                                  | 目的地     | `"浦江瑞和城柒街区30号"`      |
-| `ext` (JSON字符串) → `passengersService[].from`          | 出发地（详细） | `"仁济医院南院区门诊部(南门)南侧"` |
-| `ext` (JSON字符串) → `passengersService[].to`            | 目的地（详细） | `"浦江瑞和城柒街区30号"`      |
-| `ext` (JSON字符串) → `passengersService[].transportType` | 交通方式    | `"出租车"`              |
-
-
-> **优先取 `info.from` 和 `info.to`**（顶层字段），如为空则从 `ext.passengersService[0]` 中提取。
-
-### 出发地/目的地精简规则
-
-原始地址可能很长，需要精简后使用：
-
-
-| 原始值                  | 精简后              |
-| -------------------- | ---------------- |
-| `"仁济医院南院区门诊部(南门)南侧"` | `"仁济医院南院"`       |
-| `"浦江瑞和城柒街区30号"`      | `"浦江瑞和城"`        |
-| `"上海虹桥国际机场T2航站楼出发层"` | `"虹桥机场T2"`       |
-| `"北京南站"`             | `"北京南站"`（已够短，保留） |
-
-
-精简原则：
-
-- 去掉括号及括号内内容（如 `(南门)`）
-- 去掉"侧"、"层"、"出发层"、"到达层"等方位后缀
-- 去掉门牌号（如 `30号`、`3419号`）
-- 保留核心地标名称，控制在 **10 个字以内**
-
-### 返回示例（精简）
-
-```json
-{
-  "infos": [
-    {
-      "info": {
-        "id": "1301956959986835460",
-        "from": "仁济医院南院区门诊部(南门)南侧",
-        "to": "浦江瑞和城柒街区30号",
-        "ext": "{...\"passengersService\":[{\"from\":\"仁济医院南院区门诊部(南门)南侧\",\"to\":\"浦江瑞和城柒街区30号\",\"transportType\":\"出租车\"}]...}"
-      }
-    }
-  ]
-}
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1295366637717012483"]}'
 ```
 
 ---
 
-## 5.8 取发票字段对象
-
-CLI operation：`invoice.browse-field.data`（read）
-
-报销单明细的「相关发票」是 `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.browse-field.data --input-json '{"fids":["1295366637717012482","1298798990831518001"]}'
-```
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1298798990831518001"]}'
-```
-
----
-
-## 5.9 相关客户 / 相关项目模糊搜索
+## 7. 相关客户 / 相关项目模糊搜索
 
 CLI operation：`invoice.reim.field.search`（read）
 
-用户给出相关客户或相关项目名称后、写入之前调用。封装 `GET /api/government/formStructure/fieldRelateSearch`（参数走 query）。编排见 [reim-form-fill-rules.md](reim-form-fill-rules.md#相关客户模糊搜索)。**必须在建草稿前搜完确认，不要先建空单再搜。**
-
-### 入参
+用户给出相关客户或相关项目名称后、写入之前调用。编排见 [reim-form-fill-rules.md](reim-form-fill-rules.md#相关客户模糊搜索)。**必须在建草稿前搜完确认，不要先建空单再搜。**
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `keywords` | String | 是 | 用户原话，不要改写 |
+| `keywords` | String | 是 | 用户原话，不要改写。⚠️ 是 `keywords`，不是 `keyword` |
 | `fieldId` | String | 是 | 本次 `createForm` 里对应字段 id（相关客户或相关项目） |
 | `workflowId` | String | 是 | 本次报销工作流 ID |
 | `nodeId` | String | 否 | 默认 `100004140000000271` |
 
-### 命令
-
-macOS/Linux（bash/zsh）：
+Windows PowerShell：
 
-```bash
+```powershell
 weaver-work-cli --json invoice run invoice.reim.field.search --input-json '{"keywords":"学院","fieldId":"100003720000000687","workflowId":"100003460000000060"}'
 ```
 
-Windows PowerShell：
+macOS/Linux（bash/zsh）：
 
-```powershell
+```bash
 weaver-work-cli --json invoice run invoice.reim.field.search --input-json '{"keywords":"学院","fieldId":"100003720000000687","workflowId":"100003460000000060"}'
 ```
 
-### 返回
-
-| 字段 | 说明 |
+| 返回字段 | 说明 |
 | --- | --- |
 | `keywords` | 本次搜索词 |
 | `match` | `unique` / `multiple` / `none` |
 | `items` | `{id,name,value}` 列表，`value` 与 `id` 相同 |
 | `selected` | `match=unique` 时是那一条；否则 `null` |
 
-`match=unique` → 直接填 `"名称(ID)"`，不问用户。`match=multiple` → 把 `items` 的名称列给用户选。`match=none` → 请用户换更完整的名称。不要把未消歧简称直接丢给 `createRequest`。
+`match=unique` → 直接填 `"名称(ID)"`，不问用户。`match=multiple` → 把 `items` 的名称列给用户选。`match=none` → 请用户换更完整的名称。
 
 ---
 
-## 6. 创建 / 修改报销单（`weaver-e10-workflow`）
+## 8. 创建 / 修改报销单（`weaver-e10-workflow`）
 
-报销单创建与修改不再使用本技能的 operation，统一调用 `weaver-e10-workflow` 技能：
+读取出差流程、创建与修改报销单统一调用 `weaver-e10-workflow` 技能：
 
 | 动作 | 命令 | 契约 |
 | --- | --- | --- |
+| 读取出差流程起止日期 | `workflow.summary`（`requestId`，只读，不标记已读） | [`workflow-view.md`](../../weaver-e10-workflow/references/workflow-view.md)，用法见第 3 节 |
 | 载入报销表单 | `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) |
 
 `data` 的组装规则见 [reim-form-fill-rules.md](reim-form-fill-rules.md)，编排顺序见 [reim-workflow.md](reim-workflow.md) Step 3 ~ Step 6。
-
-`workflow.createForm` 的 `historyRequestData` 已是本工作流近一年、非草稿、我发起的前 5 条。总部费用报销用它按已确认的相关项目带出合同号，**不要询问合同号**（见 [reim-workflow.md](reim-workflow.md) Step 4.4）。客户和项目同一次让用户一起输入。不要再调用 `workflow.search` 或 `workflow.detail`。
-
-相关客户、相关项目必须在调用 `workflow.createRequest` 前一次问齐（见 Step 4.5），禁止先建空草稿再问，也不要询问合同号。明细每行只写「相关发票」（及「相关流程」），其余明细列（费用日期、金额、币种、科目、费用说明、费用明细、相关凭证等）禁止填值，由「相关发票」联动带出，落库后仍空也不要补写。草稿落库后再查客户 / 项目是否被联动冲空（见 Step 5.3）。已确认值被冲空则 `workflow.edit*` 写回。看不清时用 `workflow.editLoad` 读 `currentValues`。