weaver-work-cli 0.1.1 → 0.1.4

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

@@ -0,0 +1,261 @@
+# 红字发票（红冲）
+
+## 什么时候读取
+
+用户要**红冲发票**（冲红、开红票、红字发票、冲销发票）、**查询红字确认单**、**确认/拒绝/撤销红冲**时读取本文件。
+
+> ⚠️ 红冲操作是**直接 API 调用**，不经过 `weaver-work-cli invoice run`。需要 E10 上下文的 `BASE_URL`、`eteamsId` 和发票 Token。
+
+---
+
+## 红冲概述
+
+红冲是对已开具蓝字发票的冲销操作。完整流程：
+
+```
+查询蓝票 → 发起红冲申请 → (等待对方确认) → 确认红冲 → 开具红字发票
+```
+
+---
+
+## 红冲申请流程
+
+```
+R1: 用户表达红冲意图 → 确定蓝字发票号码
+     ↓
+R2: queryAvailableBlueInfo → 查询蓝票信息
+     ↓
+R3: 展示蓝票 → 用户确认红冲方式（全额/部分）+ 原因
+     ↓ (部分红冲 → 用户选择明细行和金额)
+R4: 展示红冲预览 → 用户确认
+     ↓
+R5: redConfirmationApply → 提交申请
+     ↓
+R6: 展示结果
+```
+
+### R2: 查询蓝票
+
+**POST** `{BASE_URL}/api/inc/book/v1/open/queryAvailableBlueInfo`
+
+> 此接口**不使用** ApiParams 包装，直接传 body。
+
+```json
+{
+  "applicant": "SELLER",
+  "blueInvNum": "{蓝字发票号码}"
+}
+```
+
+返回蓝票主表（购销方、金额）和 `detailDataList`（商品明细行）。
+
+### R3: 展示蓝票信息
+
+```markdown
+已查询到蓝字发票信息：
+
+**发票号码**：{invoiceNumber}
+**发票类型**：{全电专票/全电普票}
+**开票日期**：{invoiceDate}
+**购方**：{gmfName}（{gmfNum}）
+**不含税金额**：¥{jshjXx}  **税额**：¥{zSe}  **含税金额**：¥{hsJshjXx}
+
+| # | 商品名称 | 规格 | 单位 | 数量 | 单价 | 税率 | 不含税金额 | 税额 |
+|---|----------|------|------|------|------|------|-----------|------|
+| {xh} | {hwhyslwfwmc} | {ggxh} | {dw} | {sl} | {bhsdj} | {sl1} | {bhsje} | {se} |
+
+红冲方式：1. **全额红冲** 2. **部分红冲**
+红冲原因：1. 开票有误 2. 销货退回 3. 服务终止 4. 销售折让
+```
+
+部分红冲时追问要红冲的明细行及金额。
+
+### R5: 提交红冲申请
+
+**POST** `{BASE_URL}/api/inc/book/v1/open/redConfirmationApply`
+
+使用 ApiParams 包装：`{ "invoiceReq": { ... } }`
+
+#### 全额红冲
+
+```json
+{
+  "invoiceReq": {
+    "taxNo": "9131000070322836XD",
+    "sellerName": "上海泛微网络科技股份有限公司",
+    "purchaserName": "{从蓝票}",
+    "purchaserTaxNo": "{从蓝票}",
+    "blueInvoiceNumber": "{蓝字发票号码}",
+    "blueInvoiceCode": "{蓝字发票代码}",
+    "blueInvoiceDate": "{蓝字开票日期}",
+    "blueInvoiceAmount": "{蓝字合计金额}",
+    "blueInvoiceTax": "{蓝字合计税额}",
+    "blueInvoiceType": "{蓝字发票类型 7/8}",
+    "redCause": "01",
+    "inputParty": "0",
+    "isPart": "0"
+  }
+}
+```
+
+#### 部分红冲（在全额基础上增加）
+
+```json
+{
+  "invoiceReq": {
+    "...同上...",
+    "isPart": "1",
+    "redAmount": "{红冲不含税金额}",
+    "redAmountWithTax": "{红冲含税金额}",
+    "redTax": "{红冲税额}",
+    "detail": [
+      {
+        "blueInvoiceLine": "{蓝字明细行号}",
+        "qty": "{红冲数量}",
+        "amount": "{红冲不含税金额}",
+        "amountWithTax": "{红冲含税金额}",
+        "tax": "{红冲税额}"
+      }
+    ]
+  }
+}
+```
+
+#### redCause 红冲原因
+
+| 值 | 说明 |
+|----|------|
+| 01 | 开票有误 |
+| 02 | 销货退回 |
+| 03 | 服务终止 |
+| 04 | 销售折让 |
+
+#### 响应
+
+```json
+{
+  "code": 200,
+  "data": {
+    "serialNo": "业务流水号",
+    "redConfirmNo": "红字确认单编号",
+    "redConfirmUuid": "UUID",
+    "redConfirmStatus": "状态代码"
+  }
+}
+```
+
+| redConfirmStatus | 说明 |
+|-----------------|------|
+| -1 | 申请失败 |
+| 00 | 申请中 |
+| 01 | 无需确认（直接生效） |
+| 02 | 销方录入待购方确认 |
+| 03 | 购方录入待销方确认 |
+| 04 | 购销双方已确认 |
+
+---
+
+## 查询红字确认单列表
+
+用户要查看红冲状态或待确认红冲时使用。
+
+**POST** `{BASE_URL}/api/inc/book/v1/open/queryRedConfirmationList`
+
+```json
+{
+  "invoiceReq": {
+    "taxNo": "9131000070322836XD",
+    "roleType": "0",
+    "beginDate": "{30天前 yyyy-MM-dd}",
+    "endDate": "{今天 yyyy-MM-dd}"
+  }
+}
+```
+
+| invoiceReq 字段 | 必填 | 说明 |
+|----------------|------|------|
+| taxNo | 是 | 销方税号 |
+| roleType | 是 | `"0"` 销方、`"1"` 购方 |
+| beginDate | 是 | 起始日期 `yyyy-MM-dd` |
+| endDate | 是 | 截止日期 `yyyy-MM-dd` |
+| purchaserName | 否 | 按购方名称筛选 |
+| blueInvoiceNumber | 否 | 按蓝字发票号筛选 |
+| redConfirmStatus | 否 | 按状态筛选 |
+| pageNumber | 是 | 默认 1 |
+| pageSize | 是 | 默认 50 |
+
+返回 `redConfirmList[]`，每条含 `uuid`、`redConfirmNo`、`purchaserName`、`blueInvoiceNumber`、`redAmount`、`redCause`、`redConfirmStatus`、`inputDate` 等。
+
+### redConfirmStatus 状态码
+
+| 值 | 说明 |
+|----|------|
+| 01 | 无需确认 |
+| 02 | 销方录入待购方确认 |
+| 03 | 购方录入待销方确认 |
+| 04 | 购销双方已确认 |
+| 05-10 | 各种作废状态 |
+
+### 列表展示
+
+```
+红字确认单列表（共 {totalCount} 条）：
+
+| # | 确认单编号 | 购方 | 蓝字发票号 | 红冲金额 | 原因 | 状态 | 日期 |
+|---|-----------|------|-----------|---------|------|------|------|
+| 1 | {redConfirmNo} | {purchaserName} | {blueInvoiceNumber} | ¥{redAmount} | {redCause} | {status} | {date} |
+
+输入编号查看详情，或告诉我要确认/拒绝哪一条。
+```
+
+---
+
+## 查询红字确认单明细
+
+**POST** `{BASE_URL}/api/inc/book/v1/open/queryRedConfirmationDetail`
+
+```json
+{
+  "invoiceReq": {
+    "taxNo": "9131000070322836XD",
+    "redConfirmNo": "{红字确认单编号}"
+  }
+}
+```
+
+也可用 `uuid` 查询。返回完整信息含 `detailList[]`（明细行：name、amount、taxRate、tax 等）。
+
+---
+
+## 红冲确认操作
+
+**POST** `{BASE_URL}/api/inc/book/v1/open/redConfirmationConfirm`
+
+```json
+{
+  "invoiceReq": {
+    "confirmType": "Y",
+    "uuid": "{红字确认单UUID}",
+    "taxNo": "9131000070322836XD",
+    "redConfirmNo": "{红字确认单编号}"
+  }
+}
+```
+
+| confirmType | 操作 |
+|-------------|------|
+| Y | 同意红冲 |
+| N | 拒绝红冲（确认单作废） |
+| C | 撤销红冲（仅发起方可撤销） |
+
+响应含 `confirmDate` 和 `status`。
+
+---
+
+## 关键规则
+
+- **红冲申请前必须展示预览并获得用户确认**
+- **红冲确认（同意/拒绝/撤销）前必须展示确认单详情并确认**
+- 蓝票信息和金额严禁篡改，逐字符原样使用
+- 接口失败仅展示错误原因，不自动重试
+- 对方需在 72 小时内确认，超时自动作废

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

