# 门店领取统计 - 修改领取时间接口测试说明

## 接口信息

- **接口名称**：修改门店领取统计的领取时间
- **请求方式**：`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
curl -X POST "http://localhost:2015/api/oauth/Login" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "account=admin&password=e10adc3949ba59abbe56e057f20f883e"
```

从响应中取 `data.token` 的完整值（已含 `Bearer ` 前缀）。

### 2. 获取一条可用的使用记录 ID

先调用门店领取统计列表接口，取得某条记录的 `id`：

```bash
curl -X POST "http://localhost:2015/api/Extend/LqInventoryUsage/GetStoreReceiveStatistics" \
  -H "Authorization: <data.token>" \
  -H "Content-Type: application/json" \
  -d '{"Year":2025,"Month":3}'
```

从返回的 `data.data` 中任选一条记录的 `id`。

### 3. 调用修改领取时间接口

将 `<data.token>` 和 `<使用记录ID>` 替换为实际值：

```bash
curl -X PUT "http://localhost:2015/api/Extend/LqInventoryUsage/UpdateStoreReceiveTime" \
  -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` 后再调用本接口进行验证。