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 渲染使用。
- * 约定如下:
- *
- * - 主表字段:如 customerName、receiverName、receiverPhone、shippingDate、contractCode 等,对应 Word 模板中的
- * {{customerName}}、{{receiverName}}、{{receiverPhone}}、{{shippingDate}}、{{contractCode}} 等占位符;
- * - 明细列表:使用 {@code details} 作为列表占位符,内部每一行包含 seq、materialName、quantity、unit、remark 等字段,
- * 对应 Word 模板表格中的 {{seq}}、{{materialName}}、{{quantity}}、{{unit}}、{{remark}}。
- *
- *
- * @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