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>
|
2 days ago |
chenchuchuan
|
a6bfba6fa9
|
fix: 同步引擎查询窗口与水位线对齐,库存增量字段显式拒绝
1. SyncEngine 的查询窗口补上上界
原来 fetch(from, cursor) 只传起点,水位线却推进到 to。窗口内尚未入账的
数据会被永久跳过。改为 PageFetcher(from, to, cursor),查询与推进都限定在
[from, to)。同时补 syncProducts。
2. 新增首次全量建底 API
增量同步要求先有水位线,但此前没有任何方法能建底,只能手工 advance。
新增 bootstrapSalesOrders / bootstrapProducts:分页拉全量 → 落库 →
成功后播种水位线;已有水位线时拒绝执行,避免把线上水位线回退。
3. 库存 updatedAfter 四家仓统一显式拒绝
恒健原本就拒绝;运去哪 / 易达云 / 信仓此前静默忽略该字段,调用方以为
是按增量拉、实际拿到全量,容易误用。现统一抛 ValidationException,
与各仓 inventorySyncStrategy()=FULL_PULL_DIFF 保持一致。
补 4 个同步测试:窗口上界、无水位线、to 早于起点、建底与重复建底拒绝。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 days ago |
chenchuchuan
|
dc4db1c208
|
refactor: 连接配置收敛到 SecretProvider,调用点只传身份
调用方不再每次构造 ChannelConnection 传地址和密钥,改为:
- 账户只保留业务字段(warehouseCode / provider / providerWarehouseId / credentialRef)
- 密钥与地址由 SecretProvider 按 credentialRef 统一提供
- 门面新增免连接重载:sdk.warehouses(code)、sdk.salesOrders(key) 等
主要改动:
- ChannelSecret 承接 endpointBaseUrl / auxEndpointBaseUrl,与密钥一起配置
- WarehouseAccount 删除 timeZone / endpointBaseUrl / auxEndpointBaseUrl
- ChannelAccount 增加 endpointBaseUrl
- PlatformAdapter / WarehouseAdapter 新增 defaultEndpointBaseUrl(),适配器提供内置默认地址
(运去哪 / 信仓 / 恒健 / 领星取生产地址;易达云生产地址未定,返回 null)
- WarehouseConnection 不再无条件覆盖凭据里的地址,凭据已有地址时优先采用
- 两个门面的 Builder 新增 secretProvider(...),未注入时仍可用带连接的老入口
- 旧签名(带 connection)全部保留,向后兼容
适配器内部未改动:它们只消费 ctx.secret() / ctx.endpointBaseUrl(),
来源由调用方传入改为门面装配。
Co-Authored-By: Claude <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 |
chenchuchuan
|
96f6621bbd
|
refactor: 按 Spec W0 拆分 sdk-common / channel-sdk-core,http 并入 sdk-common
模块更名与上提(Spec W0 §11):
- shared → sdk-common,http 合并进来,channel-sdk-http 取消
- channel → channel-sdk-core,testkit → sdk-testkit
- 父 POM 更名为 channel-sdk-parent
共享层为跨域复用做的三处调整:
- IdempotencyStore / IdempotencyRecord 的 provider 改为 String,
渠道域与仓库域两套 provider 枚举落同一张幂等表
- 新增 WriteIdentity,WriteScope 实现它;幂等守卫改为面向接口
- CallSupport 从 channel 移到 sdk-common,新增 CallScope;
ChannelContext 实现 CallScope,耗时与埋点维度不再绑定渠道域
ChannelProvider 里误加的 YUNQUNA 移除:仓不是渠道,走 WarehouseProvider。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |