From 450bcae3cfffe9923dc09dea2a4e89312bb373d7 Mon Sep 17 00:00:00 2001
From: liyong <18434998025@163.com>
Date: 星期五, 31 七月 2026 15:01:03 +0800
Subject: [PATCH] 库存流水修改
---
docs/material_stock_adjust.md | 100 +++++++++++++++++++++++++++++++++++++++++++-------
1 files changed, 86 insertions(+), 14 deletions(-)
diff --git a/docs/material_stock_adjust.md b/docs/material_stock_adjust.md
index 38b6d85..20adee6 100644
--- a/docs/material_stock_adjust.md
+++ b/docs/material_stock_adjust.md
@@ -15,11 +15,11 @@
## 鏂板 API
-### 搴撳瓨璋冩暣锛堣嚜瀹氫箟鍑哄叆搴擄級
+### 鑷畾涔夊叆搴�
| 鏂规硶 | 璺緞 | 璇存槑 |
|------|------|------|
-| POST | /mes/wm/material-stock/adjust | 搴撳瓨璋冩暣锛堟鏁�=鍏ュ簱锛岃礋鏁�=鍑哄簱锛� |
+| POST | /mes/wm/material-stock/adjust-in | 鑷畾涔夊叆搴� |
**璇锋眰鍙傛暟锛�**
@@ -29,11 +29,43 @@
| warehouseId | Long | 鏄� | 浠撳簱ID |
| locationId | Long | 鏄� | 搴撳尯ID |
| areaId | Long | 鏄� | 搴撲綅ID |
-| batchId | Long | 鍚� | 鎵规ID |
+| batchId | Long | 鍚� | 鎵规ID锛堥�夋嫨宸叉湁鎵规鏃朵紶鍏ワ級 |
+| batchCode | String | 鍚� | 鎵规鍙凤紙鏂板缓鎵规鏃朵紶鍏ワ級 |
+| produceDate | DateTime | 鍚� | 鐢熶骇鏃ユ湡锛堟柊寤烘壒娆℃椂浼犲叆锛� |
+| expireDate | DateTime | 鍚� | 鏈夋晥鏈燂紙鏂板缓鎵规鏃朵紶鍏ワ級 |
+| vendorId | Long | 鍚� | 渚涘簲鍟咺D |
+| quantity | BigDecimal | 鏄� | 鍏ュ簱鏁伴噺锛堝繀椤诲ぇ浜�0锛� |
+| reason | String | 鍚� | 鍏ュ簱鍘熷洜 |
+
+**鍝嶅簲锛�**
+
+```json
+{
+ "code": 0,
+ "data": 123, // 搴撳瓨璁板綍ID
+ "msg": "鎿嶄綔鎴愬姛"
+}
+```
+
+### 鑷畾涔夊嚭搴�
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | /mes/wm/material-stock/adjust-out | 鑷畾涔夊嚭搴� |
+
+**璇锋眰鍙傛暟锛�**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
+|------|------|------|------|
+| itemId | Long | 鏄� | 鐗╂枡ID |
+| warehouseId | Long | 鏄� | 浠撳簱ID |
+| locationId | Long | 鏄� | 搴撳尯ID |
+| areaId | Long | 鏄� | 搴撲綅ID |
+| batchId | Long | 鍚� | 鎵规ID锛堝嚭搴撴椂鏍￠獙鎵规瀛樺湪锛� |
| batchCode | String | 鍚� | 鎵规鍙� |
| vendorId | Long | 鍚� | 渚涘簲鍟咺D |
-| quantity | BigDecimal | 鏄� | 璋冩暣鏁伴噺锛堟鏁�=鍏ュ簱锛岃礋鏁�=鍑哄簱锛� |
-| reason | String | 鍚� | 璋冩暣鍘熷洜 |
+| quantity | BigDecimal | 鏄� | 鍑哄簱鏁伴噺锛堝繀椤诲ぇ浜�0锛� |
+| reason | String | 鍚� | 鍑哄簱鍘熷洜 |
**鍝嶅簲锛�**
@@ -57,6 +89,10 @@
### 2. 搴撳瓨璋冩暣寮圭獥
+**鎿嶄綔绫诲瀷閫夋嫨锛�**
+- 鐢ㄦ埛棣栧厛閫夋嫨鎿嶄綔绫诲瀷锛氬叆搴� / 鍑哄簱
+- 鏍规嵁鎿嶄綔绫诲瀷璋冪敤涓嶅悓鐨� API
+
**琛ㄥ崟瀛楁锛�**
| 瀛楁 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
@@ -67,8 +103,8 @@
| 搴撲綅 | 閫夋嫨鍣� | 鏄� | 鏍规嵁搴撳尯鑱斿姩鍔犺浇搴撲綅 |
| 鎵规 | 閫夋嫨鍣� | 鍚� | 寮瑰嚭鎵规閫夋嫨瀵硅瘽妗嗭紙濡傛灉鐗╂枡鍚敤鎵规绠＄悊锛� |
| 渚涘簲鍟� | 閫夋嫨鍣� | 鍚� | 涓嬫媺閫夋嫨渚涘簲鍟� |
-| 璋冩暣鏁伴噺 | 鏁板瓧杈撳叆 | 鏄� | 姝ｆ暟=鍏ュ簱锛岃礋鏁�=鍑哄簱 |
-| 璋冩暣鍘熷洜 | 鏂囨湰杈撳叆 | 鍚� | 濉啓璋冩暣鍘熷洜 |
+| 鍏ュ簱鏁伴噺/鍑哄簱鏁伴噺 | 鏁板瓧杈撳叆 | 鏄� | 蹇呴』澶т簬0 |
+| 鍏ュ簱鍘熷洜/鍑哄簱鍘熷洜 | 鏂囨湰杈撳叆 | 鍚� | 濉啓鍘熷洜 |
**鑱斿姩閫昏緫锛�**
@@ -81,16 +117,18 @@
**鎻愪氦閫昏緫锛�**
1. 鏍￠獙蹇呭～瀛楁
-2. 璋冪敤 API `/mes/wm/material-stock/adjust`
-3. 鎴愬姛鍚庢彁绀�"璋冩暣鎴愬姛"锛屽埛鏂板垪琛ㄩ〉
+2. 鏍规嵁鎿嶄綔绫诲瀷璋冪敤涓嶅悓 API锛�
+ - 鍏ュ簱锛歚/mes/wm/material-stock/adjust-in`
+ - 鍑哄簱锛歚/mes/wm/material-stock/adjust-out`
+3. 鎴愬姛鍚庢彁绀�"鍏ュ簱鎴愬姛"/"鍑哄簱鎴愬姛"锛屽埛鏂板垪琛ㄩ〉
4. 澶辫触鏃舵樉绀洪敊璇俊鎭�
## 涓氬姟瑙勫垯璇存槑
| 鍦烘櫙 | 瑙勫垯 |
|------|------|
-| 鍏ュ簱锛坬uantity > 0锛� | 鑷姩鍒涘缓搴撳瓨璁板綍锛堝鏋滀笉瀛樺湪锛夛紝澧炲姞搴撳瓨鏁伴噺 |
-| 鍑哄簱锛坬uantity < 0锛� | 鏍￠獙搴撳瓨璁板綍瀛樺湪涓旀暟閲忓厖瓒筹紝鎵ｅ噺搴撳瓨鏁伴噺 |
+| 鍏ュ簱 | 鑷姩鍒涘缓搴撳瓨璁板綍锛堝鏋滀笉瀛樺湪锛夛紝澧炲姞搴撳瓨鏁伴噺 |
+| 鍑哄簱 | 鏍￠獙搴撳瓨璁板綍瀛樺湪涓旀暟閲忓厖瓒筹紝鎵ｅ噺搴撳瓨鏁伴噺 |
| 鎵规绠＄悊 | 鐗╂枡鍚敤鎵规绠＄悊鏃讹紝蹇呴』閫夋嫨鎵规 |
| 搴撲綅娣锋斁 | 鏍规嵁搴撲綅閰嶇疆鐨勬贩鏀捐鍒欐牎楠� |
@@ -105,9 +143,43 @@
| bizId | 搴撳瓨璁板綍ID | 搴撳瓨璁板綍ID |
| bizCode | STOCK_ADJUST_{搴撳瓨ID} | STOCK_ADJUST_{搴撳瓨ID} |
+## 鎵规澶勭悊瑙勫垯
+
+鑷畾涔夊叆搴撴椂锛岀郴缁熶細鏍规嵁鐗╂枡鎵规閰嶇疆鑷姩澶勭悊鎵规锛�
+
+> **鎵规閰嶇疆鏉ユ簮**锛氬熀纭�鏁版嵁锛圡DM锛夌墿鏂欎富鏁版嵁鐨勬壒娆″睘鎬ч厤缃紝鍦ㄧ墿鏂欒鎯呴〉缁存姢銆�
+
+### 鍏ュ簱鎵规澶勭悊閫昏緫
+
+| 鎯呭喌 | 澶勭悊鏂瑰紡 |
+|------|---------|
+| 鐗╂枡鏈惎鐢ㄦ壒娆＄鐞� | 涓嶅叧鑱旀壒娆� |
+| 浼犲叆 batchId | 鏍￠獙鎵规瀛樺湪涓斿綊灞炴纭紝浣跨敤宸叉湁鎵规 |
+| 鏈紶 batchId锛堢墿鏂欏惎鐢ㄦ壒娆＄鐞嗭級 | 鏍规嵁鍙傛暟鑷姩鍒涘缓鎵规璁板綍 |
+
+### 鏂板缓鎵规鏃剁殑鍙傛暟
+
+褰撶墿鏂欏惎鐢ㄦ壒娆＄鐞嗕笖鏈紶鍏� batchId 鏃讹紝鍙紶鍏ヤ互涓嬪弬鏁扮敤浜庡垱寤烘壒娆★細
+
+| 鍙傛暟 | 璇存槑 |
+|------|------|
+| batchCode | 鎵规鍙凤紙鍙�夛紝涓嶄紶鍒欑郴缁熻嚜鍔ㄧ敓鎴愶級 |
+| produceDate | 鐢熶骇鏃ユ湡 |
+| expireDate | 鏈夋晥鏈� |
+| vendorId | 渚涘簲鍟咺D |
+
+> 绯荤粺浼氭牴鎹墿鏂欑殑鎵规閰嶇疆鏍￠獙蹇呭～鍙傛暟锛堝鐢熶骇鏃ユ湡銆佹湁鏁堟湡绛夛級
+
+### 鍑哄簱鎵规澶勭悊閫昏緫
+
+| 鎯呭喌 | 澶勭悊鏂瑰紡 |
+|------|---------|
+| 鐗╂枡鏈惎鐢ㄦ壒娆＄鐞� | 涓嶆牎楠屾壒娆� |
+| 浼犲叆 batchId | 鏍￠獙鎵规瀛樺湪涓斾笌鐗╂枡鍖归厤 |
+
## 娉ㄦ剰浜嬮」
-- 璋冩暣鏁伴噺涓嶈兘涓�0
+- 鍏ュ簱鏁伴噺/鍑哄簱鏁伴噺蹇呴』澶т簬0
- 鍑哄簱鏃跺繀椤讳繚璇佸簱瀛樺厖瓒�
-- 璋冩暣鎿嶄綔浼氳褰曞簱瀛樹簨鍔℃祦姘达紝渚夸簬杩芥函
-- 寤鸿鍦ㄨ皟鏁村師鍥犱腑濉啓璇︾粏鐨勮皟鏁村師鍥狅紝渚夸簬鍚庣画鏌ヨ鍜屽璁�
\ No newline at end of file
+- 鍏ュ簱鍜屽嚭搴撴搷浣滀細鍒嗗埆璁板綍搴撳瓨浜嬪姟娴佹按锛屼究浜庤拷婧�
+- 寤鸿鍦ㄥ師鍥犱腑濉啓璇︾粏璇存槑锛屼究浜庡悗缁煡璇㈠拰瀹¤
\ No newline at end of file
--
Gitblit v1.9.3