From 0b8d687984781818c137f52e8f811ae668506a11 Mon Sep 17 00:00:00 2001 From: chenchuchuan <13554600537@163.com> Date: Wed, 11 Nov 2026 14:37:43 +0800 Subject: [PATCH] =?UTF-8?q?fix(yqn):=20=E8=BF=90=E8=B4=B9=E8=AF=95?= =?UTF-8?q?=E7=AE=97=E7=9A=84=E4=BF=A1=E5=B0=81=E5=85=BC=E5=AE=B9=20+=20?= =?UTF-8?q?=E5=85=A8=E9=93=BE=E8=B7=AF=E6=8E=A2=E9=92=88=EF=BC=88=E7=9C=9F?= =?UTF-8?q?=E6=9C=BA=E9=AA=8C=E8=AF=81=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 真机验证发现 运费试算(POST /v1/saleOrder/calculate)与仓库目录一样, 响应没有 code 字段,只有 status=200 / message=success。原来走 execute() (强制要求业务码 200),把成功当失败了。 把「容忍式信封」抽成通用实现: - requireEnvelopeTolerant:有 code 按 200 校验,没有则看 status==200 (实测成功是 200,不是文档示例的 1) - executeTolerant:非 2xx 仍交给 YqnEnvelope 分类,2xx 才走容忍判定 - 运费试算改用 executeTolerant 新增 YqnFullFlowProbeTest(15 步,按 @Order 串链路): 出库创建 → 详情 → 取消;库存;试算;结算明细;入库创建 → 查询 → 箱标 → SKU 标;调拨;退货;销毁;商品建档。 默认跳过,需 -Dyqn.probe.all=true + token,仅限 PR 环境。 真机结论: - 出库全链路通(创建 / 详情 / 取消),且 UNSHIPPED 正确映射为 SUBMITTED - 调拨 totalWeight=1000.0(1 件 500g)→ 单位确认是 kg,不是 lb - 入库创建 → 查询通,能拿到计划单号 - 箱标 / SKU 标:仓方内部接口 Read timed out(他们那边的问题,非我们的报文) Co-Authored-By: Claude --- .../java/common/ecommerce/yqn/YqnConstants.java | 10 +- .../common/ecommerce/yqn/adapter/YqnAdapter.java | 80 +++- .../ecommerce/yqn/probe/YqnFullFlowProbeTest.java | 512 +++++++++++++++++++++ 3 files changed, 598 insertions(+), 4 deletions(-) create mode 100644 warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/probe/YqnFullFlowProbeTest.java diff --git a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java index 551c77c..cd27445 100644 --- a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java +++ b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java @@ -98,7 +98,15 @@ public final class YqnConstants { * *

实测该接口返回 {@code status=200, message=success},不是文档示例的 1。

*/ - public static final int WAREHOUSE_LIST_SUCCESS_STATUS = 200; + /** + * 没有 {@code code} 字段的接口,其成功判定用的 {@code status} 值。 + * + *

实测(仓库目录、运费试算):成功返回 {@code status: 200, message: "success"}。

+ */ + public static final int STATUS_SUCCESS_CODE = 200; + + /** 仓库查询接口的成功 status;与 {@link #STATUS_SUCCESS_CODE} 同值,保留旧名。 */ + public static final int WAREHOUSE_LIST_SUCCESS_STATUS = STATUS_SUCCESS_CODE; /** Spec §7.5:三家仓均未公开限流值,保守默认 2 req/s/仓。 */ public static final int PERMITS_PER_SECOND = 2; 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 d2a5676..3dbbe08 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 @@ -364,7 +364,10 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl public List estimate(WarehouseContext ctx, FeeEstimateQuery query) { YqnFeeEstimateDtos.CalculateRequest body = YqnFeeEstimateMapper.toRequest(query, ctx.providerWarehouseId()); - String raw = execute(ctx, YqnConstants.PATH_FEE_ESTIMATE, body, "warehouse.fee.estimate"); + // 这个接口实测没有 code 字段,只有 status=200 / message=success, + // 走 execute() 会被判成「没有业务码」而失败 + String raw = executeTolerant(ctx, YqnConstants.PATH_FEE_ESTIMATE, body, + "warehouse.fee.estimate"); List rows = json.listAt(raw, "data", YqnFeeEstimateDtos.CalculateResult.class); List out = new ArrayList(rows.size()); for (YqnFeeEstimateDtos.CalculateResult row : rows) { @@ -651,10 +654,49 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl } /** - * 这个接口的业务码判定:有 {@code code} 时按 200 校验;没有则退回看 {@code status} - * (文档示例 {@code status: 1} 表示成功)。 + * 运去哪有一批接口的响应没有 {@code code} 字段,只有 + * {@code status + message}(实测:仓库目录、运费试算)。 + * + *

判定规则:有 {@code code} 就按 200 校验;没有则看 {@code status == 200} + * —实测成功返回 {@code status: 200, message: "success"}, + * 不是文档示例里的 1。

+ * + * @param operation 用于异常里的操作名 */ + private void requireEnvelopeTolerant(WarehouseContext ctx, String raw, + String operation, String what) { + int code = json.intAt(raw, "code", Integer.MIN_VALUE); + boolean ok; + String detail; + if (code != Integer.MIN_VALUE) { + ok = code == YqnEnvelope.SUCCESS_CODE; + detail = "code=" + code; + } else { + int status = json.intAt(raw, "status", Integer.MIN_VALUE); + ok = status == YqnConstants.STATUS_SUCCESS_CODE; + detail = "status=" + status; + } + if (!ok) { + throw WarehouseException.builder() + .message("yqn " + what + " failed: " + detail + + ", message=" + json.stringAt(raw, "message")) + .operation(operation) + .warehouseCode(ctx.warehouseCode()) + .provider(provider().name()) + .requestId(ctx.requestId()) + .retryable(false) + .rawResponse(safeRelay(raw)) + .build(); + } + } + + /** 兼容旧调用点。 */ private void requireWarehouseListSuccess(WarehouseContext ctx, String raw) { + requireEnvelopeTolerant(ctx, raw, "warehouse.directory.list", "warehouse list"); + } + + @SuppressWarnings("unused") + private void legacyWarehouseListSuccess(WarehouseContext ctx, String raw) { int code = json.intAt(raw, "code", Integer.MIN_VALUE); boolean ok; String detail; @@ -885,6 +927,38 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl return ctx.zone(); } + /** + * 发请求 + 容忍式信封校验:有的接口没有 {@code code} 字段。 + * + *

HTTP 层(401/403/429/5xx)仍由 {@link YqnEnvelope} 的规则处理, + * 这里只是不强制要求业务码存在。

+ */ + private String executeTolerant(WarehouseContext ctx, String path, Object body, + String operation) { + rateLimiter.acquire(path, YqnConstants.PERMITS_PER_SECOND); + HttpRequest req = requestFactory.postJson(ctx.endpointBaseUrl(), path, + json.toJson(body), ctx.secret(), ctx, operation); + HttpResponse resp = transport.execute(req); + int status = resp.statusCode(); + if (status < 200 || status >= 300) { + // 非 2xx 交给原逻辑,保持错误分类一致 + return YqnEnvelope.of(resp, json, operation, ctx.warehouseCode(), ctx.requestId()).body(); + } + String raw = resp.body(); + if (raw == null || raw.trim().isEmpty()) { + throw WarehouseException.builder() + .message("yqn " + operation + " returned an empty body") + .operation(operation) + .warehouseCode(ctx.warehouseCode()) + .provider(provider().name()) + .requestId(ctx.requestId()) + .retryable(true) + .build(); + } + requireEnvelopeTolerant(ctx, raw, operation, operation); + return raw; + } + /** 发请求并校验信封。 */ private String execute(WarehouseContext ctx, String path, Object body, String operation) { rateLimiter.acquire(path, YqnConstants.PERMITS_PER_SECOND); diff --git a/warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/probe/YqnFullFlowProbeTest.java b/warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/probe/YqnFullFlowProbeTest.java new file mode 100644 index 0000000..0971dcc --- /dev/null +++ b/warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/probe/YqnFullFlowProbeTest.java @@ -0,0 +1,512 @@ +package common.ecommerce.yqn.probe; + +import common.ecommerce.http.JacksonJsonCodec; +import common.ecommerce.http.OkHttpTransport; +import common.ecommerce.shared.error.ChannelException; +import common.ecommerce.shared.model.Platform; +import common.ecommerce.shared.spi.ChannelSecret; +import common.ecommerce.warehouse.model.DestructionCommand; +import common.ecommerce.warehouse.enums.LabelMode; +import common.ecommerce.warehouse.enums.TransferType; +import common.ecommerce.warehouse.enums.WarehouseProvider; +import common.ecommerce.warehouse.model.DestructionOrder; +import common.ecommerce.warehouse.model.InboundCommand; +import common.ecommerce.warehouse.model.InboundLine; +import common.ecommerce.warehouse.model.InboundOrder; +import common.ecommerce.warehouse.model.InboundReceipt; +import common.ecommerce.warehouse.model.OutboundCommand; +import common.ecommerce.warehouse.model.OutboundLine; +import common.ecommerce.warehouse.model.OutboundOrder; +import common.ecommerce.warehouse.model.OutboundReceipt; +import common.ecommerce.warehouse.model.OutboundRef; +import common.ecommerce.warehouse.model.ReturnCommand; +import common.ecommerce.warehouse.model.ShipTo; +import common.ecommerce.warehouse.model.TransferCommand; +import common.ecommerce.warehouse.model.TransferOrder; +import common.ecommerce.warehouse.model.WarehouseReturn; +import common.ecommerce.warehouse.sdk.WarehouseConnection; +import common.ecommerce.warehouse.sdk.WarehouseContext; +import common.ecommerce.yqn.YqnConstants; +import common.ecommerce.yqn.adapter.YqnAdapter; +import org.junit.jupiter.api.Assumptions; +import org.junit.jupiter.api.MethodOrderer; +import org.junit.jupiter.api.Order; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestMethodOrder; +import org.junit.jupiter.api.condition.EnabledIfSystemProperty; + +import java.time.Clock; +import java.time.Instant; +import java.time.LocalDate; +import java.util.UUID; + +/** + * 运去哪全链路联调探针:按业务流程把每个接口都走一遍。 + * + *

默认跳过,需显式开启:

+ * + *
+ * mvn -pl warehouse-sdk-yqn -DfailIfNoTests=false \
+ *     -Dyqn.probe.all=true \
+ *     -Dyqn.probe.token=你的x-api-key \
+ *     -Dyqn.probe.providerWarehouseId=RF_NY_US \
+ *     -Dyqn.probe.warehouseCode=YQN-RF_NY_US \
+ *     -Dtest=YqnFullFlowProbeTest test
+ * 
+ * + *

会真实创建单据(出库 / 入库 / 调拨 / 退货 / 销毁),仅限 PR 测试环境。 + * 单号带 {@code PROBE-<时间戳>} 前缀便于识别与清理。

+ * + *

方法按 {@code @Order} 串起来:出库创建 → 查详情;调拨创建即验证; + * 入库创建 → 查详情 → 打箱标 / SKU 标。任何一步失败只打印不中断, + * 后面还会继续跑,便于一次看全。

+ */ +@EnabledIfSystemProperty(named = "yqn.probe.all", matches = "true") +@TestMethodOrder(MethodOrderer.OrderAnnotation.class) +class YqnFullFlowProbeTest { + + private static final String TOKEN = System.getProperty("yqn.probe.token", ""); + private static final String BASE_URL = opt("yqn.probe.baseUrl", YqnConstants.PR_BASE_URL); + private static final String AUX_URL = opt("yqn.probe.auxBaseUrl", YqnConstants.AUX_BASE_URL_PR); + private static final String WAREHOUSE_CODE = opt("yqn.probe.warehouseCode", "YQN-RF_NY_US"); + private static final String PROVIDER_WAREHOUSE = opt("yqn.probe.providerWarehouseId", "RF_NY_US"); + private static final String SKU = opt("yqn.probe.sku", "DM00001"); + /** 测试发货方式。 */ + private static final String CARRIER_CODE = opt("yqn.probe.carrierCode", "WLC-FEDEX"); + + /** 本次运行的唯一后缀,避免与历史数据冲突。 */ + private static final String RUN = "PROBE-" + System.currentTimeMillis(); + + private static String outboundNo; + private static String inboundNo; + + // ---------------------------------------------------------------- 出库 + + @Test + @Order(1) + void createOutbound() { + assumeToken(); + run("POST /v1/saleOrder/create", () -> { + OutboundReceipt receipt = adapter().create(ctx(), outboundCommand()); + outboundNo = receipt.outboundRequestNo(); + System.out.println("[outbound.create] requestNo=" + receipt.outboundRequestNo() + + " providerOrderId=" + receipt.providerOrderId() + + " rawStatus=" + receipt.rawStatus()); + }); + } + + @Test + @Order(2) + void getOutboundDetail() { + assumeToken(); + Assumptions.assumeTrue(outboundNo != null, "出库单未创建成功,跳过详情查询"); + run("POST /v1/saleOrder/findOne", () -> { + OutboundOrder order = adapter().get(ctx(), OutboundRef.ofRequestNo(outboundNo)); + if (order == null) { + System.out.println("[outbound.get] 未找到 " + outboundNo); + return; + } + System.out.println("[outbound.get] status=" + order.status() + + " rawStatus=" + order.rawStatus() + + " carrierCode=" + order.carrierCode() + + " tracking=" + order.trackingNumber() + + " paidAt=" + order.paidAt()); + System.out.println(" lines=" + order.lines().size() + + " attachments=" + order.attachments().size() + + " serialNumbers=" + order.serialNumbers().size() + + " signatureRequired=" + order.signatureRequired() + + " insured=" + order.insured() + + " labelMode=" + order.labelMode()); + for (OutboundLine l : order.lines()) { + System.out.println(" line sku=" + l.providerSku() + + " qty=" + l.quantity() + + " totalAmount=" + l.totalAmount() + + " ordIds=" + l.platformOrderItemIds()); + } + }); + } + + @Test + @Order(3) + void cancelOutbound() { + assumeToken(); + Assumptions.assumeTrue(outboundNo != null, "出库单未创建成功,跳过取消"); + run("POST /v1/saleOrder/cancel", () -> { + common.ecommerce.warehouse.model.CancelResult result = + adapter().cancel(ctx(), common.ecommerce.warehouse.model.CancelCommand.builder() + .outboundRequestNo(outboundNo).build()); + System.out.println("[outbound.cancel] cancelled=" + result.cancelled() + + " eligibility=" + result.eligibility() + + " rawStatus=" + result.rawStatus()); + }); + } + + // ---------------------------------------------------------------- 库存 / 费用 / 试算 + + @Test + @Order(4) + void queryInventory() { + assumeToken(); + run("GET /v2/inventory/get_inventory_by_page", () -> { + common.ecommerce.shared.support.Page page = + adapter().query(ctx(), common.ecommerce.warehouse.model.InventoryQuery.builder() + .pageSize(5).build()); + System.out.println("[inventory] " + page.size() + " 条, cursor=" + page.nextCursor()); + for (common.ecommerce.warehouse.model.InventorySnapshot s : page.items()) { + System.out.println(" sku=" + s.providerSku() + " avail=" + s.available() + + " onHand=" + s.onHand() + " type=" + s.inventoryType()); + } + }); + } + + @Test + @Order(5) + void estimateFee() { + assumeToken(); + run("POST /v1/saleOrder/calculate", () -> { + java.util.List list = + adapter().estimate(ctx(), common.ecommerce.warehouse.model.FeeEstimateQuery.builder() + .warehouseCode(PROVIDER_WAREHOUSE) + .lengthCm(new java.math.BigDecimal("30")) + .widthCm(new java.math.BigDecimal("20")) + .heightCm(new java.math.BigDecimal("10")) + .weightGrams(new java.math.BigDecimal("500")) + .receiveCountry("US").receiveState("NY").receiveCity("New York") + .receivePostal("10001").receiveAddress("1 Main St") + .logisticsServiceCode("FedEx_FEDEX_GROUND") + .build()); + System.out.println("[estimate] " + list.size() + " 个仓"); + for (common.ecommerce.warehouse.model.FeeEstimateResult r : list) { + System.out.println(" warehouse=" + r.shipOrgWarehouseCode() + + " carriers=" + r.carriers().size()); + for (common.ecommerce.warehouse.model.FeeEstimateResult.CarrierQuote q : r.carriers()) { + System.out.println(" " + q.logisticsServiceCode() + + " total=" + q.totalRate() + + " items=" + q.costItems().size()); + } + } + }); + } + + @Test + @Order(6) + void queryFeeDetail() { + assumeToken(); + Assumptions.assumeTrue(outboundNo != null, "出库单未创建成功,跳过结算明细"); + run("POST /v1/warehouse/operation/costs/detail", () -> { + java.util.List list = + adapter().settlements(ctx(), common.ecommerce.warehouse.model.FeeQuery.builder() + .saleOrderNo(outboundNo).build()); + System.out.println("[fees] " + list.size() + " 条"); + for (common.ecommerce.warehouse.model.BillingDocument d : list) { + System.out.println(" name=" + d.feeName() + " type=" + d.feeType() + + " amount=" + d.amount() + " estimated=" + d.estimated()); + } + }); + } + + // ---------------------------------------------------------------- 入库 + + @Test + @Order(7) + void createInbound() { + assumeToken(); + run("POST /v1/inbound/createInboundPlan", () -> { + InboundReceipt receipt = adapter().create(ctx(), inboundCommand()); + inboundNo = receipt.providerInboundId(); + System.out.println("[inbound.create] requestNo=" + receipt.inboundRequestNo() + + " providerInboundId=" + receipt.providerInboundId()); + }); + } + + @Test + @Order(8) + void getInboundPlan() { + assumeToken(); + Assumptions.assumeTrue(inboundNo != null, "入库单未创建成功,跳过查询"); + run("POST /v1/inbound/getInboundPlanInfo", () -> { + InboundOrder order = adapter().get(ctx(), inboundNo); + if (order == null) { + System.out.println("[inbound.get] 未找到 " + inboundNo); + return; + } + System.out.println("[inbound.get] status=" + order.status() + + " planned=" + order.plannedQuantity() + + " packed=" + order.packedQuantity() + + " received=" + order.receivedQuantity() + + " boxes=" + order.boxCount() + + " containers=" + order.containers().size() + + " lineName=" + order.lineName() + + " shipmentId=" + order.shipmentId()); + for (common.ecommerce.warehouse.model.InboundOrderBatch b : order.batches()) { + System.out.println(" batch phase=" + b.phase() + " carton=" + b.cartonNo() + + " qty=" + b.quantity()); + } + }); + } + + @Test + @Order(9) + void printBoxLabel() { + assumeToken(); + Assumptions.assumeTrue(inboundNo != null, "入库单未创建成功,跳过箱标"); + run("POST /v1/inbound/generateBoxLabel", () -> { + common.ecommerce.warehouse.model.LabelPrintTask task = + adapter().printBoxLabel(ctx(), + common.ecommerce.warehouse.model.BoxLabelCommand.builder() + .providerInboundNo(inboundNo) + .inboundRequestNo(RUN + "-IN") + .build()); + System.out.println("[boxLabel] taskNo=" + task.taskNo() + + " providerInboundNo=" + task.providerInboundNo()); + }); + } + + @Test + @Order(10) + void printSkuLabel() { + assumeToken(); + Assumptions.assumeTrue(inboundNo != null, "入库单未创建成功,跳过 SKU 标"); + run("POST /v1/inbound/generateItemLabel", () -> { + common.ecommerce.warehouse.model.LabelPrintTask task = + adapter().printSkuLabel(ctx(), + common.ecommerce.warehouse.model.SkuLabelCommand.builder() + .providerInboundNo(inboundNo) + .inboundRequestNo(RUN + "-IN") + .sizeType(common.ecommerce.warehouse.enums.SkuLabelSizeType.SIZE_70_30) + .showEn(true) + .build()); + System.out.println("[skuLabel] taskNo=" + task.taskNo()); + }); + } + + // ---------------------------------------------------------------- 调拨 / 退货 / 销毁 + + @Test + @Order(11) + void createTransfer() { + assumeToken(); + run("POST /v2/transferOutboundPlan/create", () -> { + TransferOrder order = adapter().create(ctx(), transferCommand()); + System.out.println("[transfer.create] providerNo=" + order.providerTransferNo() + + " status=" + order.status() + " rawStatus=" + order.rawStatus() + + " totalQty=" + order.totalQuantity() + + " totalWeightKg=" + order.totalWeightKg() + + " totalVolumeCbm=" + order.totalVolumeCbm() + + " fromTitle=" + order.fromWarehouseTitle() + + " toTitle=" + order.toWarehouseTitle()); + }); + } + + @Test + @Order(12) + void createReturn() { + assumeToken(); + run("POST /v3/saleReturn/createSaleReturnPlan", () -> { + WarehouseReturn ret = adapter().create(ctx(), returnCommand()); + System.out.println("[return.create] requestNo=" + ret.returnRequestNo() + + " providerReturnId=" + ret.providerReturnId() + + " status=" + ret.status()); + }); + } + + @Test + @Order(13) + void getReturnPlan() { + assumeToken(); + String returnNo = System.getProperty("yqn.probe.returnOrderNo", ""); + Assumptions.assumeTrue(!returnNo.trim().isEmpty(), + "未提供 -Dyqn.probe.returnOrderNo,跳过退货计划查询"); + run("POST /v3/saleReturn/getInboundPlanInfo", () -> { + WarehouseReturn ret = adapter().getReturn(ctx(), returnNo); + if (ret == null) { + System.out.println("[return.get] 未找到 " + returnNo); + return; + } + System.out.println("[return.get] status=" + ret.status() + " rawStatus=" + ret.rawStatus() + + " inspected=" + ret.inspectedQuantity() + " lines=" + ret.lines().size()); + for (WarehouseReturn.ReturnLine l : ret.lines()) { + System.out.println(" lineId=" + l.lineId() + " sku=" + l.providerSku() + + " qty=" + l.quantity() + " suggested=" + l.suggestedDisposition()); + } + }); + } + + /** 销毁需要不可售库存:先查一下,没有就跳过(不是代码问题)。 */ + @Test + @Order(14) + void createDestruction() { + assumeToken(); + boolean hasUnsellable = false; + try { + common.ecommerce.shared.support.Page page = + adapter().query(ctx(), common.ecommerce.warehouse.model.InventoryQuery.builder() + .inventoryType(1).pageSize(20).build()); + for (common.ecommerce.warehouse.model.InventorySnapshot snap : page.items()) { + if (snap.inventoryType() == 1 && snap.available() > 0) { + hasUnsellable = true; + break; + } + } + } catch (RuntimeException e) { + System.out.println("[destruction] 查不可售库存失败,跳过: " + e.getMessage()); + } + Assumptions.assumeTrue(hasUnsellable, + "该仓没有不可售库存,销毁计划需要不可售 SKU,跳过"); + run("POST /v1/destroyPlan/createDestroyPlan", () -> { + DestructionOrder order = adapter().create(ctx(), destructionCommand()); + System.out.println("[destruction.create] providerNo=" + order.providerDestructionId() + + " status=" + order.status()); + }); + } + + // ---------------------------------------------------------------- 商品 + + /** 商品建档:测试 SKU 已存在且状态可能不允许编辑,失败属业务约束。 */ + @Test + @Order(15) + void saveProduct() { + assumeToken(); + String probeSku = System.getProperty("yqn.probe.newSku", ""); + Assumptions.assumeTrue(!probeSku.trim().isEmpty(), + "未提供 -Dyqn.probe.newSku(新建 SKU),跳过商品建档"); + run("POST /v1/product/save", () -> { + common.ecommerce.warehouse.capability.WarehouseProductCapable.ProductResult result = + adapter().createOrUpdate(ctx(), + common.ecommerce.warehouse.capability.WarehouseProduct.builder() + .omsSku(probeSku) + .name("探针商品") + .nameEn("Probe Product") + .packingType(0) + .lengthCm(30).widthCm(20).heightCm(10).weightGrams(500) + .requireSn(0) + .build()); + System.out.println("[product.save] sku=" + result.providerSku() + + " status=" + result.status() + " rawStatus=" + result.rawStatus()); + }); + } + + // ---------------------------------------------------------------- 命令构造 + + private static OutboundCommand outboundCommand() { + return OutboundCommand.builder() + .outboundRequestNo(RUN + "-OUT") + .orderRef(RUN + "-REF") + .carrier("FEDEX") + .carrierCode(CARRIER_CODE) + .warehouseId(PROVIDER_WAREHOUSE) + .salesPlatform(Platform.AMAZON_SC) + .currency("USD") + .shipServiceLevel("Standard-48 Hours") + .shipTo(ShipTo.builder() + .name("Probe User").phone("+1-555-0100") + .countryCode("US").stateOrProvince("NY").city("New York") + .addressLine1("1 Probe St").postalCode("10001") + .build()) + .line(OutboundLine.builder() + .lineNo("1").omsSku(SKU).quantity(1) + .declareName("Probe Goods").declareNameEn("Probe Goods") + .declareValue(common.ecommerce.shared.support.Money.of("10.00", "USD")) + .build()) + .build(); + } + + private static InboundCommand inboundCommand() { + return InboundCommand.builder() + .inboundRequestNo(RUN + "-IN") + .warehouseId(PROVIDER_WAREHOUSE) + .inventoryType(0) + .currency("USD") + .estimateArriveDate(LocalDate.now().plusDays(7)) + .expectArriveDate(LocalDate.now().plusDays(7)) + .originCountry("CN") + .shipperName("Probe Shipper").shipperContact("Probe").shipperPhone("+86-555-0100") + .shipperAddress("Probe Address") + .line(InboundLine.builder().omsSku(SKU).quantity(1).build()) + .build(); + } + + private static TransferCommand transferCommand() { + return TransferCommand.builder() + .transferRequestNo(RUN + "-TR") + .type(TransferType.WAREHOUSE_TO_WAREHOUSE) + .fromWarehouseCode(PROVIDER_WAREHOUSE) + .toWarehouseCode(PROVIDER_WAREHOUSE) + .inventoryType(0) + .carrierType(1) + .transportationType(2) + .estimateOutboundDate(LocalDate.now().plusDays(3)) + .estimateInboundDate(LocalDate.now().plusDays(7)) + .remark("probe") + .line(SKU, 1) + .build(); + } + + private static ReturnCommand returnCommand() { + return ReturnCommand.builder() + .returnRequestNo(RUN + "-RT") + .warehouseId(PROVIDER_WAREHOUSE) + .saleOrderNo(RUN + "-OUT") + .returnTrackingNo("PROBE-TRK-" + System.currentTimeMillis()) + .carrierCode(CARRIER_CODE) + .estimatedReceiveDate(LocalDate.now().plusDays(5)) + .returnReason("probe") + .line(SKU, 1, common.ecommerce.warehouse.enums.ReturnDealMethod.PHOTO_CONFIRM) + .build(); + } + + private static DestructionCommand destructionCommand() { + return DestructionCommand.builder() + .destructionNo(RUN + "-DS") + .warehouseId(PROVIDER_WAREHOUSE) + .inventoryType(1) + .hopeDestroyDate(LocalDate.now().plusDays(10)) + .remark("probe") + .line(SKU, 1) + .build(); + } + + // ---------------------------------------------------------------- helpers + + private static WarehouseContext ctx() { + return WarehouseContext.of(WAREHOUSE_CODE, WarehouseProvider.YQN, PROVIDER_WAREHOUSE, + WarehouseConnection.of(BASE_URL, AUX_URL, + ChannelSecret.builder().appSecret(TOKEN).build()), + "probe-" + UUID.randomUUID(), Clock.systemUTC()); + } + + private static YqnAdapter adapter() { + return new YqnAdapter(new OkHttpTransport("common-ecommerce-yqn-probe"), + new JacksonJsonCodec()); + } + + private static void assumeToken() { + Assumptions.assumeTrue(!TOKEN.trim().isEmpty(), "未提供 -Dyqn.probe.token,跳过"); + } + + private static void run(String api, Runnable r) { + System.out.println("\n================ yqn / " + api + " ================"); + try { + r.run(); + System.out.println("[OK] " + api); + } catch (RuntimeException e) { + String msg = e.getMessage() == null ? e.getClass().getSimpleName() : e.getMessage(); + System.out.println("[ERROR] " + e.getClass().getSimpleName() + ": " + + (msg.length() <= 400 ? msg : msg.substring(0, 400) + "…")); + if (e instanceof ChannelException) { + ChannelException ce = (ChannelException) e; + System.out.println(" platformCode=" + ce.platformCode() + + " retryable=" + ce.retryable()); + } + } + } + + private static String opt(String name, String fallback) { + String value = System.getProperty(name, ""); + if (value == null) { + return fallback; + } + String trimmed = value.trim(); + return trimmed.isEmpty() ? fallback : trimmed; + } +}