Het endpoint is te vinden op de overzichtspagina "Cobra API". In de onderstaande screenshot, geel gemarkeerd boven "Wijzig NewHire instroom workflow", staat het benodigde endpoint voor de koppeling.
De volgende endpoints zijn momenteel bij ons bekend:
Bestaande koppeling
Bij een bestaande verbinding wordt enkel de Client ID getoond. De Client Secret ID is alleen zichtbaar tijdens het creëren van de verbinding. Als deze niet meer functioneert of onbekend is, kan er een nieuwe worden gegenereerd met de knop 'Client secret aanmaken'.
Nieuwe koppeling
Bij het tot stand brengen van een nieuwe koppeling worden standaard zowel de Client ID als de Client Secret ID gegenereerd. Na de creatie is het mogelijk om de instellingen voor de API te configureren.
Benodigde autorisaties op het account in Cobra
Voordat we een verbinding kunnen opzetten, moeten we beschikken over de juiste autorisaties. Op dit moment kunnen we gegevens van Organisatie (OG), Werknemers (DV), Verzuim (VZ) en Gebruikers (GB) inlezen. De klant moet de volgende autorisaties in de kolom 'GET' hebben aangevinkt:
- Organization
- Department
- Person
- CitizenServiceNumber
- Address
- Phone
- PersonEmployment
- CurrentEmployment
- EmploymentHistory
- Function
- SickLeave
- SickLeavePeriod
- DynamicLists
Organisatie ID's te delen door klant
De klant dient het juiste OrganizationID of ID's te delen met Otherside at Work. Deze ID's moeten vervolgens in de Xpert Suite toegevoegd worden aan de desbetreffende werkgever bij de 'Werkgevercode'. Indien de werkgevercode niet correct is ingevuld, zal er geen data worden opgehaald. Het niet invullen van de werkgevercode zal resulteren in een foutstatus van de koppeling.