lml
|
b6c0bbbdd3
|
fix(walmart): shipDateTime 响应类型按官方 schema 修正为 int64
官方 Orders spec 里 trackingInfo.shipDateTime 在请求与响应中都是
{"type":"integer","format":"int64"},实测响应示例为 1580821866000。
原实现把响应字段声明成 String 并注释为「ISO-8601 字符串」,导致:
- getShipping 侥幸能用(Jackson 把数字转成 "1580821866000"),
但返回值形态与官方语义不符
- markShipped 的 ShipmentResult.shippedAt 恒为 null:
Instant.parse("1580821866000") 抛异常后被吞掉
【改动】
- TrackingInfo.shipDateTime 改为 Object,同时接住 int64 与 ISO-8601
- WalmartShipmentMapper 增加 shipTimeOf:统一转成字符串原值,
保留平台原值不做时区换算
- WalmartShipmentWriteMapper 的 parseShipTime 兼容 epoch 毫秒(Number 与数字串)
和 ISO-8601,解析失败返回 null
- 三个测试夹具从 ISO 字符串改成官方形态的 epoch 毫秒——
原来的夹具是错的,所以错的实现一直测不出来
【其它】
- 修正 WalmartShipmentMapper javadoc 里指向已删除方法 toShipmentLines 的链接
- 删除 WalmartRefundMapper 未使用的 import
- ITEM_CURSOR_INITIAL / ITEM_CURSOR_TTL_SECONDS 补注释:
适配器不显式传初始游标,常量供宿主的游标缓存参考
【测试】159 个全过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2 days ago |
lml
|
e3a087dfc8
|
fix(walmart): 退货详情与发货信息改用官方存在的接口
沃尔玛官方 spec 里这两条路由都不存在,原实现会 404:
- GET /v3/returns/{returnOrderId}:Returns spec 只有 GET /v3/returns 与 POST .../refund
- GET /v3/orders/{id}/shipping:Orders spec 里该路径只有 POST(标发)
【改动】
- getReturn 改走列表接口 GET /v3/returns?returnOrderId=xxx&limit=1;
平台不保证过滤生效(沙箱 mock 就不生效),本地再按单号筛一次,
避免把别的退货单混进来
- getShipping 改读订单详情 GET /v3/orders/{id},从
orderLines[].orderLineStatuses[].trackingInfo 抽行级发货记录;
数据与「发货信息」完全一致
- 两个方法的对外签名不变,调用方无需改动
- 删除不再使用的 WalmartShipmentDtos 与 orders/shipping.json、
returns/detail.json 两个夹具
【顺带修复】
- markShipped 解析响应改用 parseQuietly:平台只回受理结果或空体时
返回最小结果而不是抛异常,避免成功的发货被幂等层记成 FAILED 后重试重复发货
【测试】158 个;新增「平台返回多条退货单时本地只保留目标单」
「无 trackingInfo 时返回空列表」等用例。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
3 days ago |
lml
|
a3c5931c5c
|
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>
|
3 days ago |
lml
|
e716a2593e
|
feat(walmart): 沃尔玛 Marketplace 直连适配器(只读一期)
通道 ChannelProvider.DIRECT + Platform.WALMART_SC,新增模块 channel-sdk-walmart。
一期只做只读:鉴权、订单、商品、售后。标发、退款、商品写入不在本期,
对应能力位也不声明——门面调用会显式抛 UnsupportedCapabilityException。
【core 模型增量】全部是可选字段,不影响领星现有行为:
- 新增 ShipToAddress(收件信息;toString 只输出城市/州/邮编,不输出街道与姓名)
- SalesOrder 增加 buyerEmail / shipToAddress
- OrderLine 增加 status(行状态原值)与 lineAmount(行金额,金额权威来源)
- OrderLine.unitPrice 明确为「单价」:行金额除以数量,除不尽时留 null
而不是四舍五入倒推,否则 unitPrice × quantity 与原金额会差出分差
【适配器】
- POST /v3/token(Basic Auth + client_credentials),按 clientId 缓存,
提前 120s 续期;401/403 时 forceRefresh 后重发一次
- GET /v3/orders、/v3/orders/{id}:updatedAfter/Before 映射到创建时间窗
(沃尔玛没有更新时间过滤),跨度超 180 天本地拒绝
- GET /v3/items、/v3/items/{sku}:limit 上限 200;syncStrategy=FULL_PULL_DIFF,
传更新时间窗直接报错而不是静默忽略
- GET /v3/returns:一个退货单按商品行展开成多个 AfterSale,
nextCursor 是整段查询串,翻页时整串拼到路径后
- 扩展查询:getReturn(退货详情)、getShipping(发货信息),沙箱均 404
增量语义拆成两条车道:pull 走创建时间窗语义可预测,老单状态变化由
pullOpenOrders 按行状态对账,不混在一个方法里。
脏数据处理:缺订单号/下单时间/退货单号的记录跳过并 WARN,不崩整页,
也不用假值兜底写脏主键。运费不冒充商品单价,行金额除不尽时 unitPrice 留 null。
【测试】108 个:订单 22、商品 18、售后 13、脏数据 10、扩展查询 12、
状态映射 16、错误 11、门面 5、沙箱探针 1(默认跳过)。
【文档】仅新增 docs/walmart/README.md,以及 README / 操作手册.md 里
沃尔玛相关的两处能力表条目。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
3 days ago |