Skip to content
JQuickJQuick

Packing list — generate this PDF with Java (Template)

JQuick-PdfCustoms & Trade Demos

Template1 页 A4 · 26 KB

Bilingual PACKING LIST & MANIFEST layout.

Download the PDFView raw template fileBack to all demos

Packing list — Template
Rendered output

Output specs

PDF pages
1
Chart type
Template
Template lines
144
Source lines
206

Java source · JQuickBiz129PackingListManifest.java

This is the complete test class that produced the PDF above — copy it and run as-is; see the quick-start section for the Maven dependency.

/*
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * Copyright (c) [2025-2099] Martin ([email protected])
 */
package com.github.paohaijiao.biz.customs;

import com.github.paohaijiao.config.JPdfConfig;
import com.github.paohaijiao.executor.JQuickPdfFactory;

import java.io.File;
import java.io.IOException;
import java.math.BigDecimal;
import java.nio.file.Files;
import java.util.Arrays;
import java.util.LinkedHashMap;
import java.util.Map;

/**
 * 单据 129：装箱单 / 舱单（PACKING LIST & MANIFEST）（customs 领域第 5 项）。
 *
 * <p>本类为独立可运行 Demo：自带 {@code main} 方法、不依赖任何公共工具类或实体类，
 * 数据以 key-value 形式通过 {@link JQuickPdfFactory#bindAll(Map)} 注入，
 * 版式全部落在模板文件 {@code demo/biz/customs/129_packing_list_manifest.txt} 中。</p>
 *
 * <p>视觉主题「靛蓝·厚框·通栏」：主色 #2F728C、辅色 #91273A、浅底 #F1F5F6；
 * 版式为 banner 抬头 + chip 信息区 + solid 明细表 + three 签章区 + right 落款，
 * 与同领域其它单据互不重样。</p>
 *
 * <p>装箱单 / 舱单：船名航次与提单号、发货人与收货人、逐箱明细（净重 / 毛重 / 尺码），</p>
 * <p>合计件数与体积、发货人签章栏。</p>
 *
 * <p>运行后输出：{@code D:/test/pdf/129_packing_list_manifest.pdf}。</p>
 *
 * @author Martin
 * @version 1.0.0
 */
public class JQuickBiz129PackingListManifest {

    private static final String PDF_DIR = "D:/test/pdf/";
    private static final String OUT_FILE = PDF_DIR + "129_packing_list_manifest.pdf";
    private static final String TEMPLATE = "demo/biz/customs/129_packing_list_manifest.txt";

    /** 模板固定明细行数，不足时补空行，避免占位符原样输出。 */
    private static final int ITEM_ROWS = 6;

