diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InboundCapable.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InboundCapable.java index e01c7cd..218b727 100644 --- a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InboundCapable.java +++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InboundCapable.java @@ -26,7 +26,14 @@ public interface InboundCapable extends WarehouseAdapter { /** 按 OMS 单号或仓单号查。 */ InboundOrder get(WarehouseContext ctx, String inboundRef); - /** 分页查入库单。 */ + /** + * 分页查入库单。 + * + *
并非所有仓都支持分页 / 时间窗:运去哪的 API 101 只支持按 + * {@code orderNo}(入库单号或来源单号)单条查,没有列表接口。适配器在 + * {@code cursor} 非空时把它当单号用,返回单条结果;{@code cursor} 为空时 + * 显式拒绝而不是返回全量。调用方不能假定本方法能用于增量同步。
+ */ Page运去哪不提供:API 101 的响应没有创建时间字段,该值恒为 null。 + * 需要近似值时用 {@link #actualArrivalAt()} / {@link #receivedAt()}, + * 不要拿它做「按创建时间同步」的增量条件——那类逻辑对运去哪恒为空集。
+ */ private final Instant createdAt; private final Instant receivedAt; /** 预计到仓(UTC)。 */ diff --git a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java index 47473ee..c4e9598 100644 --- a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java +++ b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java @@ -421,8 +421,10 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl } /** - * 运去哪没有入库单列表接口,与订单一样只能按单号取。 - * {@code cursor} 在这里被当作入库单号使用;不给就拒绝,不返回全量。 + * API 101 不支持时间查询,只支持按 {@code orderNo}(入库单号 / 来源单号)单条查。 + * + *{@code cursor} 在这里被当作 {@code orderNo} 使用;不给就拒绝,不返回全量—— + * 否则容易被误当成增量同步入口。
*/ @Override public Page