From 93e85bfeb70f37b2f0637213f0177b77288bbed5 Mon Sep 17 00:00:00 2001
From: lml <1297555865@qq.com>
Date: Tue, 17 Nov 2026 11:50:09 +0800
Subject: [PATCH] =?UTF-8?q?feat(hengjian):=20=E5=AF=B9=E6=8E=A5=E5=85=A5?=
=?UTF-8?q?=E5=BA=93=E7=AE=B1=E6=A0=87=E7=94=9F=E6=88=90=20/v2/inbound/box?=
=?UTF-8?q?LabelGenerate?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
真机确认必填五项:inboundPlanOrderNo / type / pageSize / isIndexNo /
isOriginCountry(空 body 时仓方一次性列出全部缺失项);paperType 与
fileNamingType 选填。
- 响应无 data:只有 code/message,不回任务号也不回文件,文件要去
入库计划详情的 packingLabelUrl 取。所以 LabelPrintTask.taskNo 恒为
null,不代表调用失败
- 份数口径不同:twoCopies → type 1 一式一份 / 2 一式两份,是份数码
不是布尔
- 恒健没有 sizeType / downloadMode 口径,改用 paperType(1 A4 /
2 10×10);labelsPerPage 直接映射 pageSize
- isIndexNo / isOriginCountry 仓方标必填,统一模型是 null-able:
null 时本地拒绝而不是猜——猜「是」每箱多印一行,猜「否」漏印
- core LabelPrintTask.taskNo 改为可空;BoxLabelCommand 补
showIndexNo / showOriginCountry / paperTypeCode / fileNamingType
顺带修正一处笔误:AddressClassificationCapable 的 @param city
被改成「必」,恢复为「必填」。
验证:mvn test 全量通过,恒健 340 个用例(+11)通过。
Co-Authored-By: Claude Code 恒健 {@code isIndexNo}(1 是 / 0 否)标必填;运去哪没有这个开关。 恒健 {@code isOriginCountry}(1 是 / 0 否)标必填;运去哪没有这个开关。 恒健 {@code paperType}:1 A4 / 2 10×10。与 {@link #sizeType()} 不是同一套口径:
+ * 那个是标签纸物理尺寸(100×100 之类),这个是 PDF 排版样式。 恒健 {@code fileNamingType}:0 按入库计划名 / 1 按来源单号命名。
{@link #label()} 在任务已同步完成、仓方直接返回文件时才有值;异步生成的仓恒为 null。
+ * + *{@link #taskNo()} 可能为 null:有的仓(恒健)的箱标接口只回「成功」, + * 不给任务号,文件要回入库计划详情里取。这类仓的 {@code taskNo} 恒为 null, + * 调用方不要拿它当「调用失败」——看有没有抛异常。
*/ public final class LabelPrintTask { @@ -23,7 +27,8 @@ public final class LabelPrintTask { private LabelPrintTask(Builder b) { this.sourceProvider = b.sourceProvider; - this.taskNo = require(b.taskNo, "taskNo"); + // taskNo 允许为空:恒健的箱标接口只回成功,不给任务号 + this.taskNo = b.taskNo; this.providerInboundNo = b.providerInboundNo; this.inboundRequestNo = b.inboundRequestNo; this.label = b.label; @@ -37,7 +42,12 @@ public final class LabelPrintTask { return sourceProvider; } - /** 任务编号;用它去任务中心查下载地址。 */ + /** + * 任务编号;用它去任务中心查下载地址。 + * + *为 null 表示仓方没给任务号(恒健),文件要从入库计划详情里取, + * 不代表调用失败。
+ */ public String taskNo() { return taskNo; } diff --git a/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/HengjianConstants.java b/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/HengjianConstants.java index b6d7d60..cfdb12e 100644 --- a/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/HengjianConstants.java +++ b/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/HengjianConstants.java @@ -308,6 +308,15 @@ public final class HengjianConstants { public static final String PATH_DESTRUCTION_FIND = "/v2/destroyPlanOrder/find"; /** + * 入库箱标生成({@code POST})。 + * + *真机确认必填:{@code inboundPlanOrderNo} / {@code type} / {@code pageSize} / + * {@code isIndexNo} / {@code isOriginCountry}。响应无 data(只有 message), + * 不回任务号也不回文件——文件从入库计划详情的 {@code packingLabelUrl} 取。
+ */ + public static final String PATH_INBOUND_BOX_LABEL = "/v2/inbound/boxLabelGenerate"; + + /** * {@code btChargeAt} 的日期区间分隔符。 * *文档示例是 {@code "2025-01-01 ~ 2025-02-01"}(前后各一个空格)。
diff --git a/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/adapter/HengjianAdapter.java b/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/adapter/HengjianAdapter.java index a266224..43dc664 100644 --- a/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/adapter/HengjianAdapter.java +++ b/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/adapter/HengjianAdapter.java @@ -4,6 +4,7 @@ import com.fasterxml.jackson.databind.JsonNode; import common.ecommerce.hengjian.dto.HengjianAddressClassificationDtos; import common.ecommerce.hengjian.dto.HengjianCancelOrderDtos; import common.ecommerce.hengjian.dto.HengjianCarrierGroupDtos; +import common.ecommerce.hengjian.dto.HengjianBoxLabelDtos; import common.ecommerce.hengjian.dto.HengjianCreateOrderDtos; import common.ecommerce.hengjian.dto.HengjianDestructionDtos; import common.ecommerce.hengjian.dto.HengjianFeeEstimateDtos; @@ -64,6 +65,7 @@ import common.ecommerce.warehouse.error.OutboundCancelBlockedException; import common.ecommerce.warehouse.error.WarehouseException; import common.ecommerce.warehouse.model.BillingDocument; import common.ecommerce.warehouse.model.CancelCommand; +import common.ecommerce.warehouse.model.BoxLabelCommand; import common.ecommerce.warehouse.model.DestructionCommand; import common.ecommerce.warehouse.model.DestructionOrder; import common.ecommerce.warehouse.model.CancelResult; @@ -75,6 +77,7 @@ import common.ecommerce.warehouse.model.InboundOrder; import common.ecommerce.warehouse.model.InboundQuery; import common.ecommerce.warehouse.model.InboundReceipt; import common.ecommerce.warehouse.model.InventoryMovement; +import common.ecommerce.warehouse.model.LabelPrintTask; import common.ecommerce.warehouse.model.InventoryMovementQuery; import common.ecommerce.warehouse.model.InventoryQuery; import common.ecommerce.warehouse.model.InventorySnapshot; @@ -144,6 +147,7 @@ public final class HengjianAdapter implements WarehouseDirectoryCapable, Logisti private static final String OP_INBOUND_CREATE = "warehouse.inbound.create"; private static final String OP_INBOUND_GET = "warehouse.inbound.get"; private static final String OP_INBOUND_QUERY = "warehouse.inbound.query"; + private static final String OP_INBOUND_BOX_LABEL = "warehouse.inbound.boxLabel"; private static final String OP_TRANSFER_CREATE = "warehouse.transfer.create"; private static final String OP_TRANSFER_QUERY = "warehouse.transfer.query"; private static final String OP_TRANSFER_CANCEL = "warehouse.transfer.cancel"; @@ -192,6 +196,7 @@ public final class HengjianAdapter implements WarehouseDirectoryCapable, Logisti WarehouseCapability.TRACKING_CHANGE, WarehouseCapability.INVENTORY_QUERY, WarehouseCapability.INBOUND, + WarehouseCapability.BOX_LABEL, WarehouseCapability.TRANSFER, WarehouseCapability.RETURN, WarehouseCapability.DESTRUCTION, @@ -524,6 +529,31 @@ public final class HengjianAdapter implements WarehouseDirectoryCapable, Logisti } /** + * 生成入库箱标({@code POST /v2/inbound/boxLabelGenerate})。 + * + *响应没有任务号也没有文件:只有 {@code code / message}。 + * 文件要从入库计划详情的 {@code packingLabelUrl} 取,所以返回的 + * {@link LabelPrintTask#taskNo()} 为 null——不代表调用失败。
+ * + *恒健要求 {@code isIndexNo} / {@code isOriginCountry} 必填,统一模型里是 + * null-able;没给时本地拒绝而不是猜一个值(猜错会多印或漏印一行)。
+ * + *尺寸 / 每页数量的联动约束由 {@link BoxLabelCommand} 构造期校验; + * 恒健没有 {@code sizeType} / {@code downloadMode} 口径,改用 {@code paperType}。
+ */ + @Override + public LabelPrintTask printBoxLabel(WarehouseContext ctx, BoxLabelCommand cmd) { + String fallback = trimToNull(ctx.providerWarehouseId()); + if (fallback == null) { + fallback = trimToNull(cmd.inboundRequestNo()); + } + HengjianBoxLabelDtos.BoxLabelRequest body = + HengjianBoxLabelMapper.toRequest(cmd, fallback); + execute(ctx, HengjianConstants.PATH_INBOUND_BOX_LABEL, body, OP_INBOUND_BOX_LABEL); + return HengjianBoxLabelMapper.toTask(cmd, fallback); + } + + /** * 按游标分页查入库单。 * *统一模型这个入口只有一个游标,恒健的列表接口支持多条件;这里把游标当页码, diff --git a/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/adapter/HengjianBoxLabelMapper.java b/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/adapter/HengjianBoxLabelMapper.java new file mode 100644 index 0000000..662f217 --- /dev/null +++ b/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/adapter/HengjianBoxLabelMapper.java @@ -0,0 +1,103 @@ +package common.ecommerce.hengjian.adapter; + +import common.ecommerce.hengjian.dto.HengjianBoxLabelDtos; +import common.ecommerce.warehouse.enums.WarehouseProvider; +import common.ecommerce.warehouse.model.BoxLabelCommand; +import common.ecommerce.warehouse.model.LabelPrintTask; + +/** + * 恒健入库箱标映射({@code POST /v2/inbound/boxLabelGenerate})。 + * + *
{@code inboundPlanOrderNo} / {@code type} / {@code pageSize} / {@code isIndexNo} / + * {@code isOriginCountry}——五项缺一不可,空 body 时仓方一次性列出所有缺失项。
+ * + *只有 {@code code / message}(「生成箱标成功」),不回任务号也不回文件。 + * 文件要从入库计划详情({@code getInboundPlanInfo})的 {@code packingLabelUrl} 里取。 + * 所以 {@link LabelPrintTask#taskNo()} 恒为 null——不代表调用失败。
+ * + *| 统一模型 | 恒健 | 说明 |
|---|---|---|
| {@code twoCopies} | {@code type} 1/2 | + *恒健是份数码(1 一式一份 / 2 一式两份),不是布尔 |
| {@code labelsPerPage} | {@code pageSize} | + *1 或 6;与运去哪同值 |
| {@code sizeType} / {@code downloadMode} | — | + *恒健没有这两个口径,改用 {@code paperType}(1 A4 / 2 10×10) |
{@code showIndexNo} / {@code showOriginCountry} 在统一模型里是 null-able, + * 但恒健标必填——没给时拒绝而不是替调用方猜一个值: + * 猜「是」会让每箱多印一行,猜「否」会漏印。
+ * + * @param cmd 统一命令 + * @param fallbackNo 命令里没给仓单号时的回退值(账户仓 id 或来源单号) + * @throws IllegalArgumentException 缺必填开关 + */ + public static HengjianBoxLabelDtos.BoxLabelRequest toRequest(BoxLabelCommand cmd, + String fallbackNo) { + String planNo = firstNonBlank(cmd.providerInboundNo(), fallbackNo); + if (planNo == null) { + throw new IllegalArgumentException( + "hengjian box label requires inboundPlanOrderNo; none given and account has none"); + } + if (cmd.showIndexNo() == null) { + throw new IllegalArgumentException( + "hengjian box label requires showIndexNo (1 是 / 0 否,仓方必填);" + + "给 null 会让每箱是否印序号变成猜的"); + } + if (cmd.showOriginCountry() == null) { + throw new IllegalArgumentException( + "hengjian box label requires showOriginCountry (1 是 / 0 否,仓方必填)"); + } + + HengjianBoxLabelDtos.BoxLabelRequest req = new HengjianBoxLabelDtos.BoxLabelRequest(); + req.inboundPlanOrderNo = planNo; + req.type = cmd.twoCopies() ? COPIES_TWO : COPIES_ONE; + req.pageSize = cmd.labelsPerPage().count(); + req.isIndexNo = cmd.showIndexNo() ? 1 : 0; + req.isOriginCountry = cmd.showOriginCountry() ? 1 : 0; + req.paperType = cmd.paperTypeCode(); + req.fileNamingType = cmd.fileNamingType(); + return req; + } + + /** + * 响应 → 任务。 + * + *恒健只回成功,没有任务号也没有文件——两者都留 null,不编。
+ */ + public static LabelPrintTask toTask(BoxLabelCommand cmd, String fallbackNo) { + return LabelPrintTask.builder() + .sourceProvider(WarehouseProvider.HENGJIAN) + // taskNo 为 null:恒健不回任务号,文件从入库计划详情的 packingLabelUrl 取 + .providerInboundNo(firstNonBlank(cmd.providerInboundNo(), fallbackNo)) + .inboundRequestNo(cmd.inboundRequestNo()) + .build(); + } + + private static String firstNonBlank(String a, String b) { + if (a != null && !a.trim().isEmpty()) { + return a.trim(); + } + if (b != null && !b.trim().isEmpty()) { + return b.trim(); + } + return null; + } +} diff --git a/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/dto/HengjianBoxLabelDtos.java b/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/dto/HengjianBoxLabelDtos.java new file mode 100644 index 0000000..4031136 --- /dev/null +++ b/warehouse-sdk-hengjian/src/main/java/common/ecommerce/hengjian/dto/HengjianBoxLabelDtos.java @@ -0,0 +1,56 @@ +package common.ecommerce.hengjian.dto; + +import com.fasterxml.jackson.annotation.JsonInclude; + +/** + * 恒健报文结构:入库箱标生成({@code POST /v2/inbound/boxLabelGenerate})。 + * + *真机确认的必填项(空 body 触发的校验信息):
+ *+ * inboundPlanOrderNo(单号不能为空) + * type(类型不能为空) + * pageSize(每页个数不能为空) + * isIndexNo(是否生成数字标不能为空) + * isOriginCountry(是否展示原产地不能为空) + *+ *
{@code paperType} / {@code fileNamingType} 选填。
+ * + *响应无 data:只有 {@code code / message},不回任务号、不回文件。
+ */ +public final class HengjianBoxLabelDtos { + + private HengjianBoxLabelDtos() { + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public static final class BoxLabelRequest { + + /** 入库计划单号;必填。 */ + public String inboundPlanOrderNo; + + /** 打印份数:1 一式一份 / 2 一式两份;必填。 */ + public Integer type; + + /** 每页箱标个数:1 或 6;必填。 */ + public Integer pageSize; + + /** 是否生成数字标:1 是 / 0 否;必填。 */ + public Integer isIndexNo; + + /** 是否展示原产地:1 是 / 0 否;必填。 */ + public Integer isOriginCountry; + + /** PDF 样式:1 A4 / 2 10×10;不填默认 1(A4)。 */ + public Integer paperType; + + /** 文件命名类型:0 按入库计划名 / 1 按来源单号命名;不填默认 0。 */ + public Integer fileNamingType; + } + + /** 响应:无 data。 */ + public static final class BoxLabelResponse { + + public Integer code; + public String message; + } +} diff --git a/warehouse-sdk-hengjian/src/test/java/common/ecommerce/hengjian/adapter/HengjianBoxLabelTest.java b/warehouse-sdk-hengjian/src/test/java/common/ecommerce/hengjian/adapter/HengjianBoxLabelTest.java new file mode 100644 index 0000000..1e6a07b --- /dev/null +++ b/warehouse-sdk-hengjian/src/test/java/common/ecommerce/hengjian/adapter/HengjianBoxLabelTest.java @@ -0,0 +1,206 @@ +package common.ecommerce.hengjian.adapter; + +import common.ecommerce.hengjian.HengjianConstants; +import common.ecommerce.http.JacksonJsonCodec; +import common.ecommerce.shared.spi.ChannelSecret; +import common.ecommerce.shared.testkit.RecordingTransport; +import common.ecommerce.shared.testkit.Responses; +import common.ecommerce.warehouse.enums.LabelSizeType; +import common.ecommerce.warehouse.enums.LabelsPerPage; +import common.ecommerce.warehouse.enums.WarehouseCapability; +import common.ecommerce.warehouse.enums.WarehouseProvider; +import common.ecommerce.warehouse.model.BoxLabelCommand; +import common.ecommerce.warehouse.model.LabelPrintTask; +import common.ecommerce.warehouse.sdk.WarehouseConnection; +import common.ecommerce.warehouse.sdk.WarehouseContext; +import org.junit.jupiter.api.Test; + +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * 入库箱标生成({@code /v2/inbound/boxLabelGenerate})契约测试。 + */ +class HengjianBoxLabelTest { + + private static final WarehouseContext CTX = WarehouseContext.of( + "HJ-EFCA", WarehouseProvider.HENGJIAN, "EFCA", + WarehouseConnection.of(HengjianConstants.TEST_BASE_URL, + ChannelSecret.builder().appSecret("token-1").build()), + "req-1", Clock.fixed(Instant.parse("2026-11-17T00:00:00Z"), ZoneOffset.UTC)); + + private static final String OK_BODY = + "{\"statusCode\":200,\"status\":0,\"code\":200,\"message\":\"生成箱标成功\"}"; + + private static HengjianAdapter adapter(RecordingTransport transport) { + return new HengjianAdapter(transport, new JacksonJsonCodec()); + } + + private static RecordingTransport generating() { + return RecordingTransport.create() + .route(HengjianConstants.PATH_INBOUND_BOX_LABEL, req -> Responses.ok(OK_BODY)); + } + + private static BoxLabelCommand.Builder command() { + return BoxLabelCommand.builder() + .providerInboundNo("IP26052500012") + .inboundRequestNo("IB-1") + .sizeType(LabelSizeType.SIZE_100_100) + .labelsPerPage(LabelsPerPage.ONE) + .showIndexNo(true) + .showOriginCountry(true); + } + + // ---------------------------------------------------------------- 请求形状 + + @Test + void postsToBoxLabelGenerate() { + RecordingTransport transport = generating(); + adapter(transport).printBoxLabel(CTX, command().build()); + + assertEquals("POST", transport.lastDataRequest().method()); + assertEquals(HengjianConstants.TEST_BASE_URL + "/v2/inbound/boxLabelGenerate", + transport.lastDataRequest().url()); + } + + /** 真机确认的五个必填项都要出现。 */ + @Test + void sendsMandatoryFields() { + RecordingTransport transport = generating(); + adapter(transport).printBoxLabel(CTX, command().build()); + String body = transport.lastDataRequest().body(); + + String[] mandatory = {"inboundPlanOrderNo", "type", "pageSize", + "isIndexNo", "isOriginCountry"}; + for (String field : mandatory) { + assertTrue(body.contains("\"" + field + "\""), "缺少必填字段 " + field + ",body=" + body); + } + assertTrue(body.contains("\"inboundPlanOrderNo\":\"IP26052500012\""), body); + } + + /** 份数:twoCopies → type 1/2(恒健是份数码,不是布尔)。 */ + @Test + void twoCopiesMapsToTypeOneOrTwo() { + RecordingTransport one = generating(); + adapter(one).printBoxLabel(CTX, command().twoCopies(false).build()); + assertTrue(one.lastDataRequest().body().contains("\"type\":1")); + + RecordingTransport two = generating(); + adapter(two).printBoxLabel(CTX, command().twoCopies(true).build()); + assertTrue(two.lastDataRequest().body().contains("\"type\":2")); + } + + /** 每页数量 1 / 6 直接下发。 */ + @Test + void labelsPerPageMapsToPageSize() { + RecordingTransport one = generating(); + adapter(one).printBoxLabel(CTX, command().labelsPerPage(LabelsPerPage.ONE).build()); + assertTrue(one.lastDataRequest().body().contains("\"pageSize\":1")); + + RecordingTransport six = generating(); + adapter(six).printBoxLabel(CTX, command() + .labelsPerPage(LabelsPerPage.SIX).sizeType(LabelSizeType.SIZE_104_98).build()); + assertTrue(six.lastDataRequest().body().contains("\"pageSize\":6")); + } + + /** 开关:1 是 / 0 否。 */ + @Test + void booleanFlagsMapToOneZero() { + RecordingTransport transport = generating(); + adapter(transport).printBoxLabel(CTX, command() + .showIndexNo(false).showOriginCountry(true).build()); + String body = transport.lastDataRequest().body(); + + assertTrue(body.contains("\"isIndexNo\":0"), body); + assertTrue(body.contains("\"isOriginCountry\":1"), body); + } + + /** 选填的 paperType / fileNamingType 给了才发。 */ + @Test + void optionalFieldsOnlyWhenGiven() { + RecordingTransport absent = generating(); + adapter(absent).printBoxLabel(CTX, command().build()); + assertFalse(absent.lastDataRequest().body().contains("paperType")); + assertFalse(absent.lastDataRequest().body().contains("fileNamingType")); + + RecordingTransport present = generating(); + adapter(present).printBoxLabel(CTX, command() + .paperTypeCode(1).fileNamingType(1).build()); + String body = present.lastDataRequest().body(); + assertTrue(body.contains("\"paperType\":1"), body); + assertTrue(body.contains("\"fileNamingType\":1"), body); + } + + // ---------------------------------------------------------------- 本地校验 + + /** 仓方必填的两个开关没给时拒绝,不猜(猜错会多印或漏印一行)。 */ + @Test + void rejectsMissingRequiredFlags() { + RecordingTransport transport = generating(); + HengjianAdapter adapter = adapter(transport); + + IllegalArgumentException noIndex = assertThrows(IllegalArgumentException.class, + () -> adapter.printBoxLabel(CTX, BoxLabelCommand.builder() + .providerInboundNo("IP1").inboundRequestNo("IB-1") + .showOriginCountry(true).build())); + assertTrue(noIndex.getMessage().contains("showIndexNo"), noIndex.getMessage()); + + IllegalArgumentException noOrigin = assertThrows(IllegalArgumentException.class, + () -> adapter.printBoxLabel(CTX, BoxLabelCommand.builder() + .providerInboundNo("IP1").inboundRequestNo("IB-1") + .showIndexNo(true).build())); + assertTrue(noOrigin.getMessage().contains("showOriginCountry"), noOrigin.getMessage()); + + assertTrue(transport.dataRequests().isEmpty()); + } + + /** 尺寸 / 每页数量的联动约束在 BoxLabelCommand 构造期已挡。 */ + @Test + void commandRejectsIncompatibleSizeAndPerPage() { + assertThrows(IllegalArgumentException.class, () -> BoxLabelCommand.builder() + .providerInboundNo("IP1").inboundRequestNo("IB-1") + .sizeType(LabelSizeType.SIZE_104_98).labelsPerPage(LabelsPerPage.ONE) + .showIndexNo(true).showOriginCountry(true).build()); + } + + // ---------------------------------------------------------------- 响应 + + /** 恒健不回任务号:taskNo 为 null,不代表失败。 */ + @Test + void taskHasNoTaskNo() { + LabelPrintTask task = adapter(generating()).printBoxLabel(CTX, command().build()); + + assertNull(task.taskNo(), "恒健不回任务号,文件从入库计划详情的 packingLabelUrl 取"); + assertNull(task.label(), "同步也没有文件"); + assertEquals("IP26052500012", task.providerInboundNo()); + assertEquals("IB-1", task.inboundRequestNo()); + assertEquals(WarehouseProvider.HENGJIAN, task.sourceProvider()); + } + + @Test + void businessErrorIsPropagated() { + RecordingTransport transport = RecordingTransport.create() + .route(HengjianConstants.PATH_INBOUND_BOX_LABEL, req -> Responses.ok( + "{\"statusCode\":500,\"status\":1,\"code\":999999," + + "\"message\":\"生成箱标失败\"}")); + + RuntimeException ex = assertThrows(RuntimeException.class, + () -> adapter(transport).printBoxLabel(CTX, command().build())); + assertTrue(ex.getMessage().contains("生成箱标失败"), ex.getMessage()); + } + + // ---------------------------------------------------------------- 能力位 + + @Test + void declaresBoxLabelCapability() { + assertTrue(adapter(RecordingTransport.create()).capabilities() + .contains(WarehouseCapability.BOX_LABEL)); + } +}