You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
338 lines
16 KiB
338 lines
16 KiB
package common.ecommerce.xincang.probe; |
|
|
|
import common.ecommerce.shared.model.Platform; |
|
import common.ecommerce.shared.support.Money; |
|
import common.ecommerce.warehouse.capability.WarehouseProduct; |
|
import common.ecommerce.warehouse.capability.WarehouseProductCapable; |
|
import common.ecommerce.warehouse.enums.LabelMode; |
|
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.ShipTo; |
|
import common.ecommerce.warehouse.model.TransferCommand; |
|
import common.ecommerce.warehouse.model.TransferOrder; |
|
import common.ecommerce.warehouse.enums.TransferType; |
|
import common.ecommerce.xincang.adapter.XincangAdapter; |
|
import org.junit.jupiter.api.Test; |
|
import org.junit.jupiter.api.condition.EnabledIfSystemProperty; |
|
|
|
import java.time.LocalDate; |
|
|
|
/** |
|
* 信仓写接口的联网探针:真实下单 / 建转运 / 建预报,用于核对报文。 |
|
* |
|
* <p><b>默认整类跳过</b>,需要两个开关同时打开:</p> |
|
* <pre> |
|
* -Dxincang.probe=true -Dxincang.probe.write=true |
|
* </pre> |
|
* |
|
* <p>运行示例:</p> |
|
* <pre> |
|
* mvn -pl warehouse-sdk-xincang -am -DfailIfNoTests=false \ |
|
* -Dxincang.probe=true -Dxincang.probe.write=true \ |
|
* -Dxincang.probe.appKey=... -Dxincang.probe.appSecret=... \ |
|
* -Dxincang.probe.sku=... -Dxincang.probe.postcode=... \ |
|
* -Dtest=XincangWriteProbeTest test |
|
* </pre> |
|
* |
|
* <p><b>注意:会在仓方测试环境留下真实数据。</b>能自清理的链路(订单、转运)会尽量删掉; |
|
* 商品建档与预报没有删除接口,跑完需要人工清理。所有单号都带时间戳后缀, |
|
* 重跑不会撞唯一约束。</p> |
|
*/ |
|
@EnabledIfSystemProperty(named = XincangProbeSupport.PROBE_WRITE, matches = "true") |
|
class XincangWriteProbeTest { |
|
|
|
// ================================================================ 商品 |
|
|
|
/** |
|
* 商品建档 / 更新:走 add_product 或 update_product(先查临时产品决定)。 |
|
* |
|
* <p>需要 {@code -Dxincang.probe.sku};金额按 1.00 USD 下发, |
|
* 因为信仓把 amount 列为必填且我们不再兜底 0。</p> |
|
*/ |
|
@Test |
|
void probeProductUpsert() { |
|
XincangProbeSupport.requireCredentials(); |
|
XincangProbeSupport.requireProperty("xincang.probe.sku"); |
|
System.out.println("\n================ xincang / api.add_product | api.update_product ================"); |
|
XincangAdapter adapter = XincangProbeSupport.adapter(); |
|
|
|
WarehouseProduct product = WarehouseProduct.builder() |
|
.omsSku(XincangProbeSupport.SKU) |
|
.name("探针商品") |
|
.nameEn("Probe Product") |
|
.barcode("PROBE-" + XincangProbeSupport.uniqueSuffix()) |
|
.packingType(0) |
|
.lengthCm(30) |
|
.widthCm(20) |
|
.heightCm(10) |
|
.weightGrams(500) |
|
.declaredValue(Money.of("1.00", "USD")) |
|
.hsCode("9403600000") |
|
.countryOfOrigin("US") |
|
.build(); |
|
|
|
WarehouseProductCapable.ProductResult result = XincangProbeSupport.step( |
|
"createOrUpdate sku=" + XincangProbeSupport.SKU, |
|
() -> adapter.createOrUpdate(XincangProbeSupport.ctx(), product)); |
|
if (result != null) { |
|
System.out.println(" providerSku=" + result.providerSku() |
|
+ " status=" + result.status() |
|
+ " rawStatus=" + result.rawStatus()); |
|
System.out.println(" [注意] 没有删除产品接口,跑完需人工清理或复用该 SKU。"); |
|
} |
|
} |
|
|
|
// ================================================================ 出库 |
|
|
|
/** |
|
* 出库闭环:下单 → 详情回读 → 删除。 |
|
* |
|
* <p>需要 sku + postcode;承运商从目录接口自动取(或 {@code -Dxincang.probe.carrier})。</p> |
|
*/ |
|
@Test |
|
void probeOutboundRoundTrip() { |
|
XincangProbeSupport.requireCredentials(); |
|
XincangProbeSupport.requireProperty("xincang.probe.sku"); |
|
XincangProbeSupport.requireProperty("xincang.probe.postcode"); |
|
System.out.println("\n================ xincang / api.add_order_multiple → get_order → delete_order ================"); |
|
XincangAdapter adapter = XincangProbeSupport.adapter(); |
|
String warehouseCode = XincangProbeSupport.warehouseCode(adapter); |
|
String carrier = XincangProbeSupport.carrier(adapter); |
|
if (warehouseCode == null || carrier == null) { |
|
System.out.println(" [skip] 缺少仓代码或承运商,跳过"); |
|
return; |
|
} |
|
String requestNo = "PROBE-" + XincangProbeSupport.uniqueSuffix(); |
|
|
|
OutboundCommand command = OutboundCommand.builder() |
|
.outboundRequestNo(requestNo) |
|
.orderRef(requestNo) |
|
.labelMode(LabelMode.WAREHOUSE_LABEL) |
|
.salesPlatform(Platform.CUSTOM) |
|
.carrierCode(carrier) |
|
.warehouseId(warehouseCode) |
|
.splitOrder(true) |
|
.shipTo(ShipTo.builder() |
|
.name("Probe Receiver") |
|
.phone("5550000000") |
|
.countryCode("US") |
|
.stateOrProvince("CA") |
|
.city("Fontana") |
|
.addressLine1("1 Probe Street") |
|
.postalCode(XincangProbeSupport.POSTCODE) |
|
.build()) |
|
.line(OutboundLine.builder() |
|
.lineNo("1") |
|
.omsSku(XincangProbeSupport.SKU) |
|
.quantity(XincangProbeSupport.qty()) |
|
.declareName("Probe Item") |
|
.build()) |
|
.build(); |
|
|
|
OutboundReceipt receipt = XincangProbeSupport.step("add_order_multiple ckh=" + requestNo, |
|
() -> adapter.create(XincangProbeSupport.ctx(warehouseCode), command)); |
|
if (receipt == null || receipt.providerOrderId() == null) { |
|
return; |
|
} |
|
System.out.println(" providerOrderId=" + receipt.providerOrderId()); |
|
|
|
OutboundOrder order = XincangProbeSupport.step("get_order 回读", |
|
() -> adapter.get(XincangProbeSupport.ctx(warehouseCode), |
|
OutboundRef.ofProviderOrderId(receipt.providerOrderId()))); |
|
if (order != null) { |
|
System.out.println(" status=" + order.status() + "(raw=" + order.rawStatus() + ")" |
|
+ " ref=" + order.orderRef() |
|
+ " lines=" + order.lines().size()); |
|
System.out.println(" checkCancel=" + XincangProbeSupport.step("checkCancel", |
|
() -> adapter.checkCancel(XincangProbeSupport.ctx(warehouseCode), |
|
OutboundRef.ofProviderOrderId(receipt.providerOrderId())))); |
|
} |
|
|
|
XincangProbeSupport.step("delete_order 自清理", |
|
() -> adapter.cancel(XincangProbeSupport.ctx(warehouseCode), |
|
common.ecommerce.warehouse.model.CancelCommand.builder() |
|
.providerOrderId(receipt.providerOrderId()) |
|
.build())); |
|
} |
|
|
|
// ================================================================ 转运 |
|
|
|
/** |
|
* 转运闭环:建转运 → 详情回读 → 删除(仅待审核可删)。 |
|
*/ |
|
@Test |
|
void probeTransferRoundTrip() { |
|
XincangProbeSupport.requireCredentials(); |
|
XincangProbeSupport.requireProperty("xincang.probe.sku"); |
|
XincangProbeSupport.requireProperty("xincang.probe.destWarehouse"); |
|
System.out.println("\n================ xincang / fba.do_fba → fba_detail → fba.delete_fba ================"); |
|
XincangAdapter adapter = XincangProbeSupport.adapter(); |
|
String warehouseCode = XincangProbeSupport.warehouseCode(adapter); |
|
if (warehouseCode == null) { |
|
System.out.println(" [skip] 缺少仓代码,跳过"); |
|
return; |
|
} |
|
String transferNo = "PROBE-" + XincangProbeSupport.uniqueSuffix(); |
|
String destWarehouse = XincangProbeSupport.opt("xincang.probe.destWarehouse", ""); |
|
|
|
TransferCommand command = TransferCommand.builder() |
|
.transferRequestNo(transferNo) |
|
.type(TransferType.OUTBOUND) |
|
.fromWarehouseCode(warehouseCode) |
|
.toWarehouseCode(destWarehouse) |
|
.po(transferNo) |
|
// 信仓只用 pre_send_time;到仓日期与收件地址它都不收, |
|
// 这里不传,顺便验证模型已不再强制这两个字段 |
|
.estimateOutboundDate(LocalDate.now().plusDays(1)) |
|
.deliveryMode(XincangProbeSupport.opt("xincang.probe.deliveryMode", "")) |
|
.deliveryWay(XincangProbeSupport.opt("xincang.probe.deliveryWay", "")) |
|
.orderType(XincangProbeSupport.opt("xincang.probe.orderType", "")) |
|
.palletRequired(Boolean.FALSE) |
|
.line(XincangProbeSupport.SKU, XincangProbeSupport.qty()) |
|
.build(); |
|
|
|
TransferOrder created = XincangProbeSupport.step("do_fba fba_no=" + transferNo, |
|
() -> adapter.create(XincangProbeSupport.ctx(warehouseCode), command)); |
|
if (created == null || created.providerTransferNo() == null) { |
|
return; |
|
} |
|
String providerNo = created.providerTransferNo(); |
|
System.out.println(" providerTransferNo=" + providerNo + " status=" + created.status()); |
|
|
|
XincangProbeSupport.step("fba_detail 回读", |
|
() -> adapter.getTransfer(XincangProbeSupport.ctx(warehouseCode), providerNo)); |
|
|
|
XincangProbeSupport.step("fba.delete_fba 自清理", |
|
() -> adapter.deleteTransfer(XincangProbeSupport.ctx(warehouseCode), providerNo)); |
|
} |
|
|
|
/** |
|
* 转运审核:建转运 → 审核。 |
|
* |
|
* <p><b>审核之后不能删除</b>,会在测试环境留下数据,默认不跑; |
|
* 需要显式加 {@code -Dxincang.probe.transferApprove=true}。</p> |
|
*/ |
|
@Test |
|
void probeTransferApprove() { |
|
XincangProbeSupport.requireCredentials(); |
|
XincangProbeSupport.requireProperty("xincang.probe.transferApprove"); |
|
XincangProbeSupport.requireProperty("xincang.probe.sku"); |
|
XincangProbeSupport.requireProperty("xincang.probe.destWarehouse"); |
|
System.out.println("\n================ xincang / fba.do_approve ================"); |
|
System.out.println(" [注意] 审核后的转运单无法删除,会留下数据。"); |
|
XincangAdapter adapter = XincangProbeSupport.adapter(); |
|
String warehouseCode = XincangProbeSupport.warehouseCode(adapter); |
|
if (warehouseCode == null) { |
|
System.out.println(" [skip] 缺少仓代码,跳过"); |
|
return; |
|
} |
|
String transferNo = "PROBE-APPROVE-" + XincangProbeSupport.uniqueSuffix(); |
|
TransferCommand command = TransferCommand.builder() |
|
.transferRequestNo(transferNo) |
|
.type(TransferType.OUTBOUND) |
|
.fromWarehouseCode(warehouseCode) |
|
.toWarehouseCode(XincangProbeSupport.opt("xincang.probe.destWarehouse", "")) |
|
.po(transferNo) |
|
.estimateOutboundDate(LocalDate.now().plusDays(1)) |
|
.deliveryMode(XincangProbeSupport.opt("xincang.probe.deliveryMode", "")) |
|
.deliveryWay(XincangProbeSupport.opt("xincang.probe.deliveryWay", "")) |
|
.orderType(XincangProbeSupport.opt("xincang.probe.orderType", "")) |
|
.palletRequired(Boolean.FALSE) |
|
.line(XincangProbeSupport.SKU, XincangProbeSupport.qty()) |
|
.build(); |
|
|
|
TransferOrder created = XincangProbeSupport.step("do_fba", |
|
() -> adapter.create(XincangProbeSupport.ctx(warehouseCode), command)); |
|
if (created == null || created.providerTransferNo() == null) { |
|
return; |
|
} |
|
XincangProbeSupport.step("do_approve " + created.providerTransferNo(), |
|
() -> adapter.approve(XincangProbeSupport.ctx(warehouseCode), |
|
created.providerTransferNo())); |
|
} |
|
|
|
// ================================================================ 预报 |
|
|
|
/** |
|
* 预报闭环:新增 → 完善资料 → 提交 → 详情回读。 |
|
* |
|
* <p><b>没有删除接口</b>,跑完会在测试环境留下预报单。</p> |
|
*/ |
|
@Test |
|
void probeForecastRoundTrip() { |
|
XincangProbeSupport.requireCredentials(); |
|
XincangProbeSupport.requireProperty("xincang.probe.sku"); |
|
System.out.println("\n================ xincang / forecast.do_forecast → improve → done → detail ================"); |
|
System.out.println(" [注意] 预报没有删除接口,会留下数据。"); |
|
XincangAdapter adapter = XincangProbeSupport.adapter(); |
|
String warehouseCode = XincangProbeSupport.warehouseCode(adapter); |
|
if (warehouseCode == null) { |
|
System.out.println(" [skip] 缺少仓代码,跳过"); |
|
return; |
|
} |
|
String suffix = XincangProbeSupport.uniqueSuffix(); |
|
String requestNo = "PROBE-FC-" + suffix; |
|
|
|
InboundCommand head = InboundCommand.builder() |
|
.inboundRequestNo(requestNo) |
|
.warehouseId(warehouseCode) |
|
.shipmentType(XincangProbeSupport.opt("xincang.probe.shipmentType", "2")) |
|
.cabinetType(XincangProbeSupport.opt("xincang.probe.cabinetType", "1")) |
|
.containerNo("PROBE-CAB-" + suffix) |
|
.predictionShipDate(LocalDate.now().plusDays(1)) |
|
.estimateArriveDate(LocalDate.now().plusDays(30)) |
|
.deliveryRequirements(XincangProbeSupport.opt("xincang.probe.deliveryRequirements", "1")) |
|
.line(InboundLine.builder() |
|
.omsSku(XincangProbeSupport.SKU) |
|
.providerSku(XincangProbeSupport.SKU) |
|
.quantity(XincangProbeSupport.qty()) |
|
.build()) |
|
.build(); |
|
|
|
InboundReceipt receipt = XincangProbeSupport.step("do_forecast fba_no=" + requestNo, |
|
() -> adapter.create(XincangProbeSupport.ctx(warehouseCode), head)); |
|
if (receipt == null || receipt.providerInboundId() == null) { |
|
return; |
|
} |
|
String forecastNo = receipt.providerInboundId(); |
|
System.out.println(" forecast_no=" + forecastNo); |
|
|
|
InboundCommand improve = InboundCommand.builder() |
|
.inboundRequestNo(requestNo) |
|
.warehouseId(warehouseCode) |
|
.shipmentType(XincangProbeSupport.opt("xincang.probe.shipmentType", "2")) |
|
.cabinetType(XincangProbeSupport.opt("xincang.probe.cabinetType", "1")) |
|
.containerNo("PROBE-CAB-" + suffix) |
|
.predictionShipDate(LocalDate.now().plusDays(1)) |
|
.estimateArriveDate(LocalDate.now().plusDays(30)) |
|
.deliveryRequirements(XincangProbeSupport.opt("xincang.probe.deliveryRequirements", "1")) |
|
.referenceNo("REF-" + suffix) |
|
.otherNeed(XincangProbeSupport.opt("xincang.probe.otherNeed", "")) |
|
.line(InboundLine.builder() |
|
.omsSku(XincangProbeSupport.SKU) |
|
.providerSku(XincangProbeSupport.SKU) |
|
.quantity(XincangProbeSupport.qty()) |
|
.build()) |
|
.build(); |
|
|
|
XincangProbeSupport.step("do_improve_forecast", |
|
() -> adapter.improve(XincangProbeSupport.ctx(warehouseCode), forecastNo, improve)); |
|
XincangProbeSupport.step("done_forecast", |
|
() -> adapter.submit(XincangProbeSupport.ctx(warehouseCode), forecastNo)); |
|
|
|
InboundOrder detail = XincangProbeSupport.step("forecast_detail 回读", |
|
() -> adapter.get(XincangProbeSupport.ctx(warehouseCode), forecastNo)); |
|
if (detail != null) { |
|
System.out.println(" status=" + detail.status() + "(raw=" + detail.rawStatus() + ")" |
|
+ " boxCount=" + detail.boxCount() |
|
+ " lines=" + detail.lines().size()); |
|
} |
|
} |
|
}
|
|
|