Werken met koppelingen in Staff #

Koppelingen zorgen dat jouw systemen met Staff samenwerken. Denk aan uren en loon, planning, kassa en inkoop. Zo hoef je gegevens maar één keer in te voeren — de rest gaat automatisch. Gebruik je nog geen koppelingen? Start dan met één koppeling, test of de data goed doorloopt en breid daarna rustig uit.

Wat is een koppeling? #

Een koppeling laat twee systemen met elkaar praten. Voorbeelden:

• Jouw kassasysteem stuurt dagelijks omzet door naar Staff (zie ook omzet registreren en Countler (omzet)).
• Jouw HR/loonpakket haalt uren en medewerkers op uit Staff (lees o.a. Nmbrs: account aanmaken voor koppeling en Uren-export inrichten voor Loket.nl en Nmbrs).
• Plan- en flexplatforms delen diensten en beschikbaarheid met Staff (zie Koppeling Temper en Beschikbaarheid).

Standaardkoppelingen (aan/uit te zetten in Staff) #

We bieden instructies voor veelgebruikte systemen. Een greep:

• Loon/HR: Nmbrs (FAQ koppeling), Loket.nl, SD Worx. Handig: check ook Mijn profiel (API-sleutel & rechten) en troubleshooten AFAS/Loket.nl – missende medewerker.
• Kassa/omzet: Sligro koppeling, Countler (omzet), MEWS omzetprognose.
• Tijd/klok: Kloktijden importeren vanuit SNL kassa, Klokken voor medewerkers, Aanwezigheid met Datafox.
• Uitzend/plaatsing: Connexie export.

Zoek je een andere koppeling? Gebruik de zoekfunctie op Help — grote kans dat er al een artikel is.

API-koppelingen (maatwerk) #

Wil je koppelen met een systeem dat nog niet standaard wordt ondersteund? Gebruik onze MaxCC API. Hiermee kun je o.a. medewerkers, uren/timesheets, afwezigheid, clocking, omzet en documenten veilig uitwisselen.

• API documentatie: https://api.staff.nl/
• Authenticatie: met API-sleutel (aanbevolen) of met gebruikersnaam/wachtwoord. Je API-sleutel vind je in Mijn profiel. Geen rechten? Mail support@staff.nl.

Voorbeeld: afwezigheid ophalen (API-sleutel) #

curl --location 'https://maxccdev.staff.nl/api/Absence/MyBalancesOverview' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
  "APIKeyLogin": {
    "DeviceId": "<jouw-apparaat-id>",
    "APIKey":   "<jouw-api-sleutel>"
  },
  "ISODate": "20250101"
}'

De API antwoordt in JSON. Ontwikkelaars kunnen hiermee eenvoudig scripts of integraties bouwen. Bekijk alle endpoints (zoals Absence, Timesheet, Employee, Invoicing, Clocking, OrganisationInfo) in de API documentatie.

Slim starten (beste werkwijze) #

1. Begin klein. Activeer één koppeling en test of data compleet is (uren, medewerkers, omzet).
2. Controleer rechten. Regel API-sleutel en gebruikersrechten via Mijn profiel.
3. Valideren & fiatteren. Gebruik Uren evaluatie en Evalueren en goedkeuren van kloktijden voordat je exporteert.
4. Troubleshoot snel. Veelvoorkomende issues staan in Troubleshooten AFAS/Loket.nl.
5. Breid uit. Klaar? Voeg een volgende koppeling toe, zoals Temper of Sligro.

Handige artikelen om direct door te pakken #

Nmbrs:
Account aanmaken voor koppeling •
Veelgestelde vragen over de koppeling •
Handmatig stroken importeren

Loket.nl / AFAS:
Uren-export inrichten en testen •
Troubleshooten missende medewerker •
AFAS automaten omzet importeren

Planning & klok:
Kloktijden importeren vanuit SNL kassa •
Klokken voor medewerkers •
Beschikbaarheid

Omzet & inkoop:
Countler (omzet) •
Sligro koppeling •
MEWS omzetprognose

Hulp nodig? #

Kom je er niet uit of wil je weten wat in jouw situatie het handigst is? Mail Staff Support B.V. via support@staff.nl — we denken graag mee.