Koppeling met Caoloon.com
Als u gebruikmaakt van de koppeling met Caoloon.com, kunnen de caogegevens automatisch worden ingelezen en geüpdatet. Daarvoor moet op de pagina Externe datavalidatiesystemen setup de sneltab Caoloon zijn ingericht. Om de gegevens automatisch op te halen, moeten een of meer taakwachtrijposten zijn ingesteld.
Opmerking: Zie https://caoloon.com/koppelingen/mysolution/caos welke cao's beschikbaar zijn via deze koppeling.
Belangrijk: Caoloon.com stuurt een e-mail:
-
voorafgaand aan elke cao-wijziging in geval van reguliere cao's
- na een aanpassing van een inlenerscao op het inlenersportaal
Taakwachtrijpost(en)
De gegevens van Caoloon worden automatisch opgehaald als een taakwachtrijpost met:
- codeunit 11076422 (JQ: Sychronize Caoloon.com) is ingesteld, of
- rapport 11076467 is ingesteld. Zie ook Rapport Synchroniseer cao's vanuit Caoloon.com.
Standaard cao-gegevens die Caoloon aanlevert
De volgende algemene cao-gegevens worden standaard opgehaald van Caoloon.com:
| Veld | Toelichting/zie ook |
|---|---|
| Cao-nr. |
zie ook Veld Cao-nr. |
| Code |
zie ook Veld Code |
| Omschrijving | maximaal 250 tekens |
| Uren per week |
Als een cao loontabellen met verschillende aantallen uren per week heeft, worden automatisch meerdere cao-codes aangemaakt. Zie ook Veld Uren per week |
| Begindatum |
Als op de pagina Externe datavalidatiesystemen setup de optie Cao-code aanmaken per cao-versie is ingeschakeld, wordt de begindatum ingelezen in het veld Begindatum op de pagina Cao. Is deze optie niet ingeschakeld, dan wordt de begindatum ingelezen op de pagina Cao versies. Zie ook Cao versies, Veld Begindatum en Veld Cao-code aanmaken per cao-versie |
| Einddatum |
Als op de pagina Externe datavalidatiesystemen setup de optie Cao-code aanmaken per cao-versie is ingeschakeld, wordt de einddatum ingelezen in het veld Einddatum op de pagina Cao. Is deze optie niet ingeschakeld, dan wordt de einddatum ingelezen op de pagina Cao versies. Zie ook Cao versies, Veld Einddatum en Veld Cao-code aanmaken per cao-versie |
| Algemeenverbindendverklaring | |
| Bijgewerkt door Caoloon.com op | Zie ook Veld Bijgewerkt door Caoloon.com op en Veld Bijgewerkt door Caoloon.com op |
Uurloontabellen en/of maandloontabellen
Caoloon.com kan naast uurloontabellen ook maandloontabellen sturen (als maandloontabellen worden afgenomen). In geval van een maandloontabel wordt een aparte cao-code aangemaakt, met aan het eind van de code de toevoeging -M. Zie ook Veld Code.
Om maandloontabellen te kunnen verwerken bevat het JSON-bericht vanuit Caoloon.com de volgende velden/nodes:
- op cao-niveau: wage_preference (waarden: month en/of hour)
- op loontabelniveau: days_per_week en hours_per_day
- op loonregelniveau: monthly_salary
Inlenerscao's
Caoloon.com heeft een inlenersportaal, waar een inlener kan aangeven wat de afwijkingen zijn ten opzichte van de reguliere cao. Caoloon.com levert deze inlenerscao’s aan via de koppeling.
In het JSON-bericht vanuit Caoloon.com zijn hiertoe de volgende velden/nodes opgenomen:
- based_on - in geval van een inlenerscao geeft dit veld aan op welke standaardcao (cao-nr. met jaartal) deze gebaseerd is
- inlener_cao - geeft aan of het een standaardcao (waarde: false) of inlenerscao (true) betreft
- kvk_inlener - lijst met een of meer KvK-nummers waar de inlenerscao op van toepassing is
- company_name - de bedrijfsnaam die bij de inlenerscao hoort
- id - uniek id van Caoloon.com; dit wordt gebruikt bij het doorvoeren van wijzigingen, zie ook Veld Caoloon.com ID
- updated_at - geeft aan wanneer de cao gewijzigd is door Caoloon.com
Zie ook de handleiding van Caoloon.com over het inlenersportaal: https://handleiding.test.caoloon.com/
Om inlenerscao's te onderscheiden van reguliere cao's is op de cao het veld Inlenerscao ingeschakeld.
Help per veld
Voor verschillende cao-gegevens kunt u in de sneltab Caoloon van de pagina Externe datavalidatiesystemen setup instellen of ze moeten worden geïmporteerd, als u daar rechten voor hebt.
Veld Importeer loontabellen
Als Importeer loontabellen is ingeschakeld worden loontabellen geïmporteerd. Zie Loontabellen, onder Caoloon.com.
Toeslag in combinatie met Caoloon.com en minimumloon
In geval van het minimumloon levert Caoloon.com in de loontabel een loonregel met een waarde van 1,00 aan. Deze wordt vervolgens in de loonbepaling op de projectresource gecorrigeerd naar het minimumloon. Als daarnaast ook een toeslag op het loon wordt vastgelegd, wordt een eventuele toeslag op het loon na de minimumlooncorrectie toegepast op het loon. Zie ook Veld Minimumloon.
Veld Importeer functies
De optie Importeer functies kunt u alleen inschakelen als Importeer loontabellen is ingeschakeld.
Als Importeer functies is ingeschakeld, worden functies inclusief de aard werkzaamheden en de inschaling per loontabel geïmporteerd. Als tijdens de looptijd van een loontabel de inschaling van een functie wijzigt, wordt op de pagina Functies per loontabel automatisch een einddatum ingevuld in de regel met de oude inschaling en een nieuwe regel met de nieuwe inschaling toegevoegd.
Let op: Als er al projectresources zijn met de 'oude' inschaling, dan wordt niet automatisch een nieuwe projectresource aangemaakt met de nieuwe inschaling. Er volgt ook geen melding. Om te controleren of een nieuwe projectresource met een nieuwe inschaling aangemaakt moet worden, kunt u bijvoorbeeld een modelleerbare actie instellen. Zie ook Pagina Modelleerbare actie.
Zie ook Pagina Functies per loontabel.
Veld Importeer werksoorten
Als Importeer werksoorten is ingeschakeld, worden de werksoorten van de cao geïmporteerd.
Opmerking: Werksoorten met urensoort Vergoeding zijn hiervan standaard uitgesloten. Wilt u deze ook importeren, schakel dan de optie Importeer vergoeding werksoorten in.
Mapping
Per werksoortcode die Caoloon.com aanlevert moet worden ingesteld met welke werksoortcode in MSF deze overeenkomt. Deze mapping kunt u instellen op de pagina Caoloon werksoort mapping overzicht. Zie Caoloon werksoort mapping overzicht.
Gegevens per werksoortregel
Bij urenwerksoorten worden het loon- en tariefpercentage automatisch ingelezen.
Bij het inlezen van een werksoort kan een begin- en/of einddatum worden ingevuld door Caoloon.com.
Bij het inlezen van werksoorten wordt de optie Centraal beheren aangevinkt. Zie ook Veld Centraal beheren.
Gedetailleerde werksoortomschrijving
Als in het JSON-bestand het veld 'description' is gevuld, wordt in de werksoortregel op de caokaart het veld Werksoortomschrijving (gedetailleerd) standaard ingelezen door Caoloon.com. Zie ook Veld Werksoortomschrijving (gedetailleerd).
Voorbeeld: Bij een werksoort voor een kilometervergoeding wordt dan bijvoorbeeld de gedetailleerde omschrijving woon-werk enkele reis maximaal 30 km. Geen vergoeding over 1e 5 km enkele reis ingelezen.
Gedetailleerde werksoortomschrijving niet inlezen
Het is niet altijd wenselijk om de gedetailleerde werksoortomschrijving te gebruiken. Het is daarom mogelijk om op de pagina Caoloon werksoort mapping overzicht het veld Importeer werksoortomschrijving (gedetailleerd) uit te vinken, zodat de gedetailleerde werksoortomschrijving niet wordt ingelezen. Zie ook Veld Importeer werksoortomschrijving (gedetailleerd).
Overige velden
De overige velden van een werksoortregel in een cao worden niet gevuld door Caoloon.com.
De werksoortomschrijving wordt automatisch overgenomen vanuit de werksoortkaart.
De optie Automatisch tonen in urenstaat wordt in elke nieuwe regel automatisch aangevinkt, dus ook bij het inlezen van werksoorten door Caoloon.com. Zie ook Veld Automatisch tonen in urenstaat.
Handmatige wijzigingen
Belangrijk: Als u handmatig wijzigingen aanbrengt in de velden van werksoortregels die door Caoloon.com zijn ingelezen (bijvoorbeeld een percentage), dan worden deze bij een synchronisatie weer overschreven. Wijzigt u in een cao een werksoortveld dat niet door Caoloon.com is ingelezen (bijvoorbeeld de optie Automatisch tonen in urenstaat), dan wordt die wijziging niet overschreven. Handmatig toegevoegde werksoorten worden ook niet overschreven.
Veld Werksoort eindejaarsuitkering
Via dit veld is het mogelijk om automatisch een werksoort voor de eindejaarsuitkering in te lezen, in cao's waar dat van toepassing is.
Een van de onderdelen van de inlenersbeloning volgens de ABU-/NBBU-cao betreft vaste eindejaarsuitkeringen. Onder vaste eindejaarsuitkeringen worden alle inkomensbestanddelen verstaan die jaarlijks of periodiek terugkerend worden uitgekeerd, zoals een dertiende maand, eindejaarsuitkering of kerstgratificatie.
Caoloon levert ook informatie over de eindejaarsuitkering aan, maar niet als werksoort. Wel in de vorm van de volgende velden:
- duration_start met een datum
- year_end_bonus_type met de waarde percentage
- year_end_bonus_amount met een getal (percentage)
Werksoort eindejaarsuitkering inlezen
Als u in dit veld een werksoort instelt, wordt bij de betreffende cao's een regel toegevoegd aan de sneltab Werksoorten voor cao met de volgende gegevens:
- de werksoortcode uit dit veld in het veld Werksoort
- de inhoud van het veld duration_start wordt ingelezen in het veld Begindatum
- de inhoud van het veld year_end_bonus_amount wordt ingelezen in het veld Loon % (als het veld year_end_bonus_type de waarde amount heeft, worden de gegevens niet ingelezen)
Overige velden
De overige velden van een werksoortregel in een cao worden niet gevuld door Caoloon.com.
De werksoortomschrijving wordt automatisch overgenomen vanuit de werksoortkaart.
De optie Automatisch tonen in urenstaat wordt in elke nieuwe regel automatisch aangevinkt, dus ook bij het inlezen van werksoorten door Caoloon.com. Zie ook Veld Automatisch tonen in urenstaat.
Handmatige wijzigingen
Belangrijk: Als u handmatig wijzigingen aanbrengt in de velden van werksoortregels die door Caoloon.com zijn ingelezen (bijvoorbeeld een percentage), dan worden deze bij een synchronisatie weer overschreven. Wijzigt u in een cao een werksoortveld dat niet door Caoloon.com is ingelezen (bijvoorbeeld de optie Automatisch tonen in urenstaat), dan wordt die wijziging niet overschreven. Handmatig toegevoegde werksoorten worden ook niet overschreven.
Voorbeeld: Stel dat u in dit veld werksoort EJU hebt ingesteld.
Caoloon.com levert voor een bepaalde cao de volgende gegevens aan voor de eindejaarsuitkering:
Dit wordt als volgt ingelezen in de cao:
Werksoort instellen
In dit veld kunt u alleen werksoorten selecteren waarbij in het veld Urensoort de waarde Periodieke uitkering is ingesteld en die in minimaal 1 bedrijfseenheid actief zijn.
Zie ook Veld Urensoort.
Verwerken in urenstaten
Om de eindejaarsuitkering te verwerken, moet de werksoort die in dit veld is ingesteld, ook zijn ingericht op de pagina Grondslag periodieke uitkeringen (samen met de betreffende cao). Zie ook Pagina Grondslag periodieke uitkeringen.
Veld Importeer vergoeding werksoorten
Als Importeer vergoeding werksoorten is ingeschakeld, worden de vergoedingwerksoorten van de cao (werksoorten met de urensoort Vergoeding) geïmporteerd.
Mapping
Per werksoortcode die Caoloon.com aanlevert moet worden ingesteld met welke werksoortcode in MSF deze overeenkomt. Deze mapping kunt u instellen op de pagina Caoloon werksoort mapping overzicht. Zie Caoloon werksoort mapping overzicht.
Gegevens per werksoortregel
Opmerking: Het bedrag wordt automatisch ingelezen in de tarieventabel en is niet zichtbaar in de cao. Als de cao op een projectresource wordt ingevuld, wordt het bedrag van de vergoeding getoond.
Bij het inlezen van een werksoort kan een begin- en/of einddatum worden ingevuld door Caoloon.com.
Bij het inlezen van werksoorten wordt de optie Centraal beheren aangevinkt. Zie ook Veld Centraal beheren.
Gedetailleerde werksoortomschrijving
Als in het JSON-bestand het veld 'description' is gevuld, wordt in de werksoortregel op de caokaart het veld Werksoortomschrijving (gedetailleerd) standaard ingelezen door Caoloon.com. Zie ook Veld Werksoortomschrijving (gedetailleerd).
Voorbeeld: Bij een werksoort voor een kilometervergoeding wordt dan bijvoorbeeld de gedetailleerde omschrijving woon-werk enkele reis maximaal 30 km. Geen vergoeding over 1e 5 km enkele reis ingelezen.
Gedetailleerde werksoortomschrijving niet inlezen
Het is niet altijd wenselijk om de gedetailleerde werksoortomschrijving te gebruiken. Het is daarom mogelijk om op de pagina Caoloon werksoort mapping overzicht het veld Importeer werksoortomschrijving (gedetailleerd) uit te vinken, zodat de gedetailleerde werksoortomschrijving niet wordt ingelezen. Zie ook Veld Importeer werksoortomschrijving (gedetailleerd).
Overige velden
De overige velden van een werksoortregel in een cao worden niet gevuld door Caoloon.com.
De werksoortomschrijving wordt automatisch overgenomen vanuit de werksoortkaart.
De optie Automatisch tonen in urenstaat wordt in elke nieuwe regel automatisch aangevinkt, dus ook bij het inlezen van werksoorten door Caoloon.com. Zie ook Veld Automatisch tonen in urenstaat.
Handmatige wijzigingen
Belangrijk: Als u handmatig wijzigingen aanbrengt in de velden van werksoortregels die door Caoloon.com zijn ingelezen (bijvoorbeeld een percentage), dan worden deze bij een synchronisatie weer overschreven. Wijzigt u in een cao een werksoortveld dat niet door Caoloon.com is ingelezen (bijvoorbeeld de optie Automatisch tonen in urenstaat), dan wordt die wijziging niet overschreven. Handmatig toegevoegde werksoorten worden ook niet overschreven.
Veld Importeer ATV
Als Importeer ATV is ingeschakeld, wordt atv (arbeidstijdverkorting) geïmporteerd. Dit betreft de ingangsdatum en het atv-aantal in dagen of het atv-percentage. Leeftijd en geboortejaar worden niet aangeleverd.
Als in een regel handmatig het veld Leeftijd vanaf of Geboortejaar wordt gevuld, wordt die regel niet overschreven door Caoloon.com. Zie ook Sneltab Cao ATV lijst.
Als een cao loontabellen met verschillende atv-dagen of -percentages heeft, worden automatisch meerdere cao-codes aangemaakt. Zie ook Veld Code.
Veld Importeer HTML tekst
Als Importeer HTML tekst is ingeschakeld, wordt HTML-tekst geïmporteerd. Dit betreft cao-teksten. Zie ook Cao html-omschrijving.
Veld Importeer periodieken
Op de pagina Periodiekeninstellingen kan worden ingesteld op basis waarvan een volgende loontrede moet worden toegekend. Als Importeer periodieken is ingeschakeld, kunnen de periodiekeninstellingen per cao worden geïmporteerd. Deze worden aangeleverd op loontabelniveau.
Let op: De data wordt momenteel nog niet aangeleverd door Caoloon.com.
Zorg dat ook de optie Importeer loontabellen is ingeschakeld.
Opmerking: Als een loontabel wijzigt, dus als Caoloon.com een loontabel met een nieuwe ingangsdatum inleest, wordt de bestaande periodiekeninstellingsregel automatisch overschreven.
In het JSON-bericht dat Caoloon.com stuurt staat een blok 'periodiek_verhogingen' onder de loontabel.
Voorbeeld:
Caoloon.com kan de volgende velden vullen in de periodiekeninstellingen:
- Cao-code
- Cao-omschrijving
- Loontabelcode
- Loontabelomschrijving
- Soort - zie ook Veld Soort
- Aantal weken - zie ook Veld Aantal weken
- Aantal uren - zie ook Veld Aantal uren
- Kalender - zie ook Veld Kalender
Na het inlezen heeft het veld Tellingsoort de waarde Projectresource en het veld Tellingniveau waarde Loontrede.
Zie ook Pagina Periodiekeninstellingen.
Veld Cao-code aanmaken per cao-versie
Als de optie Cao-code aanmaken per cao-versie is uitgeschakeld, wordt elke nieuwe versie van een cao toegevoegd aan de pagina Cao versies van de betreffende cao. Is de optie ingeschakeld, dan worden bij het verschijnen van een nieuwe versie van de cao nieuwe cao- en loontabelcodes aangemaakt. Zie ook Cao versies en Veld Code.
Veld Reguliere cao's opgevraagd op
Dit veld geeft aan wanneer de gegevens voor standaardcao's voor het laatst zijn opgevraagd.
Let op: Dit veld wordt alleen bijgewerkt als de gegevens zijn opgevraagd via:
- rapport 11076467 waarbij de filtervelden Wijzigingen vanaf en Cao leeg zijn, of
- een taakwachtrijpost met codeunit 11076422
Zie ook
Veld Inlenerscao's opgevraagd op
Dit veld geeft aan wanneer de gegevens voor inlenerscao's voor het laatst zijn opgevraagd.
Let op: Dit veld wordt alleen bijgewerkt als de gegevens zijn opgevraagd via:
- rapport 11076467 waarbij de filtervelden Wijzigingen vanaf en Cao leeg zijn, of
- een taakwachtrijpost met codeunit 11076422
Zie ook
Synchroniseren
Naast het automatisch ophalen van de caogegevens via een of meer taakwachtrijpost(en) is het ook mogelijk om de gegevens handmatig te verversen. Vanuit de pagina Cao's kunt u dat doen via de knop Synchroniseer cao-informatie vanuit Caoloon. Vanuit een caokaart kunt u via de knop Synchroniseer cao-informatie vanuit Caoloon de caowijzigingen van alleen de betreffende cao ophalen.
Bijgewerkt op
Het veld Bijgewerkt door Caoloon.com op geeft aan op welke datum en welk tijdstip de gegevens voor het laatst zijn bijgewerkt door Caoloon.com. Dit betreft de datum en het tijdstip die in het JSON-bestand in het veld updated_at staan gevuld.
Foutmelding
Als zich bij het synchroniseren een fout voordoet, wordt een (technische) foutmelding opgenomen op de pagina Koppelingsmeldingen.
Zie ook
Taakwachtrijposten in Mysolution
Caoloon werksoort mapping overzicht
Werksoorten centraal of decentraal beheren
Bekijk ook de video Vernieuwingen in koppeling met Caoloon.com