Browse Source

docs(warehouse): 标注运去哪不提供入库单创建时间 / API 101 只支持按单号查

Co-Authored-By: Claude <noreply@anthropic.com>
feature/supplier-lingxing
chenchuchuan 1 week ago
parent
commit
9c814851dd
  1. 9
      warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InboundCapable.java
  2. 7
      warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/InboundOrder.java
  3. 6
      warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java

9
warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InboundCapable.java

@ -26,7 +26,14 @@ public interface InboundCapable extends WarehouseAdapter {
/** 按 OMS 单号或仓单号查。 */ /** 按 OMS 单号或仓单号查。 */
InboundOrder get(WarehouseContext ctx, String inboundRef); InboundOrder get(WarehouseContext ctx, String inboundRef);
/** 分页查入库单。 */ /**
* 分页查入库单。
*
* <p><b>并非所有仓都支持分页 / 时间窗</b>:运去哪的 API 101 只支持按
* {@code orderNo}(入库单号或来源单号)单条查,没有列表接口。适配器在
* {@code cursor} 非空时把它当单号用,返回单条结果;{@code cursor} 为空时
* 显式拒绝而不是返回全量。调用方不能假定本方法能用于增量同步。</p>
*/
Page<InboundOrder> query(WarehouseContext ctx, String cursor); Page<InboundOrder> query(WarehouseContext ctx, String cursor);
/** BOL 文档;无此能力的仓返回空列表。 */ /** BOL 文档;无此能力的仓返回空列表。 */

7
warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/InboundOrder.java

@ -30,6 +30,13 @@ public final class InboundOrder {
/** 库存类型:0 可售 / 1 不可售。 */ /** 库存类型:0 可售 / 1 不可售。 */
private final int inventoryType; private final int inventoryType;
private final int boxCount; private final int boxCount;
/**
* 创建时间(UTC)。
*
* <p><b>运去哪不提供</b>:API 101 的响应没有创建时间字段,该值恒为 null。
* 需要近似值时用 {@link #actualArrivalAt()} / {@link #receivedAt()},
* 不要拿它做「按创建时间同步」的增量条件——那类逻辑对运去哪恒为空集。</p>
*/
private final Instant createdAt; private final Instant createdAt;
private final Instant receivedAt; private final Instant receivedAt;
/** 预计到仓(UTC)。 */ /** 预计到仓(UTC)。 */

6
warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java

@ -421,8 +421,10 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
} }
/** /**
* 运去哪没有入库单列表接口,与订单一样只能按单号取。 * API 101 不支持时间查询,只支持按 {@code orderNo}(入库单号 / 来源单号)单条查。
* {@code cursor} 在这里被当作入库单号使用;不给就拒绝,不返回全量。 *
* <p>{@code cursor} 在这里被当作 {@code orderNo} 使用;不给就拒绝,不返回全量——
* 否则容易被误当成增量同步入口。</p>
*/ */
@Override @Override
public Page<InboundOrder> query(WarehouseContext ctx, String inboundRef) { public Page<InboundOrder> query(WarehouseContext ctx, String inboundRef) {

Loading…
Cancel
Save