Browse Source

fix(yqn): 运费试算的信封兼容 + 全链路探针(真机验证)

真机验证发现 运费试算(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 <noreply@anthropic.com>
feature/supplier-lingxing
chenchuchuan 1 week ago
parent
commit
0b8d687984
  1. 10
      warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java
  2. 80
      warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java
  3. 512
      warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/probe/YqnFullFlowProbeTest.java

10
warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java

@ -98,7 +98,15 @@ public final class YqnConstants { @@ -98,7 +98,15 @@ public final class YqnConstants {
*
* <p>实测该接口返回 {@code status=200, message=success},不是文档示例的 1。</p>
*/
public static final int WAREHOUSE_LIST_SUCCESS_STATUS = 200;
/**
* 没有 {@code code} 字段的接口,其成功判定用的 {@code status} 值。
*
* <p>实测(仓库目录、运费试算):成功返回 {@code status: 200, message: "success"}。</p>
*/
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;

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

@ -364,7 +364,10 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl @@ -364,7 +364,10 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
public List<FeeEstimateResult> 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<YqnFeeEstimateDtos.CalculateResult> rows = json.listAt(raw, "data", YqnFeeEstimateDtos.CalculateResult.class);
List<FeeEstimateResult> out = new ArrayList<FeeEstimateResult>(rows.size());
for (YqnFeeEstimateDtos.CalculateResult row : rows) {
@ -651,10 +654,49 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl @@ -651,10 +654,49 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
}
/**
* 这个接口的业务码判定:有 {@code code} 时按 200 校验;没有则退回看 {@code status}
* (文档示例 {@code status: 1} 表示成功)。
* 运去哪有一批接口的响应<b>没有 {@code code} 字段</b>,只有
* {@code status + message}(实测:仓库目录、运费试算)。
*
* <p>判定规则:有 {@code code} 就按 200 校验;没有则看 {@code status == 200}
* —实测成功返回 {@code status: 200, message: "success"},
* <b>不是</b>文档示例里的 1。</p>
*
* @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 @@ -885,6 +927,38 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
return ctx.zone();
}
/**
* 发请求 + 容忍式信封校验:有的接口没有 {@code code} 字段。
*
* <p>HTTP 层(401/403/429/5xx)仍由 {@link YqnEnvelope} 的规则处理,
* 这里只是不强制要求业务码存在。</p>
*/
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);

512
warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/probe/YqnFullFlowProbeTest.java

@ -0,0 +1,512 @@ @@ -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;
/**
* 运去哪<b>全链路</b>联调探针:按业务流程把每个接口都走一遍。
*
* <p>默认跳过,需显式开启:</p>
*
* <pre>
* 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
* </pre>
*
* <p><b>会真实创建单据</b>(出库 / 入库 / 调拨 / 退货 / 销毁),仅限 PR 测试环境。
* 单号带 {@code PROBE-<时间戳>} 前缀便于识别与清理。</p>
*
* <p>方法按 {@code @Order} 串起来:出库创建 → 查详情;调拨创建即验证;
* 入库创建 → 查详情 → 打箱标 / SKU 标。任何一步失败只打印不中断,
* 后面还会继续跑,便于一次看全。</p>
*/
@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<common.ecommerce.warehouse.model.InventorySnapshot> 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<common.ecommerce.warehouse.model.FeeEstimateResult> 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<common.ecommerce.warehouse.model.BillingDocument> 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<common.ecommerce.warehouse.model.InventorySnapshot> 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;
}
}
Loading…
Cancel
Save