确认收货接口

概述

用于用户确认邮寄订单已收货完成。

接口名称：确认收货
接口用途：用户确认邮寄订单收货完成
调用方：小程序前端
请求方式：POST
请求路径：/orders/{orderId}/confirm-receipt
请求头要求：Authorization、X-Idempotency-Key

请求参数

参数	类型	必填	说明
orderId	path string	是	订单 ID

返回参数

参数	类型	说明
orderStatus	string	完成后状态
finishedAt	string	完成时间

成功示例

{"code":"0","message":"ok","data":{"orderStatus":"completed","finishedAt":"2026-04-10T12:00:00+08:00"}}

失败示例

错误码

A0001
B1004：当前订单状态不允许确认收货

接口约束

幂等要求：是
缓存策略：不缓存
一致性要求：强一致

前后端同步规则

确认收货完成后：

刷新订单详情
允许评价功能预留（AI假设项 A1）