    public static void main(String[] args) throws IOException {
        new File(PDF_DIR).mkdirs();

        // ---------- 1. 数据（无实体类，直接 bind）----------
        String[][] items = {
                {"CTN-01 ~ 08", "伺服电机 / SERVO MOTOR", "SM-500W", "8 PCS", "320.00", "368.00", "0.86 CBM"},
                {"CTN-09 ~ 16", "精密齿轮箱 / GEAR BOX", "GB-120", "8 PCS", "1840.00", "1960.00", "2.44 CBM"},
                {"CTN-17 ~ 22", "运动控制卡 / CONTROL CARD", "MC-8020", "6 PCS", "48.00", "66.00", "0.42 CBM"},
                {"CTN-23 ~ 30", "三坐标测量仪 / CMM", "CMM-1210", "1 SET", "8600.00", "9200.00", "8.60 CBM"},
                {"CTN-31 ~ 44", "工业阀门组件 / VALVE", "IV-50", "24 SETS", "1104.00", "1218.00", "3.12 CBM"},
                {"CTN-45 ~ 46", "技术资料 / DOCUMENT", "—", "1 SET", "8.00", "48.00", "0.18 CBM"}
        };

        Map<String, Object> data = new LinkedHashMap<String, Object>();
        data.put("packingNo", "PL-2026-0918");
        data.put("packingDate", "2026年09月18日");
        data.put("vesselNo", "××轮 / V.2608");
        data.put("blNo", "COSU6123456780");
        data.put("shipper", "×× PRECISION MACHINERY PTE. LTD.");
        data.put("consignee", "××国际贸易有限公司");
        data.put("portInfo", "SINGAPORE / SHANGHAI");
        data.put("totalInfo", "46 CTNS / 12860 KGS");
        data.put("remark", "木质包装已加施 IPPC 标识；货物分 46 纸箱装载，箱号连续，唛头见箱体刷唛。");
        data.put("preparer", "苏见宁");
        data.put("reviewer", "柳文渊");
        data.put("signer", "×× PRECISION MACHINERY PTE. LTD.");

        // 明细逐格展开，并累计金额
        BigDecimal itemTotal = BigDecimal.ZERO;
        for (int i = 0; i < ITEM_ROWS; i++) {
            int n = i + 1;
            if (i >= items.length) {
                data.put("itemName" + n, "—");
                data.put("itemSpec" + n, "—");
                data.put("itemUnit" + n, "—");
                data.put("itemQty" + n, "—");
                data.put("itemPrice" + n, "—");
                data.put("itemAmount" + n, "—");
                data.put("itemTax" + n, "—");
                continue;
            }
            data.put("itemName" + n, items[i][0]);
            data.put("itemSpec" + n, items[i][1]);
            data.put("itemUnit" + n, items[i][2]);
            data.put("itemQty" + n, items[i][3]);
            itemTotal = itemTotal.add(new BigDecimal(items[i][4]));
            data.put("itemPrice" + n, items[i][4]);
            data.put("itemAmount" + n, items[i][5]);
            data.put("itemTax" + n, items[i][6]);
        }

        data.put("totalAmount", itemTotal.setScale(2, BigDecimal.ROUND_HALF_UP).toPlainString());

        data.put("netWeight", itemTotal.setScale(2, BigDecimal.ROUND_HALF_UP).toPlainString());

        data.put("grossWeight", new BigDecimal("12860.00").setScale(2, BigDecimal.ROUND_HALF_UP).toPlainString());

        data.put("measure", new BigDecimal("15.62").setScale(2, BigDecimal.ROUND_HALF_UP).toPlainString());

        // ---------- 2. 渲染 ----------
        JPdfConfig config = new JPdfConfig();
        config.getLayoutConfig().setFlexLayout(true);
        config.getDoc().setMargins(Arrays.asList(40, 40, 40, 40));
        config.getFontConfig().setDefaultFontName("Noto Sans CJK SC");
        config.getHeaderConfig().setEnabled(true);
        config.getHeaderConfig().setText("×× PRECISION MACHINERY PTE. LTD.　PACKING LIST　PL-2026-0918");
        config.getHeaderConfig().setFontSize(7.5f);
        config.getHeaderConfig().setHeight(28);
        config.getFooterConfig().setEnabled(true);
        config.getFooterConfig().setFontSize(8);
        config.getFooterConfig().setPageNumberFormat("第 %d 页");

        JQuickPdfFactory factory = new JQuickPdfFactory(config);
        factory.bindAll(data);
        byte[] pdf = factory.executeResource(TEMPLATE);
        Files.write(new File(OUT_FILE).toPath(), pdf);
        System.out.println("已生成：" + OUT_FILE + "（" + pdf.length + " 字节）");
    }

