From 9c814851dd90f6a75910396f6ea4cba32bb961d6 Mon Sep 17 00:00:00 2001 From: chenchuchuan <13554600537@163.com> Date: Tue, 10 Nov 2026 16:39:50 +0800 Subject: [PATCH] =?UTF-8?q?docs(warehouse):=20=E6=A0=87=E6=B3=A8=E8=BF=90?= =?UTF-8?q?=E5=8E=BB=E5=93=AA=E4=B8=8D=E6=8F=90=E4=BE=9B=E5=85=A5=E5=BA=93?= =?UTF-8?q?=E5=8D=95=E5=88=9B=E5=BB=BA=E6=97=B6=E9=97=B4=20/=20API=20101?= =?UTF-8?q?=20=E5=8F=AA=E6=94=AF=E6=8C=81=E6=8C=89=E5=8D=95=E5=8F=B7?= =?UTF-8?q?=E6=9F=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude --- .../common/ecommerce/warehouse/capability/InboundCapable.java | 9 ++++++++- .../main/java/common/ecommerce/warehouse/model/InboundOrder.java | 7 +++++++ .../src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java | 6 ++++-- 3 files changed, 19 insertions(+), 3 deletions(-) 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 query(WarehouseContext ctx, String cursor); /** BOL 文档;无此能力的仓返回空列表。 */ diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/InboundOrder.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/InboundOrder.java index 04e8808..8b86999 100644 --- a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/InboundOrder.java +++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/InboundOrder.java @@ -30,6 +30,13 @@ public final class InboundOrder { /** 库存类型:0 可售 / 1 不可售。 */ private final int inventoryType; private final int boxCount; + /** + * 创建时间(UTC)。 + * + *

运去哪不提供: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 query(WarehouseContext ctx, String inboundRef) {