diff --git a/README.md b/README.md index bf7ac01..dde7859 100644 --- a/README.md +++ b/README.md @@ -334,6 +334,8 @@ common.ecommerce ├── adapter XincangAdapter / XincangAdapterFactory / │ XincangProductMapper / XincangOrderMapper / XincangTransferMapper ├── dto XincangDtos(登录 / 商品) + ├── enums XincangOrderStatus / XincangTransferState / + │ XincangForecastStatus / XincangOrderType └── http XincangRequestFactory / XincangMultipart / XincangEnvelope / XincangRateLimiter ``` diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/OutboundStatus.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/OutboundStatus.java index 4214aee..2dfba69 100644 --- a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/OutboundStatus.java +++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/OutboundStatus.java @@ -36,6 +36,22 @@ public enum OutboundStatus { CANCELLED(80, "已取消", 7), /** 异常(仓侧拣货失败、地址异常等)。 */ EXCEPTION(90, "异常", 8), + /** 仓侧审核中(信仓订单 {@code state=11})。 */ + REVIEWING(100, "审核中", 9), + /** 待审核(信仓订单 {@code state=0})。 */ + PENDING_REVIEW(110, "待审核", 10), + /** 待发货(审核通过、尚未开始作业;信仓订单 {@code state=1})。 */ + PENDING_SHIPMENT(120, "待发货", 11), + /** 已拣货、待打包(信仓订单 {@code state=3})。 */ + PICKED(130, "已拣货", 12), + /** 已拦截(信仓订单 {@code state=6});与「已取消」语义不同,不合并。 */ + INTERCEPTED(140, "已拦截", 13), + /** 审核失败(信仓订单 {@code state=12})。 */ + REVIEW_FAILED(150, "审核失败", 14), + /** 缺货(信仓订单 {@code state=7})。 */ + OUT_OF_STOCK(160, "缺货", 15), + /** 已删除(信仓订单 {@code state=10})。 */ + DELETED(170, "已删除", 16), /** 无法识别;原值见 {@code rawStatus},不参与 rank 比较。 */ UNKNOWN(0, "未知", -1); diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/TransferStatus.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/TransferStatus.java index cc4b41e..62d659c 100644 --- a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/TransferStatus.java +++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/TransferStatus.java @@ -27,6 +27,16 @@ public enum TransferStatus { CANCELLING(140, "取消中"), CANCELLED(150, "已取消"), CANCEL_EXCEPTION(160, "取消异常"), + /** 待处理(信仓转运 {@code state=1})。 */ + PENDING_PROCESSING(170, "待处理"), + /** 待拣货(信仓转运 {@code state=2})。 */ + PENDING_PICK(180, "待拣货"), + /** 待贴标(信仓转运 {@code state=3})。 */ + PENDING_LABELING(190, "待贴标"), + /** 待打托(信仓转运 {@code state=4})。 */ + PENDING_PALLETIZING(200, "待打托"), + /** 已发货(信仓转运 {@code state=6});与 {@link #COMPLETED} 不同,尚未确认完成。 */ + SHIPPED(210, "已发货"), /** 无法识别;0 保留给 UNKNOWN。 */ UNKNOWN(0, "未知"); diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderMapper.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderMapper.java index d25cc44..e39c422 100644 --- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderMapper.java +++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderMapper.java @@ -11,6 +11,7 @@ import common.ecommerce.warehouse.model.ShipTo; import common.ecommerce.warehouse.sdk.WarehouseContext; import common.ecommerce.xincang.XincangConstants; import common.ecommerce.xincang.dto.XincangDtos; +import common.ecommerce.xincang.enums.XincangOrderType; import java.time.Instant; import java.time.LocalDateTime; @@ -36,9 +37,6 @@ public final class XincangOrderMapper { DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); /** 地址 1 上限 32 字符,超出部分走 address2。 */ private static final int ADDRESS_MAX = 32; - /** 订单类型:信仓只接受 common / wayfair。 */ - static final String ORDER_TYPE_COMMON = "common"; - static final String ORDER_TYPE_WAYFAIR = "wayfair"; /** 信仓布尔字段统一用「是 / 否」。 */ private static final String YES = "是"; private static final String NO = "否"; @@ -72,8 +70,8 @@ public final class XincangOrderMapper { requireText(cmd.carrierCode(), "carrierCode (信仓 logistics_type)", ctx); Map form = new LinkedHashMap(); - String orderType = orderTypeOf(cmd.salesPlatform()); - form.put("order_type", orderType); + XincangOrderType orderType = orderTypeOf(cmd.salesPlatform()); + form.put("order_type", orderType.rawCode()); form.put("warehouse_code", warehouseCode); // ckh = 参考号,信仓要求唯一;用 OMS 出库单号,便于回查 form.put("ckh", cmd.outboundRequestNo()); @@ -97,7 +95,7 @@ public final class XincangOrderMapper { } // wayfair(自供面单)时 gzh + face_base64 都是必填,缺了必然被仓拒绝,这里提前挡 - if (ORDER_TYPE_WAYFAIR.equals(orderType)) { + if (orderType.requiresSelfLabel()) { requireText(cmd.trackingNumber(), "trackingNumber (信仓 gzh,wayfair 必填)", ctx); requireText(cmd.labelContentBase64(), "labelContentBase64 (信仓 face_base64,wayfair 必填)", ctx); } @@ -139,13 +137,13 @@ public final class XincangOrderMapper { } /** - * 信仓订单类型只接受 {@code common} / {@code wayfair}。 + * 销售平台 → 信仓订单类型({@link XincangOrderType})。 * *

Wayfair 渠道走 {@code wayfair};其余平台走 {@code common}。 * 信仓不区分其它平台,不做臆造映射。

*/ - static String orderTypeOf(Platform platform) { - return platform == Platform.WAYFAIR ? ORDER_TYPE_WAYFAIR : ORDER_TYPE_COMMON; + static XincangOrderType orderTypeOf(Platform platform) { + return platform == Platform.WAYFAIR ? XincangOrderType.WAYFAIR : XincangOrderType.COMMON; } /** 地址超过 32 字符的部分截到 address2,避免被仓侧截断丢信息。 */ diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferMapper.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferMapper.java index 2bd246b..18beb8f 100644 --- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferMapper.java +++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferMapper.java @@ -6,10 +6,10 @@ import common.ecommerce.warehouse.enums.WarehouseProvider; import common.ecommerce.warehouse.model.TransferAttachment; import common.ecommerce.warehouse.model.TransferCommand; import common.ecommerce.warehouse.model.TransferOrder; -import common.ecommerce.warehouse.enums.TransferStatus; import common.ecommerce.warehouse.enums.TransferType; import common.ecommerce.warehouse.sdk.WarehouseContext; import common.ecommerce.xincang.dto.XincangDtos; +import common.ecommerce.xincang.enums.XincangTransferState; import java.time.LocalDate; import java.time.format.DateTimeFormatter; @@ -111,15 +111,17 @@ public final class XincangTransferMapper { /** 转运单创建结果 → 统一模型;信仓只回 {@code order_no},其余字段留空。 */ public static TransferOrder toCreated(TransferCommand cmd, String providerTransferNo) { + // 新增成功后处于待审核(state=0);审核走 approve + String rawState = XincangTransferState.PENDING_REVIEW.rawCode(); return TransferOrder.builder() .transferRequestNo(cmd.transferRequestNo()) .providerTransferNo(providerTransferNo) .fromWarehouseCode(cmd.fromWarehouseCode()) .toWarehouseCode(cmd.toWarehouseCode()) .type(cmd.type()) - // 新增成功后处于待审核;审核走 approve - .status(TransferStatus.PENDING_REVIEW) - .rawStatus("0") + .status(XincangTransferState.toCore(rawState)) + .rawStatus(rawState) + .sourceProvider(WarehouseProvider.XINCANG) .build(); } diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangForecastStatus.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangForecastStatus.java new file mode 100644 index 0000000..33f9a6b --- /dev/null +++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangForecastStatus.java @@ -0,0 +1,84 @@ +package common.ecommerce.xincang.enums; + +import common.ecommerce.warehouse.enums.InboundStatus; + +/** + * 信仓预报(头程入库)状态({@code forecast.forecast_detail} 的 {@code state})。 + * + *

码表来自 Apifox「OMS接口文档V2」预报详情: + * 0 建仓中 / 1 出运中 / 2 预报完成 / 3 在海上 / 4 送仓中 / 5 卸柜中 / + * 6 清点中 / 7 上架中 / 8 上架完成 / 9 已驳回。

+ * + *

信仓没有独立的「入库单」接口,预报单即头程入库单,这里映射到统一的 + * {@link InboundStatus}。映射口径:

+ * + * + *

未知码归 {@link #UNKNOWN},不猜。

+ */ +public enum XincangForecastStatus { + + /** 0 建仓中。 */ + BUILDING("0", InboundStatus.DRAFT), + /** 1 出运中。 */ + SHIPPING("1", InboundStatus.IN_TRANSIT), + /** 2 预报完成。 */ + FORECAST_DONE("2", InboundStatus.PENDING_SHIPMENT), + /** 3 在海上。 */ + ON_SEA("3", InboundStatus.IN_TRANSIT), + /** 4 送仓中。 */ + DELIVERING("4", InboundStatus.IN_TRANSIT), + /** 5 卸柜中。 */ + UNLOADING("5", InboundStatus.RECEIVING), + /** 6 清点中。 */ + COUNTING("6", InboundStatus.RECEIVING), + /** 7 上架中。 */ + SHELVING("7", InboundStatus.STORING), + /** 8 上架完成。 */ + SHELVED("8", InboundStatus.COMPLETED), + /** 9 已驳回。 */ + REJECTED("9", InboundStatus.REJECTED), + /** 无法识别。 */ + UNKNOWN(null, InboundStatus.UNKNOWN); + + private final String rawCode; + private final InboundStatus core; + + XincangForecastStatus(String rawCode, InboundStatus core) { + this.rawCode = rawCode; + this.core = core; + } + + /** 信仓状态码;null 表示无法识别。 */ + public String rawCode() { + return rawCode; + } + + /** 对应的底层状态。 */ + public InboundStatus toCore() { + return core; + } + + /** 信仓状态码 → 平台枚举。 */ + public static XincangForecastStatus of(String rawStatus) { + if (rawStatus == null || rawStatus.trim().isEmpty()) { + return UNKNOWN; + } + String s = rawStatus.trim(); + for (XincangForecastStatus v : values()) { + if (s.equals(v.rawCode)) { + return v; + } + } + return UNKNOWN; + } + + /** 信仓状态码 → 底层状态。 */ + public static InboundStatus toCore(String rawStatus) { + return of(rawStatus).toCore(); + } +} diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangOrderStatus.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangOrderStatus.java new file mode 100644 index 0000000..fd7d946 --- /dev/null +++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangOrderStatus.java @@ -0,0 +1,93 @@ +package common.ecommerce.xincang.enums; + +import common.ecommerce.warehouse.enums.OutboundStatus; + +/** + * 信仓出库订单状态(订单列表 / 详情 / 删除接口的 {@code state})。 + * + *

码表来自 Apifox「OMS接口文档V2」订单详情: + * 0 待审核 / 1 待发货 / 2 拣货中 / 3 已拣货 / 4 已贴单 / 5 已发货 / + * 6 已拦截 / 7 缺货 / 8 已取消 / 10 已删除 / 11 审核中 / 12 审核失败。

+ * + *

未知码归 {@link #UNKNOWN},不猜;原始值由调用方一起保存 + * ({@code rawStatus} + {@code sourceProvider})。

+ */ +public enum XincangOrderStatus { + + /** 0 待审核。 */ + PENDING_REVIEW("0", OutboundStatus.PENDING_REVIEW), + /** 1 待发货。 */ + PENDING_SHIPMENT("1", OutboundStatus.PENDING_SHIPMENT), + /** 2 拣货中。 */ + PICKING("2", OutboundStatus.PICKING), + /** 3 已拣货。 */ + PICKED("3", OutboundStatus.PICKED), + /** 4 已贴单(面单已出)。 */ + LABEL_READY("4", OutboundStatus.LABEL_READY), + /** 5 已发货。 */ + SHIPPED("5", OutboundStatus.SHIPPED), + /** 6 已拦截。 */ + INTERCEPTED("6", OutboundStatus.INTERCEPTED), + /** 7 缺货。 */ + OUT_OF_STOCK("7", OutboundStatus.OUT_OF_STOCK), + /** 8 已取消。 */ + CANCELLED("8", OutboundStatus.CANCELLED), + /** 10 已删除。 */ + DELETED("10", OutboundStatus.DELETED), + /** 11 审核中。 */ + REVIEWING("11", OutboundStatus.REVIEWING), + /** 12 审核失败。 */ + REVIEW_FAILED("12", OutboundStatus.REVIEW_FAILED), + /** 无法识别。 */ + UNKNOWN(null, OutboundStatus.UNKNOWN); + + private final String rawCode; + private final OutboundStatus core; + + XincangOrderStatus(String rawCode, OutboundStatus core) { + this.rawCode = rawCode; + this.core = core; + } + + /** 信仓状态码;null 表示无法识别。 */ + public String rawCode() { + return rawCode; + } + + /** 对应的底层状态。 */ + public OutboundStatus toCore() { + return core; + } + + /** 信仓状态码 → 平台枚举。 */ + public static XincangOrderStatus of(String rawStatus) { + if (rawStatus == null || rawStatus.trim().isEmpty()) { + return UNKNOWN; + } + String s = rawStatus.trim(); + for (XincangOrderStatus v : values()) { + if (s.equals(v.rawCode)) { + return v; + } + } + return UNKNOWN; + } + + /** 信仓状态码 → 底层状态。 */ + public static OutboundStatus toCore(String rawStatus) { + return of(rawStatus).toCore(); + } + + /** 底层状态 → 信仓状态码;无对应时返回 null(调用方决定是否拒绝)。 */ + public static String codeOf(OutboundStatus status) { + if (status == null) { + return null; + } + for (XincangOrderStatus v : values()) { + if (v.core == status) { + return v.rawCode; + } + } + return null; + } +} diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangOrderType.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangOrderType.java new file mode 100644 index 0000000..94da0de --- /dev/null +++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangOrderType.java @@ -0,0 +1,49 @@ +package common.ecommerce.xincang.enums; + +/** + * 信仓下单的订单类型({@code api.add_order_multiple} 的 {@code order_type})。 + * + *

信仓只接受两个值:{@code common}(非自供面单)与 {@code wayfair}(自供面单)。

+ * + *

只在这里出现,不映射到 core:这是「由谁提供面单」的仓方协议开关, + * core 已有 {@code LabelMode} 表达同一业务语义(仓出单 / 平台面单)。 + * 两者的判定口径不同——core 看 {@code LabelMode},信仓看渠道平台是不是 Wayfair—— + * 所以由适配器按自己的规则选择,不做枚举级映射,也不把仓方字符串塞进 core。

+ */ +public enum XincangOrderType { + + /** 非自供面单(默认)。 */ + COMMON("common"), + /** 自供面单;{@code gzh} 与 {@code face_base64} 必填。 */ + WAYFAIR("wayfair"); + + private final String rawCode; + + XincangOrderType(String rawCode) { + this.rawCode = rawCode; + } + + /** 信仓原值。 */ + public String rawCode() { + return rawCode; + } + + /** 是否需要随单提供跟踪号与面单文件。 */ + public boolean requiresSelfLabel() { + return this == WAYFAIR; + } + + /** 信仓原值 → 平台枚举;未知返回 null(调用方按错误处理)。 */ + public static XincangOrderType of(String rawCode) { + if (rawCode == null) { + return null; + } + String s = rawCode.trim(); + for (XincangOrderType v : values()) { + if (v.rawCode.equals(s)) { + return v; + } + } + return null; + } +} diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangTransferState.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangTransferState.java new file mode 100644 index 0000000..7f3f963 --- /dev/null +++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/enums/XincangTransferState.java @@ -0,0 +1,87 @@ +package common.ecommerce.xincang.enums; + +import common.ecommerce.warehouse.enums.TransferStatus; + +/** + * 信仓转运单状态({@code fba.fbalist} / {@code fba.fba_detail} 的 {@code state})。 + * + *

码表来自 Apifox「OMS接口文档V2」转运详情: + * 0 待审核 / 1 待处理 / 2 待拣货 / 3 待贴标 / 4 待打托 / 5 待发货 / 6 已发货 / 7 已取消。

+ * + *

列表接口与详情接口的码表不一致:列表的 {@code state} 说明里写的是 + * 「0 待审核 1 待处理 2 带拣货 3 待打托 4 待发货 5 已发货 9 取消」(少了「待贴标」、 + * 后续码值整体前移)。详情接口的码表与 {@code state_name} 说明更完整,这里以详情码表 + * 为准;联调时如果列表返回的 {@code state} 对不上,原始值仍在 {@code rawStatus} 里, + * 只需调整本枚举,不动调用方。

+ */ +public enum XincangTransferState { + + /** 0 待审核。 */ + PENDING_REVIEW("0", TransferStatus.PENDING_REVIEW), + /** 1 待处理。 */ + PENDING_PROCESSING("1", TransferStatus.PENDING_PROCESSING), + /** 2 待拣货。 */ + PENDING_PICK("2", TransferStatus.PENDING_PICK), + /** 3 待贴标。 */ + PENDING_LABELING("3", TransferStatus.PENDING_LABELING), + /** 4 待打托。 */ + PENDING_PALLETIZING("4", TransferStatus.PENDING_PALLETIZING), + /** 5 待发货。 */ + PENDING_OUTBOUND("5", TransferStatus.PENDING_OUTBOUND), + /** 6 已发货。 */ + SHIPPED("6", TransferStatus.SHIPPED), + /** 7 已取消。 */ + CANCELLED("7", TransferStatus.CANCELLED), + /** 无法识别。 */ + UNKNOWN(null, TransferStatus.UNKNOWN); + + private final String rawCode; + private final TransferStatus core; + + XincangTransferState(String rawCode, TransferStatus core) { + this.rawCode = rawCode; + this.core = core; + } + + /** 信仓状态码;null 表示无法识别。 */ + public String rawCode() { + return rawCode; + } + + /** 对应的底层状态。 */ + public TransferStatus toCore() { + return core; + } + + /** 信仓状态码 → 平台枚举。 */ + public static XincangTransferState of(String rawStatus) { + if (rawStatus == null || rawStatus.trim().isEmpty()) { + return UNKNOWN; + } + String s = rawStatus.trim(); + for (XincangTransferState v : values()) { + if (s.equals(v.rawCode)) { + return v; + } + } + return UNKNOWN; + } + + /** 信仓状态码 → 底层状态。 */ + public static TransferStatus toCore(String rawStatus) { + return of(rawStatus).toCore(); + } + + /** 底层状态 → 信仓状态码;无对应时返回 null。 */ + public static String codeOf(TransferStatus status) { + if (status == null) { + return null; + } + for (XincangTransferState v : values()) { + if (v.core == status) { + return v.rawCode; + } + } + return null; + } +} diff --git a/warehouse-sdk-xincang/src/test/java/common/ecommerce/xincang/enums/XincangEnumsTest.java b/warehouse-sdk-xincang/src/test/java/common/ecommerce/xincang/enums/XincangEnumsTest.java new file mode 100644 index 0000000..efb28c9 --- /dev/null +++ b/warehouse-sdk-xincang/src/test/java/common/ecommerce/xincang/enums/XincangEnumsTest.java @@ -0,0 +1,80 @@ +package common.ecommerce.xincang.enums; + +import common.ecommerce.warehouse.enums.InboundStatus; +import common.ecommerce.warehouse.enums.OutboundStatus; +import common.ecommerce.warehouse.enums.TransferStatus; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * 信仓平台枚举 → core 底层枚举的映射。 + * + *

码表来自 Apifox「OMS接口文档V2」,1:1 对应;认不出的值一律归 UNKNOWN,不猜。

+ */ +class XincangEnumsTest { + + @Test + void orderStatusMapsEveryDocumentedCode() { + assertEquals(OutboundStatus.PENDING_REVIEW, XincangOrderStatus.toCore("0")); + assertEquals(OutboundStatus.PENDING_SHIPMENT, XincangOrderStatus.toCore("1")); + assertEquals(OutboundStatus.PICKING, XincangOrderStatus.toCore("2")); + assertEquals(OutboundStatus.PICKED, XincangOrderStatus.toCore("3")); + assertEquals(OutboundStatus.LABEL_READY, XincangOrderStatus.toCore("4")); + assertEquals(OutboundStatus.SHIPPED, XincangOrderStatus.toCore("5")); + assertEquals(OutboundStatus.INTERCEPTED, XincangOrderStatus.toCore("6")); + assertEquals(OutboundStatus.OUT_OF_STOCK, XincangOrderStatus.toCore("7")); + assertEquals(OutboundStatus.CANCELLED, XincangOrderStatus.toCore("8")); + assertEquals(OutboundStatus.DELETED, XincangOrderStatus.toCore("10")); + assertEquals(OutboundStatus.REVIEWING, XincangOrderStatus.toCore("11")); + assertEquals(OutboundStatus.REVIEW_FAILED, XincangOrderStatus.toCore("12")); + } + + @Test + void unknownOrderStatusIsNotGuessed() { + assertEquals(OutboundStatus.UNKNOWN, XincangOrderStatus.toCore("99")); + assertEquals(OutboundStatus.UNKNOWN, XincangOrderStatus.toCore("")); + assertEquals(OutboundStatus.UNKNOWN, XincangOrderStatus.toCore(null)); + } + + @Test + void transferStateMapsEveryDocumentedCode() { + assertEquals(TransferStatus.PENDING_REVIEW, XincangTransferState.toCore("0")); + assertEquals(TransferStatus.PENDING_PROCESSING, XincangTransferState.toCore("1")); + assertEquals(TransferStatus.PENDING_PICK, XincangTransferState.toCore("2")); + assertEquals(TransferStatus.PENDING_LABELING, XincangTransferState.toCore("3")); + assertEquals(TransferStatus.PENDING_PALLETIZING, XincangTransferState.toCore("4")); + assertEquals(TransferStatus.PENDING_OUTBOUND, XincangTransferState.toCore("5")); + assertEquals(TransferStatus.SHIPPED, XincangTransferState.toCore("6")); + assertEquals(TransferStatus.CANCELLED, XincangTransferState.toCore("7")); + } + + @Test + void unknownTransferStateIsNotGuessed() { + assertEquals(TransferStatus.UNKNOWN, XincangTransferState.toCore("9")); + assertEquals(TransferStatus.UNKNOWN, XincangTransferState.toCore(null)); + } + + @Test + void forecastStatusMapsToInboundStatus() { + assertEquals(InboundStatus.DRAFT, XincangForecastStatus.toCore("0")); + assertEquals(InboundStatus.IN_TRANSIT, XincangForecastStatus.toCore("1")); + assertEquals(InboundStatus.PENDING_SHIPMENT, XincangForecastStatus.toCore("2")); + assertEquals(InboundStatus.IN_TRANSIT, XincangForecastStatus.toCore("3")); + assertEquals(InboundStatus.RECEIVING, XincangForecastStatus.toCore("6")); + assertEquals(InboundStatus.STORING, XincangForecastStatus.toCore("7")); + assertEquals(InboundStatus.COMPLETED, XincangForecastStatus.toCore("8")); + assertEquals(InboundStatus.REJECTED, XincangForecastStatus.toCore("9")); + assertEquals(InboundStatus.UNKNOWN, XincangForecastStatus.toCore("99")); + } + + @Test + void orderTypeDrivesSelfLabelRequirement() { + assertEquals("common", XincangOrderType.COMMON.rawCode()); + assertEquals("wayfair", XincangOrderType.WAYFAIR.rawCode()); + assertFalse(XincangOrderType.COMMON.requiresSelfLabel()); + assertTrue(XincangOrderType.WAYFAIR.requiresSelfLabel()); + assertEquals(XincangOrderType.WAYFAIR, XincangOrderType.of("wayfair")); + assertNull(XincangOrderType.of("unknown")); + } +}