Quellenkontor HR-Daten

Quellenkontor

通过 API、SDK、CLI 和 MCP 获取德国官方 HR 数据。每项数据均附来源、法律依据和有效期。

最低工资、缴费基数上限、缴费率、实物福利价值、各联邦州的节假日、解雇通知期限以及其他 17 个数据集。你按指定日期查询，即可获得该日期适用的值，以及《联邦法律公报》或《联邦公报》中的出处。

网站 · 文档 · 免费密钥 · 指南 · English

---

为什么要做这个

德国的每款 HR 和薪资软件都要维护相同的数据：每年 1 月 1 日、7 月 1 日，以及每次发布法规时。通常，这项工作依赖某个人、一张表格和一条日历提醒。如果数据录入太晚或有误，薪资计算就会出错，而且不会立刻有人发现。

Quellenkontor 负责维护这些数据。每项数据都从官方来源获取，经过核验，并按有效期保存。只有正式公布后才会录入未来生效的数据，不会在专家草案阶段就提前录入。具体流程请见核验流程。

答复示例

curl "https://api.quellenkontor.dev/v1/hr/mindestlohn?datum=2027-01-15"

{
  "datensatz": "mindestlohn",
  "datum": "2027-01-15",
  "mindestlohn_brutto_stunde": 14.6,
  "minijob_grenze_monat": 633,
  "gueltig_ab": "2027-01-01",
  "gueltig_bis": null,
  "rechtsgrundlage": "Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025 (BGBl. 2025 I Nr. 268), Stufe 2",
  "quelle": {
    "titel": "Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025 (BGBl. 2025 I Nr. 268)",
    "url": "https://www.recht.bund.de/bgbl/1/2025/268/VO.html"
  },
  "vorheriger_wert": {
    "gueltig_ab": "2026-01-01",
    "mindestlohn_brutto_stunde": 13.9,
    "minijob_grenze_monat": 603
  }
}

无需密钥即可进行此查询。最低工资、节假日和计算参数可在沙盒中查询，每天限 50 次。此处的答复经过删节，完整版本还包含说明、许可证和可直接使用的引文。

适用对象

你在构建	Quellenkontor 可以为你处理
薪资软件	任意指定日期（包括过去日期）的计算参数、缴费率、实物福利价值和过渡区数据。了解更多
HR 软件	各联邦州的节假日、工作日、解雇通知期限、休假权利和产假保护计算器。了解更多
HR 聊天机器人和 AI Agent	一个 MCP 服务，让 Agent 查询数据，而不是凭记忆作答。了解更多
薪资处理和雇主记录服务	从一个来源获取德国薪资数据，无需追踪十几个政府网站。了解更多

指南

针对常见任务的简短指南，每篇都附有可复制的代码。

• 随时掌握最新最低工资和迷你工作收入上限
• 为薪资核算的年末切换做好准备
• 各联邦州的节假日和工作日
• 正确计算解雇通知期限
• 通过 MCP 在 AI Agent 中使用 HR 数据

更多应用场景和背景信息请见 quellenkontor.dev/anwendungsfaelle。

数据集

领域	数据集
薪资	最低工资和迷你工作收入上限、最低职业培训津贴、护理行业最低工资
社会保险	计算参数、缴费率、过渡区（中等收入工作）、迷你工作缴费、艺术家社会保险缴费、平衡缴费
税务	实物福利价值、免税金额、国内差旅费用、夜班、周日和节假日津贴、公务用车、所得税关键数值
劳动法与期限	解雇通知期限、休假权利、产假保护、休息规定、法定退休年龄、工资扣押豁免额度
日历	各联邦州的节假日、工作日

每个数据集的参数和字段见参考文档。以 JSON 格式获取数据集列表：https://api.quellenkontor.dev/v1/datensaetze。

开始使用

此仓库包含官方客户端。它们无需必需依赖（只有异步 Python 客户端需要 httpx，pip install "quellenkontor[async]"），并使用相同的 API。

软件包	安装	文档
JavaScript/TypeScript SDK	npm install @quellenkontor/sdk	JavaScript SDK
Python SDK	pip install quellenkontor	Python SDK
CLI	npm install -g @quellenkontor/cli	命令行
MCP 服务	https://mcp.quellenkontor.dev/v1（在指南中进行设置）	MCP

import { Quellenkontor } from "@quellenkontor/sdk";

const qk = new Quellenkontor(process.env.QK_KEY);

const frist = await qk.hr.kuendigungsfrist({ eintritt: "2017-03-01", zugang: "2026-11-10" });
console.log(frist.ende); // "2027-02-28"

import os
from quellenkontor import Quellenkontor

qk = Quellenkontor(api_key=os.environ["QK_KEY"])

ml = qk.hr.mindestlohn(datum="2027-01-15")
print(ml["mindestlohn_brutto_stunde"])  # 14.6

npx @quellenkontor/cli feiertage --jahr 2027 --land HE --format csv > feiertage.csv

免费密钥每月可查询 500 次，可在 quellenkontor.dev/anmelden 获取。无需密码或信用卡。首次查询的操作步骤见快速入门。

联系方式

欢迎通过 Issue 或发送邮件至 [email protected] 提交错误报告和功能建议。

此仓库中的客户端采用 MIT 许可证。数据由 API 提供，相关条款见使用条款。

---

英文

通过 API、SDK、CLI 和 MCP 提供德国官方 HR 参考数据。每项数据都附有官方来源、法律依据和生效日期。

最低工资、社会保险缴费上限和费率、实物福利、各州公共假日、通知期限以及另外 17 个数据集。使用参考日期进行查询，即可获取当日适用的数据，并附上《联邦法律公报》或《联邦公报》中的引文。字段名和参数名均为德语，与 API 中一致。

• 文档：quellenkontor.dev/en/docs
• 免费密钥（每月 500 次请求）：quellenkontor.dev/en/sign-in
• 软件包：npm install @quellenkontor/sdk、pip install quellenkontor、npm install -g @quellenkontor/cli