Payroll koppeling
Remote PayFit koppeling: direct employees van de eigen Franse entiteit uit Remote als collaborator in PayFit
Een koppeling tussen Remote en PayFit maakt een direct employee van de eigen Franse entiteit in Remote aan als collaborator met contract in PayFit, met naam, privé-e-mail, adres, functietitel en startdatum. Medewerkers die Remote als employer of record in dienst heeft of zelf verloont, gaan niet naar PayFit.
Wat de koppeling doet
Organisaties die Remote gebruiken voor EOR in andere landen en ook hun eigen Franse medewerkers in Remote beheren, verlonen die Franse medewerkers in PayFit. Wie in Remote als direct employee start, wordt nu met de hand in PayFit aangemaakt, en een schuivende startdatum komt daar niet vanzelf aan.
- KoppelHet laadt eenmalig alle employments van het type direct_employee en registreert de webhooks van Remote.
- Bij een melding haalt KoppelHet het volledige dienstverband op en controleert de juridische entiteit.
- Een nieuwe Franse direct employee wordt een collaborator in PayFit, gevolgd door een contract.
- Loon en afwijkende startdatum gaan als taak naar de payrollbeheerder.
- Elke nacht vergelijkt KoppelHet de volledige lijst van Remote met de collaborators in PayFit.
Waar je op let bij Remote en PayFit
- Remote kent de types employee, contractor, direct_employee en global_payroll_employee. Alleen direct_employee is iemand in dienst van de eigen entiteit die Remote niet verloont. KoppelHet filtert de lijst op dat type en controleert daarna of engaged_by_legal_entity_id de Franse entiteit is.
- Voor direct_employee zijn in de Remote-API alleen List en Show employment beschikbaar; schrijven kan niet. De koppeling gaat dus één kant op, en een fout in naam of adres corrigeert HR in Remote, waarna KoppelHet de wijziging aan payroll meldt.
- De lijst van Remote is licht en bevat geen landspecifieke gegevens. PayFit vraagt een privé-e-mailadres en een adres met huisnummer, straat, plaats en postcode. KoppelHet haalt daarom per nieuwe Franse medewerker het volledige dienstverband op en splitst het adres in de delen die PayFit verplicht stelt.
- In het dienstverband van Remote heet de startdatum provisional_start_date, en die kan tot de eerste werkdag nog schuiven. PayFit maakt een contract met startDate, dat via de API niet te wijzigen is. KoppelHet vergelijkt de datum elke nacht en geeft een verschoven start als taak aan payroll.
- Remote heeft geen enkel event voor een gewijzigd dienstverband; er zijn losse employment-events voor persoonsgegevens, administratieve gegevens, status en werkmail. Remote raadt zelf aan af en toe de hele lijst opnieuw op te halen. KoppelHet doet dat elke nacht, zodat een gemiste melding geen ontbrekende collaborator in PayFit wordt.
- PayFit maakt een contract via de API alleen voor Frankrijk en geeft daarop 201 zonder gegevens; het contract verschijnt na twee tot vijf minuten. KoppelHet controleert daarna of het er staat voordat de Remote-medewerker als verwerkt geldt.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Gaat het loon ook mee?
Nee. In het dienstverband van Remote vonden we voor een direct employee geen salaris, en het PayFit-contract vraagt het niet. Payroll vult het loon in PayFit in.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Remote API met een bedrijfstoken: GET /v1/employments met employment_type=direct_employee en page, page_size; GET /v1/employments/{employment_id} voor engaged_by_legal_entity_id, provisional_start_date, personal_details en address_details. Webhooks via POST /v1/webhook-callbacks.
- PayFit via partner-api.payfit.com met een API-key: POST /companies/{companyId}/collaborators en POST /companies/{companyId}/collaborators/{collaboratorId}/contracts (alleen Frankrijk).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Remote | Veld in PayFit | Toelichting |
|---|---|---|
type (direct_employee) | Filter | employee en global_payroll_employee vallen af |
engaged_by_legal_entity_id | companyId in PayFit | Alleen de Franse entiteit |
full_name en personal_details | firstName, lastName | |
personal_email | personalEmail | Verplicht in PayFit |
address_details | personalAddress (streetNumber, addressFirstLine, city, postCode, country) | |
job_title, provisional_start_date | jobTitle, startDate (contract) |
Gerelateerd
Greenhouse → Remote
Greenhouse Remote koppeling: buitenlandse aannames als EOR-employment met het formulier van het land
Recruitee → Remote
Recruitee Remote koppeling: buitenlandse aannames direct als employment bij Remote
Remote → 4PS Construct
Remote 4PS Construct koppeling: eigen medewerkers van de bouwentiteit uit Remote in 4PS
Remote → Active Directory
Remote Active Directory koppeling: accounts voor collega's in andere landen