Metadata-Version: 2.4
Name: quellenkontor
Version: 0.1.0
Summary: Offizielles SDK für die Quellenkontor-API: geprüfte HR-Daten für Deutschland mit Quelle und Gültigkeit. German HR reference data API client.
License: MIT
Project-URL: Homepage, https://quellenkontor.dev
Project-URL: Documentation, https://quellenkontor.dev/docs/sdk-python
Project-URL: Changelog, https://quellenkontor.dev/docs/aenderungen
Project-URL: Repository, https://github.com/NicksAdvisory/quellenkontor-sdk
Project-URL: Issues, https://github.com/NicksAdvisory/quellenkontor-sdk/issues
Keywords: hr,mindestlohn,sozialversicherung,feiertage,api,lohn,germany,german,minimum-wage,payroll,social-security,public-holidays,hr-data
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: German
Classifier: Topic :: Office/Business
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# quellenkontor

**English:** Official Python SDK for the [Quellenkontor](https://quellenkontor.dev/en) API: verified German HR reference data (minimum wage, social security ceilings and rates, public holidays by state, notice periods and more), each value with its legal basis, official source and effective date. No dependencies, Python 3.9+. English docs: [quellenkontor.dev/en/docs/sdk-python](https://quellenkontor.dev/en/docs/sdk-python). Field and parameter names are German, as in the API.


Offizielles Python-SDK für die [Quellenkontor](https://quellenkontor.dev)-API: geprüfte HR-Daten für Deutschland mit Quelle, Rechtsgrundlage und Gültigkeit. Ohne Abhängigkeiten, ab Python 3.9.

```bash
pip install quellenkontor
```

```python
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"], ml["minijob_grenze_monat"])  # 14.6 633

frist = qk.hr.kuendigungsfrist(eintritt="2017-03-01", zugang="2026-11-10")
print(frist["ende"])  # 2027-02-28
```

Fehler der API kommen als `QuellenkontorFehler` mit `status`, `code` und `parameter`.

Kostenloser Schlüssel: https://quellenkontor.dev/anmelden · Doku: https://quellenkontor.dev/docs/sdk-python
