Lease and mobility
AFAS to FrieslandLease integration: drivers to FrieslandLease, lease car or bike back as a vehicle in AFAS
With an integration between AFAS Profit and FrieslandLease, an employee with a lease entitlement goes from AFAS to FrieslandLease as a driver automatically, and the active lease contract comes back to AFAS as a vehicle on the employee, with lease amount, catalogue value and taxable benefit percentage. The signed contract becomes a dossier item on the employee and the vehicle, so HR and payroll no longer retype anything.
What the integration does
Employers that lease cars, vans or bikes from FrieslandLease and run payroll in AFAS email new drivers to FrieslandLease and then retype the contract in AFAS. A wrongly copied list price leads to an incorrect taxable benefit on the payslip.
- HR records an employee in AFAS who is entitled to a lease car or lease bike.
- KoppelHet sends the driver to FrieslandLease with the details needed for the contract.
- The driver chooses and signs the contract with FrieslandLease.
- Once the contract is active, KoppelHet creates the vehicle on the employee in AFAS, at the right employer.
- The signed contract becomes a dossier item on the employee and the vehicle. Payroll checks the taxable benefit and includes the vehicle in the pay run.
Back: Vehicle with lease amount, catalogue value, taxable benefit and contract number · Signed contract as a dossier item
What to watch for with AFAS Profit and FrieslandLease
- AFAS has its own registration for vehicles on the employee, with lease amount, catalogue value and taxable benefit percentage. KoppelHet fills it from the active contract at FrieslandLease, so the catalogue value is no longer retyped.
- Leasing company and make are tables in AFAS that the organisation maintains itself. KoppelHet looks up the code for FrieslandLease and for the make. If one is missing, KoppelHet does not create the vehicle halfway, but HR gets an alert.
- FrieslandLease leases cars and bikes. AFAS has a type per vehicle, such as car, bike or speed pedelec, and a kind of lease, such as operational or financial. KoppelHet takes both from the contract, so a lease bike does not appear in AFAS as a car.
- Whether a vehicle counts in payroll is a separate choice per employee in AFAS. KoppelHet leaves that choice to payroll, so a taxable benefit only reaches the payslip after someone has checked the contract.
- The signed contract becomes a dossier item linked to both the employee and the vehicle. HR therefore finds it on the employee, and whoever opens the vehicle later sees the contract with it.
- An AFAS environment often contains several employers. The vehicle is registered at the employer of the employment, so the costs and taxable benefit end up in the right payroll administration.
- When the employment in AFAS gets an end date, FrieslandLease receives that date, so returning or transferring the car or bike is arranged on time.
How we build and run it
- The integration runs on the KoppelHet platform, hosted in a data centre in the EU.
- Every sync and every error is visible in the functional log; on an error your administrator is notified.
- A change that cannot go through is not half-applied but queued for another attempt.
- KoppelHet is ISO 27001 certified. Data travels encrypted and stays on the platform no longer than needed.
- After go-live we manage the integration and adjust it when your process changes.
- The integration fits next to your existing integration layer. Only the fields in the design are transferred; the platform keeps no register of its own.
Implementation and price
This is not an app you switch on. We build the integration for your organisation on our platform, with building blocks we reuse on every project. So it is custom work that does not start from scratch.
A consultant prepares the intake and analyses both systems. We then record the mapping and exceptions field by field, test in the test or acceptance environment and go live at a moment you choose. Costs are a one-off amount for the setup and a monthly amount for platform, monitoring and support.
Frequently asked questions
Does the integration put the taxable benefit on the payslip straight away?
No. The vehicle is ready in AFAS with taxable benefit percentage and catalogue value, but payroll switches on whether it counts in the pay run.
Does this also work for the lease bike?
Yes. AFAS has bike and speed pedelec as vehicle types. The type follows the contract at FrieslandLease.
What if FrieslandLease is not yet in the leasing companies table in AFAS?
Then the AFAS administrator adds it once. Until then the integration creates no vehicles and HR gets an alert.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- AFAS is read with a dedicated app connector with a GetConnector on employees and employments, filtered on change date. Makes come from a GetConnector on free tables (table MarkTabl). The vehicle goes to AFAS through UpdateConnector HrMobility with HrEmployeeMobility (EmId, DaBe, PeAd, PaVr, ApAd); the response returns the sequence number CcSn.
- The contract goes to AFAS through UpdateConnector KnSubject with KnSubjectLink (SfTp 2 for employee, SfId, CcSn of the vehicle) and KnSubjectAttachment (FileName, FileStream). The dossier item type (StId) is agreed with the AFAS administrator.
- FrieslandLease does not publish public API documentation. The connection on the FrieslandLease side is agreed with FrieslandLease.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in AFAS Profit | Field in FrieslandLease | Notes |
|---|---|---|
Medewerker (EmId) | Kenmerk van de berijder bij FrieslandLease | Key between both systems |
Naam, adres en contactgegevens | Gegevens van de berijder | |
Werkgever | Werkgever bij FrieslandLease | |
Soort leasecontract (terug) | HrMobility: TrTy (auto, fiets, speed-pedelec) en LeTy (operationeel of financieel) | |
Leasebedrag (terug) | HrMobility: LsAm | |
Cataloguswaarde (terug) | HrMobility: CtVl | |
Bijtellingspercentage (terug) | HrMobility: PeAd en HrEmployeeMobility: PeAd | |
Contractnummer en looptijd (terug) | HrMobility: CoNu, DaBl en DaEl | |
FrieslandLease | HrMobility: AgId | Code from the leasing companies table in AFAS |
Getekend contract (terug) | KnSubject met KnSubjectLink (medewerker en vervoermiddel) en KnSubjectAttachment |
Related
ADP Workforce Now → AFAS Profit
ADP Workforce Now to AFAS integration: Dutch employees from the US HR system in AFAS Profit
AFAS Profit → 4PS Construct
AFAS to 4PS Construct integration: payroll journal per employer in the right 4PS company
AFAS Profit → Adobe Creative Cloud
AFAS to Adobe Creative Cloud integration: users and product profiles from AFAS Profit
AFAS Profit → AG5
AFAS to AG5 integration: employees, employments and absence from AFAS Profit in the skills matrix