b43001c6
 “wangming”
Remove unused CSS...
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
# 门店领取统计 - 修改领取时间接口测试说明
## 接口信息
- **接口名称**：修改门店领取统计的领取时间
- **请求方式**：`PUT`
- **URL**：`/api/Extend/LqInventoryUsage/UpdateStoreReceiveTime`
- **Content-Type**：`application/json`
## 请求体
```json
{
"id": "使用记录ID（门店领取统计列表中的 id）",
"receiveTime": "2025-03-01 10:00:00"
}
```
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| id | string | 是 | 使用记录ID，来自门店领取统计列表返回的 `id` |
| receiveTime | string | 是 | 新的领取时间，格式：`yyyy-MM-dd HH:mm:ss` |
## 测试步骤
### 1. 获取 Token
```bash
|
|
8daf47d0
“wangming”
修改访问地址
|
29
|
curl -X POST "http://localhost:2015/api/oauth/Login" \
|
|
b43001c6
“wangming”
Remove unused CSS...
|
30
31
32
33
34
35
36
37
38
39
40
|
-H "Content-Type: application/x-www-form-urlencoded" \
-d "account=admin&password=e10adc3949ba59abbe56e057f20f883e"
```
从响应中取 `data.token` 的完整值（已含 `Bearer ` 前缀）。
### 2. 获取一条可用的使用记录 ID
先调用门店领取统计列表接口，取得某条记录的 `id`：
```bash
|
|
8daf47d0
“wangming”
修改访问地址
|
41
|
curl -X POST "http://localhost:2015/api/Extend/LqInventoryUsage/GetStoreReceiveStatistics" \
|
|
b43001c6
“wangming”
Remove unused CSS...
|
42
43
44
45
46
47
48
49
50
51
52
53
|
-H "Authorization: <data.token>" \
-H "Content-Type: application/json" \
-d '{"Year":2025,"Month":3}'
```
从返回的 `data.data` 中任选一条记录的 `id`。
### 3. 调用修改领取时间接口
将 `<data.token>` 和 `<使用记录ID>` 替换为实际值：
```bash
|
|
8daf47d0
“wangming”
修改访问地址
|
54
|
curl -X PUT "http://localhost:2015/api/Extend/LqInventoryUsage/UpdateStoreReceiveTime" \
|
|
b43001c6
“wangming”
Remove unused CSS...
|
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
-H "Authorization: <data.token>" \
-H "Content-Type: application/json" \
-d '{"Id":"<使用记录ID>","ReceiveTime":"2025-03-10 14:30:00"}'
```
### 4. 预期结果
- **成功**：HTTP 200，响应体示例：
```json
{
"code": 200,
"data": {
"success": true,
"message": "领取时间修改成功"
}
}
```
- **失败**：如参数为空、记录不存在、未找到已领取申请单等，返回相应错误信息（如 `使用记录不存在或已失效`、`未找到对应的已领取申请单，无法修改领取时间`）。
## 验证要点
- [ ] 使用有效的使用记录 ID 和新的领取时间，接口返回成功
- [ ] 再次查询门店领取统计列表，该记录（及同批次其他记录）的领取时间已更新为新时间
- [ ] 传入不存在的 `id`，返回“使用记录不存在或已失效”
- [ ] 传入空的 `id` 或空的 `receiveTime`，返回参数错误提示
## 已执行验证（异常分支）
在本地已执行以下请求，结果符合预期：
| 用例 | 请求 | 预期 | 实际 |
|------|------|------|------|
| 空 Id | `Id: ""` | 参数错误 | HTTP 200，`msg`: "使用记录ID不能为空" ✓ |
| 不存在的 Id | `Id: "999999999999999999"` | 记录不存在 | HTTP 200，`msg`: "使用记录不存在或已失效" ✓ |
成功分支需在存在门店领取数据的月份下，先通过 `GetStoreReceiveStatistics` 获取真实 `id` 后再调用本接口进行验证。
|
