在 3 次点击中将 Stripe 收款导入为发票
Source: Dev.to
请提供您希望翻译的完整文本内容（除代码块和 URL 之外），我将为您翻译成简体中文并保持原有的格式。谢谢！
使用 Stripe 收款。你的客户付款。
但这些交易在被某人转换为发票之前并不是发票。现在，你不再需要自己成为那个**“某人”**。
今天我们推出 Stripe Revenue Sync
这是一项集成，可自动将你的 Stripe 收款导入为 Frihet 中的已登记发票。具备去重、VeriFactu 哈希链以及每 6 小时自动同步功能。
问题：一边收款，一边开票
- Stripe 收款。 你的客户使用信用卡支付，订阅会自动续费，准时收到付款。
- 你的会计系统不知情。 这些收款在 Stripe 中存在，但在你的开票软件中没有。
- 你充当桥梁。 每个月，你手动创建发票，复制 Stripe 的数据。更糟的是：如果不这样做，你的财务顾问在下个季度会抓狂。
Stripe 会生成收据，但 在西班牙并非合法的税务发票。它不包含你的 NIF（税号），不使用税务局要求的编号，也不生成 VeriFactu 所需的哈希链。要符合西班牙税务法规，你需要在开票软件中生成真实的发票。
到目前为止，这意味着双倍工作。现在不再如此。
什么是 Stripe Revenue Sync
Revenue Sync 使用 只读受限 API Key 将你的 Stripe 账户连接到 Frihet。无需 OAuth、无需重定向、也不授予对你的资金的写入权限。
功能
- 查询 Stripe 中已付款的发票 – 仅限状态为
paid的发票。 - 为每笔收款在 Frihet 中创建发票 – 包含客户、明细行和金额。
- 将发票标记为已付款 – VeriFactu 流程会自动触发。
- 按 Stripe ID 去重 – 若发票已存在，则忽略。
结果： 你的 Stripe 收款会以已登记的发票形式出现在 Frihet 中，具备顺序编号、SHA‑256 哈希，并可直接用于你的 Modelo 303。
实际运作方式
三步。无需代码，无需复杂配置。
步骤 1：在 Stripe 创建受限 API Key
前往你的 Stripe Dashboard > Developers > API Keys。创建一个仅包含以下两个权限的受限密钥：
- Invoices → Read
- Customers → Read
仅此而已。无需写入权限，也不需要访问付款、转账或余额。密钥以 rk_live_ 开头，仅具只读权限。
步骤 2：在 Frihet 中连接
前往 设置 > 集成 > Stripe Revenue Sync。粘贴你的 API Key，并选择要导入的起始日期。你可以导入最近 90 天的记录，或指定具体日期。
步骤 3：导入
点击 «立即导入»。Frihet 查询 Stripe，获取已付款的发票并在你的账户中创建。每张发票都会经过 Firestore 的触发器：无间隙编号和 VeriFactu 哈希链。
:::tip 启用 自动同步，让 Frihet 每 6 小时自动查询 Stripe。新的收款会自动出现在你的会计系统中，无需任何操作。 :::
VeriFactu 从首次导入即兼容
导入自 Stripe 的发票并非“二手”。它们会与您在 Frihet 手动创建的发票走完全相同的流程：
- 无间隙编号 – 服务器上的原子计数器。没有空缺，没有跳号。
- SHA‑256 哈希 – 包含 8 个字段的哈希串，符合 AEAT 的要求。每张发票都引用前一张的哈希。
- 不可变性 – 注册后，关键字段被锁定。任何修改都会生成更正发票。
- 登记簿 – 导入的发票会在您的 CSV 导出中显示，包含税务局要求的 19 列。
:::info VeriFactu 将于 2027 年 1 月对公司强制实施，2027 年 7 月对个体经营者强制实施。您今天通过 Revenue Sync 导入的发票已符合该规范。 :::
这意味着您的 Stripe 收款已准备好用于 Modelo 303、Modelo 130以及任何检查。无需额外步骤。
Revenue Sync 适用于谁
使用 Stripe Billing 收费的 SaaS 创始人
你直接在 Stripe 上收取订阅费用。每个月都有数十或数百位客户续订。使用 Revenue Sync，每次续订会自动在 Frihet 中生成发票。你的 MRR、季度增值税和账簿始终保持最新。
通过 Stripe 收取项目费用的自由职业者
你的客户通过 Stripe 向你付款，你希望将所有发票集中在一个地方，以便进行季度报表。无需手动创建每张发票，也无需在 Stripe 与电子表格之间来回对照数据。
直接使用 Stripe 的电商
你销售数字或实体商品，并使用 Stripe 收款（而非通过 Shopify 或 WooCommerce）。每笔交易都会生成记录在案的发票。若向欧盟客户销售并需要管理增值税，这尤其有用。
混合计费的机构
部分客户通过 Stripe 支付，其他客户通过转账。Revenue Sync 会导入 Stripe 的付款记录，而其余部分你可以手动开票或使用 Frihet 的直接计费功能。所有记录共存于同一本账簿。
什么 不是 Revenue Sync
- 不是 Stripe 的 OAuth 集成。 该集成已在 Frihet 中实现，允许通过应用内的支付链接收款。Revenue Sync 是单向的：只导入。
- 不发起收费。 不处理支付，也不在 Stripe 创建收费。只读取已付款的发票。
- 不取代 Stripe Billing。 它是对其的补充。Stripe 收款，Frihet 记录。
- 不按客户过滤。 导入自您选择的日期起的所有已付款发票。去重机制确保不会出现重复。
安全
受限的 API Key 仅对两个资源拥有只读权限：invoices 和 customers。它不能转移资金、创建收费或修改你的 Stripe 账户。
该密钥在 Frihet 服务器上使用 AES‑256‑GCM 加密存储。绝不暴露给前端。如果 Stripe 检测到该密钥…
⚠️ 集成已过期
如果授权已过期或被撤销，Frihet 会将集成标记为 “需要重新连接” 并提醒你。
你可以随时在 设置 > 集成 中断开连接。
已导入的发票仍会保留在 Frihet 中。
立即开始！
如果你使用 Stripe 收款，你的发票已经在那里；只需要把它们导入你的会计系统。
Stripe Revenue Sync 只需 3 次点击，无需 OAuth、无需危险权限，并且从第一天起就支持 VeriFactu。
连接你的 Stripe 账户 ，让你的收款自动转换为已登记的发票。
:::newsletter-cta :::
原文发表于 frihet.io。