    /** 人民币金额转票据大写（元角分，末尾补「整」）。 */
    private static String toChineseAmount(BigDecimal amount) {
        String[] digits = {"零", "壹", "贰", "叁", "肆", "伍", "陆", "柒", "捌", "玖"};
        String[] units = {"", "拾", "佰", "仟"};
        String[] sections = {"", "万", "亿", "万亿"};
        long cents = amount.setScale(2, BigDecimal.ROUND_HALF_UP)
                .movePointRight(2).longValue();
        if (cents == 0) {
            return "零元整";
        }
        long yuan = cents / 100;
        int jiao = (int) (cents % 100 / 10);
        int fen = (int) (cents % 10);
        StringBuilder sb = new StringBuilder();
        if (yuan > 0) {
            sb.append(toChineseSection(yuan, digits, units, sections)).append("元");
        }
        if (jiao == 0 && fen == 0) {
            sb.append("整");
        } else {
            if (jiao > 0) {
                sb.append(digits[jiao]).append("角");
            } else if (yuan > 0) {
                sb.append("零");
            }
            if (fen > 0) {
                sb.append(digits[fen]).append("分");
            }
        }
        return sb.toString();
    }

    /** 整数部分按四位分节转大写。 */
    private static String toChineseSection(long value, String[] digits, String[] units, String[] sections) {
        StringBuilder sb = new StringBuilder();
        int sectionIndex = 0;
        boolean needZero = false;
        while (value > 0) {
            int section = (int) (value % 10000);
            StringBuilder part = new StringBuilder();
            int unitIndex = 0;
            boolean zeroInSection = false;
            int temp = section;
            while (temp > 0) {
                int digit = temp % 10;
                if (digit == 0) {
                    zeroInSection = true;
                } else {
                    if (zeroInSection || (needZero && part.length() == 0 && sb.length() > 0)) {
                        part.insert(0, digits[0]);
                    }
                    part.insert(0, units[unitIndex]);
                    part.insert(0, digits[digit]);
                    zeroInSection = false;
                    needZero = false;
                }
                unitIndex++;
                temp /= 10;
            }
            if (part.length() > 0) {
                part.append(sections[sectionIndex]);
            }
            sb.insert(0, part);
            needZero = section < 1000 && section > 0;
            value /= 10000;
            sectionIndex++;
        }
        return sb.toString();
    }
}

Minimal invocation (3 lines)

Skip the full test class — the core is these three lines: bind the chart SVG, execute the template, get the PDF bytes. Copy them straight into your project.

// config 可省略；svg 来自 JChartRendererFactory.renderChart(...)，见下方完整源码
byte[] pdf = new JQuickPdfFactory(config).executeResource("demo/biz/customs/129_packing_list_manifest.txt");

Template file · 129_packing_list_manifest.txt

An HTML-like template with inline CSS that renders to PDF once bound to data. The full template is below — copy it or download the raw file.

