跳到主要内容

如何在 Power Automate 中创建 ZUGFeRD 发票?Dropbox + JSON 分步工作流程。

· 阅读需 15 分钟
SEO and Content Writer

本指南完整展示了所有内容。 动力自动化 读取工作流程 基础 PDF发票 JSON 来自 Dropbox,生成一个 ZUGFeRD/Factur-X 使用发票 PDF4me 创建 ZUGFeRD 发票并将最终文件写回 Dropbox。

屏幕截图序列使用了以下示例路径:

  • 基础PDF: /blog data/zugferd invoice/simplepdf.pdf
  • JSON: /blog data/zugferd invoice/sample-invoice.json
  • 输出文件夹: /blog 数据/zugferd 发票/输出
简短版

1. 手动触发流程 → 2. 获取基础 PDF 文件(Dropbox)→ 3. 获取 JSON 文件(Dropbox)→ 4. 创建 ZUGFeRD 发票(PDF4me,输入格式 = JSON,输出模式 = PDF 转 XML)→ 5. 创建文件(Dropbox 输出文件夹)。

配置步骤 4 时请记住这一点。

输入格式 = JSON然后仅绘制地图 发票 JSON 数据。 保持 发票 XML 数据发票 CSV 数据 本次运行为空。 PDF 和 XMLPDF 文件内容 是必需的,并且必须来自基础 PDF 步骤。

你正在构建的

你生产一个 混合发票 PDF 输出结果基于模板 PDF 和结构化 JSON 数据。该输出适用于需要可读 PDF 输出且包含符合 ZUGFeRD/Factur-X 规范的机器可读发票数据的团队。


一览:全部五个步骤

1Trigger
2Get PDF
3Get JSON
4Create ZUGFeRD
5Save output

这种工作流程布局为何有效

分离输入

PDF 和 JSON 是独立获取的,因此您可以更新有效负载文件而无需触及可视化 PDF 模板流程。

单代步骤

创建 ZUGFeRD 发票 在一个地方接收两个内容源,并返回一个Dropbox可以直接使用的文件输出。 创建文件

以后很容易分叉

生成之后,您可以添加验证、通知、ERP/API 交付或归档路由,而无需重构核心流程。


开始之前

检查清单

本教程中使用的输入文件

使用基础 PDF 文档预览作为创建 ZUGFeRD 发票操作的 PDF 输入

基础PDF输入文件。

发票 JSON 有效负载内容,显示映射到 ZUGFeRD 生成的发票字段

发票JSON数据输入。


流程概览(五步)

  1. 手动触发流程:在配置过程中按需运行。
  2. 获取基础 PDF 文件 (Dropbox):读取模板 PDF 字节。
  3. 获取 JSON 文件 (Dropbox):读取发票 JSON 字节/内容。
  4. 创建 ZUGFeRD 发票 (PDF4me):使用 JSON 模式合并输入。
  5. 创建文件 (Dropbox):将生成的输出存储在目标文件夹中。

流程概览

Power Automate 流程:手动触发流程、获取基础 PDF 文件、获取 JSON 文件、创建 ZUGFeRD 发票、创建文件

用于此 ZUGFeRD 生成模式的完整流程链。


步骤 1:获取基础 PDF 文件(Dropbox)

目前为止的流程: 触发器 → 获取基础 PDF 文件。

  1. 添加 Dropbox 根据路径获取文件内容的操作。
  2. 文件路径 到基础模板 PDF(例如: /blog data/zugferd invoice/simplepdf.pdf)。
  3. 在高级选项中,保留 推断内容类型 = 是
  4. 保存并测试此步骤;确保它返回文件内容/二进制输出。
Dropbox 获取基础 PDF 文件操作显示文件路径 blog data zugferd invoice simplepdf.pdf 并推断内容类型为“是”

步骤 1 截图:已配置基本 PDF 路径和内容推断。


步骤 2:获取 JSON 文件(Dropbox)

