From e1797a873bf114329f4870062201d388155ef014 Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期五, 14 八月 2026 13:39:51 +0800
Subject: [PATCH] refactor(erp): 移除采购来票审核流程并简化业务逻辑
---
docs/purchase_invoice_payment_link.md | 49 +++++++++++++++++++++++--------------------------
1 files changed, 23 insertions(+), 26 deletions(-)
diff --git a/docs/purchase_invoice_payment_link.md b/docs/purchase_invoice_payment_link.md
index fa6e939..388c433 100644
--- a/docs/purchase_invoice_payment_link.md
+++ b/docs/purchase_invoice_payment_link.md
@@ -2,7 +2,7 @@
## 娑夊強椤甸潰
-- 閲囪喘鏉ョエ绠＄悊椤碉紙**鏂板缓椤甸潰**锛屽弬鑰冮噰璐敵璇�/閲囪喘璁㈠崟椤甸潰缁撴瀯锛�
+- 閲囪喘鏉ョエ绠＄悊椤碉紙鏉ョエ鍒楄〃銆佹柊澧�/缂栬緫/璇︽儏寮圭獥锛�
- 閲囪喘璁㈠崟璇︽儏椤碉紙灞曠ず璇ヨ鍗曚笅宸插叧鑱旂殑鏉ョエ淇℃伅锛�
- 浠樻鍗曠鐞嗛〉锛堟柊寤�/缂栬緫寮圭獥銆佸垪琛ㄣ�佽鎯咃級
- 浠樻鍗曡鎯呴〉锛堝睍绀哄叧鑱旂殑鏉ョエ淇℃伅锛�
@@ -10,15 +10,14 @@
## 涓氬姟娴佺▼涓庢暟鎹甫鍏�
1. 閲囪喘璁㈠崟锛堝鏍搁�氳繃锛�-> 鍒涘缓鏉ョエ锛歚purchaseOrderId` 蹇呴�夛紝渚涘簲鍟嗚嚜鍔ㄥ甫鍑猴紙浠ラ噰璐鍗曠殑渚涘簲鍟嗕负鍑嗭紝鍓嶇鏃犻渶浼� `supplierId`锛岀敱鍚庣鎸夐噰璐鍗曟煡璇㈣缃級銆�
-2. 鏉ョエ鍒涘缓鍚� -> 涓婁紶鍙戠エ闄勪欢锛堣蛋 system 妯″潡 Storage API锛夈��
-3. 鏉ョエ鎻愪氦瀹℃壒 -> 瀹℃壒閫氳繃 -> 鎵嶅彲浣滀负浠樻鍏宠仈瀵硅薄銆�
-4. 鏂板缓浠樻鍗� -> 閫夋嫨鍏宠仈鏉ョエ锛坄invoiceId` 蹇呭～锛夛細浠� `GET /erp/purchase-invoice/simple-list?supplierId=&purchaseOrderId=` 閫夋嫨锛屼粎鏄剧ず"瀹℃壒閫氳繃 + 宸蹭笂浼犻檮浠� + 鍓╀綑鍙粯閲戦 > 0"鐨勬潵绁紱閫夋嫨鍚� `remainingInvoicePrice` 鍙敤浜庨濉粯娆鹃噾棰濅笂闄愩��
+2. 鏉ョエ鍒涘缓鍚� -> 涓婁紶鍙戠エ闄勪欢锛堣蛋 system 妯″潡 Storage API锛夈��**鏉ョエ鍒涘缓鍗崇敓鏁堬紝鏃犲鏍哥幆鑺�**銆�
+3. 鏂板缓浠樻鍗� -> 閫夋嫨鍏宠仈鏉ョエ锛坄invoiceId` 蹇呭～锛夛細浠� `GET /erp/purchase-invoice/simple-list?supplierId=&purchaseOrderId=` 閫夋嫨锛屼粎鏄剧ず"宸蹭笂浼犻檮浠� + 鍓╀綑鍙粯閲戦 > 0"鐨勬潵绁紱閫夋嫨鍚� `remainingInvoicePrice` 鍙敤浜庨濉粯娆鹃噾棰濅笂闄愩��
瀵瑰簲鍏崇郴锛�**閲囪喘璁㈠崟(1) -> 鏉ョエ(N) -> 浠樻(M)**銆�
## API
-### 1. 鏉ョエ绠＄悊锛堟柊锛�
+### 1. 鏉ョエ绠＄悊
| 鏂规硶 | 璺緞 | 璇存槑 |
|------|------|------|
@@ -28,9 +27,9 @@
| GET | /erp/purchase-invoice/get?id= | 鑾峰緱鏉ョエ璇︽儏 |
| GET | /erp/purchase-invoice/page | 鏉ョエ鍒嗛〉 |
| GET | /erp/purchase-invoice/export-excel | 瀵煎嚭鏉ョエ Excel |
-| PUT | /erp/purchase-invoice/submit?id= | 鎻愪氦鏉ョエ瀹℃壒 |
-| GET | /erp/purchase-invoice/audit-count | 寰呭鏍告潵绁ㄦ暟閲� |
| GET | /erp/purchase-invoice/simple-list?supplierId=&purchaseOrderId= | 绮剧畝鍒楄〃锛堜粯娆捐〃鍗曢�夋潵绁級 |
+
+> 宸茬Щ闄ゆ帴鍙ｏ細`/erp/purchase-invoice/update-status`锛堝鏍�/鍙嶅鏍革級銆乣/erp/purchase-invoice/audit-count`锛堝緟瀹℃牳鏁伴噺锛夈�傚墠绔鍚屾鍒犻櫎瀵瑰簲鎸夐挳涓庢帴鍙ｈ皟鐢ㄣ��
**鍒涘缓/鏇存柊鏉ョエ璇锋眰鍙傛暟锛�**
@@ -46,17 +45,18 @@
| remark | String | 鍚� | 澶囨敞 |
| blobIds | List\<Long\> | 鍚� | 鍙戠エ闄勪欢 blobId 鍒楄〃 |
-**鏉ョエ鍒嗛〉/璇︽儏鍝嶅簲鏂板瀛楁锛�**
+**鏉ョエ鍒嗛〉/璇︽儏鍝嶅簲瀛楁锛�**
| 瀛楁 | 绫诲瀷 | 璇存槑 |
|------|------|------|
| no | String | 鏉ョエ缂栧彿锛堝悗绔敓鎴愶紝鍓嶇紑 FPD锛� |
| supplierName | String | 渚涘簲鍟嗗悕绉� |
| order | Object | 閲囪喘璁㈠崟淇℃伅锛堝祵濂楋級 |
-| auditStatus | Integer | 瀹℃壒鐘舵�侊紙0鏈彁浜�/10瀹℃壒涓�/20瀹℃牳閫氳繃/30瀹℃牳涓嶉�氳繃/40宸插彇娑堬級 |
| attachmentList | List | 鍙戠エ闄勪欢鍒楄〃 |
| hasAttachment | Boolean | 鏄惁宸蹭笂浼犲彂绁ㄩ檮浠� |
| remainingInvoicePrice | BigDecimal | 鍓╀綑鍙粯閲戦 = 鏉ョエ閲戦 - 璇ユ潵绁ㄥ凡浠樻閲戦 |
+
+> 宸茬Щ闄ゅ搷搴斿瓧娈碉細`auditStatus`锛堝鎵圭姸鎬侊級銆乣processInstanceId`锛堝伐浣滄祦缂栧彿锛夈��
**simple-list 鍝嶅簲锛�**
@@ -69,18 +69,17 @@
| price | BigDecimal | 鏉ョエ閲戦 |
| supplierId | Long | 渚涘簲鍟嗙紪鍙� |
| purchaseOrderId | Long | 閲囪喘璁㈠崟缂栧彿 |
-| auditStatus | Integer | 瀹℃壒鐘舵�� |
| hasAttachment | Boolean | 鏄惁宸蹭笂浼犻檮浠讹紙鎭掍负 true锛� |
| remainingInvoicePrice | BigDecimal | 鍓╀綑鍙粯閲戦 |
-### 2. 浠樻鍗曪紙鎺ュ彛鍙樻洿锛�
+### 2. 浠樻鍗�
| 鏂规硶 | 璺緞 | 璇存槑 |
|------|------|------|
-| POST | /erp/finance-payment/create | 鍒涘缓浠樻鍗曪紝璇锋眰浣撴柊澧� `invoiceId`锛堝繀濉級 |
-| PUT | /erp/finance-payment/update | 鏇存柊浠樻鍗曪紝璇锋眰浣撴柊澧� `invoiceId`锛堝繀濉級 |
-| GET | /erp/finance-payment/get | 鍝嶅簲鏂板 `invoiceId`銆乣invoice` 宓屽瀵硅薄 |
-| GET | /erp/finance-payment/page | 鍝嶅簲鏂板 `invoiceId`銆乣invoice` 宓屽瀵硅薄 |
+| POST | /erp/finance-payment/create | 鍒涘缓浠樻鍗曪紝璇锋眰浣撳惈 `invoiceId`锛堝繀濉級 |
+| PUT | /erp/finance-payment/update | 鏇存柊浠樻鍗曪紝璇锋眰浣撳惈 `invoiceId`锛堝繀濉級 |
+| GET | /erp/finance-payment/get | 鍝嶅簲鍚� `invoiceId`銆乣invoice` 宓屽瀵硅薄 |
+| GET | /erp/finance-payment/page | 鍝嶅簲鍚� `invoiceId`銆乣invoice` 宓屽瀵硅薄 |
**璇锋眰鍙傛暟鏂板锛�**
@@ -93,7 +92,7 @@
| 瀛楁 | 绫诲瀷 | 璇存槑 |
|------|------|------|
| invoiceId | Long | 鍏宠仈鐨勬潵绁ㄧ紪鍙� |
-| invoice | Object | 鍏宠仈鐨勬潵绁ㄤ俊鎭紙鍚� no銆乮nvoiceNo銆乮nvoiceTitle銆乸rice銆乤uditStatus 绛夛級 |
+| invoice | Object | 鍏宠仈鐨勬潵绁ㄤ俊鎭紙鍚� no銆乮nvoiceNo銆乮nvoiceTitle銆乸rice 绛夛級 |
**鍝嶅簲绀轰緥锛�**
@@ -109,8 +108,7 @@
"no": "FPD20260810000001",
"invoiceNo": "02564178",
"invoiceTitle": "XX绉戞妧鏈夐檺鍏徃",
- "price": 9000.00,
- "auditStatus": 20
+ "price": 9000.00
},
"paymentPrice": 5000.00
}
@@ -127,20 +125,20 @@
| 鍙戠エ鍙风爜/鎶ご | 鏉ョエ鍒楄〃銆佽鎯� | 褰曞叆瀛楁 |
| 鏉ョエ閲戦 | 鏉ョエ鍒楄〃銆佽鎯呫�佷粯娆捐〃鍗� | 鍏� |
| 鏉ョエ鏃ユ湡 | 鏉ョエ鍒楄〃銆佽鎯� | |
-| 瀹℃壒鐘舵�� | 鏉ョエ鍒楄〃銆佽鎯� | 瀛楀吀灞曠ず |
-| 鍙戠エ闄勪欢 | 鏉ョエ璇︽儏銆佹潵绁ㄥ垪琛� | 涓婁紶/棰勮/涓嬭浇 |
+| 鍙戠エ闄勪欢 | 鏉ョエ璇︽儏銆佹潵绁ㄥ垪琛� | 涓婁紶/棰勮/涓嬭浇锛屾湁闄勪欢鏄剧ず"宸蹭笂浼�"Tag |
| 鍓╀綑鍙粯閲戦 | 鏉ョエ鍒楄〃銆佷粯娆捐〃鍗� | 鏉ョエ閲戦 - 宸蹭粯娆鹃噾棰� |
| 鍏宠仈鏉ョエ | 浠樻鍒楄〃銆佷粯娆捐鎯� | 灞曠ず invoice.no / invoice.invoiceNo / invoice.price |
+
+> 宸茬Щ闄ゅ睍绀哄瓧娈碉細鏉ョエ鍒楄〃鐨�"瀹℃壒鐘舵��"鍒椼�佹悳绱㈡潯浠�"瀹℃牳鐘舵��"銆�"瀹℃牳/鍙嶅鏍�"鎿嶄綔鎸夐挳銆�
## 涓氬姟瑙勫垯璇存槑
| 鍦烘櫙 | 瑙勫垯 |
|------|------|
-| 鏉ョエ鍒涘缓 | 閲囪喘璁㈠崟蹇呴』瀹℃牳閫氳繃锛涙潵绁ㄤ緵搴斿晢涓庨噰璐鍗曚竴鑷达紱鏉ョエ閲戦涓嶈秴杩囪鍗曞墿浣欏彲寮�绁ㄩ噾棰� |
-| 鏉ョエ缂栬緫 | 浠�"鏈彁浜�"鐘舵�佸彲缂栬緫 |
-| 鏉ョエ鍒犻櫎 | 瀹℃壒閫氳繃鍚庝笉鍙垹闄� |
-| 鏉ョエ鎻愪氦瀹℃壒 | 浠�"鏈彁浜�"鐘舵�佸彲鎻愪氦锛屾彁浜ゅ悗杩涘叆瀹℃壒涓� |
-| 浠樻閫夋嫨鏉ョエ | 浠呭鎵归�氳繃 + 宸蹭笂浼犲彂绁ㄩ檮浠剁殑鏉ョエ鍙�� |
+| 鏉ョエ鍒涘缓 | 閲囪喘璁㈠崟蹇呴』瀹℃牳閫氳繃锛涙潵绁ㄤ緵搴斿晢涓庨噰璐鍗曚竴鑷达紱鏉ョエ閲戦涓嶈秴杩囪鍗曞墿浣欏彲寮�绁ㄩ噾棰濓紱**鍒涘缓鍗崇敓鏁堬紝鏃犻渶瀹℃牳** |
+| 鏉ョエ缂栬緫 | 浠绘剰鐘舵�佸彲缂栬緫锛屾棤瀹℃牳鐘舵�侀檺鍒� |
+| 鏉ョエ鍒犻櫎 | 宸叉湁鏈夋晥浠樻鍗曪紙鏈綔搴熶笖浠樻閲戦 > 0锛夊叧鑱旂殑鏉ョエ涓嶅彲鍒犻櫎锛屽叾浣欏彲鍒犻櫎 |
+| 浠樻閫夋嫨鏉ョエ | 宸蹭笂浼犲彂绁ㄩ檮浠朵笖鍓╀綑鍙粯閲戦 > 0 鐨勬潵绁ㄥ彲閫夛紙**涓嶅啀瑕佹眰瀹℃牳閫氳繃**锛� |
| 浠樻閲戦涓婇檺 | 浠樻閲戦 <= 璇ユ潵绁ㄩ噾棰� - 璇ユ潵绁ㄥ凡浠樻閲戦锛堟湭瀹℃牳+瀹℃壒涓�+宸插鏍镐粯娆撅紝鎺掗櫎浣滃簾锛� |
| 渚涘簲鍟嗕竴鑷存�� | 浠樻鐨勪緵搴斿晢蹇呴』涓庡叧鑱旀潵绁ㄧ殑渚涘簲鍟嗕竴鑷� |
| 瀛橀噺浠樻鍗� | invoiceId 涓虹┖鐨勫瓨閲忎粯娆惧崟锛岀紪杈戞椂闇�閲嶆柊閫夋嫨鍚堟牸鏉ョエ |
@@ -151,5 +149,4 @@
- 浠樻琛ㄥ崟閫夋嫨鏉ョエ鏃讹紝鍏堟寜渚涘簲鍟嗚繃婊わ紙`supplierId`锛夛紝鍙�夎鍗曟椂浼� `purchaseOrderId` 杩涗竴姝ヨ繃婊ゃ��
- `remainingInvoicePrice` 涓鸿礋鏁版垨 0 鐨勬潵绁ㄤ笉浼氬嚭鐜板湪 simple-list 涓紝鍓嶇鍙洿鎺ユ寜杩斿洖鍒楄〃娓叉煋銆�
- 浠樻閲戦鏍￠獙鍦ㄥ悗绔紝鍓嶇鍙皢鏉ョエ鐨� `remainingInvoicePrice` 浣滀负浠樻閲戦杈撳叆涓婇檺鎻愮ず銆�
-- 鏉ョエ瀹℃壒鐘舵�佸彉鍖栭�氳繃 BPM 鍥炶皟鏇存柊锛屽墠绔棤闇�澶勭悊锛屽垎椤垫帴鍙ｇ洿鎺ヨ繑鍥炴渶鏂扮姸鎬併��
- 鏉ョエ鍙戠エ闄勪欢涓婁紶浣跨敤 system 妯″潡 Storage API锛坲pload -> bind锛夛紝涓嶈浣跨敤鏃х増 /infra/file 鎺ュ彛銆�
--
Gitblit v1.9.3