bkempinski/ksef_link_daemon

KSeF.Link Daemon – 本地API集成波兰电子发票系统（KSeF）

本容器提供完全本地（on-premise）的REST API，用于与波兰国家电子发票系统（Krajowym Systemem e-Faktur，KSeF）集成。所有数据（包括遥测和统计信息）均在容器内处理，不向第三方发送，仅与KSeF通信，确保信息处理的隐私与安全。该集成方案由Kempinski IT Solutions开发，更多信息可访问ksef.link及镜像页面https://hub.docker.com/r/bkempinski/ksef_link_daemon。

核心功能

• 本地API容器化部署
• 支持多个NIP（税号）
• 镜像侧无NIP数量及操作（发送/获取/查询等）限制
• 可选文件集成：XML处理器支持Drop/Processing/Sent/Error/Retrieve目录
• Webhook推送：结果通知可附加文件，URL支持占位符（{{resultId}}、{{identifier}}等）
• 容器内提供Swagger UI

使用场景

适用于需要与波兰KSeF系统集成的企业或组织，例如财务系统自动发送/获取电子发票、批量处理发票数据、实时接收发票状态通知等场景。

配置说明

环境建议

推荐为测试、演示和生产环境分别部署独立实例，便于环境隔离与管理。

认证方式

• 测试/演示环境：无需密码的Basic Auth（适用于所有NIP），示例：-u 1234567890:
• 生产环境：需使用KSeF.Link许可证密钥作为Basic Auth密码，密钥可从ksef.link获取。

支持格式与版本（v1）

• 完全支持FA(2)格式的发送/获取及辅助操作
• 兼容KSeF API 2.6.0版本
• 详细定义可通过容器内Swagger UI（/swagger）查看

开发中功能

• 实现FA(3)格式适配与验证
• 集成KSeF最新版本API
• 进度更新可关注ksef.link

快速部署

Docker Run

bash
docker run -d --name KSeF.Link.Daemon \
  -p 12319:2319 \
  -v /path/to/Data:/app/Data \
  -v /path/to/Logs:/app/Logs \
  --restart=always \
  docker.xuanyuan.run/bkempinski/ksef_link_daemon:latest

Docker Compose

yaml
services:
  ksef_link_daemon:
    container_name: KSeF.Link.Daemon
    image: docker.xuanyuan.run/bkempinski/ksef_link_daemon:latest
    pull_policy: always
    restart: always
    ports:
      - "12319:2319"
    volumes:
      - ./Data:/app/Data
      - ./Logs:/app/Logs

访问方式

• API地址：http://localhost:***/api/v1/…
• Swagger UI：http://localhost:***/swagger

端口与卷

• 容器内部端口：2319/tcp（建议映射为***:2319）
• 卷挂载：
  • /app/Data：存储配置、XML文件（如/app/Data/XML/...）等数据
  • /app/Logs：存储日志文件

操作示例

添加凭证（公开环境，无需Basic Auth）

bash
curl -X POST "http://localhost:12319/api/v1/Daemon/credentials?environment=Prod&identifier=1234567890&token=KSEF_TOKEN"

发送电子发票（生产环境，需许可证密钥）

bash
curl -X POST "http://localhost:12319/api/v1/Invoice/send" \
  -u 1234567890:你的许可证密钥 \
  -H "Content-Type: application/json" \
  -d '{"invoiceXmlBase64":"<BASE64编码的XML>"}'

发送电子发票（测试/演示环境，无密码）

bash
curl -X POST "http://localhost:12319/api/v1/Invoice/send" \
  -u 1234567890: \
  -H "Content-Type: application/json" \
  -d '{"invoiceXmlBase64":"<BASE64编码的XML>"}'

查询结果

bash
curl "http://localhost:12319/api/v1/Daemon/result?resultId=结果ID" -u 1234567890:

配置XML处理器（可选）

bash
curl -X POST "http://localhost:12319/api/v1/Daemon/xmlprocessor" \
  -H "Content-Type: application/json" \
  -d '{"sendEnabled":true,"retrieveEnabled":true,"dropPath":"/app/Data/XML/Drop","processingPath":"/app/Data/XML/Processing","sentPath":"/app/Data/XML/Sent","errorPath":"/app/Data/XML/Error","retrievePath":"/app/Data/XML/Retrieve","retrieveFrequency":60}'

相关链接

• 产品官网：ksef.link
• Docker镜像页面：https://hub.docker.com/r/bkempinski/ksef_link_daemon