介绍
peppol.sh 是一个 Peppol 电子发票 API，旨在帮助企业发送合规的电子发票，而无需自行管理 Peppol 网络。开发者无需为 UBL 模式、SMP 查询或接入点设置而烦恼，只需携带 JSON 数据发起一个简单的 API 调用，剩下的转换和投递工作都由 peppol.sh 完成。
什么是 peppol.sh？
peppol.sh 是一个 Peppol 电子发票 API，同时也是面向 Peppol 网络的 API 优先电子发票服务。它解决了一个实际问题：Peppol 电子发票需要验证、注册以及与经认证的接入点进行通信。peppol.sh 将整个流程封装为一次 REST API 调用。
该服务接受 JSON 数据负载，将其转换为 Peppol BIS 3.0 UBL，根据 EN 16931 标准验证文档，并通过 Peppol 网络进行投递。它还从注册起就提供沙盒环境，因此用户可以立即发送 Peppol 发票，并在正式上线前测试集成。这使得 peppol.sh 不仅仅是一个简单的转换工具：它是面向现代软件团队的完整 Peppol 电子发票 API。
为什么这很重要？欧洲的电子发票强制要求正在扩大。ViDA 将要求整个欧盟在 2030 年前采用结构化电子发票，而且如今已有多个成员国强制执行这一要求。对于软件团队而言，这意味着他们需要一种可靠的途径来满足电子发票合规要求，而无需成为 Peppol 专家。peppol.sh 瞄准的正是这一缺口。
peppol.sh 的主要功能
这个 Peppol 电子发票 API 的主要优势在于每个流程都实现了自动化。
一次调用即可发送文档
将 JSON 数据负载发送到 /v1/documents 端点，文档即进入投递队列。无需多步骤流程，无需手动配置 Peppol。这就是 Peppol 电子发票 API 体验的核心。
JSON 转 UBL
peppol.sh 自动将 JSON 转换为有效的 Peppol BIS 3.0 UBL。这让开发者无需再学习 UBL 语法或维护复杂的转换模板。
内置电子发票合规能力
该服务负责 EN 16931 验证，并作为经认证的 Peppol 接入点运行。这使得满足欧盟电子发票合规要求变得更加容易。
从第一天起就提供沙盒环境
每个账户都从沙盒模式开始。开发者可以使用 ps_test_ 密钥发送 Peppol 发票，沙盒投递通过电子邮件发送。无需界面、无需审批、无需信用卡。
投递跟踪与 Webhook
每个文档都有一个状态端点，webhook 会通知投递事件。团队可以检查每张发票是否真正送达收件人。
参与者查询
查询端点让你可以在发送前检查某家公司是否已在 Peppol 上注册。这有助于避免投递失败。
用于自动发送的 Stripe 应用
对于 Stripe 用户，官方应用会监听 invoice.finalized 事件，并自动通过 Peppol 网络发送发票。此路径无需任何代码更改。
支持 AI 智能体
peppol.sh 包含一个 SKILL.md 文件和 MCP 服务器，因此 AI 智能体可以自主创建账户、发送发票和跟踪投递状态。这与 API 优先的设计理念相契合。
peppol.sh 的使用场景
SaaS 与电商结账
客户付款后，系统可以通过 peppol.sh 向其企业发送 Peppol 发票。这对于 SaaS 产品、电商商店和服务型企业非常有用。
会计与 ERP 集成
会计平台可以将 Peppol 发送功能嵌入到自己的产品中。每个租户拥有一个公司身份，但无需按租户付费，也没有月度最低消费。
自动化计费工作流
财务团队和开发者可以构建完全由 API 驱动的计费流程。从注册到 KYC 再到正式发送，每一步都可以自动化。
AI 智能体与内部工具
由于整个 API 支持自助引导，AI 智能体或内部脚本可以创建工作区、发送发票和查看状态，而无需打开仪表盘。
如何使用 peppol.sh
使用这个 Peppol 电子发票 API 只需几个简单步骤。
- 通过一条 curl 请求调用
/v1/signup创建账户，立即获得沙盒 API 密钥。 - 使用
ps_test_密钥在沙盒模式下发送 Peppol 发票，并确认响应中包含文档 ID。 - 通过
/v1/kyc/documents和/v1/kyc/submit上传并提交文档，完成 KYC。 - 创建正式 API 密钥，开始通过经认证的 Peppol 接入点发送发票。
无需浏览器。整个流程都可以在终端中或通过自动化智能体完成。
peppol.sh 的目标受众
- 希望使用 Peppol 电子发票 API 而无需管理基础设施的开发者
- SaaS 和电商企业
- 会计和 ERP 平台
- 计费服务提供商和金融科技公司
- AI 智能体构建者和自动化团队
- 正在为欧盟电子发票强制要求做准备的公司
peppol.sh 免费吗？
peppol.sh 提供免费的沙盒环境，并为正式发送提供透明的按文档计费价格。
| 套餐 | 价格 | 功能 |
|---|---|---|
| 沙盒 | 免费 | 无限制测试发票、邮件投递、API 访问 |
| 正式 | 每张发送的发票 €0.10 起 | 无月度最低消费、无按租户收费 |
这种定价结构使 Peppol 电子发票 API 对小型团队和大型平台同样友好。注册时无需信用卡，且点数永不过期。
peppol.sh 的优点与缺点
| 方面 | 优点 | 缺点 |
|---|---|---|
| 易用性 | 简单的 JSON API，无需 UBL 知识 | API 集成需要一定的技术能力 |
| 合规性 | EN 16931 验证、经认证的接入点 | 专注于欧洲 Peppol 要求 |
| 价格 | 按文档付费，沙盒永久免费 | 发票量非常大时成本会增加 |
| 上手体验 | 完全由 API 驱动，无需仪表盘 | 对非技术团队不太友好 |
| 自动化 | Webhook、支持 AI 智能体、Stripe 应用 | 部分功能需要额外配置 |
关于 peppol.sh 的常见问题
开始使用 Peppol 电子发票 API 需要多长时间？
通过 API 注册是即时完成的。在沙盒模式下，一分钟内即可发送测试发票。正式上线需要 KYC 审批和工作区验证，但注册时无需打开仪表盘，也没有审批步骤。
peppol.sh 适用于所有欧盟国家吗？
peppol.sh 基于 Peppol 网络和 Peppol BIS 3.0 构建，这两者在欧洲被广泛使用。买方和供应商必须在 Peppol 上注册，才能通过网络发送和接收发票。查询端点可以帮助按名称或税号检查注册状态。
沙盒密钥和正式密钥有什么区别？
沙盒密钥以 ps_test_ 开头，通过电子邮件投递测试发票。正式密钥以 ps_live_ 开头，通过真实的 Peppol 网络投递发票。工作区验证只需完成一次，正式密钥在审批通过后创建。
我可以通过 peppol.sh 发送 PDF 发票吗？
可以。根据产品文档，该 Peppol 电子发票 API 支持 JSON 和 PDF 上传两种方式发送合规文档。JSON 会转换为 UBL，PDF 则作为文档提交。
有免费的测试套餐吗？
有。每个账户都从沙盒模式开始，并且永久免费用于测试。用户可以在创建正式工作区之前，在沙盒中发送测试文档。
peppol.sh 按租户收费吗？
不收。没有按租户计算的费用，也没有月度最低消费。定价基于发送的发票数量，每张发票 €0.10 起。
peppol.sh 标签
Peppol 电子发票 API、发送 Peppol 发票、JSON 转 UBL、Peppol BIS 3.0、电子发票合规、Peppol 接入点、电子发票 API、沙盒测试、Stripe 电子发票、欧盟电子发票强制要求、自动化电子发票、API 优先电子发票
