weaver-work-cli 0.1.6 → 0.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -9
- package/dist/cmd/skills/index.js +60 -0
- package/dist/internal/e10/auth/commands.js +44 -31
- package/dist/internal/e10/auth/session.js +44 -3
- package/dist/internal/e10/auth/xiaoe.js +363 -11
- package/dist/internal/e10/context.js +4 -2
- package/dist/internal/skills/detector.js +42 -0
- package/dist/internal/skills/install.js +50 -3
- package/dist/shortcuts/archive/render/search-format.js +12 -3
- package/dist/shortcuts/ebuilder-form/continuation.js +70 -0
- package/dist/shortcuts/ebuilder-form/errors.js +54 -0
- package/dist/shortcuts/ebuilder-form/host.js +1238 -0
- package/dist/shortcuts/ebuilder-form/index.js +108 -0
- package/dist/shortcuts/ebuilder-form/manifest.js +347 -0
- package/dist/shortcuts/ebuilder-form/operations/read.js +157 -0
- package/dist/shortcuts/ebuilder-form/operations/registry.js +56 -0
- package/dist/shortcuts/ebuilder-form/operations/shared.js +132 -0
- package/dist/shortcuts/ebuilder-form/operations/types.js +19 -0
- package/dist/shortcuts/ebuilder-form/operations/write.js +277 -0
- package/dist/shortcuts/ebuilder-form/operations.js +8 -0
- package/dist/shortcuts/ehr/operations/salary.js +2 -140
- package/dist/shortcuts/im/continuation.js +70 -0
- package/dist/shortcuts/{yimiaoban → im}/errors.js +14 -14
- package/dist/shortcuts/{yimiaoban → im}/host.js +26 -26
- package/dist/shortcuts/{yimiaoban → im}/index.js +42 -42
- package/dist/shortcuts/{yimiaoban → im}/manifest.js +7 -6
- package/dist/shortcuts/{yimiaoban → im}/operations/file-user.js +54 -41
- package/dist/shortcuts/{yimiaoban → im}/operations/group-read.js +46 -44
- package/dist/shortcuts/{yimiaoban → im}/operations/group-write.js +113 -66
- package/dist/shortcuts/{yimiaoban → im}/operations/msg-sync.js +164 -141
- package/dist/shortcuts/{yimiaoban → im}/operations/msg-write.js +47 -47
- package/dist/shortcuts/{yimiaoban → im}/operations/person.js +10 -10
- package/dist/shortcuts/{yimiaoban → im}/operations/registry.js +10 -8
- package/dist/shortcuts/{yimiaoban → im}/operations/session.js +82 -83
- package/dist/shortcuts/im/operations/shared.js +442 -0
- package/dist/shortcuts/{yimiaoban → im}/operations/types.js +1 -1
- package/dist/shortcuts/im/operations/user-remind.js +201 -0
- package/dist/shortcuts/{yimiaoban → im}/operations/write-util.js +7 -7
- package/dist/shortcuts/{yimiaoban → im}/operations.js +3 -3
- package/dist/shortcuts/index.js +10 -2
- package/dist/shortcuts/invoice/manifest.js +113 -10
- package/dist/shortcuts/invoice/operations/import.js +39 -14
- package/dist/shortcuts/invoice/operations/reim.js +38 -18
- package/dist/shortcuts/invoice/operations/shared.js +35 -6
- package/dist/shortcuts/jiuchuanhui/manifest.js +3 -3
- package/dist/shortcuts/jiuchuanhui/operations/registry.js +2 -2
- package/dist/shortcuts/{yimiaoban → okr}/continuation.js +10 -10
- package/dist/shortcuts/okr/errors.js +70 -0
- package/dist/shortcuts/okr/host.js +169 -0
- package/dist/shortcuts/okr/index.js +155 -0
- package/dist/shortcuts/okr/manifest.js +70 -0
- package/dist/shortcuts/okr/operations/link.js +305 -0
- package/dist/shortcuts/okr/operations/read.js +481 -0
- package/dist/shortcuts/okr/operations/registry.js +31 -0
- package/dist/shortcuts/okr/operations/shared.js +381 -0
- package/dist/shortcuts/okr/operations/types.js +88 -0
- package/dist/shortcuts/okr/operations/write.js +838 -0
- package/dist/shortcuts/okr/operations.js +8 -0
- package/dist/shortcuts/project/continuation.js +70 -0
- package/dist/shortcuts/project/errors.js +53 -0
- package/dist/shortcuts/project/host.js +160 -0
- package/dist/shortcuts/project/index.js +106 -0
- package/dist/shortcuts/project/manifest.js +36 -0
- package/dist/shortcuts/project/operations/read.js +551 -0
- package/dist/shortcuts/project/operations/registry.js +31 -0
- package/dist/shortcuts/project/operations/shared.js +68 -0
- package/dist/shortcuts/project/operations/types.js +39 -0
- package/dist/shortcuts/project/operations/write.js +266 -0
- package/dist/shortcuts/project/operations.js +8 -0
- package/dist/shortcuts/workflow/continuation.js +508 -0
- package/dist/shortcuts/workflow/endpoints.js +149 -0
- package/dist/shortcuts/workflow/errors.js +112 -0
- package/dist/shortcuts/workflow/host.js +224 -0
- package/dist/shortcuts/workflow/index.js +116 -0
- package/dist/shortcuts/workflow/manifest.js +30 -0
- package/dist/shortcuts/workflow/operations/form.js +4159 -0
- package/dist/shortcuts/workflow/operations/read.js +3778 -0
- package/dist/shortcuts/workflow/operations/registry.js +33 -0
- package/dist/shortcuts/workflow/operations/shared.js +167 -0
- package/dist/shortcuts/workflow/operations/types.js +44 -0
- package/dist/shortcuts/workflow/operations/write.js +1991 -0
- package/dist/shortcuts/workflow/operations.js +119 -0
- package/dist/shortcuts/workflow/state.js +182 -0
- package/docs/SKILL.md +5 -3
- package/docs/_catalog.md +10 -1
- package/docs/agent-invoice.md +2 -2
- package/docs/agent-skill-install.md +2 -2
- package/docs/e10-auth.md +3 -1
- package/docs/ebuilder-form.md +38 -0
- package/docs/im.md +104 -0
- package/docs/invoice.md +5 -5
- package/docs/okr.md +122 -0
- package/docs/operation-manual.md +10 -7
- package/docs/project.md +69 -0
- package/docs/skill-review-2026-09-19.md +68 -0
- package/package.json +3 -2
- package/scripts/package-skill.mjs +38 -11
- package/scripts/sync-connector-skills.mjs +172 -0
- package/skill-template/business-info.json +357 -16
- package/skill-template/domains/ebuilder-form.md +5 -0
- package/skill-template/domains/okr.md +18 -0
- package/skill-template/domains/shijingran.md +3 -0
- package/skill-template/domains/skill-maker.md +4 -4
- package/skill-template/domains/workflow.md +22 -0
- package/skill-template/domains/yepiaotong.md +4 -2
- package/skill-template/domains/yimiaoban.md +13 -10
- package/skill-template/product.json +5 -0
- package/skill-template/skill-template.md +1 -0
- package/skills/weaver-e10-calendar/SKILL.md +5 -1
- package/skills/weaver-e10-calendar/references/calendar-query.md +7 -0
- package/skills/weaver-e10-calendar/references/source-manifest.json +314 -32
- package/skills/weaver-e10-ebuilder-form/SKILL.md +123 -0
- package/skills/weaver-e10-ebuilder-form/references/context-routing.md +90 -0
- package/skills/weaver-e10-ebuilder-form/references/custom-api.md +86 -0
- package/skills/weaver-e10-ebuilder-form/references/disabled-capabilities.md +50 -0
- package/skills/weaver-e10-ebuilder-form/references/fields-browser.md +100 -0
- package/skills/weaver-e10-ebuilder-form/references/list-nlist.md +91 -0
- package/skills/weaver-e10-ebuilder-form/references/openapi-read.md +74 -0
- package/skills/weaver-e10-ebuilder-form/references/openapi-write.md +86 -0
- package/skills/weaver-e10-ebuilder-form/references/source-manifest.json +107 -0
- package/skills/weaver-e10-esb/SKILL.md +1 -1
- package/skills/weaver-e10-esb/references/source-manifest.json +15 -14
- package/skills/weaver-e10-hrm/SKILL.md +1 -1
- package/skills/weaver-e10-hrm/references/source-manifest.json +357 -38
- package/skills/weaver-e10-jiuchuanhui/SKILL.md +22 -4
- package/skills/weaver-e10-jiuchuanhui/references/clue.md +4 -2
- package/skills/weaver-e10-jiuchuanhui/references/contact.md +1 -1
- package/skills/weaver-e10-jiuchuanhui/references/customer.md +3 -3
- package/skills/weaver-e10-jiuchuanhui/references/disabled-capabilities.md +1 -1
- package/skills/weaver-e10-jiuchuanhui/references/discovery-config.md +10 -10
- package/skills/weaver-e10-jiuchuanhui/references/general-helpers.md +3 -3
- package/skills/weaver-e10-jiuchuanhui/references/sale.md +7 -7
- package/skills/weaver-e10-jiuchuanhui/references/source-manifest.json +3 -3
- package/skills/weaver-e10-jucailin/SKILL.md +2 -2
- package/skills/weaver-e10-mail/SKILL.md +22 -6
- package/skills/weaver-e10-meeting/SKILL.md +22 -1
- package/skills/weaver-e10-okr/SKILL.md +139 -0
- package/skills/weaver-e10-okr/references/okr-align.md +59 -0
- package/skills/weaver-e10-okr/references/okr-keyresult.md +68 -0
- package/skills/weaver-e10-okr/references/okr-link-routing.md +67 -0
- package/skills/weaver-e10-okr/references/okr-query.md +105 -0
- package/skills/weaver-e10-okr/references/okr-write.md +94 -0
- package/skills/weaver-e10-okr/references/source-manifest.json +672 -0
- package/skills/weaver-e10-plan/SKILL.md +3 -3
- package/skills/weaver-e10-plan/references/plan-report-write.md +1 -1
- package/skills/weaver-e10-plan/references/source-manifest.json +20 -20
- package/skills/weaver-e10-qiyecheng/SKILL.md +21 -1
- package/skills/weaver-e10-qiyecheng/references/source-manifest.json +17 -17
- package/skills/weaver-e10-shared/SKILL.md +79 -11
- package/skills/weaver-e10-shared/references/e10-auth-and-session.md +41 -8
- package/skills/weaver-e10-shared/references/non-interactive-environment.md +78 -0
- package/skills/weaver-e10-shared/references/weaver-e10-installation.md +39 -0
- package/skills/weaver-e10-shijingran/SKILL.md +83 -0
- package/skills/weaver-e10-shijingran/references/field-resolution.md +105 -0
- package/skills/weaver-e10-shijingran/references/operations.md +154 -0
- package/skills/weaver-e10-shijingran/references/source-manifest.json +1380 -0
- package/skills/weaver-e10-shijingran/references/write-operations.md +90 -0
- package/skills/weaver-e10-skill-maker/SKILL.md +26 -9
- package/skills/weaver-e10-skill-maker/references/business-skill-generation.md +39 -8
- package/skills/weaver-e10-skill-maker/references/detector-validation.md +25 -8
- package/skills/weaver-e10-skill-maker/references/module-cli-generation.md +66 -5
- package/skills/weaver-e10-skill-maker/references/module-gap-audit-and-repair.md +86 -0
- package/skills/weaver-e10-skill-maker/references/source-update-detection.md +59 -5
- package/skills/weaver-e10-skill-maker/references/weaver-skill-style.md +16 -8
- package/skills/weaver-e10-wenshuding/SKILL.md +28 -4
- package/skills/weaver-e10-wenshuding/references/archive-search.md +14 -0
- package/skills/weaver-e10-wenshuding/references/source-manifest.json +27 -26
- package/skills/weaver-e10-workflow/SKILL.md +250 -0
- package/skills/weaver-e10-workflow/references/source-manifest.json +1062 -0
- package/skills/weaver-e10-workflow/references/workflow-agent-entry.md +96 -0
- package/skills/weaver-e10-workflow/references/workflow-batch.md +275 -0
- package/skills/weaver-e10-workflow/references/workflow-create.md +182 -0
- package/skills/weaver-e10-workflow/references/workflow-edit.md +106 -0
- package/skills/weaver-e10-workflow/references/workflow-memory.md +165 -0
- package/skills/weaver-e10-workflow/references/workflow-operate.md +153 -0
- package/skills/weaver-e10-workflow/references/workflow-query.md +821 -0
- package/skills/weaver-e10-workflow/references/workflow-share.md +117 -0
- package/skills/weaver-e10-workflow/references/workflow-view.md +189 -0
- package/skills/weaver-e10-yepiaotong/SKILL.md +28 -28
- package/skills/weaver-e10-yepiaotong/references/invoice-disabled-capabilities.md +11 -5
- package/skills/weaver-e10-yepiaotong/references/invoice-import.md +14 -8
- package/skills/weaver-e10-yepiaotong/references/invoice-issuing-examples.md +9 -43
- package/skills/weaver-e10-yepiaotong/references/invoice-issuing.md +8 -0
- package/skills/weaver-e10-yepiaotong/references/invoice-reim.md +13 -17
- package/skills/weaver-e10-yepiaotong/references/reim-api-reference.md +6 -7
- package/skills/weaver-e10-yepiaotong/references/reim-examples.md +2 -2
- package/skills/weaver-e10-yepiaotong/references/source-manifest.json +1155 -553
- package/skills/weaver-e10-yimiaoban/SKILL.md +56 -38
- package/skills/weaver-e10-yimiaoban/references/ding-write.md +8 -8
- package/skills/weaver-e10-yimiaoban/references/error-codes.md +16 -0
- package/skills/weaver-e10-yimiaoban/references/field-resolution.md +10 -10
- package/skills/weaver-e10-yimiaoban/references/file-user-i18n.md +12 -12
- package/skills/weaver-e10-yimiaoban/references/group-read.md +16 -16
- package/skills/weaver-e10-yimiaoban/references/group-write.md +17 -15
- package/skills/weaver-e10-yimiaoban/references/msg-read.md +21 -17
- package/skills/weaver-e10-yimiaoban/references/msg-write.md +10 -10
- package/skills/weaver-e10-yimiaoban/references/person.md +6 -6
- package/skills/weaver-e10-yimiaoban/references/safety-boundaries.md +15 -11
- package/skills/weaver-e10-yimiaoban/references/session-sysmsg.md +11 -10
- package/skills/weaver-e10-yimiaoban/references/source-manifest.json +2164 -154
- package/skills/weaver-e10-yimiaoban/references/user-remind.md +75 -0
- package/skills/weaver-e10-ziguanjia/SKILL.md +4 -2
- package/skills/weaver-e10-ziguanjia/references/source-manifest.json +99 -29
- package/tools/weaver-skill-detector-1.0.13/SKILL.md +253 -0
- package/tools/weaver-skill-detector-1.0.13/_meta.json +6 -0
- package/tools/weaver-skill-detector-1.0.13/references/checklist.md +298 -0
- package/tools/weaver-skill-detector-1.0.13/scripts/validate_skill.py +4190 -0
- package/dist/shortcuts/yimiaoban/operations/shared.js +0 -236
- package/docs/yimiaoban.md +0 -86
- package/skills/weaver-e10-calendar/product.json +0 -8
- package/skills/weaver-e10-esb/product.json +0 -8
- package/skills/weaver-e10-hrm/product.json +0 -8
- package/skills/weaver-e10-jiuchuanhui/product.json +0 -8
- package/skills/weaver-e10-jucailin/product.json +0 -8
- package/skills/weaver-e10-mail/product.json +0 -8
- package/skills/weaver-e10-meeting/product.json +0 -8
- package/skills/weaver-e10-plan/product.json +0 -8
- package/skills/weaver-e10-qiyecheng/product.json +0 -8
- package/skills/weaver-e10-skill-maker/product.json +0 -8
- package/skills/weaver-e10-wenshuding/product.json +0 -8
- package/skills/weaver-e10-yepiaotong/product.json +0 -8
- package/skills/weaver-e10-yepiaotong/references/invoice-red.md +0 -261
- package/skills/weaver-e10-yimiaoban/product.json +0 -8
- package/skills/weaver-e10-ziguanjia/product.json +0 -8
- /package/dist/shortcuts/{yimiaoban → im}/operations/msg-parse.js +0 -0
|
@@ -1,261 +0,0 @@
|
|
|
1
|
-
# 红字发票(红冲)
|
|
2
|
-
|
|
3
|
-
## 什么时候读取
|
|
4
|
-
|
|
5
|
-
用户要**红冲发票**(冲红、开红票、红字发票、冲销发票)、**查询红字确认单**、**确认/拒绝/撤销红冲**时读取本文件。
|
|
6
|
-
|
|
7
|
-
> ⚠️ 红冲操作是**直接 API 调用**,不经过 `weaver-work-cli invoice run`。需要 E10 上下文的 `BASE_URL`、`eteamsId` 和发票 Token。
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## 红冲概述
|
|
12
|
-
|
|
13
|
-
红冲是对已开具蓝字发票的冲销操作。完整流程:
|
|
14
|
-
|
|
15
|
-
```
|
|
16
|
-
查询蓝票 → 发起红冲申请 → (等待对方确认) → 确认红冲 → 开具红字发票
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
## 红冲申请流程
|
|
22
|
-
|
|
23
|
-
```
|
|
24
|
-
R1: 用户表达红冲意图 → 确定蓝字发票号码
|
|
25
|
-
↓
|
|
26
|
-
R2: queryAvailableBlueInfo → 查询蓝票信息
|
|
27
|
-
↓
|
|
28
|
-
R3: 展示蓝票 → 用户确认红冲方式(全额/部分)+ 原因
|
|
29
|
-
↓ (部分红冲 → 用户选择明细行和金额)
|
|
30
|
-
R4: 展示红冲预览 → 用户确认
|
|
31
|
-
↓
|
|
32
|
-
R5: redConfirmationApply → 提交申请
|
|
33
|
-
↓
|
|
34
|
-
R6: 展示结果
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
### R2: 查询蓝票
|
|
38
|
-
|
|
39
|
-
**POST** `{BASE_URL}/api/inc/book/v1/open/queryAvailableBlueInfo`
|
|
40
|
-
|
|
41
|
-
> 此接口**不使用** ApiParams 包装,直接传 body。
|
|
42
|
-
|
|
43
|
-
```json
|
|
44
|
-
{
|
|
45
|
-
"applicant": "SELLER",
|
|
46
|
-
"blueInvNum": "{蓝字发票号码}"
|
|
47
|
-
}
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
返回蓝票主表(购销方、金额)和 `detailDataList`(商品明细行)。
|
|
51
|
-
|
|
52
|
-
### R3: 展示蓝票信息
|
|
53
|
-
|
|
54
|
-
```markdown
|
|
55
|
-
已查询到蓝字发票信息:
|
|
56
|
-
|
|
57
|
-
**发票号码**:{invoiceNumber}
|
|
58
|
-
**发票类型**:{全电专票/全电普票}
|
|
59
|
-
**开票日期**:{invoiceDate}
|
|
60
|
-
**购方**:{gmfName}({gmfNum})
|
|
61
|
-
**不含税金额**:¥{jshjXx} **税额**:¥{zSe} **含税金额**:¥{hsJshjXx}
|
|
62
|
-
|
|
63
|
-
| # | 商品名称 | 规格 | 单位 | 数量 | 单价 | 税率 | 不含税金额 | 税额 |
|
|
64
|
-
|---|----------|------|------|------|------|------|-----------|------|
|
|
65
|
-
| {xh} | {hwhyslwfwmc} | {ggxh} | {dw} | {sl} | {bhsdj} | {sl1} | {bhsje} | {se} |
|
|
66
|
-
|
|
67
|
-
红冲方式:1. **全额红冲** 2. **部分红冲**
|
|
68
|
-
红冲原因:1. 开票有误 2. 销货退回 3. 服务终止 4. 销售折让
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
部分红冲时追问要红冲的明细行及金额。
|
|
72
|
-
|
|
73
|
-
### R5: 提交红冲申请
|
|
74
|
-
|
|
75
|
-
**POST** `{BASE_URL}/api/inc/book/v1/open/redConfirmationApply`
|
|
76
|
-
|
|
77
|
-
使用 ApiParams 包装:`{ "invoiceReq": { ... } }`
|
|
78
|
-
|
|
79
|
-
#### 全额红冲
|
|
80
|
-
|
|
81
|
-
```json
|
|
82
|
-
{
|
|
83
|
-
"invoiceReq": {
|
|
84
|
-
"taxNo": "9131000070322836XD",
|
|
85
|
-
"sellerName": "上海泛微网络科技股份有限公司",
|
|
86
|
-
"purchaserName": "{从蓝票}",
|
|
87
|
-
"purchaserTaxNo": "{从蓝票}",
|
|
88
|
-
"blueInvoiceNumber": "{蓝字发票号码}",
|
|
89
|
-
"blueInvoiceCode": "{蓝字发票代码}",
|
|
90
|
-
"blueInvoiceDate": "{蓝字开票日期}",
|
|
91
|
-
"blueInvoiceAmount": "{蓝字合计金额}",
|
|
92
|
-
"blueInvoiceTax": "{蓝字合计税额}",
|
|
93
|
-
"blueInvoiceType": "{蓝字发票类型 7/8}",
|
|
94
|
-
"redCause": "01",
|
|
95
|
-
"inputParty": "0",
|
|
96
|
-
"isPart": "0"
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
#### 部分红冲(在全额基础上增加)
|
|
102
|
-
|
|
103
|
-
```json
|
|
104
|
-
{
|
|
105
|
-
"invoiceReq": {
|
|
106
|
-
"...同上...",
|
|
107
|
-
"isPart": "1",
|
|
108
|
-
"redAmount": "{红冲不含税金额}",
|
|
109
|
-
"redAmountWithTax": "{红冲含税金额}",
|
|
110
|
-
"redTax": "{红冲税额}",
|
|
111
|
-
"detail": [
|
|
112
|
-
{
|
|
113
|
-
"blueInvoiceLine": "{蓝字明细行号}",
|
|
114
|
-
"qty": "{红冲数量}",
|
|
115
|
-
"amount": "{红冲不含税金额}",
|
|
116
|
-
"amountWithTax": "{红冲含税金额}",
|
|
117
|
-
"tax": "{红冲税额}"
|
|
118
|
-
}
|
|
119
|
-
]
|
|
120
|
-
}
|
|
121
|
-
}
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
#### redCause 红冲原因
|
|
125
|
-
|
|
126
|
-
| 值 | 说明 |
|
|
127
|
-
|----|------|
|
|
128
|
-
| 01 | 开票有误 |
|
|
129
|
-
| 02 | 销货退回 |
|
|
130
|
-
| 03 | 服务终止 |
|
|
131
|
-
| 04 | 销售折让 |
|
|
132
|
-
|
|
133
|
-
#### 响应
|
|
134
|
-
|
|
135
|
-
```json
|
|
136
|
-
{
|
|
137
|
-
"code": 200,
|
|
138
|
-
"data": {
|
|
139
|
-
"serialNo": "业务流水号",
|
|
140
|
-
"redConfirmNo": "红字确认单编号",
|
|
141
|
-
"redConfirmUuid": "UUID",
|
|
142
|
-
"redConfirmStatus": "状态代码"
|
|
143
|
-
}
|
|
144
|
-
}
|
|
145
|
-
```
|
|
146
|
-
|
|
147
|
-
| redConfirmStatus | 说明 |
|
|
148
|
-
|-----------------|------|
|
|
149
|
-
| -1 | 申请失败 |
|
|
150
|
-
| 00 | 申请中 |
|
|
151
|
-
| 01 | 无需确认(直接生效) |
|
|
152
|
-
| 02 | 销方录入待购方确认 |
|
|
153
|
-
| 03 | 购方录入待销方确认 |
|
|
154
|
-
| 04 | 购销双方已确认 |
|
|
155
|
-
|
|
156
|
-
---
|
|
157
|
-
|
|
158
|
-
## 查询红字确认单列表
|
|
159
|
-
|
|
160
|
-
用户要查看红冲状态或待确认红冲时使用。
|
|
161
|
-
|
|
162
|
-
**POST** `{BASE_URL}/api/inc/book/v1/open/queryRedConfirmationList`
|
|
163
|
-
|
|
164
|
-
```json
|
|
165
|
-
{
|
|
166
|
-
"invoiceReq": {
|
|
167
|
-
"taxNo": "9131000070322836XD",
|
|
168
|
-
"roleType": "0",
|
|
169
|
-
"beginDate": "{30天前 yyyy-MM-dd}",
|
|
170
|
-
"endDate": "{今天 yyyy-MM-dd}"
|
|
171
|
-
}
|
|
172
|
-
}
|
|
173
|
-
```
|
|
174
|
-
|
|
175
|
-
| invoiceReq 字段 | 必填 | 说明 |
|
|
176
|
-
|----------------|------|------|
|
|
177
|
-
| taxNo | 是 | 销方税号 |
|
|
178
|
-
| roleType | 是 | `"0"` 销方、`"1"` 购方 |
|
|
179
|
-
| beginDate | 是 | 起始日期 `yyyy-MM-dd` |
|
|
180
|
-
| endDate | 是 | 截止日期 `yyyy-MM-dd` |
|
|
181
|
-
| purchaserName | 否 | 按购方名称筛选 |
|
|
182
|
-
| blueInvoiceNumber | 否 | 按蓝字发票号筛选 |
|
|
183
|
-
| redConfirmStatus | 否 | 按状态筛选 |
|
|
184
|
-
| pageNumber | 是 | 默认 1 |
|
|
185
|
-
| pageSize | 是 | 默认 50 |
|
|
186
|
-
|
|
187
|
-
返回 `redConfirmList[]`,每条含 `uuid`、`redConfirmNo`、`purchaserName`、`blueInvoiceNumber`、`redAmount`、`redCause`、`redConfirmStatus`、`inputDate` 等。
|
|
188
|
-
|
|
189
|
-
### redConfirmStatus 状态码
|
|
190
|
-
|
|
191
|
-
| 值 | 说明 |
|
|
192
|
-
|----|------|
|
|
193
|
-
| 01 | 无需确认 |
|
|
194
|
-
| 02 | 销方录入待购方确认 |
|
|
195
|
-
| 03 | 购方录入待销方确认 |
|
|
196
|
-
| 04 | 购销双方已确认 |
|
|
197
|
-
| 05-10 | 各种作废状态 |
|
|
198
|
-
|
|
199
|
-
### 列表展示
|
|
200
|
-
|
|
201
|
-
```
|
|
202
|
-
红字确认单列表(共 {totalCount} 条):
|
|
203
|
-
|
|
204
|
-
| # | 确认单编号 | 购方 | 蓝字发票号 | 红冲金额 | 原因 | 状态 | 日期 |
|
|
205
|
-
|---|-----------|------|-----------|---------|------|------|------|
|
|
206
|
-
| 1 | {redConfirmNo} | {purchaserName} | {blueInvoiceNumber} | ¥{redAmount} | {redCause} | {status} | {date} |
|
|
207
|
-
|
|
208
|
-
输入编号查看详情,或告诉我要确认/拒绝哪一条。
|
|
209
|
-
```
|
|
210
|
-
|
|
211
|
-
---
|
|
212
|
-
|
|
213
|
-
## 查询红字确认单明细
|
|
214
|
-
|
|
215
|
-
**POST** `{BASE_URL}/api/inc/book/v1/open/queryRedConfirmationDetail`
|
|
216
|
-
|
|
217
|
-
```json
|
|
218
|
-
{
|
|
219
|
-
"invoiceReq": {
|
|
220
|
-
"taxNo": "9131000070322836XD",
|
|
221
|
-
"redConfirmNo": "{红字确认单编号}"
|
|
222
|
-
}
|
|
223
|
-
}
|
|
224
|
-
```
|
|
225
|
-
|
|
226
|
-
也可用 `uuid` 查询。返回完整信息含 `detailList[]`(明细行:name、amount、taxRate、tax 等)。
|
|
227
|
-
|
|
228
|
-
---
|
|
229
|
-
|
|
230
|
-
## 红冲确认操作
|
|
231
|
-
|
|
232
|
-
**POST** `{BASE_URL}/api/inc/book/v1/open/redConfirmationConfirm`
|
|
233
|
-
|
|
234
|
-
```json
|
|
235
|
-
{
|
|
236
|
-
"invoiceReq": {
|
|
237
|
-
"confirmType": "Y",
|
|
238
|
-
"uuid": "{红字确认单UUID}",
|
|
239
|
-
"taxNo": "9131000070322836XD",
|
|
240
|
-
"redConfirmNo": "{红字确认单编号}"
|
|
241
|
-
}
|
|
242
|
-
}
|
|
243
|
-
```
|
|
244
|
-
|
|
245
|
-
| confirmType | 操作 |
|
|
246
|
-
|-------------|------|
|
|
247
|
-
| Y | 同意红冲 |
|
|
248
|
-
| N | 拒绝红冲(确认单作废) |
|
|
249
|
-
| C | 撤销红冲(仅发起方可撤销) |
|
|
250
|
-
|
|
251
|
-
响应含 `confirmDate` 和 `status`。
|
|
252
|
-
|
|
253
|
-
---
|
|
254
|
-
|
|
255
|
-
## 关键规则
|
|
256
|
-
|
|
257
|
-
- **红冲申请前必须展示预览并获得用户确认**
|
|
258
|
-
- **红冲确认(同意/拒绝/撤销)前必须展示确认单详情并确认**
|
|
259
|
-
- 蓝票信息和金额严禁篡改,逐字符原样使用
|
|
260
|
-
- 接口失败仅展示错误原因,不自动重试
|
|
261
|
-
- 对方需在 72 小时内确认,超时自动作废
|
|
File without changes
|