|
|
|
|
package common.ecommerce.hengjian.probe;
|
|
|
|
|
|
|
|
|
|
import common.ecommerce.hengjian.HengjianConstants;
|
|
|
|
|
import common.ecommerce.hengjian.adapter.HengjianAdapter;
|
|
|
|
|
import common.ecommerce.http.JacksonJsonCodec;
|
|
|
|
|
import common.ecommerce.http.OkHttpTransport;
|
|
|
|
|
import common.ecommerce.shared.spi.ChannelSecret;
|
|
|
|
|
import common.ecommerce.shared.support.Money;
|
|
|
|
|
import common.ecommerce.shared.support.Page;
|
|
|
|
|
import common.ecommerce.warehouse.enums.AddressType;
|
|
|
|
|
import common.ecommerce.warehouse.enums.WarehouseFeeType;
|
|
|
|
|
import common.ecommerce.warehouse.enums.WarehouseProvider;
|
|
|
|
|
import common.ecommerce.warehouse.model.BillingDocument;
|
|
|
|
|
import common.ecommerce.warehouse.model.DestructionOrder;
|
|
|
|
|
import common.ecommerce.warehouse.model.FeeEstimateQuery;
|
|
|
|
|
import common.ecommerce.warehouse.model.FeeQuery;
|
|
|
|
|
import common.ecommerce.warehouse.model.FeeEstimateResult;
|
|
|
|
|
import common.ecommerce.warehouse.model.InboundOrder;
|
|
|
|
|
import common.ecommerce.warehouse.model.InboundQuery;
|
|
|
|
|
import common.ecommerce.warehouse.model.InventoryMovement;
|
|
|
|
|
import common.ecommerce.warehouse.model.InventoryMovementQuery;
|
|
|
|
|
import common.ecommerce.warehouse.model.InventorySnapshot;
|
|
|
|
|
import common.ecommerce.warehouse.model.LogisticsProduct;
|
|
|
|
|
import common.ecommerce.warehouse.model.OutboundLine;
|
|
|
|
|
import common.ecommerce.warehouse.model.OutboundOrder;
|
|
|
|
|
import common.ecommerce.warehouse.model.OutboundQuery;
|
|
|
|
|
import common.ecommerce.warehouse.model.OutboundRef;
|
|
|
|
|
import common.ecommerce.warehouse.model.ProductInfo;
|
|
|
|
|
import common.ecommerce.warehouse.model.ProductQuery;
|
|
|
|
|
import common.ecommerce.warehouse.model.ReturnHandle;
|
|
|
|
|
import common.ecommerce.warehouse.model.ReturnQuery;
|
|
|
|
|
import common.ecommerce.warehouse.model.TransferOrder;
|
|
|
|
|
import common.ecommerce.warehouse.model.TransferQuery;
|
|
|
|
|
import common.ecommerce.warehouse.model.WarehouseFacility;
|
|
|
|
|
import common.ecommerce.warehouse.model.WarehouseReturn;
|
|
|
|
|
import common.ecommerce.warehouse.sdk.WarehouseConnection;
|
|
|
|
|
import common.ecommerce.warehouse.sdk.WarehouseContext;
|
|
|
|
|
import org.junit.jupiter.api.Assumptions;
|
|
|
|
|
import org.junit.jupiter.api.Test;
|
|
|
|
|
import org.junit.jupiter.api.condition.EnabledIfSystemProperty;
|
|
|
|
|
|
|
|
|
|
import java.math.BigDecimal;
|
|
|
|
|
import java.time.Clock;
|
|
|
|
|
import java.time.LocalDate;
|
|
|
|
|
import java.util.Arrays;
|
|
|
|
|
import java.util.List;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 恒健<b>只读</b>探针:核对已对接接口的真实出入参。
|
|
|
|
|
*
|
|
|
|
|
* <p>默认跳过,用 {@code -Dhengjian.probe=true} 显式开启;凭据走系统属性,
|
|
|
|
|
* <b>真实 token 不入库</b>:</p>
|
|
|
|
|
*
|
|
|
|
|
* <pre>
|
|
|
|
|
* mvn -pl warehouse-sdk-hengjian -am -DfailIfNoTests=false \
|
|
|
|
|
* -Dhengjian.probe=true \
|
|
|
|
|
* -Dhengjian.probe.token=你的组织token \
|
|
|
|
|
* -Dhengjian.probe.warehouseCode=EFCA \
|
|
|
|
|
* -Dtest=HengjianReadOnlyProbeTest test
|
|
|
|
|
* </pre>
|
|
|
|
|
*
|
|
|
|
|
* <p><b>只跑查询类接口</b>:建单 / 取消 / 销毁会真实创建单据,没有测试环境
|
|
|
|
|
* 明确许可前一律不碰。</p>
|
|
|
|
|
*
|
|
|
|
|
* <p>输出只打印字段名与取值摘要,不打印 token 与完整报文(可能含 PII)。</p>
|
|
|
|
|
*/
|
|
|
|
|
@EnabledIfSystemProperty(named = "hengjian.probe", matches = "true")
|
|
|
|
|
class HengjianReadOnlyProbeTest {
|
|
|
|
|
|
|
|
|
|
private static final String TOKEN = System.getProperty("hengjian.probe.token", "");
|
|
|
|
|
private static final String BASE_URL = opt("hengjian.probe.baseUrl", HengjianConstants.TEST_BASE_URL);
|
|
|
|
|
private static final String WAREHOUSE_CODE = opt("hengjian.probe.warehouseCode", "HJ-PROBE");
|
|
|
|
|
private static final String PROVIDER_WAREHOUSE = opt("hengjian.probe.providerWarehouseId", "EFCA");
|
|
|
|
|
|
|
|
|
|
private static String opt(String key, String fallback) {
|
|
|
|
|
String v = System.getProperty(key);
|
|
|
|
|
return v == null || v.trim().isEmpty() ? fallback : v.trim();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static void assumeToken() {
|
|
|
|
|
Assumptions.assumeTrue(!TOKEN.trim().isEmpty(),
|
|
|
|
|
"未提供 -Dhengjian.probe.token,跳过恒健探针");
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static WarehouseContext ctx() {
|
|
|
|
|
return WarehouseContext.of(WAREHOUSE_CODE, WarehouseProvider.HENGJIAN, PROVIDER_WAREHOUSE,
|
|
|
|
|
WarehouseConnection.of(BASE_URL,
|
|
|
|
|
ChannelSecret.builder().appSecret(TOKEN.trim()).build()),
|
|
|
|
|
"probe-" + System.currentTimeMillis(), Clock.systemUTC());
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static HengjianAdapter adapter() {
|
|
|
|
|
return new HengjianAdapter(new OkHttpTransport("common-ecommerce-hengjian-probe"),
|
|
|
|
|
new JacksonJsonCodec());
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 一次跑完,异常只打印不中断——探针要把所有问题一次暴露出来。 */
|
|
|
|
|
private static void run(String what, Runnable action) {
|
|
|
|
|
System.out.println("---- " + what);
|
|
|
|
|
try {
|
|
|
|
|
action.run();
|
|
|
|
|
} catch (RuntimeException e) {
|
|
|
|
|
System.out.println(" [FAIL] " + e.getClass().getSimpleName() + ": " + e.getMessage());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ================================================================ 基础资料
|
|
|
|
|
|
|
|
|
|
/** 仓库目录:不依赖任何单号,最容易验通,也顺带验证鉴权与信封。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeWarehouseDirectory() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("POST /v2/warehouse/getWarehouse", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
List<WarehouseFacility> list = adapter().warehouses(ctx());
|
|
|
|
|
System.out.println(" 返回 " + list.size() + " 个仓");
|
|
|
|
|
for (int i = 0; i < Math.min(list.size(), 5); i++) {
|
|
|
|
|
WarehouseFacility w = list.get(i);
|
|
|
|
|
System.out.println(" [" + i + "] code=" + w.warehouseCode()
|
|
|
|
|
+ " name=" + w.name()
|
|
|
|
|
+ " country=" + w.country()
|
|
|
|
|
+ " state=" + w.state()
|
|
|
|
|
+ " city=" + w.city()
|
|
|
|
|
+ " postal=" + w.postcode());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 全量物流渠道:验证无参数 POST 与 data 是数组。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeAllCarrierServices() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("POST /v2/carrierGroup/getCarrierGroup", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
List<LogisticsProduct> list = adapter().products(ctx(), PROVIDER_WAREHOUSE);
|
|
|
|
|
System.out.println(" 返回 " + list.size() + " 个物流产品");
|
|
|
|
|
for (int i = 0; i < Math.min(list.size(), 5); i++) {
|
|
|
|
|
LogisticsProduct p = list.get(i);
|
|
|
|
|
System.out.println(" [" + i + "] code=" + p.logisticsProductCode()
|
|
|
|
|
+ " name=" + p.logisticsProductName());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 按仓过滤的物流渠道:验证 data 是「仓代码 → 数组」的对象。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeWarehouseCarrierServices() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("POST /v2/carrierGroup/getWarehouseCarrierGroupServices", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
List<LogisticsProduct> list = adapter().productsOfWarehouse(ctx(), PROVIDER_WAREHOUSE);
|
|
|
|
|
System.out.println(" 仓 " + PROVIDER_WAREHOUSE + " 返回 " + list.size() + " 个物流产品");
|
|
|
|
|
for (int i = 0; i < Math.min(list.size(), 5); i++) {
|
|
|
|
|
System.out.println(" [" + i + "] code=" + list.get(i).logisticsProductCode()
|
|
|
|
|
+ " name=" + list.get(i).logisticsProductName());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 承运商代码清单(走同一个全量接口,验证去重)。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeCarrierCodes() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("POST /v2/carrierGroup/getCarrierGroup (carriers)", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
List<String> codes = adapter().carriers(ctx());
|
|
|
|
|
System.out.println(" 去重后 " + codes.size() + " 个 code");
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ================================================================ 商品
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 商品分页查询:验证 {@code pageSize} / {@code pageNum} 是 STRING、
|
|
|
|
|
* {@code data} 是分页对象、以及文档疑似漏掉的 {@code length} 到底回不回。
|
|
|
|
|
*/
|
|
|
|
|
@Test
|
|
|
|
|
void probeProductQuery() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("POST /v2/product/queryPage", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
ProductQuery query = ProductQuery.builder().pageSize(5).build();
|
|
|
|
|
Page<ProductInfo> page = adapter().query(ctx(), query);
|
|
|
|
|
System.out.println(" 本页 " + page.size() + " 条, 有下一页=" + page.hasMore()
|
|
|
|
|
+ ", 游标=" + page.nextCursor());
|
|
|
|
|
for (ProductInfo p : page.items()) {
|
|
|
|
|
System.out.println(" sku=" + p.providerSku()
|
|
|
|
|
+ " name=" + p.name()
|
|
|
|
|
+ " 长=" + p.lengthCm() + " 宽=" + p.widthCm() + " 高=" + p.heightCm()
|
|
|
|
|
+ " 重=" + p.weightGrams()
|
|
|
|
|
+ " 实测长=" + p.measuredLengthCm()
|
|
|
|
|
+ " 箱规=" + p.packedQuantity()
|
|
|
|
|
+ " 成本=" + (p.cost() == null ? null : p.cost().amount()));
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 按 SKU 精确查:验证 {@code skus} 数组过滤。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeProductQueryBySku() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
final String sku = opt("hengjian.probe.sku", "");
|
|
|
|
|
Assumptions.assumeTrue(!sku.isEmpty(), "未提供 -Dhengjian.probe.sku,跳过按 SKU 查商品");
|
|
|
|
|
run("POST /v2/product/queryPage (skus)", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
Page<ProductInfo> page = adapter().query(ctx(),
|
|
|
|
|
ProductQuery.builder().providerSku(sku).build());
|
|
|
|
|
System.out.println(" sku=" + sku + " 命中 " + page.size() + " 条");
|
|
|
|
|
for (ProductInfo p : page.items()) {
|
|
|
|
|
System.out.println(" " + p.providerSku() + " / " + p.name());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ================================================================ 出库
|
|
|
|
|
|
|
|
|
|
/** 订单详情:只按来源单号查,需要 {@code -Dhengjian.probe.orderNo}。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeOrderDetail() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
final String orderNo = opt("hengjian.probe.orderNo", "");
|
|
|
|
|
Assumptions.assumeTrue(!orderNo.isEmpty(),
|
|
|
|
|
"未提供 -Dhengjian.probe.orderNo,跳过订单详情探针");
|
|
|
|
|
run("POST /v1/saleOrder/findOne", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
OutboundOrder order = adapter().get(ctx(), OutboundRef.ofRequestNo(orderNo));
|
|
|
|
|
if (order == null) {
|
|
|
|
|
System.out.println(" [空] 未找到该单");
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
System.out.println(" status=" + order.status()
|
|
|
|
|
+ " rawStatus=" + order.rawStatus()
|
|
|
|
|
+ " providerOrderId=" + order.providerOrderId()
|
|
|
|
|
+ " tracking=" + order.trackingNumber()
|
|
|
|
|
+ " paidAt=" + order.paidAt()
|
|
|
|
|
+ " shippedAt=" + order.shippedAt()
|
|
|
|
|
+ " fee=" + order.estimatedShippingFee());
|
|
|
|
|
System.out.println(" 行数=" + order.lines().size()
|
|
|
|
|
+ " 附件数=" + order.attachments().size()
|
|
|
|
|
+ " exception=" + order.exceptionCode());
|
|
|
|
|
for (OutboundLine line : order.lines()) {
|
|
|
|
|
System.out.println(" line sku=" + line.providerSku()
|
|
|
|
|
+ " qty=" + line.quantity()
|
|
|
|
|
+ " total=" + line.totalAmount());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 订单列表:按时间窗查,核对分页结构与 {@code orderId} 是否真回。
|
|
|
|
|
*
|
|
|
|
|
* <p>需要 {@code -Dhengjian.probe.begin=yyyy-MM-dd} 与 {@code -Dhengjian.probe.end=yyyy-MM-dd},
|
|
|
|
|
* 跨度不超过 30 天。</p>
|
|
|
|
|
*/
|
|
|
|
|
@Test
|
|
|
|
|
void probeOrderList() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
final String begin = opt("hengjian.probe.begin", "");
|
|
|
|
|
final String end = opt("hengjian.probe.end", "");
|
|
|
|
|
Assumptions.assumeTrue(!begin.isEmpty() && !end.isEmpty(),
|
|
|
|
|
"未提供 -Dhengjian.probe.begin / end,跳过订单列表探针");
|
|
|
|
|
run("GET /v1/saleOrder/findByPage", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
OutboundQuery query = OutboundQuery.builder()
|
|
|
|
|
.after(java.time.LocalDate.parse(begin)
|
|
|
|
|
.atStartOfDay(java.time.ZoneOffset.UTC).toInstant())
|
|
|
|
|
.before(java.time.LocalDate.parse(end)
|
|
|
|
|
.atTime(23, 59, 59).toInstant(java.time.ZoneOffset.UTC))
|
|
|
|
|
.pageSize(10)
|
|
|
|
|
.build();
|
|
|
|
|
Page<OutboundOrder> page = adapter().query(ctx(), query);
|
|
|
|
|
System.out.println(" 本页 " + page.size() + " 条, 有下一页=" + page.hasMore()
|
|
|
|
|
+ ", 游标=" + page.nextCursor());
|
|
|
|
|
for (OutboundOrder order : page.items()) {
|
|
|
|
|
System.out.println(" orderNo=" + order.outboundRequestNo()
|
|
|
|
|
+ " orderId=" + order.providerOrderId()
|
|
|
|
|
+ " status=" + order.rawStatus()
|
|
|
|
|
+ " carrier=" + order.carrierCode()
|
|
|
|
|
+ " shippedAt=" + order.shippedAt());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ================================================================ 库存
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 库存查询:恒健有「按 SKU」与「按仓分页」两个接口,且<b>不能同时用</b>。
|
|
|
|
|
*
|
|
|
|
|
* <p>按 SKU 查需要 {@code -Dhengjian.probe.sku}。</p>
|
|
|
|
|
*/
|
|
|
|
|
@Test
|
|
|
|
|
void probeInventoryBySku() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
final String sku = opt("hengjian.probe.sku", "");
|
|
|
|
|
Assumptions.assumeTrue(!sku.isEmpty(), "未提供 -Dhengjian.probe.sku,跳过按 SKU 查库存");
|
|
|
|
|
run("POST /v1/inventory/getInventory", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
Page<InventorySnapshot> page = adapter().query(ctx(),
|
|
|
|
|
common.ecommerce.warehouse.model.InventoryQuery.builder()
|
|
|
|
|
.sku(sku).build());
|
|
|
|
|
System.out.println(" sku=" + sku + " 返回 " + page.size() + " 条");
|
|
|
|
|
for (InventorySnapshot s : page.items()) {
|
|
|
|
|
System.out.println(" sku=" + s.providerSku()
|
|
|
|
|
+ " 可用=" + s.available()
|
|
|
|
|
+ " 在手=" + s.onHand()
|
|
|
|
|
+ " 在途=" + s.inTransit()
|
|
|
|
|
+ " 预留=" + s.reserved()
|
|
|
|
|
+ " 类型=" + s.inventoryType()
|
|
|
|
|
+ " asOf=" + s.asOfUtc());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 库存按仓分页:验证 {@code v2/inventory/get_inventory_by_page} 的分页结构。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeInventoryByPage() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("GET /v2/inventory/get_inventory_by_page", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
Page<InventorySnapshot> page = adapter().query(ctx(),
|
|
|
|
|
common.ecommerce.warehouse.model.InventoryQuery.builder()
|
|
|
|
|
.warehouseCode(PROVIDER_WAREHOUSE)
|
|
|
|
|
.pageSize(5)
|
|
|
|
|
.build());
|
|
|
|
|
System.out.println(" 本页 " + page.size() + " 条, 有下一页=" + page.hasMore()
|
|
|
|
|
+ ", 游标=" + page.nextCursor());
|
|
|
|
|
for (InventorySnapshot s : page.items()) {
|
|
|
|
|
System.out.println(" sku=" + s.providerSku() + " 可用=" + s.available()
|
|
|
|
|
+ " 在手=" + s.onHand());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 库存变动流水:SKU + 日期区间都必填,区间 ≤ 30 天。
|
|
|
|
|
*
|
|
|
|
|
* <p>需要 {@code -Dhengjian.probe.sku} 与 {@code -Dhengjian.probe.begin} / {@code end}。</p>
|
|
|
|
|
*/
|
|
|
|
|
@Test
|
|
|
|
|
void probeInventoryMovements() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
final String sku = opt("hengjian.probe.sku", "");
|
|
|
|
|
final String begin = opt("hengjian.probe.begin", "");
|
|
|
|
|
final String end = opt("hengjian.probe.end", "");
|
|
|
|
|
Assumptions.assumeTrue(!sku.isEmpty() && !begin.isEmpty() && !end.isEmpty(),
|
|
|
|
|
"未提供 -Dhengjian.probe.sku / begin / end,跳过库存流水探针");
|
|
|
|
|
run("POST /v1/inventory/task/query", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
Page<InventoryMovement> page = adapter().queryMovements(ctx(),
|
|
|
|
|
InventoryMovementQuery.builder()
|
|
|
|
|
.sku(sku)
|
|
|
|
|
.dateRange(LocalDate.parse(begin), LocalDate.parse(end))
|
|
|
|
|
.pageSize(10)
|
|
|
|
|
.build());
|
|
|
|
|
System.out.println(" 本页 " + page.size() + " 条, 有下一页=" + page.hasMore());
|
|
|
|
|
for (InventoryMovement m : page.items()) {
|
|
|
|
|
System.out.println(" sku=" + m.providerSku()
|
|
|
|
|
+ " docType=" + m.documentType()
|
|
|
|
|
+ " changeType=" + m.changeType()
|
|
|
|
|
+ " 变化=" + m.changeQuantity()
|
|
|
|
|
+ " planNo=" + m.planOrderNo()
|
|
|
|
|
+ " sourceNo=" + m.sourceNo()
|
|
|
|
|
+ " at=" + m.businessAt());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ================================================================ 入库
|
|
|
|
|
|
|
|
|
|
/** 入库计划详情:单号既可是仓方计划号也可是来源单号。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeInboundDetail() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
final String inboundNo = opt("hengjian.probe.inboundNo", "");
|
|
|
|
|
Assumptions.assumeTrue(!inboundNo.isEmpty(),
|
|
|
|
|
"未提供 -Dhengjian.probe.inboundNo,跳过入库详情探针");
|
|
|
|
|
run("POST /v1/inbound/getInboundPlanInfo", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
InboundOrder order = adapter().get(ctx(), inboundNo);
|
|
|
|
|
if (order == null) {
|
|
|
|
|
System.out.println(" [空] 未找到该入库计划");
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
System.out.println(" status=" + order.status()
|
|
|
|
|
+ " rawStatus=" + order.rawStatus()
|
|
|
|
|
+ " providerId=" + order.providerInboundId()
|
|
|
|
|
+ " sourceNo=" + order.inboundRequestNo()
|
|
|
|
|
+ " 行数=" + order.lines().size()
|
|
|
|
|
+ " 箱数=" + order.boxes().size());
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 入库计划列表:验证分页结构与状态过滤。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeInboundList() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("POST /v1/inbound/getInboundPlanPage", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
Page<InboundOrder> page = adapter().queryInbounds(ctx(),
|
|
|
|
|
InboundQuery.builder().pageSize(5).build());
|
|
|
|
|
System.out.println(" 本页 " + page.size() + " 条, 有下一页=" + page.hasMore()
|
|
|
|
|
+ ", 游标=" + page.nextCursor());
|
|
|
|
|
for (InboundOrder o : page.items()) {
|
|
|
|
|
System.out.println(" no=" + o.providerInboundId()
|
|
|
|
|
+ " sourceNo=" + o.inboundRequestNo()
|
|
|
|
|
+ " status=" + o.rawStatus()
|
|
|
|
|
+ " createdAt=" + o.createdAt());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ================================================================ 调拨
|
|
|
|
|
|
|
|
|
|
/** 调拨计划查询:验证分页与仓过滤。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeTransferList() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("POST /v1/transferPlan/findByPage", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
Page<TransferOrder> page = adapter().queryTransfers(ctx(),
|
|
|
|
|
TransferQuery.builder().pageSize(5).build());
|
|
|
|
|
System.out.println(" 本页 " + page.size() + " 条, 有下一页=" + page.hasMore()
|
|
|
|
|
+ ", 游标=" + page.nextCursor());
|
|
|
|
|
for (TransferOrder t : page.items()) {
|
|
|
|
|
System.out.println(" no=" + t.providerTransferNo()
|
|
|
|
|
+ " sourceNo=" + t.transferRequestNo()
|
|
|
|
|
+ " status=" + t.rawStatus()
|
|
|
|
|
+ " from=" + t.fromWarehouseCode()
|
|
|
|
|
+ " to=" + t.toWarehouseCode());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ================================================================ 退货
|
|
|
|
|
|
|
|
|
|
/** 退货计划详情。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeReturnDetail() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
final String returnNo = opt("hengjian.probe.returnNo", "");
|
|
|
|
|
Assumptions.assumeTrue(!returnNo.isEmpty(),
|
|
|
|
|
"未提供 -Dhengjian.probe.returnNo,跳过退货详情探针");
|
|
|
|
|
run("POST /v1/saleReturn/thirdParty/getReturnPlanOrderInfo", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
WarehouseReturn ret = adapter().getReturn(ctx(), returnNo);
|
|
|
|
|
if (ret == null) {
|
|
|
|
|
System.out.println(" [空] 未找到该退货计划");
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
System.out.println(" returnRequestNo=" + ret.returnRequestNo()
|
|
|
|
|
+ " providerReturnId=" + ret.providerReturnId()
|
|
|
|
|
+ " status=" + ret.status()
|
|
|
|
|
+ " rawStatus=" + ret.rawStatus()
|
|
|
|
|
+ " type=" + ret.type()
|
|
|
|
|
+ " 行数=" + ret.lines().size());
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 退货计划列表:验证双层包裹与单状态过滤。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeReturnList() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("POST /v1/saleReturn/thirdParty/getReturnPlanOrderPage", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
Page<WarehouseReturn> page = adapter().queryReturns(ctx(),
|
|
|
|
|
ReturnQuery.builder().pageSize(5).build());
|
|
|
|
|
System.out.println(" 本页 " + page.size() + " 条, 有下一页=" + page.hasMore()
|
|
|
|
|
+ ", 游标=" + page.nextCursor());
|
|
|
|
|
for (WarehouseReturn r : page.items()) {
|
|
|
|
|
System.out.println(" no=" + r.providerReturnId()
|
|
|
|
|
+ " sourceNo=" + r.returnRequestNo()
|
|
|
|
|
+ " status=" + r.rawStatus());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 退货处理单列表:另一个接口(平铺请求),验证四项定位字段都在。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeReturnHandles() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("POST /v1/saleReturn/getReturnPlanHandlePage", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
Page<ReturnHandle> page = adapter().queryHandles(ctx(),
|
|
|
|
|
ReturnQuery.builder().pageSize(5).build());
|
|
|
|
|
System.out.println(" 本页 " + page.size() + " 条, 有下一页=" + page.hasMore());
|
|
|
|
|
for (ReturnHandle h : page.items()) {
|
|
|
|
|
System.out.println(" planNo=" + h.returnPlanNo()
|
|
|
|
|
+ " handleNo=" + h.returnHandleNo()
|
|
|
|
|
+ " sku=" + h.providerSku()
|
|
|
|
|
+ " tracking=" + h.trackingNumber()
|
|
|
|
|
+ " handlingStatus=" + h.handlingStatus()
|
|
|
|
|
+ " primaryMethod=" + h.primaryHandlingMethod());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ================================================================ 销毁
|
|
|
|
|
|
|
|
|
|
/** 销毁计划查询:验证裸数组请求 + 数组响应(路径真机待确认)。 */
|
|
|
|
|
@Test
|
|
|
|
|
void probeDestruction() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
final String destructionNo = opt("hengjian.probe.destructionNo", "");
|
|
|
|
|
Assumptions.assumeTrue(!destructionNo.isEmpty(),
|
|
|
|
|
"未提供 -Dhengjian.probe.destructionNo,跳过销毁查询探针");
|
|
|
|
|
run("POST /v2/destroyPlanOrder/find", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
DestructionOrder order = adapter().getDestruction(ctx(), destructionNo);
|
|
|
|
|
if (order == null) {
|
|
|
|
|
System.out.println(" [空] 未找到该销毁计划");
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
System.out.println(" no=" + order.destructionNo()
|
|
|
|
|
+ " providerId=" + order.providerDestructionId()
|
|
|
|
|
+ " status=" + order.status()
|
|
|
|
|
+ " rawStatus=" + order.rawStatus()
|
|
|
|
|
+ " hopeDestroyDate=" + order.hopeDestroyDate());
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ================================================================ 计费 / 试算
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 计费明细(仓储费 / 尾程费 / 作业费):只读,验证三个路径与分页信封。
|
|
|
|
|
*
|
|
|
|
|
* <p>用 {@code -Dhengjian.probe.feeType=STORAGE|LAST_MILE|OPERATION} 指定查哪一类;
|
|
|
|
|
* 必须同时给 {@code -Dhengjian.probe.begin} / {@code end}(yyyy-MM-dd),
|
|
|
|
|
* 因为恒健要求至少一条过滤条件。</p>
|
|
|
|
|
*/
|
|
|
|
|
@Test
|
|
|
|
|
void probeFeeDetails() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
final String feeType = opt("hengjian.probe.feeType", "");
|
|
|
|
|
Assumptions.assumeTrue(!feeType.isEmpty(),
|
|
|
|
|
"未提供 -Dhengjian.probe.feeType,跳过计费明细探针");
|
|
|
|
|
final String begin = opt("hengjian.probe.begin", "");
|
|
|
|
|
final String end = opt("hengjian.probe.end", "");
|
|
|
|
|
Assumptions.assumeTrue(!begin.isEmpty() && !end.isEmpty(),
|
|
|
|
|
"未提供 -Dhengjian.probe.begin / end,跳过计费明细探针");
|
|
|
|
|
|
|
|
|
|
final WarehouseFeeType type;
|
|
|
|
|
try {
|
|
|
|
|
type = WarehouseFeeType.valueOf(feeType.trim().toUpperCase());
|
|
|
|
|
} catch (IllegalArgumentException e) {
|
|
|
|
|
System.out.println("[skip] 未知的 feeType=" + feeType);
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
run("POST /v1/chargingSettlement/* (" + type + ")", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
FeeQuery query = FeeQuery.builder()
|
|
|
|
|
.costType(type)
|
|
|
|
|
.settledAfter(LocalDate.parse(begin)
|
|
|
|
|
.atStartOfDay(java.time.ZoneOffset.UTC).toInstant())
|
|
|
|
|
.settledBefore(LocalDate.parse(end)
|
|
|
|
|
.atTime(23, 59, 59).toInstant(java.time.ZoneOffset.UTC))
|
|
|
|
|
.pageSize(10)
|
|
|
|
|
.build();
|
|
|
|
|
List<BillingDocument> docs = adapter().settlements(ctx(), query);
|
|
|
|
|
System.out.println(" 返回 " + docs.size() + " 条(<10 说明已是末页)");
|
|
|
|
|
for (int i = 0; i < Math.min(docs.size(), 5); i++) {
|
|
|
|
|
BillingDocument d = docs.get(i);
|
|
|
|
|
System.out.println(" [" + i + "] type=" + d.feeType()
|
|
|
|
|
+ " billNo=" + d.documentNo()
|
|
|
|
|
+ " name=" + d.feeName()
|
|
|
|
|
+ " amount=" + d.amount()
|
|
|
|
|
+ " sku=" + d.providerSku()
|
|
|
|
|
+ " settledAt=" + d.settledAt());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 运费试算:只读(不下单),验证必须的收件信息与返回结构。
|
|
|
|
|
*
|
|
|
|
|
* <p>恒健试算需要完整收件地址 + 包裹尺寸重量。</p>
|
|
|
|
|
*/
|
|
|
|
|
@Test
|
|
|
|
|
void probeFeeEstimate() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("POST /v2/api/shipping/calculate", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
FeeEstimateQuery query = FeeEstimateQuery.builder()
|
|
|
|
|
// 恒健要求「发运仓库」与「发运邮编」至少给一个;字段名是 warehouseCode
|
|
|
|
|
.shipFromWarehouseCode(PROVIDER_WAREHOUSE)
|
|
|
|
|
.receiveCountry("US")
|
|
|
|
|
.receiveState("CA")
|
|
|
|
|
.receiveCity("Fontana")
|
|
|
|
|
.receivePostal("92337")
|
|
|
|
|
.receiveAddress("1 Test St")
|
|
|
|
|
.lengthCm(BigDecimal.valueOf(30))
|
|
|
|
|
.widthCm(BigDecimal.valueOf(20))
|
|
|
|
|
.heightCm(BigDecimal.valueOf(10))
|
|
|
|
|
.weightGrams(BigDecimal.valueOf(1500))
|
|
|
|
|
.insuredValue(Money.of("50.00", "USD"))
|
|
|
|
|
.build();
|
|
|
|
|
List<FeeEstimateResult> results = adapter().estimate(ctx(), query);
|
|
|
|
|
System.out.println(" 返回 " + results.size() + " 个报价");
|
|
|
|
|
for (FeeEstimateResult r : results) {
|
|
|
|
|
System.out.println(" warehouse=" + r.shipOrgWarehouseCode());
|
|
|
|
|
for (FeeEstimateResult.CarrierQuote q : r.carriers()) {
|
|
|
|
|
System.out.println(" 渠道=" + q.carrier()
|
|
|
|
|
+ " service=" + q.logisticsServiceCode()
|
|
|
|
|
+ " 总价=" + (q.totalRate() == null ? null : q.totalRate().amount())
|
|
|
|
|
+ " 明细项=" + q.costItems().size());
|
|
|
|
|
for (FeeEstimateResult.CarrierQuote.CostItem c : q.costItems()) {
|
|
|
|
|
System.out.println(" - " + c.costName() + "="
|
|
|
|
|
+ (c.estimatedCost() == null ? null : c.estimatedCost().amount()));
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 地址属性识别:只读,判定商业 / 住宅。
|
|
|
|
|
*
|
|
|
|
|
* <p>真机确认五项必填(street1 / city / state / postal / country)。</p>
|
|
|
|
|
*/
|
|
|
|
|
@Test
|
|
|
|
|
void probeAddressClassification() {
|
|
|
|
|
assumeToken();
|
|
|
|
|
run("POST /v2/api/shipping/addressClassification", new Runnable() {
|
|
|
|
|
@Override
|
|
|
|
|
public void run() {
|
|
|
|
|
AddressType type = adapter().classifyAddress(ctx(),
|
|
|
|
|
"351 S Waterman Ave", null, "San Bernardino", "CA", "92408", "US");
|
|
|
|
|
System.out.println(" 地址属性=" + type);
|
|
|
|
|
}
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
}
|