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

接口信息

• 接口名称：修改门店领取统计的领取时间
• 请求方式：PUT
• URL：/api/Extend/LqInventoryUsage/UpdateStoreReceiveTime
• Content-Type：application/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

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：

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> 替换为实际值：

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 后再调用本接口进行验证。