KOMBIT client provides easy connection to webservices from KOMBIT / Serviceplatformen / digitaliseringskataloget.
Project description
kombit-client
A Python client for connecting to Danish government web services via KOMBIT Serviceplatformen. The package wraps a .NET library using pythonnet, exposing a clean Python API with Pythonic naming conventions.
Requirements
- Python 3.10–3.14
- .NET 9 runtime or SDK (download)
- Certificates issued by KOMBIT for STS and service authentication: digitaliseringskataloget - certifikater
Installation
pip install kombit-client
Overview
All configuration is handled via environment variables. You must set the following variables before using the client:
| Environment Variable | Description |
|---|---|
CERT_BASE_PATH |
Directory containing all certificate files |
CLIENT_CERT |
Filename of client certificate (e.g., client.p12) |
CLIENT_CERT_BASE64 |
(Optional) client certificate as a base64 string |
CLIENT_PASS |
(Optional) Password for client certificate |
ROOT_CERT |
(Optional) Filename of the root certificate (needs to be added to trust store) |
ACCESS_CONTROL_CERT |
(Optional) Filename of the STS/Access Control certificate |
SIGNING_CERT |
(Optional) Filename of the Service Provider signing certificate |
STS_ENDPOINT_ADDRESS |
(Optional) URL of the STS endpoint |
STS_ENDPOINT_ID |
(Optional) Entity identifier for the STS |
If optional variables are not set, defaults will be used as defined in the code. All certificate paths are constructed as os.path.join(CERT_BASE_PATH, <filename>).
Integrations
SF1520 – CPR replika opslag
Lookup person base data from CPR via SF1520.
Services
PersonBaseDataExtendedService
This service allows public authorities' user systems to retrieve personal information.
from kombit_client.integrations.sf1520.person_base_data_extended import PersonBaseDataExtendedClient
client = PersonBaseDataExtendedClient(
cvr="<organisation's CVR>"
)
result = client.person_lookup(pnr="<a civil registration number>")
# Returns a dict with person base data
SF0770A – SKAT Indkomst - Opslag personoplysninger
Retrieve income data from SKAT via SF0770_A.
Services
SKATForwardEIndkomstService
Synchronous web service that allows you to retrieve income information.
The current implementaion only allows retrieving income information for private individuals.
Useful docs:
- eIndkomst Udstilling ("underbilag 1 (excel)" describes the different fields)
Code example
from kombit_client.integrations.sf0770a.skat_forward_eindkomst import SKATForwardEIndkomstClient
client = SKATForwardEIndkomstClient(
cvr="<organisation's CVR number>",
virksomhed_se_nummer_identifikator="<organisation's SE number>",
abonnement_type_kode="<subscription type code>",
abonnent_type_kode="<subscriber type code>",
adgang_formaal_type_kode="<purpose of access code>"
)
result = client.indkomstoplysninger_laes(
person_civil_registration_identifier="<a civil registration number>",
soege_aar_maaned_fra_kode="202401",
soege_aar_maaned_til_kode="202403",
)
# Returns a dict with income data for the given period
The soege_aar_maaned_fra_kode and soege_aar_maaned_til_kode parameters are year-month strings in YYYYMM format defining the search period.
SF1491 – Hent ydelser fra egen sektor
Lookup granted benefits and payments for a person within your own sector via SF1491.
Services
YdelseListeHent
This service allows public authorities' systems to retrieve information about granted and disbursed financial benefits (effektueringer) for a given person.
from kombit_client.integrations.sf1491.ydelse_liste_hent import YdelseListeHentClient
client = YdelseListeHentClient(
cvr="<organisation's CVR>"
)
result = client.effektuering_hent(
cpr="<a civil registration number>",
start_dato="2026-01-01", # optional
slut_dato="2026-12-31" # optional
)
License
MIT – see LICENSE for details.
Authors
- Rune Keena (runekeena@gmail.com)
- Randers Kommune Digitalisering
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file kombit_client-1.1.0-py3-none-any.whl.
File metadata
- Download URL: kombit_client-1.1.0-py3-none-any.whl
- Upload date:
- Size: 2.3 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8bf4651c0b5ec32b7ca0dd30a281e91ffb828032ea5d125004d75e584542d24b
|
|
| MD5 |
9351f33bdcc23f8ee0c549a52f465c12
|
|
| BLAKE2b-256 |
1b5806ab3942b5a8b23f27d4739bad501e7c7ada4da8c537328348c7f3cf3d2a
|