跳转到内容
JQuickJQuick

Java 生成「报关小票·查验回执」PDF 示例（Template）

JQuick-Pdf海关外贸 Demo

Template1 页 A4 · 30 KB

报关小票 / 现场查验回执版式。

下载 PDF 文件查看模板原始文件返回全部示例

报关小票·查验回执 — Template
渲染效果

输出规格

PDF 页数
1
图表类型
Template
模板行数
158
源码行数
121

Java 源码 · JQuickBiz127DeclarationReceiptInspection.java

以下代码即生成上方 PDF 的完整测试类，可直接复制运行；Maven 依赖见快速开始章节。

/*
 * 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.nio.file.Files;
import java.util.Arrays;
import java.util.LinkedHashMap;
import java.util.Map;

/**
 * 单据 127：报关小票 / 现场查验回执（customs 领域第 3 项）。
 *
 * <p>本类为独立可运行 Demo：自带 {@code main} 方法、不依赖任何公共工具类或实体类，
 * 数据以 key-value 形式通过 {@link JQuickPdfFactory#bindAll(Map)} 注入，
 * 版式全部落在模板文件 {@code demo/biz/customs/127_declaration_receipt_inspection.txt} 中。</p>
 *
 * <p>视觉主题「靛蓝·疏朗·下线」：主色 #169DB8、辅色 #912747、浅底 #EFF6F8；
 * 版式为 underline 抬头 + kv 信息区 + airy 明细表 + card 签章区 + right 落款，
 * 与同领域其它单据互不重样。</p>
 *
 * <p>报关小票 / 现场查验回执：查验现场与方式、逐项查验内容与结果，</p>
 * <p>查验结论与查验关员、收发货人签收栏。</p>
 *
 * <p>运行后输出：{@code D:/test/pdf/127_declaration_receipt_inspection.pdf}。</p>
 *
 * @author Martin
 * @version 1.0.0
 */
public class JQuickBiz127DeclarationReceiptInspection {

    private static final String PDF_DIR = "D:/test/pdf/";
    private static final String OUT_FILE = PDF_DIR + "127_declaration_receipt_inspection.pdf";
    private static final String TEMPLATE = "demo/biz/customs/127_declaration_receipt_inspection.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 = {
                {"品名规格核对", "伺服电机 / 精密齿轮箱等 6 项", "相符", "无", "通过"},
                {"数量重量核对", "申报 46 件 / 12140 kg", "相符", "无", "通过"},
                {"原产地核对", "新加坡，随附原产地证书", "相符", "无", "通过"},
                {"木质包装检疫", "IPPC 标识核查", "相符", "无", "通过"},
                {"知识产权核查", "商标 / 专利备案比对", "相符", "无", "通过"},
                {"单证完整性", "合同发票装箱单提单齐全", "相符", "无", "通过"}
        };

        Map<String, Object> data = new LinkedHashMap<String, Object>();
        data.put("receiptNo", "CHK-20261010-0331");
        data.put("checkDate", "2026年10月10日");
        data.put("checkPlace", "××海关××查验中心 3 号台");
        data.put("declarationNo", "220120261012003388");
        data.put("consignee", "××国际贸易有限公司");
        data.put("checkMethod", "机检 + 人工开箱");
        data.put("officer", "闻仲平 / 路承志");
        data.put("conclusion", "单货相符，予以放行");
        data.put("customsOffice", "××海关");
        data.put("remark", "本回执一式两联，一联交收发货人留存，一联由海关归档；如需复验请在 3 个工作日内提出书面申请。");
        data.put("consigneeSign", "崔行知");
        data.put("inputer", "苏见宁");

        // 明细逐格展开
        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("itemAmount" + 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]);
            data.put("itemAmount" + n, items[i][4]);
        }

        // ---------- 2. 渲染 ----------
        JPdfConfig config = new JPdfConfig();
        config.getLayoutConfig().setFlexLayout(true);
        config.getDoc().setMargins(Arrays.asList(48, 48, 48, 48));
        config.getFontConfig().setDefaultFontName("Noto Sans CJK SC");
        config.getHeaderConfig().setEnabled(true);
        config.getHeaderConfig().setText("××海关　现场查验回执　CHK-20261010-0331");
        config.getHeaderConfig().setFontSize(8f);
        config.getHeaderConfig().setHeight(34);
        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 + " 字节）");
    }
}

最小调用（3 行）

