Browse Source
枚举原来散在各模型内部(OutboundStatus 嵌在 OutboundOrder 里、DealMethod 嵌在 ReturnCommand 里),且直接带仓方的数字码,导致 core 知道运去哪的协议值。改成两层: - 底层枚举(warehouse-sdk-core/enums):只含 SDK 自编稳定 code + 中文名, 不认识任何仓的码值。code 从 10 起按 10 递增、只追加不重排,落库用。 - 平台枚举(warehouse-sdk-yqn/enums):带仓方原始码,toCore() 映射到底层。 运去哪出库状态是自由文本(无码表),按关键字收敛;其余按文档码表 1:1。 Mapper 里 9 个散落的 switch 全部删除,改为一行 of(raw).toCore()。 顺带修两处会误导下游的问题: - OutboundStatus 缺 UNKNOWN,认不出的状态被兜底成 SUBMITTED(已下发)。 补 UNKNOWN(0, rank=-1),认不出归它;对应测试断言一并修正, 新增 unknownStatusIsNotGuessed 覆盖 null / 空串 / 未知值。 - InboundOrder / TransferOrder / WarehouseReturn / BillingDocument 缺 sourceProvider,rawStatus 无法解释(同一数字在不同仓含义不同)。补上字段, 运去哪的 Mapper 全部标注 YQN。 落库契约写进 WarehouseSink:rawStatus 必须与 sourceProvider 成对保存, 它是映射调整后唯一能重跑、修正历史数据的依据。 删除 WarehouseEnum 接口——在该规模下各枚举自带 code()/label()/ofCode() 足够, 不引入额外抽象。合并 ReturnDisposition 到 ReturnProcessDisposition(后者加 UNKNOWN),退货只保留「预约预报」与「检验后决定」两套语义。 Co-Authored-By: Claude <noreply@anthropic.com>feature/supplier-lingxing
69 changed files with 1295 additions and 566 deletions
@ -1,49 +0,0 @@
@@ -1,49 +0,0 @@
|
||||
package common.ecommerce.warehouse; |
||||
|
||||
/** |
||||
* 仓库能力位。 |
||||
* |
||||
* <p>能力是事实表,不是推荐:调用方用 {@code WarehouseSdk.capabilities()} 查询, |
||||
* 缺失时抛 {@code WarehouseUnsupportedCapabilityException},不静默降级。</p> |
||||
*/ |
||||
public enum WarehouseCapability { |
||||
|
||||
/** 商品建档 / 更新 */ |
||||
PRODUCT, |
||||
/** 出库单创建 / 查询 / 取消 / 拦截 */ |
||||
OUTBOUND, |
||||
/** 支持把平台面单文件下发给仓打印贴标 */ |
||||
PLATFORM_LABEL_DELIVERY, |
||||
/** 取消前费用预判 */ |
||||
OUTBOUND_CANCEL_FEE_CHECK, |
||||
/** 库存查询 */ |
||||
INVENTORY_QUERY, |
||||
/** 库存调整 / 调拨 */ |
||||
INVENTORY_ADJUST, |
||||
/** 仓间调拨单(移库 / FBA 移入移出) */ |
||||
TRANSFER, |
||||
/** 头程入库单创建 / 查询 */ |
||||
INBOUND, |
||||
/** 退货发起 / 查询 */ |
||||
RETURN, |
||||
/** 退货处理方式(二次上架 / 销毁) */ |
||||
RETURN_DISPOSITION, |
||||
/** 换货(三家均无) */ |
||||
EXCHANGE, |
||||
/** 无头件查询 */ |
||||
UNSHIPPED_ITEM, |
||||
/** BOL 获取 / 传递 */ |
||||
BOL, |
||||
/** 物流轨迹 */ |
||||
TRACKING, |
||||
/** 拆单 */ |
||||
SPLIT, |
||||
/** 销毁 / 报废 */ |
||||
DESTRUCTION, |
||||
/** 费用账单 / 订单费用 / 仓租 / 账户流水 */ |
||||
FEE_SETTLEMENT, |
||||
/** 费用试算 */ |
||||
FEE_ESTIMATE, |
||||
/** 状态回调推送 */ |
||||
WEBHOOK |
||||
} |
||||
@ -1,21 +0,0 @@
@@ -1,21 +0,0 @@
|
||||
package common.ecommerce.warehouse; |
||||
|
||||
/** |
||||
* 三方仓 provider 枚举。 |
||||
* |
||||
* <p>与渠道域的 {@code ChannelProvider} 分开:仓不是平台,两套枚举互不继承, |
||||
* 但幂等、水位线、审计里都以 {@link #name()} 字符串落库,共用同一批 SPI。</p> |
||||
*/ |
||||
public enum WarehouseProvider { |
||||
|
||||
/** 运去哪(打样仓) */ |
||||
YQN, |
||||
/** 信仓(新版接口) */ |
||||
XINCANG, |
||||
/** 易达云 */ |
||||
EDAYUN, |
||||
/** 领星 WMS:预留,本期不实现 */ |
||||
LINGXING, |
||||
/** 其他自建/直连仓 */ |
||||
CUSTOM |
||||
} |
||||
@ -0,0 +1,34 @@
@@ -0,0 +1,34 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 取消资格判定。 |
||||
* |
||||
* <p>仓方能力不齐,有的仓有专门的取消预判接口,有的只能查单状态推断。 |
||||
* SDK 统一映射到这三态;{@link #CHARGED} 必须由调用方显式传 |
||||
* {@code acceptCharge=true} 才执行取消。</p> |
||||
*/ |
||||
public enum CancelEligibility { |
||||
|
||||
/** 可免费取消。 */ |
||||
FREE(10, "可免费取消"), |
||||
/** 可取消但收费;需调用方确认。 */ |
||||
CHARGED(20, "可取消但收费"), |
||||
/** 不可取消(已出库 / 已交运 / 仓不允许)。 */ |
||||
BLOCKED(30, "不可取消"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
CancelEligibility(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
public String label() { |
||||
return label; |
||||
} |
||||
} |
||||
@ -0,0 +1,67 @@
@@ -0,0 +1,67 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 入库计划单状态(底层枚举)。 |
||||
* |
||||
* <p>各仓的状态在各自模块里先映射成平台枚举,再 {@code toCore()} 到这里; |
||||
* 本枚举不认识任何仓的码值。</p> |
||||
* |
||||
* <p>未知码归 {@link #UNKNOWN},不猜——猜错会让宿主把未完成的入库当完成。</p> |
||||
*/ |
||||
public enum InboundStatus { |
||||
|
||||
/** 草稿 / 已创建。 */ |
||||
DRAFT(10, "草稿"), |
||||
/** 待审核。 */ |
||||
PENDING_REVIEW(20, "待审核"), |
||||
/** 审核拒绝。 */ |
||||
REJECTED(30, "审核拒绝"), |
||||
/** 待装箱。 */ |
||||
PENDING_PACKING(40, "待装箱"), |
||||
/** 待发货。 */ |
||||
PENDING_SHIPMENT(50, "待发货"), |
||||
/** 已发运 / 在途。 */ |
||||
IN_TRANSIT(60, "在途"), |
||||
/** 收货中。 */ |
||||
RECEIVING(70, "收货中"), |
||||
/** 已收货。 */ |
||||
RECEIVED(80, "已收货"), |
||||
/** 待入库(上架)。 */ |
||||
PENDING_STORAGE(90, "待上架"), |
||||
/** 入库中(上架中)。 */ |
||||
STORING(100, "上架中"), |
||||
/** 已完成。 */ |
||||
COMPLETED(110, "已完成"), |
||||
/** 已取消。 */ |
||||
CANCELLED(120, "已取消"), |
||||
/** 无法识别的状态;码 0 保留给 UNKNOWN,不与任何业务状态冲突。 */ |
||||
UNKNOWN(0, "未知"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
InboundStatus(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
/** 落库用的稳定码;由 SDK 分配,永不复用、永不重排。 */ |
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
/** 中文显示名。 */ |
||||
public String label() { |
||||
return label; |
||||
} |
||||
|
||||
/** 按落库码反查。 */ |
||||
public static InboundStatus ofCode(int code) { |
||||
for (InboundStatus s : values()) { |
||||
if (s.code == code) { |
||||
return s; |
||||
} |
||||
} |
||||
return UNKNOWN; |
||||
} |
||||
} |
||||
@ -0,0 +1,31 @@
@@ -0,0 +1,31 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 库存同步策略。 |
||||
* |
||||
* <p>仓能力不同:有的仓支持按时间增量,有的只能全量拉取后做差异比对。 |
||||
* 具体哪家支持哪种由适配器的 {@code InventoryCapable.syncStrategy()} 声明。</p> |
||||
*/ |
||||
public enum InventorySyncStrategy { |
||||
|
||||
/** 按时间增量查询。 */ |
||||
TIME_WINDOW(10, "按时间增量"), |
||||
/** 全量拉取 + 差异比对。 */ |
||||
FULL_PULL_DIFF(20, "全量比对"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
InventorySyncStrategy(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
public String label() { |
||||
return label; |
||||
} |
||||
} |
||||
@ -0,0 +1,32 @@
@@ -0,0 +1,32 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 面单模式。 |
||||
* |
||||
* <p>必须与仓能力匹配:{@link #PLATFORM_LABEL} 要求仓声明 |
||||
* {@link WarehouseCapability#PLATFORM_LABEL_DELIVERY},缺失时 {@code create()} 拒绝, |
||||
* <b>不静默降级</b>为仓自有面单——面单归属直接影响与平台的标发方式。</p> |
||||
*/ |
||||
public enum LabelMode { |
||||
|
||||
/** 仓用自己的承运商账号出单,SDK 只回收面单与运单。 */ |
||||
WAREHOUSE_LABEL(10, "仓自有面单"), |
||||
/** 渠道域先取平台面单,OMS 把面单文件下发给仓打印贴标。 */ |
||||
PLATFORM_LABEL(20, "平台面单"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
LabelMode(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
public String label() { |
||||
return label; |
||||
} |
||||
} |
||||
@ -0,0 +1,81 @@
@@ -0,0 +1,81 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 出库单状态(底层枚举)。 |
||||
* |
||||
* <p>各仓的状态在各自模块里先映射成「平台枚举」,再 {@code toCore()} 到这里; |
||||
* 本枚举不认识任何仓的码值或字符串。</p> |
||||
* |
||||
* <p>{@link #CREATED} 与 {@link #SUBMITTED} 不是仓方状态,是 SDK 自己的生命周期: |
||||
* 前者表示 OMS 已建单未下发,后者表示已下发但仓尚未确认。仓方返回的状态只会落在 |
||||
* {@code SUBMITTED} 之后的值上。</p> |
||||
* |
||||
* <p>{@link #UNKNOWN} 是必须项:仓方给出无法识别的状态时归这里,<b>不许猜成别的值</b>, |
||||
* 原值看 {@code rawStatus}。</p> |
||||
* |
||||
* <p>{@link #rank()} 只对仓方状态有意义,用于丢弃乱序回调;{@link #UNKNOWN} |
||||
* 的 rank 为 -1,表示「不参与比较」,宿主应保留记录但不覆盖已有状态。</p> |
||||
*/ |
||||
public enum OutboundStatus { |
||||
|
||||
/** 已创建(OMS 侧),尚未下发。 */ |
||||
CREATED(10, "已创建", 0), |
||||
/** SDK 下发成功,仓未确认。 */ |
||||
SUBMITTED(20, "已下发", 1), |
||||
/** 仓已接单。 */ |
||||
ACCEPTED(30, "仓已接单", 2), |
||||
/** 拣货中。 */ |
||||
PICKING(40, "拣货中", 3), |
||||
/** 已打包。 */ |
||||
PACKED(50, "已打包", 4), |
||||
/** 面单已出。 */ |
||||
LABEL_READY(60, "面单已出", 5), |
||||
/** 已交运。 */ |
||||
SHIPPED(70, "已交运", 6), |
||||
/** 已取消。 */ |
||||
CANCELLED(80, "已取消", 7), |
||||
/** 异常(仓侧拣货失败、地址异常等)。 */ |
||||
EXCEPTION(90, "异常", 8), |
||||
/** 无法识别;原值见 {@code rawStatus},不参与 rank 比较。 */ |
||||
UNKNOWN(0, "未知", -1); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
private final int rank; |
||||
|
||||
OutboundStatus(int code, String label, int rank) { |
||||
this.code = code; |
||||
this.label = label; |
||||
this.rank = rank; |
||||
} |
||||
|
||||
/** 落库用的稳定码;由 SDK 分配,永不复用、永不重排。 */ |
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
/** 中文显示名。 */ |
||||
public String label() { |
||||
return label; |
||||
} |
||||
|
||||
/** 状态推进序号,越大越靠后;用于丢弃乱序回调。-1 表示不参与比较。 */ |
||||
public int rank() { |
||||
return rank; |
||||
} |
||||
|
||||
/** 是否终态(不会再变)。 */ |
||||
public boolean terminal() { |
||||
return this == SHIPPED || this == CANCELLED; |
||||
} |
||||
|
||||
/** 按落库码反查。 */ |
||||
public static OutboundStatus ofCode(int code) { |
||||
for (OutboundStatus s : values()) { |
||||
if (s.code == code) { |
||||
return s; |
||||
} |
||||
} |
||||
return UNKNOWN; |
||||
} |
||||
} |
||||
@ -0,0 +1,37 @@
@@ -0,0 +1,37 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 退货预约时的处理方式(业务语义)。 |
||||
* |
||||
* <p>只表达「怎么处理」,不含任何仓方的数字码:各仓码值不同,映射由适配器负责。</p> |
||||
* |
||||
* <p><b>与 {@link ReturnProcessDisposition} 不是一回事</b>:这个是下单时发货人预报的, |
||||
* 那个是仓收货检验之后逐条明细行的最终决定。两者可选值不同,不能互换。</p> |
||||
*/ |
||||
public enum ReturnDealMethod { |
||||
|
||||
/** 客户自提。 */ |
||||
CUSTOMER_PICKUP(10, "客户自提"), |
||||
/** 拍照确认后由客户决定。 */ |
||||
PHOTO_CONFIRM(20, "拍照确认"), |
||||
/** 销毁。 */ |
||||
DESTROY(30, "销毁"), |
||||
/** 仓库确认处理。 */ |
||||
WAREHOUSE_CONFIRM(40, "仓库确认"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
ReturnDealMethod(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
public String label() { |
||||
return label; |
||||
} |
||||
} |
||||
@ -0,0 +1,43 @@
@@ -0,0 +1,43 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 退货检验后的处理方式(业务语义)。 |
||||
* |
||||
* <p>只表达「怎么处理」,不含任何仓方的数字码:各仓码值不同,映射由适配器负责。</p> |
||||
* |
||||
* <p><b>与 {@link ReturnDealMethod} 不是一回事</b>:那个是预约时的预报, |
||||
* 这个是仓收货检验之后逐条明细行的最终决定。</p> |
||||
* |
||||
* <p>查询结果也用本枚举:{@link #UNKNOWN} 表示仓方返回的处理方式无法识别, |
||||
* 原值见 {@code WarehouseReturn.rawStatus()}。不再单独建一个查询专用的枚举—— |
||||
* 那只是本枚举的子集,多一个枚举就多一处「到底该用哪个」的困惑。</p> |
||||
*/ |
||||
public enum ReturnProcessDisposition { |
||||
|
||||
/** 客户自提。 */ |
||||
CUSTOMER_PICKUP(10, "客户自提"), |
||||
/** 销毁。 */ |
||||
DESTROY(20, "销毁"), |
||||
/** 上架(良品)。 */ |
||||
RESTOCK(30, "上架"), |
||||
/** 换标后上架(良品)。 */ |
||||
RESTOCK_RELABEL(40, "换标上架"), |
||||
/** 无法识别;0 保留给 UNKNOWN。 */ |
||||
UNKNOWN(0, "未知"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
ReturnProcessDisposition(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
public String label() { |
||||
return label; |
||||
} |
||||
} |
||||
@ -0,0 +1,60 @@
@@ -0,0 +1,60 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 调拨单状态(底层枚举)。 |
||||
* |
||||
* <p>各仓的状态码在各自模块里先映射成平台枚举,再 {@code toCore()} 到这里; |
||||
* 本枚举不认识任何仓的码值。未知码归 {@link #UNKNOWN},不猜。</p> |
||||
* |
||||
* <p>取值<b>只追加不合并</b>:新仓有、这里没有的状态就加一个值,已存在的值 |
||||
* 不会再合并回上一级——合并之后宿主就分不出「待审核」和「审核中」了。</p> |
||||
*/ |
||||
public enum TransferStatus { |
||||
|
||||
DRAFT(10, "草稿"), |
||||
REJECTED(20, "已驳回"), |
||||
PENDING_REVIEW(30, "待审核"), |
||||
REVIEWING(40, "审核中"), |
||||
APPROVED(50, "审核通过"), |
||||
PENDING_CONFIRM(60, "待确认"), |
||||
PENDING_PICKING(70, "待备货"), |
||||
PENDING_OUTBOUND(80, "待出库"), |
||||
OUTBOUNDING(90, "出库中"), |
||||
PENDING_INBOUND(100, "待入库"), |
||||
INBOUNDING(110, "入库中"), |
||||
COMPLETED(120, "已完成"), |
||||
CLOSED(130, "已关闭"), |
||||
CANCELLING(140, "取消中"), |
||||
CANCELLED(150, "已取消"), |
||||
CANCEL_EXCEPTION(160, "取消异常"), |
||||
/** 无法识别;0 保留给 UNKNOWN。 */ |
||||
UNKNOWN(0, "未知"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
TransferStatus(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
/** 落库用的稳定码;由 SDK 分配,永不复用、永不重排。 */ |
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
/** 中文显示名。 */ |
||||
public String label() { |
||||
return label; |
||||
} |
||||
|
||||
/** 按落库码反查。 */ |
||||
public static TransferStatus ofCode(int code) { |
||||
for (TransferStatus s : values()) { |
||||
if (s.code == code) { |
||||
return s; |
||||
} |
||||
} |
||||
return UNKNOWN; |
||||
} |
||||
} |
||||
@ -0,0 +1,35 @@
@@ -0,0 +1,35 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 调拨类型,只表达业务语义。 |
||||
* |
||||
* <p>仓方的类型码由适配器映射(如运去哪 {@code type} 0/1/2/3),core 不认识任何 |
||||
* 仓的码值。创建响应若不回传类型,适配器从请求侧带过来,不猜。</p> |
||||
*/ |
||||
public enum TransferType { |
||||
|
||||
/** 仓到仓调拨。 */ |
||||
WAREHOUSE_TO_WAREHOUSE(10, "仓到仓调拨"), |
||||
/** 调拨出库(发往外部地址或平台仓)。 */ |
||||
OUTBOUND(20, "调拨出库"), |
||||
/** 亚马逊移除订单(FBA 移出)。 */ |
||||
AMAZON_REMOVAL(30, "亚马逊移出"), |
||||
/** 亚马逊移入(FBA 入库)。 */ |
||||
AMAZON_INBOUND(40, "亚马逊移入"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
TransferType(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
public String label() { |
||||
return label; |
||||
} |
||||
} |
||||
@ -0,0 +1,65 @@
@@ -0,0 +1,65 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 仓库能力位。 |
||||
* |
||||
* <p>能力是事实表,不是推荐:调用方用 {@code WarehouseSdk.capabilities()} 查询, |
||||
* 缺失时抛 {@code WarehouseUnsupportedCapabilityException},不静默降级。</p> |
||||
*/ |
||||
public enum WarehouseCapability { |
||||
|
||||
/** 商品建档 / 更新 */ |
||||
PRODUCT(10, "商品建档"), |
||||
/** 出库单创建 / 查询 / 取消 / 拦截 */ |
||||
OUTBOUND(20, "出库"), |
||||
/** 支持把平台面单文件下发给仓打印贴标 */ |
||||
PLATFORM_LABEL_DELIVERY(30, "平台面单下发"), |
||||
/** 取消前费用预判 */ |
||||
OUTBOUND_CANCEL_FEE_CHECK(40, "取消费用预判"), |
||||
/** 库存查询 */ |
||||
INVENTORY_QUERY(50, "库存查询"), |
||||
/** 库存调整 / 调拨 */ |
||||
INVENTORY_ADJUST(60, "库存调整"), |
||||
/** 仓间调拨单(移库 / FBA 移入移出) */ |
||||
TRANSFER(70, "仓间调拨"), |
||||
/** 头程入库单创建 / 查询 */ |
||||
INBOUND(80, "入库"), |
||||
/** 退货发起 / 查询 */ |
||||
RETURN(90, "退货"), |
||||
/** 退货处理方式(二次上架 / 销毁) */ |
||||
RETURN_DISPOSITION(100, "退货处理方式"), |
||||
/** 换货 */ |
||||
EXCHANGE(110, "换货"), |
||||
/** 无头件查询 */ |
||||
UNSHIPPED_ITEM(120, "无头件"), |
||||
/** BOL 获取 / 传递 */ |
||||
BOL(130, "BOL"), |
||||
/** 物流轨迹 */ |
||||
TRACKING(140, "物流轨迹"), |
||||
/** 拆单 */ |
||||
SPLIT(150, "拆单"), |
||||
/** 销毁 / 报废 */ |
||||
DESTRUCTION(160, "销毁报废"), |
||||
/** 费用账单 / 订单费用 / 仓租 / 账户流水 */ |
||||
FEE_SETTLEMENT(170, "费用结算"), |
||||
/** 费用试算 */ |
||||
FEE_ESTIMATE(180, "费用试算"), |
||||
/** 状态回调推送 */ |
||||
WEBHOOK(190, "状态回调"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
WarehouseCapability(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
public String label() { |
||||
return label; |
||||
} |
||||
} |
||||
@ -0,0 +1,35 @@
@@ -0,0 +1,35 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 仓费用类型,只表达业务语义。 |
||||
* |
||||
* <p>仓方的费用码与分类口径由适配器维护:有的仓给类型码,有的仓只给中文费用名, |
||||
* 后者按名归类,认不出就留 null——对账时宁可不分类,也不能猜错。</p> |
||||
*/ |
||||
public enum WarehouseFeeType { |
||||
|
||||
/** 作业费(出入库操作费)。 */ |
||||
OPERATION(10, "作业费"), |
||||
/** 仓储费 / 仓租。 */ |
||||
STORAGE(20, "仓储费"), |
||||
/** 增值服务费。 */ |
||||
VALUE_ADDED(30, "增值服务费"), |
||||
/** 尾程运费。 */ |
||||
LAST_MILE(40, "尾程运费"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
WarehouseFeeType(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
public String label() { |
||||
return label; |
||||
} |
||||
} |
||||
@ -0,0 +1,39 @@
@@ -0,0 +1,39 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 三方仓 provider 枚举。 |
||||
* |
||||
* <p>与渠道域的 {@code ChannelProvider} 分开:仓不是平台,两套枚举互不继承, |
||||
* 但幂等、水位线、审计里都以 {@link #name()} 字符串落库,共用同一批 SPI。 |
||||
* provider 是<b>接入通道标识</b>而非协议码,因此落库继续用 {@code name()}, |
||||
* 不用 {@link #code()}——换码值会让存量幂等键对不上。</p> |
||||
*/ |
||||
public enum WarehouseProvider { |
||||
|
||||
/** 运去哪(打样仓) */ |
||||
YQN(10, "运去哪"), |
||||
/** 信仓(新版接口) */ |
||||
XINCANG(20, "信仓"), |
||||
/** 易达云 */ |
||||
EDAYUN(30, "易达云"), |
||||
/** 领星 WMS:预留,本期不实现 */ |
||||
LINGXING(40, "领星WMS"), |
||||
/** 其他自建/直连仓 */ |
||||
CUSTOM(90, "自建仓"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
WarehouseProvider(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
public String label() { |
||||
return label; |
||||
} |
||||
} |
||||
@ -1,17 +0,0 @@
@@ -1,17 +0,0 @@
|
||||
package common.ecommerce.warehouse.model; |
||||
|
||||
/** |
||||
* 取消资格判定。 |
||||
* |
||||
* <p>仓方能力不齐:易达云有专门接口,另两家需打样核实。SDK 统一映射到这三态; |
||||
* {@link #CHARGED} 必须由调用方显式传 {@code acceptCharge=true} 才执行取消。</p> |
||||
*/ |
||||
public enum CancelEligibility { |
||||
|
||||
/** 可免费取消。 */ |
||||
FREE, |
||||
/** 可取消但收费;需调用方确认。 */ |
||||
CHARGED, |
||||
/** 不可取消(已出库 / 已交运 / 仓不允许)。 */ |
||||
BLOCKED |
||||
} |
||||
@ -1,32 +0,0 @@
@@ -1,32 +0,0 @@
|
||||
package common.ecommerce.warehouse.model; |
||||
|
||||
/** 入库计划单状态,已归一化。仓方状态值在适配器内映射到这里。 */ |
||||
public enum InboundStatus { |
||||
|
||||
/** 草稿 / 已创建。 */ |
||||
DRAFT, |
||||
/** 待审核。 */ |
||||
PENDING_REVIEW, |
||||
/** 审核拒绝。 */ |
||||
REJECTED, |
||||
/** 待装箱。 */ |
||||
PENDING_PACKING, |
||||
/** 待发货。 */ |
||||
PENDING_SHIPMENT, |
||||
/** 已发运 / 在途。 */ |
||||
IN_TRANSIT, |
||||
/** 收货中。 */ |
||||
RECEIVING, |
||||
/** 已收货。 */ |
||||
RECEIVED, |
||||
/** 待入库(上架)。 */ |
||||
PENDING_STORAGE, |
||||
/** 入库中(上架中)。 */ |
||||
STORING, |
||||
/** 已完成。 */ |
||||
COMPLETED, |
||||
/** 已取消。 */ |
||||
CANCELLED, |
||||
/** 无法识别的状态。 */ |
||||
UNKNOWN |
||||
} |
||||
@ -1,12 +0,0 @@
@@ -1,12 +0,0 @@
|
||||
package common.ecommerce.warehouse.model; |
||||
|
||||
/** |
||||
* 库存同步策略。仓能力不同:信仓支持按时间增量,易达云只能全量 diff。 |
||||
*/ |
||||
public enum InventorySyncStrategy { |
||||
|
||||
/** 按时间增量查询。 */ |
||||
TIME_WINDOW, |
||||
/** 全量拉取 + 差异比对。 */ |
||||
FULL_PULL_DIFF |
||||
} |
||||
@ -1,16 +0,0 @@
@@ -1,16 +0,0 @@
|
||||
package common.ecommerce.warehouse.model; |
||||
|
||||
/** |
||||
* 面单模式。 |
||||
* |
||||
* <p>必须与仓能力匹配:{@link #PLATFORM_LABEL} 要求仓声明 |
||||
* {@code WarehouseCapability.PLATFORM_LABEL_DELIVERY},缺失时 {@code create()} 拒绝, |
||||
* <b>不静默降级</b>为仓自有面单——面单归属直接影响与平台的标发方式。</p> |
||||
*/ |
||||
public enum LabelMode { |
||||
|
||||
/** 仓用自己的承运商账号出单,SDK 只回收面单与运单。 */ |
||||
WAREHOUSE_LABEL, |
||||
/** 渠道域先取平台面单,OMS 把面单文件下发给仓打印贴标。 */ |
||||
PLATFORM_LABEL |
||||
} |
||||
@ -1,46 +0,0 @@
@@ -1,46 +0,0 @@
|
||||
package common.ecommerce.warehouse.model; |
||||
|
||||
/** |
||||
* 出库单状态。仓方状态在适配器内映射到这里,只前进不后退。 |
||||
* |
||||
* <p>回调不保证顺序,宿主按本枚举的 {@link #rank()} 比较:小于当前值的事件记为 |
||||
* {@code OUT_OF_ORDER},保留记录但不覆盖状态。</p> |
||||
*/ |
||||
public enum OutboundStatus { |
||||
|
||||
/** 已创建(OMS 侧),尚未下发。 */ |
||||
CREATED(0), |
||||
/** SDK 下发成功,仓未确认。 */ |
||||
SUBMITTED(1), |
||||
/** 仓已接单。 */ |
||||
ACCEPTED(2), |
||||
/** 拣货中。 */ |
||||
PICKING(3), |
||||
/** 已打包。 */ |
||||
PACKED(4), |
||||
/** 面单已出。 */ |
||||
LABEL_READY(5), |
||||
/** 已交运。 */ |
||||
SHIPPED(6), |
||||
/** 已取消。 */ |
||||
CANCELLED(7), |
||||
/** 异常(仓侧拣货失败、地址异常等)。 */ |
||||
EXCEPTION(8); |
||||
|
||||
/** 状态推进序号,越大越靠后。 */ |
||||
private final int rank; |
||||
|
||||
OutboundStatus(int rank) { |
||||
this.rank = rank; |
||||
} |
||||
|
||||
/** 状态推进序号。 */ |
||||
public int rank() { |
||||
return rank; |
||||
} |
||||
|
||||
/** 是否终态(不会再变)。 */ |
||||
public boolean terminal() { |
||||
return this == SHIPPED || this == CANCELLED; |
||||
} |
||||
} |
||||
@ -1,29 +0,0 @@
@@ -1,29 +0,0 @@
|
||||
package common.ecommerce.warehouse.model; |
||||
|
||||
/** |
||||
* 调拨单状态,已归一化。 |
||||
* |
||||
* <p>运去哪的码:0 草稿 / 3 已驳回 / 5 待审核 / 6 审核中 / 7 审核通过 / 8 待确认 / |
||||
* 9 待备货 / 10 待出库 / 15 出库中 / 20 待入库 / 25 入库中 / 70 已完成 / |
||||
* 90 已关闭 / 100 取消中 / 110 已取消 / 120 取消异常。</p> |
||||
*/ |
||||
public enum TransferStatus { |
||||
|
||||
DRAFT, |
||||
REJECTED, |
||||
PENDING_REVIEW, |
||||
REVIEWING, |
||||
APPROVED, |
||||
PENDING_CONFIRM, |
||||
PENDING_PICKING, |
||||
PENDING_OUTBOUND, |
||||
OUTBOUNDING, |
||||
PENDING_INBOUND, |
||||
INBOUNDING, |
||||
COMPLETED, |
||||
CLOSED, |
||||
CANCELLING, |
||||
CANCELLED, |
||||
CANCEL_EXCEPTION, |
||||
UNKNOWN |
||||
} |
||||
@ -1,19 +0,0 @@
@@ -1,19 +0,0 @@
|
||||
package common.ecommerce.warehouse.model; |
||||
|
||||
/** |
||||
* 调拨类型。 |
||||
* |
||||
* <p>运去哪的 {@code type} 是 0 亚马逊移出 / 1 亚马逊移入 / 2 仓-仓调拨 / 3 调拨出库。 |
||||
* 只保留业务语义,适配器维护到仓方码值的映射。</p> |
||||
*/ |
||||
public enum TransferType { |
||||
|
||||
/** 仓到仓调拨。 */ |
||||
WAREHOUSE_TO_WAREHOUSE, |
||||
/** 调拨出库(发往外部地址或平台仓)。 */ |
||||
OUTBOUND, |
||||
/** 亚马逊移除订单(FBA 移出)。 */ |
||||
AMAZON_REMOVAL, |
||||
/** 亚马逊移入(FBA 入库)。 */ |
||||
AMAZON_INBOUND |
||||
} |
||||
@ -1,19 +0,0 @@
@@ -1,19 +0,0 @@
|
||||
package common.ecommerce.warehouse.model; |
||||
|
||||
/** |
||||
* 仓费用类型。 |
||||
* |
||||
* <p>各仓的枚举值不同,由适配器维护映射;这里只保留业务语义。 |
||||
* 运去哪 API 133 的 {@code costType} 是 1 作业费 / 2 仓储费 / 3 增值服务费 / 4 尾程费用。</p> |
||||
*/ |
||||
public enum WarehouseFeeType { |
||||
|
||||
/** 作业费(出入库操作费)。 */ |
||||
OPERATION, |
||||
/** 仓储费 / 仓租。 */ |
||||
STORAGE, |
||||
/** 增值服务费。 */ |
||||
VALUE_ADDED, |
||||
/** 尾程运费。 */ |
||||
LAST_MILE |
||||
} |
||||
@ -0,0 +1,73 @@
@@ -0,0 +1,73 @@
|
||||
package common.ecommerce.yqn.enums; |
||||
|
||||
import common.ecommerce.warehouse.enums.InboundStatus; |
||||
|
||||
/** |
||||
* 运去哪入库计划状态(API 101 的 {@code inboundPlanOrderStatus})。 |
||||
* |
||||
* <p>运去哪给的是数字字符串。码表来自接口文档,1:1 对应,未知码归 {@link #UNKNOWN}。</p> |
||||
*/ |
||||
public enum YqnInboundStatus { |
||||
|
||||
/** 0 草稿。 */ |
||||
DRAFT("0", InboundStatus.DRAFT), |
||||
/** 5 待审核。 */ |
||||
PENDING_REVIEW("5", InboundStatus.PENDING_REVIEW), |
||||
/** 6 审核驳回。 */ |
||||
REJECTED("6", InboundStatus.REJECTED), |
||||
/** 8 待装箱。 */ |
||||
PENDING_PACKING("8", InboundStatus.PENDING_PACKING), |
||||
/** 10 待发货。 */ |
||||
PENDING_SHIPMENT("10", InboundStatus.PENDING_SHIPMENT), |
||||
/** 16 收货中。 */ |
||||
RECEIVING("16", InboundStatus.RECEIVING), |
||||
/** 17 已收货。 */ |
||||
RECEIVED("17", InboundStatus.RECEIVED), |
||||
/** 20 待上架。 */ |
||||
PENDING_STORAGE("20", InboundStatus.PENDING_STORAGE), |
||||
/** 25 上架中。 */ |
||||
STORING("25", InboundStatus.STORING), |
||||
/** 70 已完成。 */ |
||||
COMPLETED("70", InboundStatus.COMPLETED), |
||||
/** 100 已取消。 */ |
||||
CANCELLED("100", InboundStatus.CANCELLED), |
||||
/** 无法识别。 */ |
||||
UNKNOWN(null, InboundStatus.UNKNOWN); |
||||
|
||||
private final String rawCode; |
||||
private final InboundStatus core; |
||||
|
||||
YqnInboundStatus(String rawCode, InboundStatus core) { |
||||
this.rawCode = rawCode; |
||||
this.core = core; |
||||
} |
||||
|
||||
/** 运去哪的状态码;null 表示无法识别。 */ |
||||
public String rawCode() { |
||||
return rawCode; |
||||
} |
||||
|
||||
/** 对应的底层状态。 */ |
||||
public InboundStatus toCore() { |
||||
return core; |
||||
} |
||||
|
||||
/** 运去哪状态码 → 平台枚举。 */ |
||||
public static YqnInboundStatus of(String rawStatus) { |
||||
if (rawStatus == null || rawStatus.trim().isEmpty()) { |
||||
return UNKNOWN; |
||||
} |
||||
String s = rawStatus.trim(); |
||||
for (YqnInboundStatus v : values()) { |
||||
if (s.equals(v.rawCode)) { |
||||
return v; |
||||
} |
||||
} |
||||
return UNKNOWN; |
||||
} |
||||
|
||||
/** 运去哪状态码 → 底层状态。 */ |
||||
public static InboundStatus toCore(String rawStatus) { |
||||
return of(rawStatus).toCore(); |
||||
} |
||||
} |
||||
@ -0,0 +1,83 @@
@@ -0,0 +1,83 @@
|
||||
package common.ecommerce.yqn.enums; |
||||
|
||||
import common.ecommerce.warehouse.enums.OutboundStatus; |
||||
|
||||
/** |
||||
* 运去哪出库单状态(API 128 的 {@code orderStatusEnum})。 |
||||
* |
||||
* <p>运去哪这个字段给的是英文文本而不是数字码,且目前<b>没有公开发布的码表</b>, |
||||
* 所以这里按关键字匹配。匹配不到的归 {@link #UNKNOWN}——<b>不猜</b>, |
||||
* 早先的实现把认不出的当 {@code SUBMITTED}(已下发)是错的。</p> |
||||
* |
||||
* <p>关键字匹配是有损的:{@code UNSHIPPED} 这类名字会命中 {@code SHIP}。 |
||||
* 拿到官方码表后应改成精确匹配。</p> |
||||
*/ |
||||
public enum YqnOutboundStatus { |
||||
|
||||
/** 已取消 / 取消中。 */ |
||||
CANCELLED("CANCEL", OutboundStatus.CANCELLED), |
||||
/** 已交运 / 已发出 / 已妥投。 */ |
||||
SHIPPED("SHIP", OutboundStatus.SHIPPED), |
||||
/** 已妥投(独立关键字,避免只靠 SHIP 覆盖)。 */ |
||||
DELIVERED("DELIVER", OutboundStatus.SHIPPED), |
||||
/** 面单已打印。 */ |
||||
LABEL_READY("LABEL", OutboundStatus.LABEL_READY), |
||||
/** 已打包。 */ |
||||
PACKED("PACK", OutboundStatus.PACKED), |
||||
/** 拣货中。 */ |
||||
PICKING("PICK", OutboundStatus.PICKING), |
||||
/** 仓已接单。 */ |
||||
ACCEPTED("ACCEPT", OutboundStatus.ACCEPTED), |
||||
/** 异常。 */ |
||||
EXCEPTION("EXCEPTION", OutboundStatus.EXCEPTION), |
||||
/** 失败 / 错误。 */ |
||||
FAILED("FAIL", OutboundStatus.EXCEPTION), |
||||
/** 错误码。 */ |
||||
ERROR("ERROR", OutboundStatus.EXCEPTION), |
||||
/** 无法识别。 */ |
||||
UNKNOWN(null, OutboundStatus.UNKNOWN); |
||||
|
||||
private final String keyword; |
||||
private final OutboundStatus core; |
||||
|
||||
YqnOutboundStatus(String keyword, OutboundStatus core) { |
||||
this.keyword = keyword; |
||||
this.core = core; |
||||
} |
||||
|
||||
/** 运去哪原始值里的关键字;null 表示「无关键字 / 认不出」。 */ |
||||
public String keyword() { |
||||
return keyword; |
||||
} |
||||
|
||||
/** 对应的底层状态。 */ |
||||
public OutboundStatus toCore() { |
||||
return core; |
||||
} |
||||
|
||||
/** |
||||
* 运去哪原始值 → 平台枚举。 |
||||
* |
||||
* <p>空值或匹配不到返回 {@link #UNKNOWN}。按声明顺序匹配,越具体的放越前。</p> |
||||
*/ |
||||
public static YqnOutboundStatus of(String rawStatus) { |
||||
if (rawStatus == null) { |
||||
return UNKNOWN; |
||||
} |
||||
String s = rawStatus.trim().toUpperCase(); |
||||
if (s.isEmpty()) { |
||||
return UNKNOWN; |
||||
} |
||||
for (YqnOutboundStatus v : values()) { |
||||
if (v.keyword != null && s.contains(v.keyword)) { |
||||
return v; |
||||
} |
||||
} |
||||
return UNKNOWN; |
||||
} |
||||
|
||||
/** 运去哪原始值 → 底层状态。 */ |
||||
public static OutboundStatus toCore(String rawStatus) { |
||||
return of(rawStatus).toCore(); |
||||
} |
||||
} |
||||
@ -0,0 +1,67 @@
@@ -0,0 +1,67 @@
|
||||
package common.ecommerce.yqn.enums; |
||||
|
||||
import common.ecommerce.warehouse.enums.ReturnDealMethod; |
||||
|
||||
/** |
||||
* 运去哪「退货预约处理方式」(API 81 的 {@code returnDealMethod})。 |
||||
* |
||||
* <p>码表:0 客户自提 / 1 拍照确认 / 2 销毁 / 5 仓库确认。</p> |
||||
* |
||||
* <p><b>与 {@link YqnReturnProcessDisposition} 不是一回事</b>:那个是仓收货检验后 |
||||
* 逐条明细行的决定(0/2/3/4),两套码值不能互换。</p> |
||||
*/ |
||||
public enum YqnReturnDealMethod { |
||||
|
||||
/** 0 客户自提。 */ |
||||
CUSTOMER_PICKUP(0, ReturnDealMethod.CUSTOMER_PICKUP), |
||||
/** 1 拍照确认后由客户决定。 */ |
||||
PHOTO_CONFIRM(1, ReturnDealMethod.PHOTO_CONFIRM), |
||||
/** 2 销毁。 */ |
||||
DESTROY(2, ReturnDealMethod.DESTROY), |
||||
/** 5 仓库确认处理。 */ |
||||
WAREHOUSE_CONFIRM(5, ReturnDealMethod.WAREHOUSE_CONFIRM); |
||||
|
||||
private final Integer rawCode; |
||||
private final ReturnDealMethod core; |
||||
|
||||
YqnReturnDealMethod(Integer rawCode, ReturnDealMethod core) { |
||||
this.rawCode = rawCode; |
||||
this.core = core; |
||||
} |
||||
|
||||
/** 运去哪码值。 */ |
||||
public Integer rawCode() { |
||||
return rawCode; |
||||
} |
||||
|
||||
/** 对应的底层处理方式。 */ |
||||
public ReturnDealMethod toCore() { |
||||
return core; |
||||
} |
||||
|
||||
/** 底层处理方式 → 运去哪码值;null 透传。 */ |
||||
public static Integer codeOf(ReturnDealMethod method) { |
||||
if (method == null) { |
||||
return null; |
||||
} |
||||
for (YqnReturnDealMethod v : values()) { |
||||
if (v.core == method) { |
||||
return v.rawCode; |
||||
} |
||||
} |
||||
throw new IllegalArgumentException("yqn does not support returnDealMethod: " + method); |
||||
} |
||||
|
||||
/** 运去哪码值 → 底层处理方式;未知返回 null。 */ |
||||
public static ReturnDealMethod toCore(Integer rawCode) { |
||||
if (rawCode == null) { |
||||
return null; |
||||
} |
||||
for (YqnReturnDealMethod v : values()) { |
||||
if (rawCode.equals(v.rawCode)) { |
||||
return v.core; |
||||
} |
||||
} |
||||
return null; |
||||
} |
||||
} |
||||
@ -0,0 +1,67 @@
@@ -0,0 +1,67 @@
|
||||
package common.ecommerce.yqn.enums; |
||||
|
||||
import common.ecommerce.warehouse.enums.ReturnProcessDisposition; |
||||
|
||||
/** |
||||
* 运去哪「退货检验后处理方式」(API 77 的 {@code goodsReturnType})。 |
||||
* |
||||
* <p>码表:0 客户自提 / 2 销毁 / 3 上架(良品)/ 4 换标上架(良品)。</p> |
||||
* |
||||
* <p><b>与 {@link YqnReturnDealMethod} 不是一回事</b>:那个是预约时的预报(0/1/2/5), |
||||
* 两套码值不能互换。</p> |
||||
*/ |
||||
public enum YqnReturnProcessDisposition { |
||||
|
||||
/** 0 客户自提。 */ |
||||
CUSTOMER_PICKUP(0, ReturnProcessDisposition.CUSTOMER_PICKUP), |
||||
/** 2 销毁。 */ |
||||
DESTROY(2, ReturnProcessDisposition.DESTROY), |
||||
/** 3 上架(良品)。 */ |
||||
RESTOCK(3, ReturnProcessDisposition.RESTOCK), |
||||
/** 4 换标上架(良品)。 */ |
||||
RESTOCK_RELABEL(4, ReturnProcessDisposition.RESTOCK_RELABEL); |
||||
|
||||
private final Integer rawCode; |
||||
private final ReturnProcessDisposition core; |
||||
|
||||
YqnReturnProcessDisposition(Integer rawCode, ReturnProcessDisposition core) { |
||||
this.rawCode = rawCode; |
||||
this.core = core; |
||||
} |
||||
|
||||
/** 运去哪码值。 */ |
||||
public Integer rawCode() { |
||||
return rawCode; |
||||
} |
||||
|
||||
/** 对应的底层处理方式。 */ |
||||
public ReturnProcessDisposition toCore() { |
||||
return core; |
||||
} |
||||
|
||||
/** 底层处理方式 → 运去哪码值;null 透传。 */ |
||||
public static Integer codeOf(ReturnProcessDisposition disposition) { |
||||
if (disposition == null) { |
||||
return null; |
||||
} |
||||
for (YqnReturnProcessDisposition v : values()) { |
||||
if (v.core == disposition) { |
||||
return v.rawCode; |
||||
} |
||||
} |
||||
throw new IllegalArgumentException("yqn does not support disposition: " + disposition); |
||||
} |
||||
|
||||
/** 运去哪码值 → 底层处理方式;未知返回 null。 */ |
||||
public static ReturnProcessDisposition toCore(Integer rawCode) { |
||||
if (rawCode == null) { |
||||
return null; |
||||
} |
||||
for (YqnReturnProcessDisposition v : values()) { |
||||
if (rawCode.equals(v.rawCode)) { |
||||
return v.core; |
||||
} |
||||
} |
||||
return null; |
||||
} |
||||
} |
||||
@ -0,0 +1,82 @@
@@ -0,0 +1,82 @@
|
||||
package common.ecommerce.yqn.enums; |
||||
|
||||
import common.ecommerce.warehouse.enums.TransferStatus; |
||||
|
||||
/** |
||||
* 运去哪调拨单状态(API 139 的 {@code transferOutboundPlanStatus})。 |
||||
* |
||||
* <p>码表来自接口文档,1:1 对应;未知码归 {@link #UNKNOWN},不猜。</p> |
||||
*/ |
||||
public enum YqnTransferStatus { |
||||
|
||||
/** 0 草稿。 */ |
||||
DRAFT(0, TransferStatus.DRAFT), |
||||
/** 3 已驳回。 */ |
||||
REJECTED(3, TransferStatus.REJECTED), |
||||
/** 5 待审核。 */ |
||||
PENDING_REVIEW(5, TransferStatus.PENDING_REVIEW), |
||||
/** 6 审核中。 */ |
||||
REVIEWING(6, TransferStatus.REVIEWING), |
||||
/** 7 审核通过。 */ |
||||
APPROVED(7, TransferStatus.APPROVED), |
||||
/** 8 待确认。 */ |
||||
PENDING_CONFIRM(8, TransferStatus.PENDING_CONFIRM), |
||||
/** 9 待备货。 */ |
||||
PENDING_PICKING(9, TransferStatus.PENDING_PICKING), |
||||
/** 10 待出库。 */ |
||||
PENDING_OUTBOUND(10, TransferStatus.PENDING_OUTBOUND), |
||||
/** 15 出库中。 */ |
||||
OUTBOUNDING(15, TransferStatus.OUTBOUNDING), |
||||
/** 20 待入库。 */ |
||||
PENDING_INBOUND(20, TransferStatus.PENDING_INBOUND), |
||||
/** 25 入库中。 */ |
||||
INBOUNDING(25, TransferStatus.INBOUNDING), |
||||
/** 70 已完成。 */ |
||||
COMPLETED(70, TransferStatus.COMPLETED), |
||||
/** 90 已关闭。 */ |
||||
CLOSED(90, TransferStatus.CLOSED), |
||||
/** 100 取消中。 */ |
||||
CANCELLING(100, TransferStatus.CANCELLING), |
||||
/** 110 已取消。 */ |
||||
CANCELLED(110, TransferStatus.CANCELLED), |
||||
/** 120 取消异常。 */ |
||||
CANCEL_EXCEPTION(120, TransferStatus.CANCEL_EXCEPTION), |
||||
/** 无法识别。 */ |
||||
UNKNOWN(null, TransferStatus.UNKNOWN); |
||||
|
||||
private final Integer rawCode; |
||||
private final TransferStatus core; |
||||
|
||||
YqnTransferStatus(Integer rawCode, TransferStatus core) { |
||||
this.rawCode = rawCode; |
||||
this.core = core; |
||||
} |
||||
|
||||
/** 运去哪的状态码;null 表示无法识别。 */ |
||||
public Integer rawCode() { |
||||
return rawCode; |
||||
} |
||||
|
||||
/** 对应的底层状态。 */ |
||||
public TransferStatus toCore() { |
||||
return core; |
||||
} |
||||
|
||||
/** 运去哪状态码 → 平台枚举。 */ |
||||
public static YqnTransferStatus of(Integer rawStatus) { |
||||
if (rawStatus == null) { |
||||
return UNKNOWN; |
||||
} |
||||
for (YqnTransferStatus v : values()) { |
||||
if (rawStatus.equals(v.rawCode)) { |
||||
return v; |
||||
} |
||||
} |
||||
return UNKNOWN; |
||||
} |
||||
|
||||
/** 运去哪状态码 → 底层状态。 */ |
||||
public static TransferStatus toCore(Integer rawStatus) { |
||||
return of(rawStatus).toCore(); |
||||
} |
||||
} |
||||
@ -0,0 +1,64 @@
@@ -0,0 +1,64 @@
|
||||
package common.ecommerce.yqn.enums; |
||||
|
||||
import common.ecommerce.warehouse.enums.TransferType; |
||||
|
||||
/** |
||||
* 运去哪调拨类型(API 139 的 {@code type})。 |
||||
* |
||||
* <p>码表来自接口文档:0 亚马逊移出 / 1 亚马逊移入 / 2 仓-仓调拨 / 3 调拨出库。</p> |
||||
*/ |
||||
public enum YqnTransferType { |
||||
|
||||
/** 0 亚马逊移出。 */ |
||||
AMAZON_REMOVAL(0, TransferType.AMAZON_REMOVAL), |
||||
/** 1 亚马逊移入。 */ |
||||
AMAZON_INBOUND(1, TransferType.AMAZON_INBOUND), |
||||
/** 2 仓到仓调拨。 */ |
||||
WAREHOUSE_TO_WAREHOUSE(2, TransferType.WAREHOUSE_TO_WAREHOUSE), |
||||
/** 3 调拨出库。 */ |
||||
OUTBOUND(3, TransferType.OUTBOUND); |
||||
|
||||
private final Integer rawCode; |
||||
private final TransferType core; |
||||
|
||||
YqnTransferType(Integer rawCode, TransferType core) { |
||||
this.rawCode = rawCode; |
||||
this.core = core; |
||||
} |
||||
|
||||
/** 运去哪的类型码。 */ |
||||
public Integer rawCode() { |
||||
return rawCode; |
||||
} |
||||
|
||||
/** 对应的底层类型。 */ |
||||
public TransferType toCore() { |
||||
return core; |
||||
} |
||||
|
||||
/** 底层类型 → 运去哪类型码;null 透传。 */ |
||||
public static Integer codeOf(TransferType type) { |
||||
if (type == null) { |
||||
return null; |
||||
} |
||||
for (YqnTransferType v : values()) { |
||||
if (v.core == type) { |
||||
return v.rawCode; |
||||
} |
||||
} |
||||
throw new IllegalArgumentException("yqn does not support transfer type: " + type); |
||||
} |
||||
|
||||
/** 运去哪类型码 → 底层类型;未知码返回 null(与原有行为一致)。 */ |
||||
public static TransferType toCore(Integer rawCode) { |
||||
if (rawCode == null) { |
||||
return null; |
||||
} |
||||
for (YqnTransferType v : values()) { |
||||
if (rawCode.equals(v.rawCode)) { |
||||
return v.core; |
||||
} |
||||
} |
||||
return null; |
||||
} |
||||
} |
||||
Loading…
Reference in new issue