Developers
Bouw payroll in je eigen software.
SALAR Payroll Engine is ontwikkeld voor softwareleveranciers die Nederlandse salarisberekening en loonaangifte rechtstreeks in hun eigen applicatie willen integreren. Jouw software. Jouw gebruikerservaring. Onze payrolltechnologie.
Bestaande API-basis
Een concrete REST-basis om op voort te bouwen.
SALAR beschikt al over een publieke REST API voor SalarFusion via Swagger, als API-versie v1 op basis van OAS 2.0. Voor SALAR Payroll Engine bouwen we hierop voort waar dat logisch is. Engine-specifieke functies — waaronder het aansturen van salarisberekeningen, berekenstatussen en webhooks — zijn in ontwikkeling.
| Resource | Voorbeelden |
|---|---|
| Employers | Werkgever, werknemers, dienstbetrekkingen, loonelementen, roosters |
| Employees | Persoonsgegevens, adressen, contact- en bankgegevens, documenten |
| Engagements | Dienstbetrekking, contract, loongegevens, loonaangiftegegevens |
| Wage data | Looncomponenten, vergoedingen, reserveringen, berekende vergoedingen |
| Outputs | Salarisspecificatie, jaaropgave, loonaangifte-XML, SEPA-XML |
Authenticatie
API-accounts met gerichte rechten.
- API-key genereren per API-account
- Authorisatieniveau: alleen lezen of lezen en schrijven
- Werkgevers afzonderlijk autoriseren
- Einddatum aan een API-account koppelen
- OAuth2 waar van toepassing
De definitieve manier waarop integratiepartners API-credentials ontvangen en beheren wordt nog als onderdeel van de Payroll Engine-onboarding vastgelegd.
Van gegevens naar payroll
Een herkenbare payrollflow voor developers.
- 01
Richt werkgever en werknemer in
Gebruik de API om werkgevers en werknemers te lezen en — waar ondersteund — aan te maken of te wijzigen.
- 02
Beheer de dienstbetrekking
De dienstbetrekking vormt een centrale payrollresource voor contract, loongegevens en loonaangiftegegevens.
- 03
Lever mutaties en loondata aan
Looncomponenten, vergoedingen en reserveringen kunnen via bestaande resources worden uitgelezen en gewijzigd.
- 04
Start en volg de salarisverwerking
Voor SALAR Payroll Engine wordt de salarisverwerking rechtstreeks vanuit de software van de integratiepartner aanstuurbaar. Specifieke endpoints zijn in ontwikkeling.
- 05
Verwerk de output
De bestaande API ontsluit salarisspecificaties, jaaropgaven, loonaangiftebestanden en SEPA-bestanden.
In ontwikkeling
Engine-specifieke uitbreidingen worden nog vastgelegd.
We publiceren geen fictieve endpoints of verzonnen JSON. Tot de OpenAPI-specificatie stabiel is, is deze statuslijst eerlijker dan marketingcode.
- Payroll Engine base URL en domeinstructuur
- Endpoint om proforma en/of definitieve salarisberekening te starten
- Statusmodel voor berekeningen, inclusief synchroon/asynchroon gedrag
- Webhooks: events, payloadstructuur, signing en retrybeleid
- Formeel versioning- en deprecationbeleid
- Demo- versus productieomgeving en credential-uitgifte
Klaar om te integreren?
Wil je beoordelen hoe SALAR Payroll Engine binnen jouw architectuur past? Bespreek je use-case met ons.