通过 JustFill 用 JSON 数据填写 PDF 表单

通过 JustFill 用 JSON 数据填写 PDF 表单

一个带小网页表单的 n8n 工作流。你上传一份 PDF，再贴上一个 JSON 对象，它的键是 PDF 字段的名字。工作流把两者发给 JustFill 的托管 API，API 填好表单并返回一个下载链接。然后表单把你的浏览器带到填好的 PDF。

包里有什么

• workflow.json：n8n 导出的工作流，15 个节点，其中 10 个会运行，五个是便签。里面没有任何凭据。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• Config 里的密钥原来是一个编出来的值 jf_live_YOUR_API_KEY_HERE，现在是 <YOUR_JUSTFILL_API_KEY>。
• 第一张便签不再链接到厂商的页面，并且说的是保存后发布，而不是“激活”。
• 别的都没改。表单、四个请求和 Code 节点都和原来一样。

开始之前

• 一个 n8n，n8n Cloud 或你自己的服务器都行。
• 一个带 API 密钥的 JustFill 账户。JustFill 的页面说，要在 Account 下的 API Keys 里创建。
• 一份你已经在 JustFill 里核对过字段名并存成模板的、反复使用的 PDF。JustFill 的价格页（2026 年 11 月 12 日查阅）把已保存的模板列在它的付费方案里。
• 一份有几个字段的测试 PDF 和编造的值，这样第一次运行就不会用到客户的文档。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 打开 Config，把 <YOUR_JUSTFILL_API_KEY> 换成你的密钥。
3. 在 JustFill 里打开你的 PDF，核对它的字段名，并把它存成一次模板。记下这些名字，比如 company_name。
4. 点 Test workflow。表单会打开。上传 PDF，并在 Data JSON 里贴上一个 JSON 对象，每个要填的字段对应一个键。
5. 打开表单带你去的那个文件。然后看一下 Result 节点里的 output_mode 和 warnings，它们会告诉你输出是干净的还是带标记的。
6. 保存，点画布顶部的 Publish（或按 Shift+P）。请保密这个表单，因为拿到它地址的人都能用掉你在 JustFill 的额度。

一次运行的过程

1. On form submission 从表单取得 PDF 和 JSON 文字。
2. Config 保存 API 密钥。
3. Mint upload slot 在 https://justfill.app/api/mcp 调用 JustFill 的 request_file_upload 工具，请求头 Authorization 里带着你的密钥。它返回一个上传地址和一个令牌。
4. Prepare upload 读取这个回答，遇到任何错误就停下，并把表单里的 PDF 作为二进制文件挂上去。
5. Upload PDF 把文件以 multipart 表单数据的形式发到上传地址。
6. Open PDF 带着令牌调用 open_pdf 工具，最多等 180 秒。JustFill 返回字段清单和一个工作区 ID。
7. Map values to fields 把每个 JSON 键和字段名比较，忽略大小写、空格和标点。它构建对 fill_pdf 的调用。
8. Fill PDF 发出这个调用。Result 留下下载地址、输出模式、已填字段数、链接的到期时间和所有警告。
9. Redirect to filled PDF 把浏览器带到下载地址，结束这个表单。

改变样子

• 表单的标题、文字和字段：On form submission。
• 匹配名字和值的规则：Code 节点 Map values to fields。
• 从回答里留下什么：Result。
• 最后做什么，比如用保存或发邮件代替跳转：Redirect to filled PDF 和你加在 Result 之后的节点。

值得知道的

• 未运行：Mindket 没有调用过 JustFill 的服务器。它在自己的机器上用示例字段清单和 JSON 运行了 Map values to fields，并在 2026 年 11 月 12 日读了 JustFill 自己的页面。
• JustFill 的页面说，运行这个工作流会用掉账户的 PDF 处理额度，输出可能带水印，要看账户而定。用在真实的工作上之前，请先看你的方案。
• 按 JustFill 的页面，open_pdf 的字段来自已保存的模板、PDF 自带的表单字段，或检测。已保存的模板能让每次运行的名字都一样，PDF 变了就需要新的模板。
• 匹配很严格。一个不匹配任何字段的 JSON 键、两个同名字段、一个嵌套的值，或者两个键对应同一个字段，都会在填写任何内容之前停下这次运行。null 会变成空值。
• 下载地址是一个不用登录的普通链接，代码自己的注释说它大约 24 小时内有效。拿到它的人都能读到填好的 PDF。
• API 密钥以纯文字的形式放在 Config 里。正式使用时请用 n8n 凭据，也别分享含有真实密钥的导出文件。
• 表单没有访问控制。工作流发布之后，拿到地址的人都能通过你的账户发送 PDF。
• 你的数据：PDF 和这些值会发到 JustFill 的服务器。填好的表单里可能有个人数据，所以请先看 JustFill 的条款。
• 凭据：JSON 里没有任何凭据。