feat: 运去哪 / 易达云 商品查询接口
统一模型新增:
- ProductQuery:providerSkus(仓侧 SKU)/ barcode / 创建时间窗 / 分页,
单次上限 100 个 SKU
- ProductInfo:查询结果(仓侧 SKU、条码、尺寸重量、装箱、状态、创建时间)
- WarehouseProductCapable.query(...) 默认抛不支持;门面 queryProducts(ProductQuery)
运去哪(API 113 /v1/product/findPage):
- **页码从 0 开始**(文档原文),游标即页码、不做 ±1 换算
- 单页上限 100、skuList 上限 100
- 该接口没有条码 / 时间窗过滤,传了本地拒绝
- 翻页优先 last,其次 number+1 < totalPages,最后按满页兜底
- cost 没有 currency 时不成 Money(避免丢单位)
易达云(/webApi/skuInfo/v1/listProductPage):
- skuCode 是逗号拼接的单个字符串,一次最多 50 个,超了本地拒绝
- 页码从 1 开始、单页上限 200
- 尺寸取**实际值**,缺失才回落 forecast*(真机 ybtest:实际 55 vs 预报 10,差 5 倍)
- 「查询无数据」按空页处理,不抛异常(与轨迹接口同口径)
- 查询条件全空时仓方默认查最近一个月,本地不补默认值
真机验证(2026-11-17):
- 易达云:不带时间窗 total=52244;skuCode=ybtest 命中 1 行;
30 天窗口 + 2021 年建的 SKU → 「查询无数据」;10 年窗口正常命中
- 运去哪:未提供 x-api-key,只做了离线单测
SKU 口径已确认并写入文档:两边都传仓侧 SKU(建档下发的 providerSku,
为空时才是 omsSku),SDK 不做 OMS→仓侧转换。
Co-Authored-By: Claude <noreply@anthropic.com>
|