Wij zijn enthousiast om u te laten zien hoe Shyfter u zal helpen kostbare tijd te besparen bij het beheren van uw roosters.
Vraag een gratis demoKrijg uw volledig werkende versie van Shyfter en begin met plannen of tijdregistratie in de komende 5 minuten.
Probeer nu gratisDe SD Worx API is in wezen een digitale brug. Een cruciale verbinding die uw HR-software laat praten met andere bedrijfstools. Dankzij deze koppeling kunt u personeelsgegevens, urenregistraties en looninformatie automatisch en foutloos uitwisselen. Dat is de basis voor efficiënt personeelsbeheer.
De SD Worx API (Application Programming Interface) is een set van afspraken en protocollen die ervoor zorgt dat verschillende softwarepakketten met elkaar kunnen communiceren. U kunt het zien als een tolk die ervoor zorgt dat uw personeelsplanningstool, zoals Shyfter, en uw loonsoftware van SD Worx dezelfde taal spreken. Zeker voor Belgische ondernemingen is dat van onschatbare waarde.
Het hoofddoel is simpel: de uitwisseling van data tussen systemen automatiseren. In plaats van manueel werknemersgegevens, contractdetails of gewerkte uren over te tikken van het ene naar het andere platform, zorgt de API ervoor dat deze informatie vlot en in real time wordt gesynchroniseerd. Dit proces maakt niet alleen komaf met repetitief administratief werk, maar het verkleint ook de kans op menselijke fouten aanzienlijk.
Door uw HR-tools te verbinden via de SD Worx API, bouwt u een gecentraliseerd data-ecosysteem. Dit levert in de praktijk heel wat voordelen op die veel verder gaan dan enkel tijdsbesparing.
In België speelt de SD Worx API een sleutelrol bij het naadloos verbinden van personeelsplanningstools als Shyfter met de loonadministratie. We zien in de praktijk dat een goede integratie het aantal fouten met wel 80% kan verminderen. Vandaag de dag koppelen honderden Belgische bedrijven SD Worx via allerlei tools, wat leidt tot snellere rapportage en een merkbare daling van het absenteïsme.
Deze geautomatiseerde aanpak is vooral een must voor bedrijven met dynamische uurroosters, zoals in de horeca of retail. Een correcte en snelle verwerking van personeelsdata is daar de sleutel tot operationele perfectie. Voor meer achtergrondinformatie kunt u onze gids lezen over hoe wij uw sociaal secretariaat helpen.
Een API spreekt via 'endpoints'. Zie het als specifieke URL's die fungeren als toegangspoorten tot de data in je HR-software. Om het maximale uit de SD Worx API te halen en deze vlot te integreren met een planningstool zoals Shyfter, is het cruciaal om te begrijpen welke poorten je moet openen.
Elk endpoint heeft zijn eigen, specifieke taak. Sommige zijn bedoeld om data op te halen (een GET-request), terwijl andere dienen om informatie toe te voegen of aan te passen (POST- of PUT-requests). Voor HR-managers zijn vooral de endpoints rond werknemers, loon en tijdregistratie van goudwaarde.
De basis van elke HR-integratie is de data van je personeel. Via de werknemer-endpoints haal je de essentiële informatie op die je nodig hebt voor een sluitende personeelsplanning en administratie.
Denk hierbij aan:
Wanneer je een nieuwe medewerker aanmaakt in SD Worx, kan deze data automatisch gesynchroniseerd worden met Shyfter. Dit betekent dat je planningstool altijd over de meest actuele personeelsinfo beschikt, zonder dat er ook maar één manuele handeling aan te pas komt.
Een correcte loonverwerking is een van de meest kritische bedrijfsprocessen. De loon-endpoints van de SD Worx API slaan hier de brug tussen de gepresteerde uren in je planningstool en de uiteindelijke uitbetaling.
Een correcte datastructuur is hierbij essentieel. De API levert data vaak aan in een gestructureerd JSON-formaat. Dit formaat maakt het mogelijk om specifieke velden, zoals looncodes voor overuren of nachtwerk, direct te mappen naar de overeenkomstige velden in uw planningstool.
Dit zorgt ervoor dat prestaties die in Shyfter worden geregistreerd, zoals gewerkte uren, pauzes en toeslagen, rechtstreeks naar SD Worx kunnen worden gestuurd voor een snelle en foutloze payroll.
Overzicht van essentiële SD Worx API endpoints Een samenvatting van de belangrijkste endpoints, hun functie en de typische data die ze beschikbaar stellen voor integratie.
/employees: Ophalen en beheren van werknemersgegevens./payroll-results: Toegang tot verwerkte loonresultaten en loonfiches./timesheets: Synchroniseren van gewerkte uren en prestaties./absences: Beheren van afwezigheden./contracts: Inzien en beheren van arbeidscontracten.Deze endpoints vormen samen het zenuwcentrum voor de data-uitwisseling tussen je HR- en planningssystemen, en maken een geautomatiseerde workflow mogelijk.
De endpoints voor tijdregistratie zijn het hart van je operationele efficiëntie. Ze maken real-time synchronisatie van gewerkte uren en afwezigheden mogelijk, wat onmisbaar is voor een nauwkeurige planning en loonadministratie.
Specifiek voor de Belgische markt biedt de API via cobra.sdworx.com zogenaamde OData-endpoints voor resources zoals werknemersdata. Deze bevatten ook cruciale gegevens als het rijksregisternummer en fiscale ID's, essentieel voor een loonberekening conform de Belgische cao's. Dit stelt planningstools in staat om afwezigheden te combineren met gewerkte uren voor een payroll met een compliance-rate van 99% op Dimona-aangiften. Om de technische mogelijkheden verder uit te diepen, kan je de technische specificaties van de HR Selfservice webservice API raadplegen.
De SD Worx API koppelen aan een personeelsplanningstool zoals Shyfter is een project dat je best gestructureerd aanpakt. Een goede voorbereiding is het halve werk en zorgt ervoor dat de data-uitwisseling vanaf dag één vlekkeloos verloopt. Alles start met het verzamelen van de juiste gegevens en documentatie.
Voor je begint, heb je specifieke API-credentials van SD Worx nodig. Meestal gaat het om een client-ID en een client secret, die je kan zien als de gebruikersnaam en het wachtwoord voor je software. Neem contact op met je SD Worx accountmanager om deze sleutels aan te vragen. Vraag meteen ook naar de API-documentatie voor de endpoints die je wil gaan gebruiken.
Eens je de API-credentials in handen hebt, kan de configuratie in de Shyfter-omgeving beginnen. We hebben dit proces zo gebruiksvriendelijk mogelijk gemaakt, zodat je geen diepgaande technische kennis nodig hebt. Je navigeert simpelweg naar de integratie-instellingen en voert daar de ontvangen SD Worx API-gegevens in.
Hierna is het tijd om de synchronisatieregels in te stellen. Jij bepaalt welke data je wil uitwisselen en hoe vaak dat moet gebeuren. Je kan er bijvoorbeeld voor kiezen om dagelijks nieuwe werknemersgegevens te importeren en de prestatiegegevens wekelijks door te sturen voor de loonverwerking.
De onderstaande afbeelding geeft een helder beeld van de datastroom via de belangrijkste SD Worx API-endpoints.
Deze visualisatie laat zien hoe data over werknemers, lonen en prestaties naadloos van het ene naar het andere systeem stroomt. Dit vormt de basis van een geautomatiseerde HR-workflow.
Een absoluut cruciale stap is data mapping. Hierbij leg je de link tussen de velden uit SD Worx en de corresponderende velden in Shyfter. Denk aan het correct toewijzen van looncodes voor overuren of specifieke afwezigheidstypes zoals "ziekte" of "wettelijk verlof". Een correcte mapping is essentieel, want het zorgt ervoor dat beide systemen de data op precies dezelfde manier interpreteren en voorkomt zo fouten in de loonverwerking. Ontdek hoe een naadloze SD Worx payroll-integratie met Shyfter uw administratie kan vereenvoudigen.
Voor je live gaat, is een grondige testfase onmisbaar. Gebruik een beperkte set testdata — bijvoorbeeld van een fictieve medewerker — om de volledige cyclus van A tot Z te doorlopen.
Door de integratie eerst met testdata te valideren, spoor je eventuele problemen op in een veilige omgeving. Dit garandeert een soepele overgang, zonder dat je de live operaties en de loonverwerking van je echte medewerkers verstoort. Het verzekert een stabiele en betrouwbare dataflow vanaf dag één.
Zodra alles naar wens werkt, kan je de integratie activeren voor je volledige organisatie. Vanaf dan geniet je volop van de voordelen van een geautomatiseerde HR-administratie.
Theorie is één ding, maar hoe werkt de communicatie met de SD Worx API nu écht? Laten we het concreet maken. Elke interactie met een API bestaat uit een vraag (een request) en een antwoord (een response). Door naar echte voorbeelden te kijken, demystificeren we wat er achter de schermen gebeurt – handig voor zowel ontwikkelaars als HR-managers die de data-uitwisseling beter willen begrijpen.
Een van de meest voorkomende taken is het opvragen van de gegevens van een specifieke medewerker. Hiervoor stuur je een simpele GET-request naar het employees endpoint, met het unieke ID van de werknemer erbij.
Stel, je wilt de details van Jan Peeters met personeelsnummer 12345 opvragen. De request die jouw software naar de SD Worx API stuurt, ziet er dan zo uit:
GET /v1/employees/12345
Host: api.sdworx.com
Authorization: Bearer [JOUW_AUTHENTICATIETOKEN]
Je vraagt de server letterlijk: "Geef mij alle informatie die je hebt over werknemer 12345." De Authorization header is hierbij cruciaal; dit is de digitale sleutel die bewijst dat je gemachtigd bent om deze gegevens in te zien. Zonder geldig token krijg je simpelweg geen toegang.
Als de request succesvol is, stuurt de API onmiddellijk een antwoord terug. Dit gebeurt meestal in JSON-formaat (JavaScript Object Notation), een lichtgewicht en universele standaard die voor zowel machines als mensen makkelijk te lezen is.
Het antwoord op onze vraag over Jan Peeters zou er als volgt kunnen uitzien:
{
"employeeId": "12345",
"firstName": "Jan",
"lastName": "Peeters",
"nationalNumber": "85.01.15-123.45",
"contract": {
"contractType": "Vast",
"startDate": "2023-01-01",
"jobTitle": "Teamleider"
}
}
Zoals je ziet, is elk stukje informatie netjes gelabeld (bv. "firstName") met een bijbehorende waarde ("Jan"). Deze heldere structuur maakt het voor een tool als Shyfter kinderspel om de juiste velden te herkennen, te importeren en te gebruiken voor een vlekkeloze personeelsplanning.
Een ander praktisch voorbeeld is het ophalen van afwezigheden, wat essentieel is voor een accurate planning en loonverwerking. Zeker in sectoren als de event- en cateringbranche in België, waar naar schatting 60% van het personeel met flexibele roosters werkt, is dit onmisbaar. De HR Selfservice API van SD Worx kan bijvoorbeeld een nauwkeurigheid van 95% in de loonverwerking helpen garanderen, simpelweg door afwezigheden correct door te geven aan planningstools.
De API fungeert hier als de enige bron van waarheid. Door afwezigheden rechtstreeks uit SD Worx te halen, voorkom je dat je planningstool verouderde informatie gebruikt, wat dubbele boekingen en fouten in de loonberekening voorkomt.
Om de afwezigheden van een werknemer op te vragen, stuur je een gelijkaardige request, maar dan naar het absences endpoint.
GET /v1/employees/12345/absences?dateFrom=2024-01-01
Host: api.sdworx.com
Authorization: Bearer [JOUW_AUTHENTICATIETOKEN]
De API stuurt dan een lijst terug met alle geregistreerde afwezigheden vanaf de opgegeven datum, inclusief het type (ziekte, vakantie, etc.) en de duur. Maatwerk REST API-koppelingen voor dit soort data-uitwisseling zijn enorm populair. Meer technische details vind je in de documentatie van de HR Selfservice webservice API.
Deze voorbeelden tonen hoe krachtig en tegelijkertijd eenvoudig data-uitwisseling kan zijn. Het is precies deze gestructureerde communicatie die de basis vormt voor een efficiënte en geautomatiseerde HR-workflow.
Zelfs met de meest zorgvuldige voorbereiding kan er tijdens een API-integratie wel eens iets mislopen. De dataflow hapert, en plots verschijnt er een foutmelding. Geen paniek. Weten hoe je die fouten snel herkent en aanpakt, is cruciaal om je koppeling met de SD Worx API stabiel te houden.
De meeste API’s, en dus ook die van SD Worx, communiceren via standaard HTTP-statuscodes. Dit zijn genummerde antwoorden die de server terugstuurt. Ze vertellen je in een notendop of je verzoek succesvol was of waar het precies is fout gelopen. Deze codes begrijpen is de eerste stap naar een snelle oplossing.
Wanneer er iets fout gaat, is de statuscode je eerste en belangrijkste aanwijzing. In de context van de SD Worx API zul je vaak de volgende codes tegenkomen:
Het correct interpreteren van deze codes bespaart je een hoop zoekwerk en frustratie. Om het nog makkelijker te maken, hebben we de meest voorkomende fouten en hun oplossingen hieronder voor je samengevat.
Een snelle referentiegids voor het interpreteren en oplossen van de meest voorkomende fouten bij de SD Worx API-integratie.
Deze gids helpt je om snel te schakelen wanneer een van deze veelvoorkomende fouten de kop opsteekt, zodat je de dataflow snel weer op gang krijgt.
Loopt het toch ergens vast? Doorloop dan systematisch deze checklist. Zo kun je de meest voorkomende oorzaken snel uitsluiten en het probleem isoleren.
Een vaak vergeten aspect is 'rate limiting'. API's beperken het aantal aanvragen dat je binnen een bepaalde tijd mag doen om overbelasting te voorkomen. Als je te veel requests te snel na elkaar stuurt, krijg je een 429-fout (Too Many Requests). Zorg er dus voor dat je integratie deze limieten respecteert.
Door deze stappen te volgen, tackel je de meeste problemen met de SD Worx API vlot en efficiënt. Zo minimaliseer je de downtime en garandeer je een betrouwbare data-uitwisseling tussen je systemen.
Wie in België onderneemt, weet dat de sociale wetgeving complex is. De SD Worx API gebruiken is dan ook geen loutere technische upgrade, maar een strategische keuze om feilloos aan die verplichtingen te voldoen. De automatisering die de API brengt, is goud waard voor wie correct en efficiënt wil werken.
Door een directe lijn te leggen tussen een tool voor tijdregistratie, zoals Shyfter, en je payroll in SD Worx, worden gegevens automatisch en zonder fouten doorgestuurd. Dat is cruciaal om te voldoen aan de strenge regels die de Belgische arbeidsmarkt typeren.
De Belgische regelgeving eist een haarfijne administratie van prestaties en tewerkstelling. Met de SD Worx API voldoe je aan die eisen met een minimum aan manueel werk. De automatisering zorgt voor een stipte en correcte afhandeling van taken die je anders uren zouden kosten.
Denk bijvoorbeeld aan processen die je volledig kunt automatiseren:
Fouten in deze processen kunnen tot forse boetes en administratieve sancties leiden. De precisie van een API-koppeling verkleint dat risico aanzienlijk. Lees er meer over in ons artikel over het automatiseren van uw Dimona-aangifte.
Door de directe synchronisatie tussen tijdregistratie en payroll wordt de kans op menselijke fouten bij de loonverwerking tot een minimum beperkt. Dit verzekert niet alleen een correcte verloning, maar voorkomt ook dure boetes en tijdrovende correcties achteraf.
Een ander groot voordeel van de API-integratie is de garantie van data-integriteit. Omdat gegevens rechtstreeks van het ene naar het andere systeem vloeien, zonder manuele tussenstappen, blijft alle informatie consistent en betrouwbaar.
Bovendien laat elke synchronisatie een digitale voetafdruk achter. Zo bouw je een sluitende audittrail op die van onschatbare waarde is bij een sociale inspectie of interne controle. Je kunt op elk moment aantonen waar de data vandaan komt en hoe die verwerkt is.
Deze nauwkeurigheid is een absolute must in sectoren met veel flexibiliteit, zoals de horeca en de retail. Voor bedrijven die vaak met flexi-jobs en studentencontracten werken, is een foutloze registratie geen luxe, maar een wettelijke vereiste. De SD Worx API vormt hier de technologische ruggengraat voor een zorgeloze en conforme bedrijfsvoering.
Na het lezen van deze gids zit u misschien nog met een paar concrete vragen. Logisch, want een API-integratie is een belangrijke stap. Hieronder bundelen we de meest gestelde vragen van ondernemers en managers over de SD Worx API, met heldere en directe antwoorden.
Ja, doorgaans is het gebruik van de SD Worx API een betalende dienst. De precieze kosten hangen af van uw contract en het type data dat u wilt gaan gebruiken.
We raden altijd aan om hierover direct in gesprek te gaan met uw SD Worx accountmanager. Zij kunnen u een gedetailleerde prijsofferte op maat geven. Zo weet u precies waar u aan toe bent en komt u dit jaar niet voor verrassingen te staan.
Dat hangt ervan af. Voor een koppeling met een partnerplatform zoals Shyfter, waar de integratie al is voorbereid, heeft u meestal geen ontwikkelaar nodig. In zo’n geval volstaat het om de configuratiestappen binnen de software zelf te doorlopen.
Wilt u echter een maatwerkkoppeling bouwen met een ander, niet-standaard systeem? Dan is technische kennis of de hulp van een ontwikkelaar wel een must. Zij kunnen dan de specifieke request- en response-logica op maat van uw systemen implementeren.
De SD Worx API ontsluit een schat aan HR-data, wat de basis is voor een vlotte automatisering. Welke gegevens u precies kunt synchroniseren, hangt af van de specifieke API-endpoints die voor u geactiveerd worden.
Denk hierbij vooral aan data zoals:
Dankzij deze rijke dataset kunnen systemen als Shyfter en SD Worx naadloos informatie uitwisselen, wat uw HR-administratie een heel stuk eenvoudiger maakt.
Klaar om je planningsproces te revolutioneren?
Shyfter is meer dan alleen een planningstool – het is een complete oplossing voor personeelsbeheer, ontworpen om tijd te besparen, stress te verminderen en zowel werkgevers als werknemers tevreden te houden.
.jpg)
