backofficeplus/e-invoice-validator

德国电子发票验证器

[!IMPORTANT] 本工具及所提供信息按现状提供，不提供任何担保或保证。尽管我们力求准确，但强烈建议通过官方文档和来源验证合规性和正确性。

随着《增长机会法》（2024年）的实施，德国采用分阶段方法对B2B交易引入了强制性电子发票制度：

2025年1月1日起生效：

• 纸质发票不再优先。
• 所有企业均可发送符合***规定格式的电子发票。
• 所有企业必须能够接收电子发票。
• 若双方同意，可使用其他格式（如PDF）。

2027年1月1日起：

• 年营业额超过80万欧元的企业必须发送电子发票。
• 营业额≤80万欧元的企业可继续使用其他发票格式。

2028年1月1日起：

• 所有企业必须发送电子发票。
• 现有系统必须符合***要求。

作为接收电子发票的企业，您需要验证每张发票是否符合欧洲标准EN ***。本项目将所有所需内容打包成预配置、易于使用的验证服务，以Docker容器形式交付，专门针对德国使用场景定制，底层基于官方https://github.com/itplr-kosit/validator并包含多种配置支持相关发票场景。

使用方法

Docker部署

bash
docker run -p8080:80 docker.xuanyuan.run/backofficeplus/e-invoice-validator:latest

HTTP接口访问

验证服务监听POST请求，需在HTTP体中提供待验证的XML文件（不支持multipart/form-data格式）。请求URI最后一段为输入名称，未指定则自动生成。

注意： API不接受PDF文件，若发票嵌入PDF（如ZUGFeRD/Factur-X附件）需先提取XML。

调用示例

cURL

shell
curl --location --request POST 'http://localhost:8080' \
--header 'Content-Type: application/xml' \
--data-binary '@/target.xml'

Java（Apache HttpClient）

java
HttpClient httpClient = HttpClientBuilder.create().build();
HttpPost postRequest = new HttpPost("http://localhost:8080/");
FileEntity entity = new FileEntity(Paths.get("some.xml").toFile(), ContentType.APPLICATION_XML);
postRequest.setEntity(entity);
HttpResponse response = httpClient.execute(postRequest);
System.out.println(IOUtils.toString(response.getEntity().getContent()));

JavaScript

javascript
var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/xml");
var file = "<file contents here>";
var requestOptions = {method: 'POST', headers: myHeaders, body: file, redirect: 'follow'};
fetch("http://localhost:8080", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

PHP（Symfony HttpClient）

php
$httpClient = HttpClient::create();
$response = $httpClient->request('POST', 'http://localhost:8080', [
  'headers' => ['Content-Type' => 'application/xml'],
  'body' => fopen('/path/to/some.xml', 'r'),
]);
echo $response->getContent();

状态码说明

安全与监控

• 授权： 无内置权限检查，需通过代理（如nginx）或自定义方案保障访问安全。
• 监控： 健康检查接口/server/health返回包含状态、内存及版本的XML，支持集成Icinga/Nagios等工具。