@@ -0,0 +1,97 @@
+# 报销自动填单
+
+## 什么时候读取
+
+用户提到报销、发票报销、自动填单、提交报销单、事前申请报销，或需要把已选发票生成 E10 报销流程时读取本文件。纯查发票仍优先读个人/企业票夹 reference。
+
+## 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 |
+
+## 处理链
+
+1. 获取发票：已有 `fid` 时可用 `invoice.get` 或 `invoice.browse-field.data`；已有 E10 `fileId` 时用 `invoice.reim.file-ocr.preview`；需要查票夹时用 `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 按表单结构组装 `payload`，先调用 `invoice.reim.flow.create.prepare`，展示标题、主表字段数、明细行数、发票和风险；用户明确确认后再调用 `.apply`。
+7. 报销单创建成功后，后续修正使用 `invoice.reim.flow.update.prepare/apply`，不要重复创建同一组发票的报销单。
+
+## 命令
+
+查询事前申请：
+
+Windows PowerShell：
+
+```powershell
+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"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+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 文件传入完整 payload。
+
+Windows PowerShell：
+
+```powershell
+Set-Content -Encoding utf8 -LiteralPath .\reim-create.json -Value @'
+{
+  "payload": {
+    "work_flow_id": "1181057526276915214",
+    "mainFormId": "1181057741029226975",
+    "request_name": "交通费报销-示例-2026-08-04",
+    "main_fields": [],
+    "detail_rows": [{"dataIndex":1,"subFormId":"1181057741029227992","invoiceId":"12345","fields":[]}]
+  }
+}
+'@
+weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input .\reim-create.json
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+cat > ./reim-create.json <<'JSON'
+{
+  "payload": {
+    "work_flow_id": "1181057526276915214",
+    "mainFormId": "1181057741029226975",
+    "request_name": "交通费报销-示例-2026-08-04",
+    "main_fields": [],
+    "detail_rows": [{"dataIndex":1,"subFormId":"1181057741029227992","invoiceId":"12345","fields":[]}]
+  }
+}
+JSON
+weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input ./reim-create.json
+```
+
+确认后把 prepare 返回的 continuation 原样放入 apply 输入。
+
+## 输出处理
+
+`invoice.reim.flow.create.apply` 成功返回 `requestId`、`requestName` 和 `viewUrl`。给用户展示报销单标题、总金额、发票摘要和链接。若返回 `partial/write_uncertain`，停止，不要重放 `.apply`；最多做一次只读查询或请用户在 E10 页面核对。
+
+`invoice.reim.flow.update.apply` 若服务端返回删除或更新部分失败，CLI 会按 `partial/write_uncertain` 报告，Agent 不要继续连环重试。
+
+## 注意
+
+报销单创建和更新都是高风险写入，必须走 `prepare -> 用户确认 -> apply`。同一组发票 `invoice.reim.flow.create.apply` 成功后禁止再次创建；要修改已创建的报销单只能走 `invoice.reim.flow.update.prepare/apply`。
+
+出差/差旅流程需要具体相关客户。未拿到用户提供的客户并完成关联字段搜索前，不要调用 `invoice.reim.flow.create.prepare/apply`。
+
+`invoice.reim.file-ocr.preview` 会让 E10 侧文件进入发票识别流程；如果 fileId 来自用户新上传或附件解析，先提醒用户文件内容可能进入大模型上下文，也可能发送到 E10/OCR 服务，并等待明确确认。

