1.1.53 按照新发货单模板进行导出。

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 导出数据（模板：发货单-海威物联-矩多智能）。
      * <p>
-     * 根据 {@code word.md} 中定义的模板结构，组装主表字段和明细列表数据，供 poi-tl 渲染使用。
-     * 约定如下：
-     * <ul>
-     *     <li>主表字段：如 customerName、receiverName、receiverPhone、shippingDate、contractCode 等，对应 Word 模板中的
-     *     {{customerName}}、{{receiverName}}、{{receiverPhone}}、{{shippingDate}}、{{contractCode}} 等占位符；</li>
-     *     <li>明细列表：使用 {@code details} 作为列表占位符，内部每一行包含 seq、materialName、quantity、unit、remark 等字段，
-     *     对应 Word 模板表格中的 {{seq}}、{{materialName}}、{{quantity}}、{{unit}}、{{remark}}。</li>
-     * </ul>
-     *
-     * @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<String, Object> 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<String, Object> 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<RowRenderData> detailRows = new ArrayList<>();
         List<WmsShippingDetailsVo> 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;
+    }
 }

ruoyi-modules/ruoyi-wms/src/main/java/org/dromara/wms/word/WmsShippingDetailTablePolicy.java

@@ -20,7 +20,7 @@ import java.util.List;
  * 模板中只需放置一个占位符 {{detailsTable}}，本策略会自动删除模板行并插入实际明细数据。
  * <p>
  * 使用方式（与当前 Controller 实现保持一致）：
- * 1) Word 模板中画一个 5 列表格（序号/名称/数量/单位/备注），至少包含“表头行 + 模板行”。
+ * 1) Word 模板中画一个 5 列表格（序号/产品名称/规格型号/数量/备注），至少包含“表头行 + 模板行”。
  *    在“模板行”的任意单元格中放置占位符 {{detailsTable}}。
  * 2) Service 侧将明细数据转换为 {@code List<RowRenderData>}，并放入 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;