Koppeling met Caoloon.com
Als u gebruikmaakt van de koppeling met Caoloon.com, kunnen de caogegevens automatisch worden ingelezen en geüpdatet. Daarvoor moet u op de pagina Externe datavalidatiesystemen setup de sneltab Caoloon inrichten. Om de gegevens automatisch op te halen, moet u een of meer taakwachtrijposten instellen.
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
Standaard cao-gegevens die Caoloon aanlevert
Caoloon.com levert standaard de volgende algemene cao-gegevens aan:
| 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 het veld Cao-code aanmaken per cao-versie niet actief is, wordt de begindatum ingelezen op de pagina Cao versies. Is dat veld ingeschakeld, dan wordt de begindatum ingelezen in het veld Begindatum op de pagina Cao. Zie ook Cao versies, Veld Begindatum en Veld Cao-code aanmaken per cao-versie |
| Einddatum |
Als op de pagina Externe datavalidatiesystemen setup het veld Cao-code aanmaken per cao-versie niet actief is, wordt de einddatum ingelezen op de pagina Cao versies. Is dat veld ingeschakeld, dan wordt de einddatum ingelezen in het veld Einddatum op de pagina Cao. 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 |
|
KVK-nummers [vanaf release 25.01.0700] |
Zie ook Pagina KvK-nummers per cao |
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.
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.
Om inlenerscao's te onderscheiden van reguliere cao's is op de cao het veld Inlenerscao ingeschakeld.
Zie ook de handleiding van Caoloon.com over het inlenersportaal: https://handleiding.test.caoloon.com/
Afwijkingen op functies, toeslagen en/of HTML tekst
Voor inleners die het overgrote deel van de cao volgen, maar alleen afwijken op functies, toeslagwerksoorten en/of HTML tekst, stuurt Caoloon.com geen volledige inlenerscao. In dat geval worden in MSF alleen de afwijkingen per inlener vastgelegd en wordt verder gebruikgemaakt van de reguliere cao en loontabellen.
Taakwachtrijpost(en) instellen
Om de gegevens van Caoloon.com automatisch op te halen is een taakwachtrijpost nodig met:
- codeunit 11076422 (JQ: Sychronize Caoloon.com), of
- rapport 11076467. Zie ook Rapport Synchroniseer cao's vanuit Caoloon.com
Belangrijk: De codeunit haalt alleen standaardcao’s (reguliere cao's) op in MSF en kent geen filtering. Daarom adviseren wij in alle gevallen om het rapport te gebruiken!
Gebruikt u rapport 11076467, dan kunt u aparte taakwachtrijposten instellen voor standaardcao's en inlenerscao's.
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.
Schakel Importeer loontabellen in om loontabellen te importeren. Zie 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. In de loonbepaling op de projectresource vindt vervolgens een correctie plaats naar het minimumloon. Is daarnaast ook een toeslag op het loon vastgelegd, dan wordt een eventuele toeslag op het loon toegepast na de minimumlooncorrectie. Zie ook Veld Minimumloon.
Het veld Importeer functies kunt u alleen inschakelen als Importeer loontabellen actief is.
Schakel Importeer functies in om functies inclusief de aard werkzaamheden en de inschaling per loontabel te importeren.
Wijzigt tijdens de looptijd van een loontabel de inschaling van een functie, dan 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 Modelleerbare acties.
Zie ook Pagina Functies per loontabel.
Schakel Importeer werksoorten in om de werksoorten van de cao te importeren.
Opmerking: Werksoorten met urensoort Vergoeding zijn hiervan uitgesloten. Wilt u deze ook importeren, schakel dan Importeer vergoeding werksoorten in.
Mapping
Per werksoortcode die Caoloon.com aanlevert moet u instellen met welke werksoortcode in MSF deze overeenkomt. Zie Caoloon werksoort mapping overzicht.
Gegevens per werksoortregel
Bij urenwerksoorten worden het loon- en tariefpercentage automatisch ingelezen.
Bij het inlezen van een werksoort:
-
vult Caoloon.com indien van toepassing een begin- en/of einddatum.
-
wordt het veld Centraal beheren ingeschakeld. Zie ook Veld Centraal beheren.
Gedetailleerde werksoortomschrijving wel of niet inlezen
Caoloon.com leest ook de gedetailleerde werksoortomschrijving in (als in het JSON-bestand de sleutel 'description' is gevuld). Dit betreft het veld Werksoortomschrijving (gedetailleerd) in de werksoortregel op de caokaart. Zie ook Veld Werksoortomschrijving (gedetailleerd).
Voorbeeld: Bij een werksoort voor een kilometervergoeding is dat bijvoorbeeld de gedetailleerde omschrijving woon-werk enkele reis maximaal 30 km. Geen vergoeding over 1e 5 km enkele reis.
Gedetailleerde werksoortomschrijving niet inlezen
Het is niet altijd wenselijk om de gedetailleerde werksoortomschrijving te gebruiken. Op de pagina Caoloon werksoort mapping overzicht kunt u indien nodig per werksoort het veld Importeer werksoortomschrijving (gedetailleerd) uitschakelen. De gedetailleerde werksoortomschrijving wordt dan niet ingelezen bij de betreffende werksoorten. Zie ook Gedetailleerde werksoortomschrijving wel of niet importeren.
Overige velden niet ingelezen
De overige velden van een werksoortregel in een cao worden niet gevuld door Caoloon.com.
De werksoortomschrijving wordt automatisch overgenomen vanuit de werksoortkaart.
Het veld 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.
Schakel Importeer vergoeding werksoorten in om de vergoedingwerksoorten van de cao (werksoorten met de urensoort Vergoeding) te importeren.
Mapping
Per werksoortcode die Caoloon.com aanlevert moet u instellen met welke werksoortcode in MSF deze overeenkomt. Zie Caoloon werksoort mapping overzicht.
Gegevens per werksoortregel
Opmerking: Het bedrag wordt automatisch ingelezen in de tarieventabel en is niet zichtbaar in de cao. Op de projectresourcekaart met de cao is het bedrag van de vergoeding zichtbaar.
Bij het inlezen van een vergoedingwerksoort:
-
vult Caoloon.com indien van toepassing een begin- en/of einddatum.
-
wordt het veld Centraal beheren ingeschakeld. Zie ook Veld Centraal beheren.
Gedetailleerde werksoortomschrijving wel of niet inlezen
Caoloon.com leest ook de gedetailleerde werksoortomschrijving in (als in het JSON-bestand de sleutel 'description' is gevuld). Dit betreft het veld Werksoortomschrijving (gedetailleerd) in de werksoortregel op de caokaart. Zie ook Veld Werksoortomschrijving (gedetailleerd).
Voorbeeld: Bij een werksoort voor een kilometervergoeding is dat bijvoorbeeld de gedetailleerde omschrijving woon-werk enkele reis maximaal 30 km. Geen vergoeding over 1e 5 km enkele reis.
Gedetailleerde werksoortomschrijving niet inlezen
Het is niet altijd wenselijk om de gedetailleerde werksoortomschrijving te gebruiken. Op de pagina Caoloon werksoort mapping overzicht kunt u indien nodig per werksoort het veld Importeer werksoortomschrijving (gedetailleerd) uitschakelen. De gedetailleerde werksoortomschrijving wordt dan niet ingelezen bij de betreffende werksoorten. Zie ook Gedetailleerde werksoortomschrijving wel of niet importeren.
Overige velden niet ingelezen
De overige velden van een werksoortregel in een cao worden niet gevuld door Caoloon.com.
De werksoortomschrijving wordt automatisch overgenomen vanuit de werksoortkaart.
Het veld 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.
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. Dit betreft alle inkomensbestanddelen 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 gegevens in het JSON-bericht:
- 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 duration_start wordt ingelezen in het veld Begindatum
- de inhoud van 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 niet ingelezen
De overige velden van een werksoortregel in een cao worden niet gevuld door Caoloon.com.
De werksoortomschrijving wordt automatisch overgenomen vanuit de werksoortkaart.
Het veld 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 in dit veld werksoort EJU staat.
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 staat ook zijn ingericht op de pagina Grondslag periodieke uitkeringen (samen met de betreffende cao). Zie ook Pagina Grondslag periodieke uitkeringen.
Schakel Importeer ATV in om atv (arbeidstijdverkorting) te importeren op de pagina Cao uren vakantie van de cao. Dit betreft de ingangsdatum en het atv-aantal in dagen of het atv-percentage.
Heeft een cao loontabellen met verschillende atv-dagen of -percentages, dan worden automatisch meerdere cao-codes aangemaakt. Zie ook Veld Code.
Caoloon.com levert geen leeftijd en geboortejaar aan. Als u in een atv-regel handmatig het veld Leeftijd vanaf of Geboortejaar vult, overschrijft Caoloon.com die regel niet.
Zie ook Sneltab Cao ATV lijst.
Belangrijk: Het inschakelen van dit veld kan gevolgen hebben op eventuele (her)berekeningen in 2025 en eerder. Volg daarom de stappen in de werkinstructie Werkinstructie Activeren uitgebreide koppeling Caoloon (met en zonder Inlenersportaal).
Schakel Importeer vakantiedagen in om het aantal vakantiedagen te importeren op de pagina Cao uren vakantie van de cao, in de sneltab Cao vakantiedagen lijst. Dit betreft de ingangsdatum van de cao en het aantal dagen.
Is op de ingangsdatum van de cao al een record aanwezig (met een aantal vakantiedagen groter dan 0), dan overschrijft Caoloon.com die regel niet.
Afwijkend aantal vakantiedagen ten opzichte van standaardcao
Heeft een inlener een afwijkend aantal vakantiedagen ten opzichte van de standaardcao, dan maakt MSF een eigen cao-code aan.
Zie ook
Belangrijk: Het inschakelen van dit veld kan gevolgen hebben op eventuele (her)berekeningen in 2025 en eerder. Volg daarom de stappen in de werkinstructie Werkinstructie Activeren uitgebreide koppeling Caoloon (met en zonder Inlenersportaal).
Schakel Importeer vakantiegeld in om het percentage vakantiegeld te importeren op de pagina Cao uren vakantie van de cao, in de sneltab Cao vakantiegeld lijst. Dit betreft de ingangsdatum van de cao en het percentage.
Is op de ingangsdatum van de cao al een record aanwezig (met een percentage groter dan 0), dan overschrijft Caoloon.com die regel niet.
Afwijkend percentage ten opzichte van standaardcao
Heeft een inlener een afwijkend percentage ten opzichte van de standaardcao, dan maakt MSF een eigen cao-code aan.
Zie ook
Schakel Importeer HTML tekst in om HTML-teksten (cao-teksten) te importeren. Zie ook Teksten vastleggen bij een cao.
Op pagina Periodiekeninstellingen kan worden ingesteld op basis waarvan een volgende loontrede moet worden toegekend. Als u Importeer periodieken inschakelt, 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 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.
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 Periodiekeninstellingen.
Als 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. In de meeste gevallen is dit de gewenste situatie. Zie ook Cao versies.
Schakelt u dit veld in, dan worden bij het verschijnen van een nieuwe versie van de cao nieuwe cao- en loontabelcodes aangemaakt. Dit heeft nadelen. Zie Veld Code.
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.
Zie ook
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.
Zie ook
Het veld Vertraging bij ophalen wijzigingen (minuten) voorkomt dat cao-wijzigingen worden gemist door publicatievertraging aan de kant van Caoloon.com (de publicatiebatch draait elke 3 minuten).
Werking
-
De velden Reguliere cao's opgevraagd op en Inlenerscao's opgevraagd op houden bij wanneer voor het laatst wijzigingen zijn opgevraagd.
-
Bij een nieuw verzoek naar Caoloon.com worden de wijzigingen opgehaald vanaf dat laatste tijdstip.
-
Tussen het bijwerken en publiceren van Caoloon.com kan een kleine vertraging zitten. Daarom kunt u in het veld Vertraging bij ophalen wijzigingen (minuten) een vertraging instellen. Standaard is dat 15 minuten.
Voorbeeld: Stel dat de koppeling elke 10 minuten draait en dit veld staat op 15 minuten. Bij een run om 11.20 uur worden de wijzigingen vanaf 10.55 opgehaald. Hierdoor worden ook cao's meegenomen die iets later zijn gepubliceerd.
Synchroniseren van de gegevens
Gegevens handmatig verversen
Naast het automatisch ophalen van de caogegevens via een taakwachtrijpost 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. Klikt u vanuit een caokaart op de knop Synchroniseer cao-informatie vanuit Caoloon, dan haalt u de caowijzigingen van alleen de betreffende cao op.
Datum en tijdstip van bijwerken
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 veld staat op de pagina's:
-
Cao's
-
Cao
-
Loontabellen
-
Periodiekeninstellingen
Foutmelding
Doet zich bij het synchroniseren een fout voor, dan bevat de pagina Koppelingsmeldingen een (technische) foutmelding.
Zie ook
Taakwachtrijposten in Mysolution
Caoloon werksoort mapping overzicht
Werksoorten centraal of decentraal beheren