diff --git a/ruoyi-modules/ruoyi-wms/src/main/java/org/dromara/wms/service/impl/WmsShippingBillServiceImpl.java b/ruoyi-modules/ruoyi-wms/src/main/java/org/dromara/wms/service/impl/WmsShippingBillServiceImpl.java index 7272d215..a2316957 100644 --- a/ruoyi-modules/ruoyi-wms/src/main/java/org/dromara/wms/service/impl/WmsShippingBillServiceImpl.java +++ b/ruoyi-modules/ruoyi-wms/src/main/java/org/dromara/wms/service/impl/WmsShippingBillServiceImpl.java @@ -509,74 +509,63 @@ public class WmsShippingBillServiceImpl implements IWmsShippingBillService { } /** - * 组装发货单 Word 导出数据。 + * 组装发货单 Word 导出数据(模板:发货单-海威物联-矩多智能)。 *

- * 根据 {@code word.md} 中定义的模板结构,组装主表字段和明细列表数据,供 poi-tl 渲染使用。 - * 约定如下: - *

- * - * @param shippingBillId 发货单ID - * @return Word 模板数据 Map,建议直接传给 {@link org.dromara.common.word.util.WordTemplateUtil} + * 主表占位符:shippingCode、shippingDate、customerName、contactName、shippingAddress、 + * receiverPhone、contractCode、contactUser、contactNumber、shippingUnit、customerSign。 + * 明细表 {{detailsTable}}:序号、产品名称、规格型号、数量(含单位)、备注。 */ @Override public Map buildWordExportData(Long shippingBillId) { - // 查询发货单(包含明细列表) WmsShippingBillVo vo = queryById(shippingBillId); if (vo == null) { throw new ServiceException("发货单不存在,ID:" + shippingBillId); } - SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); + SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd"); Map data = new HashMap<>(); - // === 主表字段 === - // 客户名称 - data.put("customerName", StringUtils.blankToDefault(vo.getCustomerName(), "")); - // 收货联系人(客户侧) - data.put("receiverName", StringUtils.blankToDefault(vo.getReceiverName(), "")); - // 收货联系电话(客户侧) - data.put("receiverPhone", StringUtils.blankToDefault(vo.getReceiverPhone(), "")); - // 发货日期(实际发货时间) + data.put("shippingCode", StringUtils.blankToDefault(vo.getShippingCode(), "")); data.put("shippingDate", vo.getShippingTime() != null ? sdf.format(vo.getShippingTime()) : ""); - // 合同编号 + data.put("customerName", StringUtils.blankToDefault(vo.getCustomerName(), "")); + data.put("receiverName", StringUtils.blankToDefault(vo.getReceiverName(), "")); + data.put("receiverPhone", StringUtils.blankToDefault(vo.getReceiverPhone(), "")); + data.put("shippingAddress", StringUtils.blankToDefault(vo.getShippingAddress(), "")); data.put("contractCode", StringUtils.blankToDefault(vo.getContractCode(), "")); - // 收货日期(留空,由客户签收时填写) - data.put("receivedDate", ""); - // === 落款信息(供应商/发货方) === - // 发货单位(供应商名称) - data.put("shippingUnit", StringUtils.blankToDefault(vo.getSupplier(), "")); - // 发货人(供应商联系人) - data.put("shipper", StringUtils.blankToDefault(vo.getContactUser(), "")); - // 发货方联系电话 + data.put("contactUser", StringUtils.blankToDefault(vo.getContactUser(), "")); data.put("contactNumber", StringUtils.blankToDefault(vo.getContactNumber(), "")); - // === 明细列表(使用 DynamicTableRenderPolicy 动态表格渲染) === - // 对应 Word 模板中的 {{detailsTable}} 占位符,由 WmsShippingDetailTablePolicy 策略处理 - // 表格列顺序:序号、名称、数量、单位、备注 List detailRows = new ArrayList<>(); List itemsVo = vo.getItemsVo(); if (CollUtil.isNotEmpty(itemsVo)) { int seq = 1; for (WmsShippingDetailsVo item : itemsVo) { - // 构建行数据:序号、名称、数量、单位、备注(poi-tl 1.12.x 使用 Rows.of().create()) + String qtyText = formatShippingQuantity(item.getShippingStockAmount(), item.getUnitName()); RowRenderData row = Rows.of( String.valueOf(seq++), StringUtils.blankToDefault(item.getMaterialName(), ""), - item.getShippingStockAmount() != null ? item.getShippingStockAmount().toPlainString() : "", - StringUtils.blankToDefault(item.getUnitName(), ""), + StringUtils.blankToDefault(item.getMaterielSpecification(), ""), + qtyText, StringUtils.blankToDefault(item.getRemark(), "") ).create(); detailRows.add(row); } } - // DynamicTableRenderPolicy 表格占位符,由 WmsShippingDetailTablePolicy 渲染 data.put("detailsTable", detailRows); - return data; } + + /** + * 数量列:数量 + 单位 + */ + private String formatShippingQuantity(java.math.BigDecimal amount, String unitName) { + if (amount == null) { + return StringUtils.blankToDefault(unitName, ""); + } + String qty = amount.stripTrailingZeros().toPlainString(); + if (StringUtils.isNotBlank(unitName)) { + return qty + unitName; + } + return qty; + } } diff --git a/ruoyi-modules/ruoyi-wms/src/main/java/org/dromara/wms/word/WmsShippingDetailTablePolicy.java b/ruoyi-modules/ruoyi-wms/src/main/java/org/dromara/wms/word/WmsShippingDetailTablePolicy.java index 034fa90b..db66a8c4 100644 --- a/ruoyi-modules/ruoyi-wms/src/main/java/org/dromara/wms/word/WmsShippingDetailTablePolicy.java +++ b/ruoyi-modules/ruoyi-wms/src/main/java/org/dromara/wms/word/WmsShippingDetailTablePolicy.java @@ -20,7 +20,7 @@ import java.util.List; * 模板中只需放置一个占位符 {{detailsTable}},本策略会自动删除模板行并插入实际明细数据。 *

* 使用方式(与当前 Controller 实现保持一致): - * 1) Word 模板中画一个 5 列表格(序号/名称/数量/单位/备注),至少包含“表头行 + 模板行”。 + * 1) Word 模板中画一个 5 列表格(序号/产品名称/规格型号/数量/备注),至少包含“表头行 + 模板行”。 * 在“模板行”的任意单元格中放置占位符 {{detailsTable}}。 * 2) Service 侧将明细数据转换为 {@code List},并放入 data:{@code data.put("detailsTable", rows)}。 * 3) Controller 侧使用 {@code Configure.builder().bind("detailsTable", new WmsShippingDetailTablePolicy()).build()} 绑定策略, @@ -46,7 +46,7 @@ public class WmsShippingDetailTablePolicy extends DynamicTableRenderPolicy { private static final int DETAIL_START_ROW = 1; /** - * 表格列数(序号、名称、数量、单位、备注) + * 表格列数(序号、产品名称、规格型号、数量、备注) */ private static final int COLUMN_COUNT = 5; diff --git a/ruoyi-modules/ruoyi-wms/src/main/resources/发货单模板.docx b/ruoyi-modules/ruoyi-wms/src/main/resources/发货单模板.docx index 5c20c8ce..fe001e2a 100644 Binary files a/ruoyi-modules/ruoyi-wms/src/main/resources/发货单模板.docx and b/ruoyi-modules/ruoyi-wms/src/main/resources/发货单模板.docx differ