package/skills/{weaver-work-cli-invoice → weaver-e10-yepiaotong}/references/invoice-update.md

@@ -2,7 +2,7 @@
 
 ## 什么时候读取
 
-用户要修改已有发票字段时读取本文件。开始前也读取共享高风险协议：`../../weaver-work-cli-shared/references/high-risk-write.md`。
+用户要修改已有发票字段时读取本文件。开始前也读取共享高风险协议：`../../weaver-e10-shared/references/high-risk-write.md`。
 
 ## Operation
 

package/skills/{weaver-work-cli-invoice → weaver-e10-yepiaotong}/references/invoice-validation-preview.md

@@ -8,7 +8,7 @@
 
 | Operation | 固定规则 |
 | --- | --- |
-| `invoice.validate.preview` | 先取详情，固定 `flag=100`、`is_save=1`、`needLog=false`，不回写查验结果 |
+| `invoice.validate.preview` | 先取详情，固定 `flag=100`、`is_save=1`、`needLog=true`，不回写查验结果 |
 
 ## 输入
 
@@ -16,9 +16,16 @@
 
 ## 示例
 
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.validate.preview --input-json '{"fid":"12345","scope":"personal"}'
+```
+
+macOS/Linux（bash/zsh）：
+
 ```bash
-printf '%s\n' '{"fid":"12345","scope":"personal"}' \
-  | weaver-work-cli --json invoice run invoice.validate.preview --input -
+weaver-work-cli --json invoice run invoice.validate.preview --input-json '{"fid":"12345","scope":"personal"}'
 ```
 
 ## 注意