<pdf>
<body>
  // 129 装箱单 / 舱单（PACKING LIST & MANIFEST）（customs 领域第 5 项）　视觉主题：靛蓝·厚框·通栏
  // 版式组合：抬头=banner 信息区=chip 明细表=solid 段落=plain 签章=three 落款=right
  // 主色 #2F728C　辅色 #91273A　浅底 #F1F5F6
  // 装箱单与舱单：箱号、品名型号、数量、净重毛重与尺码，含总件数与总毛重。

  // 抬头：banner
  <table style="width:100%; marginBottom:6px">
    <tr>
      <td style="width:58%; padding:8px; backgroundColor:#2F728C; color:white; bold:true; fontSize:15pt; characterSpacing:4pt">'装箱单 / 舱单（PACKING LIST & MANIFEST）'</td>
      <td style="padding:8px; backgroundColor:#17546D; color:white; textAlign:right; fontSize:7.5pt">'装箱单号 '${packingNo}'　　日期 '${packingDate}'　　船名航次 '${vesselNo}</td>
    </tr>
  </table>

  // 信息区：chip
  <table style="width:100%; fontSize:8.5pt; marginBottom:8px">
    <tr>
      <td style="width:25%; padding:4px; border:1px solid #C1CFD5">'装箱单号 / PACKING NO.：'${packingNo}</td>
      <td style="width:25%; padding:4px; border:1px solid #C1CFD5">'日期 / DATE：'${packingDate}</td>
      <td style="width:25%; padding:4px; border:1px solid #C1CFD5">'船名航次 / VESSEL & VOY：'${vesselNo}</td>
      <td style="padding:4px; border:1px solid #C1CFD5">'提单号 / B/L NO.：'${blNo}</td>
    </tr>
    <tr>
      <td style="width:25%; padding:4px; border:1px solid #C1CFD5">'发货人 / SHIPPER：'${shipper}</td>
      <td style="width:25%; padding:4px; border:1px solid #C1CFD5">'收货人 / CONSIGNEE：'${consignee}</td>
      <td style="width:25%; padding:4px; border:1px solid #C1CFD5">'装运港 / 卸货港：'${portInfo}</td>
      <td style="padding:4px; border:1px solid #C1CFD5">'总件数 / 总毛重：'${totalInfo}</td>
    </tr>
  </table>

  <p style="fontSize:10.5pt; bold:true; color:#17546D; marginBottom:4px">'装箱明细 / PACKING DETAILS'</p>
  <table style="width:100%; fontSize:8pt; marginBottom:8px">
    <tr>
      <th style="width:12%; padding:4px; backgroundColor:#2F728C; color:white; bold:true; textAlign:center; border:1px solid #2F728C">'箱号 / CTN NO.'</th>
      <th style="width:24%; padding:4px; backgroundColor:#2F728C; color:white; bold:true; textAlign:center; border:1px solid #2F728C">'品名 / DESCRIPTION'</th>
      <th style="width:14%; padding:4px; backgroundColor:#2F728C; color:white; bold:true; textAlign:center; border:1px solid #2F728C">'型号 / MODEL'</th>
      <th style="width:10%; padding:4px; backgroundColor:#2F728C; color:white; bold:true; textAlign:center; border:1px solid #2F728C">'数量 / QTY'</th>
      <th style="width:12%; padding:4px; backgroundColor:#2F728C; color:white; bold:true; textAlign:center; border:1px solid #2F728C">'净重 / N.W.'</th>
      <th style="width:12%; padding:4px; backgroundColor:#2F728C; color:white; bold:true; textAlign:center; border:1px solid #2F728C">'毛重 / G.W.'</th>
      <th style="padding:4px; backgroundColor:#2F728C; color:white; bold:true; textAlign:center; border:1px solid #2F728C">'尺码 / MEAS.'</th>
    </tr>
    <tr>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemName1}</td>
      <td style="padding:4px; textAlign:left; border:1px solid #C1CFD5">${itemSpec1}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemUnit1}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemQty1}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemPrice1}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemAmount1}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemTax1}</td>
    </tr>
    <tr>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemName2}</td>
      <td style="padding:4px; textAlign:left; border:1px solid #C1CFD5">${itemSpec2}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemUnit2}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemQty2}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemPrice2}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemAmount2}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemTax2}</td>
    </tr>
    <tr>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemName3}</td>
      <td style="padding:4px; textAlign:left; border:1px solid #C1CFD5">${itemSpec3}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemUnit3}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemQty3}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemPrice3}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemAmount3}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemTax3}</td>
    </tr>
    <tr>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemName4}</td>
      <td style="padding:4px; textAlign:left; border:1px solid #C1CFD5">${itemSpec4}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemUnit4}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemQty4}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemPrice4}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemAmount4}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemTax4}</td>
    </tr>
    <tr>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemName5}</td>
      <td style="padding:4px; textAlign:left; border:1px solid #C1CFD5">${itemSpec5}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemUnit5}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemQty5}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemPrice5}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemAmount5}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemTax5}</td>
    </tr>
    <tr>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemName6}</td>
      <td style="padding:4px; textAlign:left; border:1px solid #C1CFD5">${itemSpec6}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemUnit6}</td>
      <td style="padding:4px; textAlign:center; border:1px solid #C1CFD5">${itemQty6}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemPrice6}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemAmount6}</td>
      <td style="padding:4px; textAlign:right; border:1px solid #C1CFD5">${itemTax6}</td>
    </tr>
    <tr>
      <td style="padding:4px; bold:true; backgroundColor:#F1F5F6; textAlign:center; border:1px solid #2F728C">'合计 / TOTAL'</td>
      <td style="padding:4px; backgroundColor:#F1F5F6; border:1px solid #2F728C">'—'</td>
      <td style="padding:4px; backgroundColor:#F1F5F6; border:1px solid #2F728C">'—'</td>
      <td style="padding:4px; bold:true; backgroundColor:#F1F5F6; textAlign:right; border:1px solid #2F728C">'48 件'</td>
      <td style="padding:4px; bold:true; backgroundColor:#F1F5F6; textAlign:right; border:1px solid #2F728C">${netWeight}' KGS'</td>
      <td style="padding:4px; bold:true; backgroundColor:#F1F5F6; textAlign:right; border:1px solid #2F728C">${grossWeight}' KGS'</td>
      <td style="padding:4px; bold:true; backgroundColor:#F1F5F6; textAlign:right; border:1px solid #2F728C">${measure}' CBM'</td>
    </tr>
  </table>

  // 段落：plain
  <p style="fontSize:10.5pt; bold:true; color:#17546D; marginBottom:3px">'备注 / REMARKS'</p>
  <p style="fontSize:9pt; marginBottom:6px">${remark}</p>

  // 签章区：three
  <!-- 签章占位区：后续加盖电子公章 / 骑缝章 / 打印二维码 -->
  <table style="width:100%; fontSize:8pt; marginBottom:8px">
    <tr>
      <td style="width:33%; padding:4px; bold:true; textAlign:center; color:#2F728C; border:1px dashed #2F728C">'（报关专用章 / 海关验讫章占位）'</td>
      <td style="width:33%; padding:4px; bold:true; textAlign:center; color:#2F728C; border:1px dashed #2F728C">'（骑缝章 / 二维码占位）'</td>
      <td style="width:33%; padding:4px; bold:true; textAlign:center; color:#2F728C; border:1px dashed #2F728C">'（二维码占位）'</td>
    </tr>
    <tr>
      <td style="width:33%; padding:4px; textAlign:center; color:#78838C; border:1px dashed #2F728C">'申报单位：'${shipper}</td>
      <td style="width:33%; padding:4px; textAlign:center; color:#78838C; border:1px dashed #2F728C">'骑缝章沿右边线骑缝加盖'</td>
      <td style="width:33%; padding:4px; textAlign:center; color:#78838C; border:1px dashed #2F728C">'扫码验真'</td>
    </tr>
    <tr>
      <td style="width:33%; padding:4px; textAlign:center; color:#78838C; border:1px dashed #2F728C">'签章日期：'${packingDate}</td>
      <td style="width:33%; padding:4px; textAlign:center; color:#78838C; border:1px dashed #2F728C">'二维码打印于右上角方框内'</td>
      <td style="width:33%; padding:4px; textAlign:center; color:#78838C; border:1px dashed #2F728C">'尺寸 22mm×22mm'</td>
    </tr>
  </table>

  // 落款：right
  <!-- 落款栏 -->
  <table style="width:100%; fontSize:9pt; marginTop:6px">
    <tr>
      <td style="width:24%; padding:4px">' '</td>
      <td style="width:38%; padding:4px; textAlign:center; color:#17546D">'制单 / PREPARED BY：'${preparer}</td>
      <td style="width:38%; padding:4px; textAlign:center; color:#17546D">'复核 / CHECKED BY：'${reviewer}</td>
      <td style="padding:4px; textAlign:center; color:#17546D">'发货人签章：'${signer}</td>
    </tr>
  </table>
</body>
</pdf>

More demos in this group

The PDF, preview image, template and source code on this page were all produced by a real JQuick-Pdf run and are free to copy into your own project.