Api: Documentatie Enumerations (Opsommingen)
Deze pagina bevat een verzameling van verschillende enumeraties (opsommingen) die vereist zijn voor API-calls.
De enumeraties zijn onderverdeeld in de volgende categorieën:
- Verzuim (Absence)
- Bankrekening (Bank account)
- Bedrijfsperiode (Company period)
- Medewerkerdocumenten (Employee documents)
- Type medewerker (Employee type)
- Leaseautocontract (Lease car contract)
- Persoonlijke informatie (Personal info)
- Reden uit dienst (Reason out of service)
- SVW-instellingen (SVW settings)
- Loonheffing (Wagetax)
- Salaris (Salary)
Verzuim (Absence)
API-calls
Verzuim wordt gebruikt voor de volgende calls:
- Absence2_GetList
- Absence2_Insert
- Absence_GetAll_AllEmployeesByCompany
- Absence_GetList
- Absence_Insert
- Absence_PartialRecoveryInsert
- Absence_RecoveryInsert
Beschrijving
De waarde in de kolom Waarde is de variabele die je invult op de plaats van het vraagteken (?). Zie het onderstaande voorbeeld voor de call : Absence_Insert.

Verzuimcodes

Bankrekening (Bank account)
API-calls
Bankrekening wordt gebruikt voor de volgende calls:
Beschrijving

Bankrekening (Bank account)

Type Bankrekening (Bank account Type)

Bedrijfsperiode (Company Period)
API-call/Type Bedrijfsperiode
Beschrijving
Wanneer een gebruiker een bedrijf aanmaakt, wordt de bedrijfsperiode gekozen. De bedrijfsperiode geeft de verloningscyclus van een bedrijf aan. Nadat een bedrijfsperiode is aangemaakt, kan deze niet meer worden gewijzigd.
Als de aanvraag succesvol is, ontvang je een periode in het formaat jjjj-pp-type, waarbij het type staat voor:
- M: Maandverloning. Totaal 12 periodes per jaar.
- W4: 4-wekenverloning. Totaal 13 periodes per jaar.
- W1: Weekverloning. Totaal 52 periodes per jaar (53 periodes in 2021).
Voor het aanmaken van een bedrijf (Company_Insert) kunnen de volgende waarden worden gebruikt:
| Waarde | Periode | Omschrijving |
| 1 | M | Maandverloning. Totaal 12 periodes. |
| 2 | 4W | 4-wekenverloning. Totaal 13 periodes. |
| 3 | W1 | Weekverloning. Totaal 52 periodes (53 periodes in 2026). |
Extra info
De meeste informatie in Cash Payroll is gebaseerd op periodes. Met de bovenstaande methoden kun je ook de huidige periode van het bedrijf opvragen. Het is belangrijk om de huidige periode van het bedrijf te weten wanneer je informatie wilt ophalen uit of verzenden naar Cash Payroll. Wanneer je de huidige periode weet, weet je zeker dat alle informatie die je in deze periode verzendt, correct wordt verwerkt in de salarisadministratie (payroll).
Medewerkerdocumenten (Employee documents)
API Calls
De document-GUID wordt gebruikt in de API-call: EmployeeDocument_UploadDocument
Beschrijving
Een van de specifieke GUID's moet worden ingevoerd in de volgende parameter:

Type Medewerkerdocument

Type medewerker (Employee type)
API-calls
Medewerkertypes worden gebruikt voor de volgende calls:
Beschrijving
De variabele in de kolom Waarde is de waarde die je invult op de plaats van de int. Zie het onderstaande voorbeeld voor de call List_GetByDebtor

Type medewerker (Employee type)

Lease auto contract (Lease car contract)
API-calls
De volgende waarde kunnen worden gebruikt in deze calls:
- LeaseCar2_GetAll_EmployeesByCompany
- LeaseCar_Delete
- LeaseCar_Get
- LeaseCar_GetAll_EmployeesByCompany
- LeaseCar_GetCurrent
- LeaseCar_GetList
- LeaseCar_Insert
- LeaseCar_InsertCurrent
- LeaseCar_Stop
Beschrijving
Deze calls worden gebruikt voor het invoeren en ophalen van gegevens met betrekking tot auto's van de zaak (leaseauto's). De variabele uit de tabel ReasonNoContribution kan als volgt worden toegepast:

Reden geen eigen bijdrage (ReasonNoContribution) 
Fiscale bijtelling eigen gebruik (ContributionPrivatePercentage)


Persoonlijke informatie ({Personal Info)
API calls
- PersonalInfoContractSalaryAddress_GetAll_AllEmployeesByCompany
- PersonalInfo_Get
- PersonalInfo_GetAll_AllEmployeesByCompany
- PersonalInfo_GetCurrent
- PersonalInfo_Update
- PersonalInfo_UpdateCurrent
Beschrijving
Deze calls worden gebruikt voor het invoeren en ophalen van gegevens binnen het dashlet 'Persoonlijke Informatie'.
Type Identificatiebewijs (IndentificationType)

Burgelijke staat (Marital State)

Naamstelling (Named)

Reden uit dienst (Reason out of service)
API-calls
Reden uit dienst wordt gebruikt voor de volgende call:
Beschrijving
De variabele in de kolom Waarde is de waarde die je invult op de plaats van het vraagteken (?). Zie het onderstaande voorbeeld voor de call Service_StopCurrent 
Reden uit dienst

SVW-instellingen (SVW settings)
API-calls
De volgende enumeraties worden gebruikt in SVW-gerelateerde calls:
Aard arbeidsverhouding (Employment Type)
Vul de waarde uit de kolom Waarde in op de plaats van de int.


ZVW (Zorgverzekeringswet)


Inkomensafhankelijke bijdrage Zvw (SVW Contribution)


Invloed verzekeringsplicht (Influence Obliged Insurance)


Loonkostenvoordeel / LKV (Wage tax benefit)


Fase-indeling (Phase classification)
Let op: Fase-indeling is alleen van toepassing op uitzendkrachten (Aard arbeidsverhouding = 11 Uitzendkracht).


Loonheffing (Wagetax)
API-calls
De volgende enumeraties worden gebruikt in loonheffing-gerelateerde calls:
Beschrijving
Er zijn veel verschillende instellingen vereist voor het invoeren van loonheffingsgegevens, bijvoorbeeld:

Loonheffing (Wagetax)

Loonheffingskorting (Wagetax / reduced fare

Voordeelregel (Advantage rule)

KleurTabel (Color table)

TijdVakTabel (Period Table)

SpecialeTabel (Special Table)

SoortInkomen (Income Type)


JaarloonBT (Special annual salary rate) 
AfwBijzTariefLH (Different special rate (optional))

30% regeling (CodeCal30PercRule)

Salaristype (Salary Type)
API-calls
Salaristypes worden gebruikt voor de volgende call:
Salaris Type
