From 1c1daebcb9f89138a84e9a7643d1909bb1a5a342 Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期二, 14 七月 2026 10:27:31 +0800
Subject: [PATCH] 1.仓储物流-自定义出入库分别新增接口
---
docs/material_stock_adjust.md | 62 ++++++++++++++++++++++++------
1 files changed, 49 insertions(+), 13 deletions(-)
diff --git a/docs/material_stock_adjust.md b/docs/material_stock_adjust.md
index 38b6d85..ada1faf 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 | 鑷畾涔夊叆搴� |
**璇锋眰鍙傛暟锛�**
@@ -32,8 +32,38 @@
| batchId | Long | 鍚� | 鎵规ID |
| batchCode | String | 鍚� | 鎵规鍙� |
| vendorId | Long | 鍚� | 渚涘簲鍟咺D |
-| quantity | BigDecimal | 鏄� | 璋冩暣鏁伴噺锛堟鏁�=鍏ュ簱锛岃礋鏁�=鍑哄簱锛� |
-| reason | String | 鍚� | 璋冩暣鍘熷洜 |
+| 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 | 鏄� | 鍑哄簱鏁伴噺锛堝繀椤诲ぇ浜�0锛� |
+| reason | String | 鍚� | 鍑哄簱鍘熷洜 |
**鍝嶅簲锛�**
@@ -57,6 +87,10 @@
### 2. 搴撳瓨璋冩暣寮圭獥
+**鎿嶄綔绫诲瀷閫夋嫨锛�**
+- 鐢ㄦ埛棣栧厛閫夋嫨鎿嶄綔绫诲瀷锛氬叆搴� / 鍑哄簱
+- 鏍规嵁鎿嶄綔绫诲瀷璋冪敤涓嶅悓鐨� API
+
**琛ㄥ崟瀛楁锛�**
| 瀛楁 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
@@ -67,8 +101,8 @@
| 搴撲綅 | 閫夋嫨鍣� | 鏄� | 鏍规嵁搴撳尯鑱斿姩鍔犺浇搴撲綅 |
| 鎵规 | 閫夋嫨鍣� | 鍚� | 寮瑰嚭鎵规閫夋嫨瀵硅瘽妗嗭紙濡傛灉鐗╂枡鍚敤鎵规绠＄悊锛� |
| 渚涘簲鍟� | 閫夋嫨鍣� | 鍚� | 涓嬫媺閫夋嫨渚涘簲鍟� |
-| 璋冩暣鏁伴噺 | 鏁板瓧杈撳叆 | 鏄� | 姝ｆ暟=鍏ュ簱锛岃礋鏁�=鍑哄簱 |
-| 璋冩暣鍘熷洜 | 鏂囨湰杈撳叆 | 鍚� | 濉啓璋冩暣鍘熷洜 |
+| 鍏ュ簱鏁伴噺/鍑哄簱鏁伴噺 | 鏁板瓧杈撳叆 | 鏄� | 蹇呴』澶т簬0 |
+| 鍏ュ簱鍘熷洜/鍑哄簱鍘熷洜 | 鏂囨湰杈撳叆 | 鍚� | 濉啓鍘熷洜 |
**鑱斿姩閫昏緫锛�**
@@ -81,16 +115,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锛� | 鏍￠獙搴撳瓨璁板綍瀛樺湪涓旀暟閲忓厖瓒筹紝鎵ｅ噺搴撳瓨鏁伴噺 |
+| 鍏ュ簱 | 鑷姩鍒涘缓搴撳瓨璁板綍锛堝鏋滀笉瀛樺湪锛夛紝澧炲姞搴撳瓨鏁伴噺 |
+| 鍑哄簱 | 鏍￠獙搴撳瓨璁板綍瀛樺湪涓旀暟閲忓厖瓒筹紝鎵ｅ噺搴撳瓨鏁伴噺 |
| 鎵规绠＄悊 | 鐗╂枡鍚敤鎵规绠＄悊鏃讹紝蹇呴』閫夋嫨鎵规 |
| 搴撲綅娣锋斁 | 鏍规嵁搴撲綅閰嶇疆鐨勬贩鏀捐鍒欐牎楠� |
@@ -107,7 +143,7 @@
## 娉ㄦ剰浜嬮」
-- 璋冩暣鏁伴噺涓嶈兘涓�0
+- 鍏ュ簱鏁伴噺/鍑哄簱鏁伴噺蹇呴』澶т簬0
- 鍑哄簱鏃跺繀椤讳繚璇佸簱瀛樺厖瓒�
-- 璋冩暣鎿嶄綔浼氳褰曞簱瀛樹簨鍔℃祦姘达紝渚夸簬杩芥函
-- 寤鸿鍦ㄨ皟鏁村師鍥犱腑濉啓璇︾粏鐨勮皟鏁村師鍥狅紝渚夸簬鍚庣画鏌ヨ鍜屽璁�
\ No newline at end of file
+- 鍏ュ簱鍜屽嚭搴撴搷浣滀細鍒嗗埆璁板綍搴撳瓨浜嬪姟娴佹按锛屼究浜庤拷婧�
+- 寤鸿鍦ㄥ師鍥犱腑濉啓璇︾粏璇存槑锛屼究浜庡悗缁煡璇㈠拰瀹¤
\ No newline at end of file
--
Gitblit v1.9.3