feat(walmart): 标发 / 退款 / 商品 Feed 接入,并按官方 schema 修正参数
【新增写操作】
- MarkShippedCapable + SalesOrders.markShipped:标发一订单,支持部分发货;
幂等键 businessRef = 订单号|行号:数量(行号排序,不含金额与跟踪号)
- RefundCapable + AfterSales.refund:按退货行 × 费用项退款
- WalmartAdapter.submitFeed / getFeedStatus:商品 Feed 提交与状态轮询(扩展方法,
不进能力接口——Feed 是沃尔玛特有机制,塞进 ProductCapable 会让统一模型变形)
【按官方 reference 修正(与《沙箱接口说明》冲突处一律以官方 schema 为准)】
标发 POST /v3/orders/{id}/shipping:
- shipDateTime 由 ISO-8601 字符串改为 epoch 毫秒整数(官方 type=integer, format=int64)
- 补 sellerOrderId(官方标必填,≤30 字符;适配器不强制,超长省略而非截断)
- 补 intentToCancelOverride(仅 true 时发)、trackingURL(可空)
- OrderShipment 支持 processMode(发货后改物流时传 PARTIAL_UPDATE)
退货 GET /v3/returns:
- 时间参数由 createdStartDate/EndDate 改为 returnCreationStartDate/EndDate
- DateType.UPDATE_TIME 映射到 returnLastModifiedStartDate/EndDate;
PURCHASE_TIME 无对应参数,本地报错
- 去掉官方不存在的 offset 参数
- returnType 枚举改为官方 PREORDER/REPLACEMENT/REFUND;保留 RETURN 别名兼容历史数据
- limit 加上限 200
商品 GET /v3/items:
- limit 上限由 200 改为 1000(200 只是「建议改用游标」的阈值)
- 新增 ITEM_CURSOR_INITIAL 与游标 TTL 常量;首页仍不显式传 nextCursor
商品 Feed POST /v3/feeds:
- feedType 按官方 13 个枚举值本地校验,非法值直接拒绝
- 成功响应是 200 而非 202
【校验与容错】
- 脏数据:缺订单号/下单时间/退货单号的记录跳过并 WARN,不崩整页
- 行金额除不尽时 unitPrice 留 null,不四舍五入倒推
- 运费不冒充商品单价;同单多币种时 totalAmount 为 null
- 请求 DTO 统一 @JsonInclude(NON_NULL),避免 null 字段被平台判为格式错误
【测试】162 个(订单 22、商品 20、售后 14、标发 16、退款 12、Feed 16、
状态映射 18、错误 11、扩展查询 12、门面 5、探针 1 跳过)。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|