{"id":19504700,"url":"https://github.com/tools4everbv/helloid-conn-prov-source-sdbhr","last_synced_at":"2026-05-14T17:42:22.887Z","repository":{"id":94206297,"uuid":"373457403","full_name":"Tools4everBV/HelloID-Conn-Prov-Source-SDBHR","owner":"Tools4everBV","description":"SDB HR - Source","archived":false,"fork":false,"pushed_at":"2024-01-15T15:18:43.000Z","size":86,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-01-08T10:45:17.135Z","etag":null,"topics":["cloud","hrm","provisioning","source"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Tools4everBV.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-03T09:47:35.000Z","updated_at":"2023-08-21T12:44:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"5d56d52b-b6d8-4112-bed1-0002e6009328","html_url":"https://github.com/Tools4everBV/HelloID-Conn-Prov-Source-SDBHR","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-SDBHR","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-SDBHR/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-SDBHR/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Source-SDBHR/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tools4everBV","download_url":"https://codeload.github.com/Tools4everBV/HelloID-Conn-Prov-Source-SDBHR/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240754366,"owners_count":19852189,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud","hrm","provisioning","source"],"created_at":"2024-11-10T22:26:48.937Z","updated_at":"2026-05-14T17:42:22.882Z","avatar_url":"https://github.com/Tools4everBV.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HelloID-Conn-Prov-Source-SDBHR\n\n\u003e [!WARNING]\n\u003e This repository contains the connector and configuration code only. The implementer is responsible to acquire the connection details such as username, password, certificate, etc. You might even need to sign a contract or agreement with the supplier before implementing this connector. Please contact the client's application manager to coordinate the connector requirements.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/Tools4everBV/HelloID-Conn-Prov-Source-SDBHR/blob/main/Logo.png\"\u003e\n\u003c/p\u003e \n\n## Table of contents\n\n- [HelloID-Conn-Prov-Source-SDBHR](#helloid-conn-prov-source-sdbhr)\n  - [Table of contents](#table-of-contents)\n  - [Introduction](#introduction)\n  - [Supported features](#supported-features)\n  - [Getting started](#getting-started)\n    - [Requirements](#requirements)\n    - [Connection settings](#connection-settings)\n    - [Mapping](#mapping)\n  - [Remarks](#remarks)\n  - [Development resources](#development-resources)\n    - [API endpoints](#api-endpoints)\n    - [API documentation](#api-documentation)\n  - [Getting help](#getting-help)\n  - [HelloID Docs](#helloid-docs)\n\n## Introduction\n\nThe SDB-HR connector is a source and provides a set of REST API's that allow you to programmatically interact with it's data.\n\n## Supported features\n\nThe following features are available:\n\n| Feature                | Supported | Remarks                                   |\n| ---------------------- | --------- | ----------------------------------------- |\n| **Persons import**     | ✅         | Retrieves the employees and the contracts |\n| **Departments import** | ✅         | Retrieves the departments                 |\n\n## Getting started\n\n### Requirements\n\n- A valid **API User** and **API Key** to authenticate with the SDB API.\n- **Access** for the API User to the following **API endpoints**:\n  - /api/medewerkersbasic (GET)\n  - /api/dienstverbandenbasic (GET)\n  - /api/dienstverbandperiodesbasic/periode/{jaar}/{maand} (GET)\n  - /api/afdelingen (GET)\n\nNote: both have to be created and configured by an SDB consultant.\n\n### Connection settings\n\nThe following settings are required to connect to the API.\n\n| Setting         | Description                                                                                         | Mandatory |\n| --------------- | --------------------------------------------------------------------------------------------------- | --------- |\n| ApiUser         | The UserName for the ApiUser that has rights to connect to the SDBHR API                            | Yes       |\n| ApiKey          | The ApiKey to connect to the SDBHR API                                                              | Yes       |\n| KlantNummer     | The number of the customer. Usually these are three-digit numbers                                   | Yes       |\n| BaseUrl         | The BaseUrl to the SDBHR environment (e.g., https://api-\u003cCustomer\u003e.sdbstart.nl)                     | Yes       |\n| PastThreshold   | The amount of days a contract's end date can be in the past and still be included in the import     | Yes       |\n| FutureThreshold | The amount of days a contract's start date can be in the future and still be included in the import | Yes       |\n\n### Mapping\n\nThe mapping can be imported by using the _mapping.json_ file.\n\n\n## Remarks\n\n**Multiple person objects per identity**  \n- The employee dataset can contain **multiple person objects for a single identity**. There is **no unique identifier** that guarantees a single real person. Each person object includes one employment, which can result in **multiple persons in HelloID for the same individual**.\n\n**Start and end date fields**  \n- There are **two sets of start and end date fields**: one on the employment (dienstverband) and one on the contract. Be careful when mapping these fields. **By default**, the connector uses the **employment (dienstverband) dates**.\n\n**Single contract per employment**  \n- SDB endpoints return **only one single contract per employment**. This means that future changes (e.g., a new role effective next month) only appear on the day they become active and are not available beforehand (or after they were active).\n- This is not ideal because historical and future contract data are missing. These are often needed to assign rights before or after an active contract.\n- If **additional rights** are required (based on multiple active contracts), an extra employment must exist so rights can be assigned based on both employments.\n\n**Threshold-based filtering**  \n- This connector **only imports persons with a contract within the configured thresholds**, based on employment (dienstverband) dates. Adjust these thresholds if needed.\n\n## Development resources\n\n### API endpoints\n\nThe following endpoints are used by the connector\n\n| Endpoint                                                     | Description                                                                                                                                                                                                   |\n| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| /api/medewerkersbasic (GET)                                  | Retrieve all employees                                                                                                                                                                                        |\n| /api/dienstverbandenbasic (GET)                              | Retrieve all employments. **Note:** This endpoint always returns the latest known values, which may include future changes (e.g., a new role effective next month) after a salary run.                        |\n| /api/dienstverbandperiodesbasic/periode/{year}/{month} (GET) | Retrieve actual employment data for the specified period. This ensures the data reflects the real situation as of today, rather than future changes that are already processed in the latest employment data. |\n| /api/afdelingen (GET)                                        | Retrieve all departments                                                                                                                                                                                      |\n### API documentation\n\n[https://api.sdbstart.nl/swagger/ui/index#Resources](https://api.sdbstart.nl/swagger/ui/index#Resources)\n\n## Getting help\n\n\u003e _For  information on how to configure a HelloID PowerShell connector, please refer to our [documentation](https://docs.helloid.com/hc/en-us/articles/360012557600-Configure-a-custom-PowerShell-source-system) pages_\n\n\u003e _If you need help, feel free to ask questions on our [forum](https://forum.helloid.com)_\n\n## HelloID Docs\n\nThe official HelloID documentation can be found at: https://docs.helloid.com/\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-source-sdbhr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-source-sdbhr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-source-sdbhr/lists"}