不想读完整测试类？核心就是这三行：绑定图表 SVG，执行模板，拿到 PDF 字节流。可直接复制到你的项目里。

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

模板文件 · 127_declaration_receipt_inspection.txt

类 HTML + 内联 CSS 的模板语法，绑定数据后渲染为 PDF。下方为完整模板，可直接复制，也可下载原始文件。

<pdf>
<body>
  // 127 报关小票 / 现场查验回执（customs 领域第 3 项）　视觉主题：靛蓝·疏朗·下线
  // 版式组合：抬头=underline 信息区=kv 明细表=airy 段落=box 签章=card 落款=right
  // 主色 #169DB8　辅色 #912747　浅底 #EFF6F8
  // 报关小票与现场查验回执：查验项目、结果、异常描述与处理意见，双方签字确认。

  // 抬头：underline
  <table style="width:100%; marginBottom:1px">
    <tr>
      <td style="width:62%; padding:2px; bold:true; fontSize:15pt; color:#047B92; characterSpacing:3pt">'报关小票 / 现场查验回执'</td>
      <td style="padding:2px; textAlign:right; fontSize:7.5pt; color:#78838C">'回执编号 '${receiptNo}'　　查验日期 '${checkDate}'　　查验现场 '${checkPlace}</td>
    </tr>
  </table>
  <lineSeparator style="color:#169DB8; thickness:2.5f; marginBottom:8px"></lineSeparator>

  // 信息区：kv
  <table style="width:100%; fontSize:9pt; marginBottom:8px">
    <tr>
      <td style="width:22%; padding:5px; backgroundColor:#EFF6F8; bold:true; border:1px solid #BBD5DA">'回执编号'</td>
      <td style="padding:5px; border:1px solid #BBD5DA">${receiptNo}</td>
    </tr>
    <tr>
      <td style="width:22%; padding:5px; backgroundColor:#EFF6F8; bold:true; border:1px solid #BBD5DA">'查验日期'</td>
      <td style="padding:5px; border:1px solid #BBD5DA">${checkDate}</td>
    </tr>
    <tr>
      <td style="width:22%; padding:5px; backgroundColor:#EFF6F8; bold:true; border:1px solid #BBD5DA">'查验现场'</td>
      <td style="padding:5px; border:1px solid #BBD5DA">${checkPlace}</td>
    </tr>
    <tr>
      <td style="width:22%; padding:5px; backgroundColor:#EFF6F8; bold:true; border:1px solid #BBD5DA">'报关单号'</td>
      <td style="padding:5px; border:1px solid #BBD5DA">${declarationNo}</td>
    </tr>
    <tr>
      <td style="width:22%; padding:5px; backgroundColor:#EFF6F8; bold:true; border:1px solid #BBD5DA">'收发货人'</td>
      <td style="padding:5px; border:1px solid #BBD5DA">${consignee}</td>
    </tr>
    <tr>
      <td style="width:22%; padding:5px; backgroundColor:#EFF6F8; bold:true; border:1px solid #BBD5DA">'查验方式'</td>
      <td style="padding:5px; border:1px solid #BBD5DA">${checkMethod}</td>
    </tr>
    <tr>
      <td style="width:22%; padding:5px; backgroundColor:#EFF6F8; bold:true; border:1px solid #BBD5DA">'查验人员'</td>
      <td style="padding:5px; border:1px solid #BBD5DA">${officer}</td>
    </tr>
    <tr>
      <td style="width:22%; padding:5px; backgroundColor:#EFF6F8; bold:true; border:1px solid #BBD5DA">'查验结论'</td>
      <td style="padding:5px; border:1px solid #BBD5DA">${conclusion}</td>
    </tr>
    <tr>
      <td style="width:22%; padding:5px; backgroundColor:#EFF6F8; bold:true; border:1px solid #BBD5DA">'查验海关'</td>
      <td style="padding:5px; border:1px solid #BBD5DA">${customsOffice}</td>
    </tr>
  </table>

  <table style="width:100%; marginBottom:3px">
    <tr>
      <td style="width:4px; padding:0px; backgroundColor:#912747">' '</td>
      <td style="padding:3px; bold:true; fontSize:10.5pt; color:#047B92">'查验项目明细'</td>
    </tr>
  </table>
  <table style="width:100%; fontSize:8.5pt; marginBottom:8px">
    <tr>
      <th style="width:22%; padding:5px; backgroundColor:#EFF6F8; color:#047B92; bold:true; textAlign:center; border:1px solid #BBD5DA">'查验项目'</th>
      <th style="width:28%; padding:5px; backgroundColor:#EFF6F8; color:#047B92; bold:true; textAlign:center; border:1px solid #BBD5DA">'查验内容'</th>
      <th style="width:16%; padding:5px; backgroundColor:#EFF6F8; color:#047B92; bold:true; textAlign:center; border:1px solid #BBD5DA">'查验结果'</th>
      <th style="width:18%; padding:5px; backgroundColor:#EFF6F8; color:#047B92; bold:true; textAlign:center; border:1px solid #BBD5DA">'异常描述'</th>
      <th style="padding:5px; backgroundColor:#EFF6F8; color:#047B92; bold:true; textAlign:center; border:1px solid #BBD5DA">'处理意见'</th>
    </tr>
    <tr>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemName1}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemSpec1}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemUnit1}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemQty1}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemAmount1}</td>
    </tr>
    <tr>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemName2}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemSpec2}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemUnit2}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemQty2}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemAmount2}</td>
    </tr>
    <tr>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemName3}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemSpec3}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemUnit3}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemQty3}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemAmount3}</td>
    </tr>
    <tr>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemName4}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemSpec4}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemUnit4}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemQty4}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemAmount4}</td>
    </tr>
    <tr>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemName5}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemSpec5}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemUnit5}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemQty5}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemAmount5}</td>
    </tr>
    <tr>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemName6}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemSpec6}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemUnit6}</td>
      <td style="padding:5px; textAlign:left; border:1px solid #E8EBEE">${itemQty6}</td>
      <td style="padding:5px; textAlign:center; border:1px solid #E8EBEE">${itemAmount6}</td>
    </tr>
  </table>

  // 段落：box
  <table style="width:100%; marginBottom:6px">
    <tr>
      <td style="width:150px; padding:5px; backgroundColor:#EFF6F8; bold:true; fontSize:9.5pt; color:#047B92; border:1px solid #BBD5DA">'查验结论'</td>
      <td style="padding:5px; fontSize:9pt; border:1px solid #BBD5DA">${conclusion}</td>
    </tr>
  </table>
  <table style="width:100%; marginBottom:6px">
    <tr>
      <td style="width:150px; padding:5px; backgroundColor:#EFF6F8; bold:true; fontSize:9.5pt; color:#047B92; border:1px solid #BBD5DA">'备注'</td>
      <td style="padding:5px; fontSize:9pt; border:1px solid #BBD5DA">${remark}</td>
    </tr>
  </table>

  // 签章区：card
  <!-- 签章占位区：后续加盖电子公章 / 骑缝章 / 打印二维码 -->
  <table style="width:100%; fontSize:8pt; marginBottom:8px">
    <tr>
      <td style="width:50%; padding:4px; backgroundColor:#EFF6F8; textAlign:center; color:#169DB8; border:1px solid #BBD5DA">'（报关专用章 / 海关验讫章占位）'</td>
      <td style="padding:4px; backgroundColor:#EFF6F8; textAlign:center; color:#169DB8; border:1px solid #BBD5DA">'（骑缝章 / 二维码占位）'</td>
    </tr>
    <tr>
      <td style="width:50%; padding:4px; backgroundColor:#EFF6F8; textAlign:center; color:#78838C; border:1px solid #BBD5DA">'申报单位：'${customsOffice}</td>
      <td style="padding:4px; backgroundColor:#EFF6F8; textAlign:center; color:#78838C; border:1px solid #BBD5DA">'骑缝章沿右边线骑缝加盖'</td>
    </tr>
    <tr>
      <td style="width:50%; padding:4px; backgroundColor:#EFF6F8; textAlign:center; color:#78838C; border:1px solid #BBD5DA">'签章日期：'${checkDate}</td>
      <td style="padding:4px; backgroundColor:#EFF6F8; textAlign:center; color:#78838C; border:1px solid #BBD5DA">'二维码打印于右上角方框内'</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:#047B92">'查验关员：'${officer}</td>
      <td style="width:38%; padding:4px; textAlign:center; color:#047B92">'收发货人签收：'${consigneeSign}</td>
      <td style="padding:4px; textAlign:center; color:#047B92">'录入：'${inputer}</td>
    </tr>
  </table>
</body>
</pdf>

同分组示例

本页 PDF、预览图、模板与源码均由 JQuick-Pdf 真实运行产出，可自由复制到你的项目中使用。