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)
*/ public final class HengjianBoxLabelMapper { /** 打印份数:一式一份。 */ static final int COPIES_ONE = 1; /** 打印份数:一式两份。 */ static final int COPIES_TWO = 2; private HengjianBoxLabelMapper() { } /** * 统一命令 → 恒健请求。 * *

{@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; } }