目前为止的流程: 触发器 → 获取基础 PDF → 获取 JSON 文件。

  1. 添加另一个 Dropbox 文件内容操作。
  2. 文件路径 将您的发票数据 JSON(例如:) /blog data/zugferd invoice/sample-invoice.json)。
  3. 保持 推断内容类型 = 是
  4. 保存并测试;确认步骤 3 中 JSON 内容可用于映射。
Dropbox 获取 JSON 文件操作显示文件路径 blog data zugferd invoice sample-invoice.json 并推断内容类型为“是”

步骤 2 截图:来自 Dropbox 的 JSON 源文件。


步骤 3:创建 ZUGFeRD 发票(PDF4me)

目前为止的流程: 触发器 → 获取基础 PDF → 获取 JSON → 创建 ZUGFeRD。

配置 PDF4me,创建 ZUGFeRD 发票 如图所示:

  1. 文件名:源 PDF 名称(例如: 测试.pdf)。
  2. PDF 文件内容地图来自 获取基础 PDF 文件
  3. 输出文件名期望的输出文件名(例如: Zugferd 发票.pdf)。
  4. 输入格式设置为 JSON
  5. 输出模式设置为 PDF 和 XML
  6. 发票 JSON 数据地图来自 获取 JSON 文件
  7. 符合性级别: 例子: 基本的
  8. ZUGFeRD 版本: 例子: 1.0 (或您需要的版本)。
  9. 以 PDF 格式渲染发票: 例子: 是的
创建 ZUGFeRD 发票操作,显示文件名、PDF 文件内容、输出文件名、输入格式 JSON、输出模式(PDF 带 XML)、发票 JSON 数据、一致性(基本)、ZUGFeRD 版本 1.0、在 PDF 上渲染发票(是)

步骤 3 截图:基于 JSON 的 ZUGFeRD 生成的完整参数映射。


步骤 4:创建文件(Dropbox)

目前为止的流程: 触发器 → 读取 PDF + JSON → 生成 ZUGFeRD → 保存文件。

  1. 添加 Dropbox:创建文件
  2. 文件夹路径:输出目标文件夹(例如: /blog 数据/zugferd 发票/输出)。
  3. 文件名:映射输出文件名 创建 ZUGFeRD 发票
  4. 文件内容:映射生成的文件内容 创建 ZUGFeRD 发票
  5. 保存并运行完整流程。
Dropbox 创建文件操作,使用文件夹路径创建博客数据 Zugferd 发票输出,并映射文件名和文件内容,来自创建 ZUGFeRD 发票

步骤 4 截图:输出文件写回 Dropbox。


输出验证

打开输出示例
创建 ZUGFeRD 发票操作后生成的 ZUGFeRD 发票 PDF 可视化输出

生成的发票PDF输出文件。

打开的输出文件带有附件面板,显示生成的 ZUGFeRD 发票 PDF 中嵌入的 XML 数据。

附件视图显示嵌入式结构化发票数据。


快速参考

#关键映射
1Get Base PDF FileFile path to template PDF + Infer Content Type = Yes
2Get JSON FileFile path to invoice JSON + Infer Content Type = Yes
3Create ZUGFeRD InvoicePDF File Content from step 1, Input Format = JSON, Invoice JSON Data from step 2
4Create fileFile Name and File Content from Create ZUGFeRD Invoice output

深度参数参考: 创建 ZUGFeRD 发票 验证 PDF


故障排除

由于输入映射问题,生成失败。

如果 输入格式 = JSON仅地图 发票 JSON 数据清除本次运行的 XML/CSV 字段。

输出模式不匹配

PDF 和 XML, 丢失的 PDF 文件内容 导致错误。从基础 PDF 步骤映射文件字节。

401、402 错误或连接问题

PDF4me故障排除 用于 API 密钥、积分和连接器授权检查。


接下来该尝试什么呢?

可选硬化处理:添加 健康)状况 在步骤 3 检查输出是否存在之后,在最终文件写入之前跳转到成功/失败通知。