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.
104 lines
4.5 KiB
104 lines
4.5 KiB
|
3 days ago
|
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})。
|
||
|
|
*
|
||
|
|
* <h2>真机确认的必填项</h2>
|
||
|
|
* <p>{@code inboundPlanOrderNo} / {@code type} / {@code pageSize} / {@code isIndexNo} /
|
||
|
|
* {@code isOriginCountry}——五项缺一不可,空 body 时仓方一次性列出所有缺失项。</p>
|
||
|
|
*
|
||
|
|
* <h2>响应没有任务号</h2>
|
||
|
|
* <p>只有 {@code code / message}(「生成箱标成功」),<b>不回任务号也不回文件</b>。
|
||
|
|
* 文件要从入库计划详情({@code getInboundPlanInfo})的 {@code packingLabelUrl} 里取。
|
||
|
|
* 所以 {@link LabelPrintTask#taskNo()} 恒为 null——不代表调用失败。</p>
|
||
|
|
*
|
||
|
|
* <h2>与运去哪字段口径不同</h2>
|
||
|
|
* <table border="1">
|
||
|
|
* <tr><th>统一模型</th><th>恒健</th><th>说明</th></tr>
|
||
|
|
* <tr><td>{@code twoCopies}</td><td>{@code type} 1/2</td>
|
||
|
|
* <td>恒健是<b>份数</b>码(1 一式一份 / 2 一式两份),不是布尔</td></tr>
|
||
|
|
* <tr><td>{@code labelsPerPage}</td><td>{@code pageSize}</td>
|
||
|
|
* <td>1 或 6;与运去哪同值</td></tr>
|
||
|
|
* <tr><td>{@code sizeType} / {@code downloadMode}</td><td>—</td>
|
||
|
|
* <td>恒健没有这两个口径,改用 {@code paperType}(1 A4 / 2 10×10)</td></tr>
|
||
|
|
* </table>
|
||
|
|
*/
|
||
|
|
public final class HengjianBoxLabelMapper {
|
||
|
|
|
||
|
|
/** 打印份数:一式一份。 */
|
||
|
|
static final int COPIES_ONE = 1;
|
||
|
|
/** 打印份数:一式两份。 */
|
||
|
|
static final int COPIES_TWO = 2;
|
||
|
|
|
||
|
|
private HengjianBoxLabelMapper() {
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 统一命令 → 恒健请求。
|
||
|
|
*
|
||
|
|
* <p>{@code showIndexNo} / {@code showOriginCountry} 在统一模型里是 null-able,
|
||
|
|
* 但恒健<b>标必填</b>——没给时拒绝而不是替调用方猜一个值:
|
||
|
|
* 猜「是」会让每箱多印一行,猜「否」会漏印。</p>
|
||
|
|
*
|
||
|
|
* @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;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 响应 → 任务。
|
||
|
|
*
|
||
|
|
* <p>恒健只回成功,没有任务号也没有文件——两者都留 null,不编。</p>
|
||
|
|
*/
|
||
|
|
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;
|
||
|
|
}
|
||
|
|
}
|