Dit document beschrijft de ‘Attentia - Visma Raet Payroll API’-connector. De connector is door Popay gebouwd bovenop de Youforce Payroll API
De interface bestaat uit 2 hoofdstromen:
- Medewerkergegevens van HR Core Business naar Attentia
- Salarisstroken terug vanuit Attentia naar het personeelsdossier in Youforce
1 - MEDEWERKERGEVENS NAAR ATTENTIA
Medewerker gegevens.
De basis medewerker gegevens bestaat uit de volgende velden.
| Category Attentia | Veldnaam | Verplicht | API endpoint | API endpoint / field | Element nummer | Veldnaam HRCB |
| Keys | FrmTechnicalEntity | Ja | employee | companyId | 18 | Bedrijfscode |
| keys | WorkerNbr | Ja | employee | upi | 7014 | Uniek Persoonlijk ID (UPI) |
| Keys | AbWorkerCat | Ja | employee (Belgium only) | extensions/CategoryEmployee | 10525264 | Type medewerker (Werknemerscategorie (BE)) |
| NATURAL PERSON (Personal SWPD) | FirstName | Ja | employee | PersonData/firstname | 51 | Voornamen |
| NATURAL PERSON (Personal SWPD) | LastName | Ja | employee | PersonData/lastNameAtBirth | 24 | Geboortenaam (Achternaam) |
| NATURAL PERSON (Personal SWPD) | Gender | Ja | employee | PersonData/gender | 36 | Geslacht |
| NATURAL PERSON (Personal SWPD) | BirthDate | Ja | employee | PersonData/dateOfBirth | 35 | Geboortedatum |
| NATURAL PERSON (Personal SWPD) | Nationaliity | Ja | employee | PersonData/primaryNationality | 10204761 | Nationaliteit |
| EMPLOYEE (EmployeeData SWE) | hireDate | Ja | employee | hireDate | 39 | (Technische) Datum in dienst |
| EMPLOYEE (EmployeeData TE) | TerminationDate | Nee | employee | dischargeDate | 10520479 | Geplande laatste datum indienst |
| EMPLOYEE (EmployeeData SED) | CompanyHireDate | Ja | employee | employmentData/firstHireDate | 308 | Concerndatum |
| NATURAL PERSON (Contact SWC) | StreetNbr | Ja | employee | personData/addresses/street (type = Home) | 391 | Straat |
| NATURAL PERSON (Contact SWC) | StreetNbr | Ja | employee | personData/addresses/houseNumber (Type = Home) | 392 | Huisnummer (mdw.) |
| NATURAL PERSON (Contact SWC) | StreetNbr | Nee | employee | personData/addresses/addition (Type = Home) | 393 | Huisnummer toevoeging (mdw.) |
| NATURAL PERSON (Contact SWC) | ZipCode | Ja | employee | personData/addresses/zipCode (Type = Home) | 394 | Postcode (mdw.) |
| NATURAL PERSON (Contact SWC) | AddressCity | Ja | employee | personData/addresses/city (Type = Home) | 395 | Woonplaats (mdw.) |
| NATURAL PERSON (Contact SWC) | AddressCountry | Ja | employee | personData/addresses/country (Type = Home) | 34 | Woonland |
| NATURAL PERSON (Contact SWC) | HomeMobile | Nee | employee | personData/phoneNumbers/number (type = mobile) | 7377 | Telefoonnummer mobiel |
| NATURAL PERSON (Contact SWC) | HomeEmail | Nee | employee | personData/emailAddresses/address (type = private) | 7213 | E-mailadres |
| NATURAL PERSON (Family SWFM) | FamilyLastName [1] | Nee | employee | dependents/lastName (relationship = Partner) | 27 | Achternaam partner |
| NATURAL PERSON (Family SWFM) | FamilyFirstName [1] | Nee | employee | dependents/firstName (relationship = Partner) | 402 | Voornamen Partner |
| NATURAL PERSON (Family SWFM) | FamilyBirthDate [1] | Nee | employee | dependents/dateOfBirth (relationship = Partner) | 424 | Geboortedatum partner |
| NATURAL PERSON (Family SWFM) | FamilyGender [1] | Nee | employee | dependents/gender (relationship = Partner) | 10006087 | Geslacht Partner |
| NATURAL PERSON (Family SWFM) | FamilyDeceaseDate [1] | Nee | employee | dependents/DateOfDeath (relationship = Partner) | 10006578 | Overlijdensdatum partner (Partner overl datum) |
| NATURAL PERSON (Taxation SWT) | DateOfMarriage | Nee | employee | dependents/relationshipStartDate (relationship = Partner) | 7352 | Trouwdatum |
| NATURAL PERSON (Bank SWBA) | AccountNbr | Ja | employee | employmentData/Bankaccount/IBAN (BankAccountType = 01 -- Salarisrekening) | 7755 | IBAN (1) |
| NATURAL PERSON (Bank SWBA) | AccountCountry | Ja | employee | employmentData/Bankaccount/Country (BankAccountType = 01 -- Salarisrekening) | 10001091 | Land begunstigde (1) |
| NATURAL PERSON (Bank SWBA) | BIC | Ja | employee | employmentData/Bankaccount/BIC (BankAccountType = 01 -- Salarisrekening) | 7745 | BIC (1) |
| EMPLOYEE (EmployeeData SED) | ElecDoc | Ja | employee (Belgium only) | extensions/PrintPaySlips | 7707 | Salarisstroken afdrukken |
| NATURAL PERSON (Personal SWPD) | National registry Number | Ja | employee (Belgium only) | extensions/nationalInsuranceNumber | 10517301 | INSZ-nummer |
| NATURAL PERSON (Personal SWPD) | BirthCountry | Ja | employee (Belgium only) | extensions/countryOfBirth | 10517302 | Geboorteland |
| NATURAL PERSON (Education SWED) | EducationLevel | Nee | employee (Belgium only) | extensions/degreeOfEducation | 10525254 | Scholingsgraad |
| NATURAL PERSON (Taxation SWT) | FiscalSatus | Nee | employee (Belgium only) | extensions/taxStatus | 10525251 | Fiscale status |
| NATURAL PERSON (Taxation SWT) | MaritalStatus | Nee | employee (Belgium only) | extensions/MaritalStatusBE | 10517075 | Burgerlijke staat |
| NATURAL PERSON (Taxation SWT) | DateOfDivorce | Nee | employee | dependents/relationshipEndDate (relationship = Partner) | 10525230 | Datum scheiding |
| NATURAL PERSON (Taxation SWT) | SpouseIncome | Nee | employee (Belgium only) | extensions/incomePartner | 10517076 | Inkomen partner |
| NATURAL PERSON (Taxation SWT) | NbofChildren | Nee | employee (Belgium only) | extensions/NumberOfDependentChildren | 10517103 | Aantal kinderen fiscaal ten laste |
| NATURAL PERSON (Taxation SWT) | NbofDisabledChildren | Nee | employee (Belgium only) | extensions/NumberOfDependentHandicappedChildren | 10517104 | Aantal gehandicapte kinderen ten laste |
| NATURAL PERSON (Taxation SWT) | NbofOthers | Nee | employee (Belgium only) | extensions/NumberOfDependentPersons | 10517105 | Aantal anderen (inwonenden) ten laste |
| NATURAL PERSON (Taxation SWT) | NbofDisabledOthers | Nee | employee (Belgium only) | extensions/NumberOfDependentDependent | 10517106 | Aanal andere gehandicapte inwonenden ten laste |
| NATURAL PERSON (Taxation SWT) | Nbof65 | Nee | employee (Belgium only) | extensions/NumberOfDependentPersonsGt65 | 10517107 | Aantal anderen ten laste > 65 |
| NATURAL PERSON (Taxation SWT) | NbofDisabled65 | Nee | employee (Belgium only) | extensions/NumberOfDependentHandicappePersonsGt65 | 10517108 | Aantal gehandicapte personen ten laste > 65 |
| NATURAL PERSON (Taxation SWT) | HospitalisationInsurance [1] (???) | Nee | employee (Belgium only) | extensions/HospitalizationInsuranceForPartner | 10526113 | Hospitalisatieverzekering voor partner? |
| EMPLOYEE (Suspension SUEC) | SuspensionValidFrom [1] | Nee | employeeBenefits | StartDatePalliativeLeave | 10525238 | Begindatum Palliatief verlof |
| EMPLOYEE (Suspension SUEC) | SuspensionValidTo [1] | Nee | employeeBenefits | EndDatePalliativeLeave | 10525239 | Einddatum Palliatief verlof |
| EMPLOYEE (Suspension SUEC) | SuspensionType [1] | Nee | employeeBenefits | PalliativeLeave | 10525258 | Palliatief verlof |
| EMPLOYEE (Suspension SUEC) | SuspensionPct [1] | Nee | employeeBenefits | PercentagePalliativeLeave | 10525240 | Percentage Palliatief verlof |
| EMPLOYEE (Suspension SUEC) | SuspensionValidFrom [2] | Nee | employeeBenefits | StartDateMedicalAssistance | 10525241 | Begindatum Medische bijstand |
| EMPLOYEE (Suspension SUEC) | SuspensionValidTo [2] | Nee | employeeBenefits | EndDateMedicalAssistance | 10525242 | Einddatum Medische bijstand |
| EMPLOYEE (Suspension SUEC) | SuspensionType [2] | Nee | employeeBenefits | MedicalAssistance | 10525259 | Medische bijstand |
| EMPLOYEE (Suspension SUEC) | SuspensionPct [2] | Nee | employeeBenefits | PercentageMedicalAssistance | 10525243 | Percentage Medische bijstand |
| EMPLOYEE (Suspension SUEC) | SuspensionValidFrom [3] | Nee | employeeBenefits | StartDateParentalLeave | 10525234 | Begindatum Ouderschapsverlof |
| EMPLOYEE (Suspension SUEC) | SuspensionValidTo [3] | Nee | employeeBenefits | EndDateParentalLeave | 10525235 | Einddatum Ouderschapsverlof |
| EMPLOYEE (Suspension SUEC) | SuspensionType [3] | Nee | employeeBenefits | ParentalLeave | 10525257 | Ouderschapsverlof |
| EMPLOYEE (Suspension SUEC) | SuspensionPct [3] | Nee | employeeBenefits | PercentageInterruptionParentalLeave | 10525237 | Percentage onderbreking ouderschapsverlof |
| EMPLOYEE (Suspension SUEC) | SuspensionValidFrom [4] | Nee | employeeBenefits | StartDateTimeCredit | 10525261 | Begindatum Tijdskrediet |
| EMPLOYEE (Suspension SUEC) | SuspensionValidTo [4] | Nee | employeeBenefits | EndDateTimeCredit | 10525262 | Einddatum Tijdskrediet |
| EMPLOYEE (Suspension SUEC) | SuspensionType [4] | Nee | employeeBenefits | TimeCredit | 10525260 | Tijdskrediet |
| EMPLOYEE (Suspension SUEC) | SuspensionPct [4] | Nee | employeeBenefits | PercentageTimeCredit | 10525263 | Percentage Tijdskrediet |
| EMPLOYEE (EmployeeData SED) | SeniorityDate | Ja | employee (Belgium only) | extensions/seniorityDate | 10525233 | Anciënniteitsdatum |
| EMPLOYEE (EmployeeData TE) | TerminationReason | Ja bij undienst | employee (Belgium only) | extensions/ReasonForDismissal | 10525248 | Reden ontslag (BE) |
| EMPLOYEE (EmployeeData SED) | FunctionHierarchy | Ja | employee (Belgium only) | extensions/HierarchicalStatute | 10525247 | Hiërachisch statuut |
| EMPLOYEE (EmployeeData SED) | CommunicationLanguage | Nee | employee (Belgium only) | extensions/LanguagePayslip | 10517309 | Taal salarisstrook |
| NATURAL PERSON (Family SWFM) | FamilyLastName [2-9] | Nee | employee | dependents/lastName (relationship = child) | 726001 | Achternaam Kind (Achternaam kind) |
| NATURAL PERSON (Family SWFM) | FamilyFirstName [2-9] | Nee | employee | dependents/firstName (relationship = child) | 726808 | Voornaam Kind (Voornamen kind) |
| NATURAL PERSON (Family SWFM) | FamilyBirthDate [2-9] | Nee | employee | dependents/dateOfBirth (relationship = child) | 726101 | Geboortedatum Kind (Geboortedatum kind) |
| NATURAL PERSON (Family SWFM) | FamilyDeceaseDate [2-9] | Nee | employee | dependents/dateOfDeath (relationship = child) | 10006579 | Overlijdensdatum Kind (Datum overlijden kind) |
| NATURAL PERSON (Family SWFM) | FamilyGender [2-9] | Nee | employee | dependents/gender (relationship = child) | 10006110 | Geslacht Kind (Geslacht) |
| NATURAL PERSON (Family SWFM) | ToBurden [2-9] | Nee | employee (Belgium only) | dependents/extensions/DependentPersonStatus (relationship = child) | 90035305 | Is kind ten laste? |
| NATURAL PERSON (Family SWFM) | Disability [2-9] | Nee | employee (Belgium only) | dependents/extensions/DisabilityRate (relationship = child) | 90035306 | Invaliditeitspercentage |
| NATURAL PERSON (Family SWFM) | HospitalisationInsurance [2-9] | Nee | employee (Belgium only) | dependents/extensions/HospitalizationInsuranceForChild (relationship = child) | 90035307 | Hospitalisatieverzekering voor kind? |
| NATURAL PERSON (Family SWFM) | FamilyAllowance [2-9] | Nee | employee (Belgium only) | dependents/extensions/IsChildBenefitReceived (relationship = child) | 90035308 | Wordt kinderbijslag ontvangen? |
| ADMINISTRATION (Function SEF) | functionType | Ja | employee | employment/jobProfile | 97 | Functie |
| ADMINISTRATION (Location LE) | JobPlace | Ja | employee | employment/location | 75 | Standplaats (Vestiging) |
| ADMINISTRATION (Costcenter ACCTE) | CostCenter | Ja | employee | employment/costCenter | 53 | Kostenplaats |
| ADMINISTRATION (Costcenter ACCTE) | CostProduct | Nee | employee | employment/clasification | 474 | Kostendrager (Classificatiekenmerk) |
| EMPLOYEE (Transportation SET) | TransportDistance | Ja | employeeBenefits | TravelDistanceMeters | 10516632 | Reisafstand in meters |
| EMPLOYEE (Contract SEC) | ContractSocialSecurity | Ja | employee (Belgium only) | extensions/socialStatute | 10525249 | Sociaal statuut |
| EMPLOYEE (Contract SEC) | ContractSystem | Ja | employee | employment/dayPeriod | 464 | Dagen per week (Dagen periode) |
| EMPLOYEE (Contract SEC) | ContractHours | Ja | employee | employment/workingAmountInDay | 465 | Uren per week (Uren periode) |
| EMPLOYEE (Contract SEC) | ContractFlex | Ja | employee (Belgium only) | extensions/flex | 10525255 | Flex |
| EMPLOYEE (Salary) | FunctionLevel | Nee | employee benefits | SalaryScale | 10300574 | Salarisschaal (Salarisschaal) |
Arbeidsvoorwaarden, vergoedingen & inhoudingen
Binnen de API is een generieke structuur ontwikkeld voor de arbeidsvoorwaarden, vergoedingen & inhoudingen (vast / Periode) en vergoedingen & inhoudingen (eenmalig/dag).
Welke velden als arbeidsvoorwaarden, vergoedingen & inhoudingen in de API zijn opgenomen wordt bepaald door het HR Core systeem. Op dit moment is dit een vaste lijst met element die beheert wordt door HR Core.
Uitbreidingen op deze lijst (zie HR Core Business België velden) kunnen aangevraagd worden bij HR Core.
Belgische schermen
Verder zullen door PD de Belgische schermen ook per tenant geactiveerd moeten worden. Dit betreft de volgens schermen:
- Medewerker / Integratie Belië - Medewerker
- Medewerker / Gezinssituatie
- Medewerker / Personen ten laste
Voor het toevoegen van bovenstaande schermen aan HR Core Business, dient een 4me ticket bij HR Core Business ingelegd te worden.
Deze schermen worden middels een script aan de klant omgeving toegevoegd.
Verwachte doorlooptijd 2 / 3 sprints
Daarnaast zijn er op dit moment een aantal belgische specifieke arbeidsvoorwaarden ontwikkeld. Dit zijn de volgende arbeidsvoorwaarden:
- AVW scherm: Integratie België
- AVW scherm: Schorsingen - België
Daarnaast worden sommige Nederlandse arbeidsvoorwaarden voor België gebruikt. Zie hiervoor ook de eerder genoemde lijst met element.
Autorisatie filters
Op dit moment kan er alleen gefilterd worden op bedrijf.
Bij het onboaden van een nieuwe klant kan aangegeven worden welke bedrijven er in de koppeling meegenomen moeten worden.
Momenteel worden de filters nog in samenspraak met de API consultants door development ingericht. Dit maakt echter onderdeel uit van de onboarding van een nieuw klant op deze interface.
2 - SALARISSTROKEN NAAR YOUFORCE
De salarisstroken worden vanuit Attentia via de file API als ZIP file naar de payroll API gestuurd. Binnen de Payroll API wordt de ZIP file uitgepakt en worden de individuele salarisstroken in het persooneelsdossier van de individuele medewerker opgeslagen.
Informatie over de mapping tussen Attentia en het Personeelsdossier is verwerkt in de file name.
Voor nieuwe klanten moet moet ten minste de file API geactiveerd worden.
Over Visma
Copyright 2022 Visma Community. All right reserved.
Visma Denemarken
Visma Finland
Visma Letland
Visma Nederland
Visma Noorwegen
Visma Zweden
Visma Developers & Partners
Visma Latijns-Amerika