ds_fw_verrekening_insert

Operatie voor muteren van de schuld van een flexwerker.
Openstaande schulden kunnen ontstaan doordat Easyflex automatisch het netto loon ophoogt tot aan het Netto Equivalent Wettelijk Minimum Loon als een netto inhouding teveel is. In Easyflex zijn de openstaande schulden van een persoon te zien in het tabblad ‘Frontoffice > Flexwerkers > Verrekeningen’.
Deze operatie is bruikbaar als een persoon een openstaande schuld contant of via een bankoverschrijving voldoet aan de uitzendorganisatie en niet via een verloning.
In de aanroep is het verplicht de ID van een gebruiker uit Easyflex op te nemen. De service controleert of deze medewerker genoeg rechten heeft om een schuld te kunnen muteren.
De instelling in Easyflex bij ‘Beheer > Bedrijfsinstellingen > Autorisatie betalingen > Muteren schuld’ moet actief zijn en op ‘Nvt’ staan of er moet een rol zijn geselecteerd die de gesprecifceerde medewerker heeft. Anders zal een foutmelding worden gegenereerd.
Er wordt altijd een notificatie aangemaakt als de operatie succesvol is uitgevoerd. In de notificatie kan de naam van het externe systeem worden geplaatst en een omschrijving. In de omschrijving kan informatie worden opgeslagen over hoe, wat en wanneer de betaling heeft plaatsgevonden.
Het is ook mogelijk dat journaalposten worden aangemaakt zodat de externe betalingen in de financiële administratie zichtbaar zijn. Elke mutatie produceert 2 journaalposten: een credit boeking op de rekeninggroep “Correctie WAS” van het looncomponent wat gekoppeld is aan de schuld.
En een debet boeking op de journaalrekening die is vastgelegd voor de parameter “soortbetaling”. De service bevat ook een test vlag.
Als deze de waarde “true” heeft wordt het gehele proces doorlopen maar wordt de schuld niet permanent gewijzigd. Een notificatie wordt wel bij de persoon aangemaakt. Zo is te zien in Easyflex dat de operatie lukte en kan de inhoud van de notificatie worden getest.
De parameter “transactiekosten” is bedoelt om eventuele transactiekosten mee te sturen naar Easyflex. Wanneer deze niet gelijk zijn aan 0.00 worden deze kosten zowel debet als credit geboekt op de hiervoor vastgelegde journaalrekeningen.
Deze journaalrekeningen zijn terug te zien in ‘Bedrijfsinstellingen > Journaalrekeningen > Schulden verrekenen’.

Parameters

Attribuut	Type	Verplicht	Omschrijving
inschrijver	xsd:int	V	Registratienummer (idnr) van de medewerker.
registratienummer	xsd:int	V	Registratienummer (idnr) van de flexwerker.
schuldnummer	xsd:int	V	Registratienummer (idnr) van een schuld. De unieke nummers van een schuld zijn zichtbaar op de export van het overzicht verrekeningen.
bedrag	xsd:float	V	Dit is het bedrag waarmee de schuld wordt gewijzigd. Een positief bedrag zal de schuldpositie verlagen.
systeem	xsd:string(100)	V	De naam van het systeem waarmee de persoon de betaling heeft gedaan. Deze tekst wordt gebruikt in de titel van de notificatie die wordt aangemaakt bij de persoon.
omschrijving	xsd:string(1024)	O	Een omschrijving van de betaling. Deze tekst wordt gebruikt in de notificatie die wordt aangemaakt.
journaliseren	xsd:boolean	V	Indicator of de journaalposten worden aangemaakt. Deze worden dan op een later moment geëxporteerd naar de financiële administratie.
test	xsd:boolean	V	Indicator of het gehele proces zal worden doorlopen. Maar er wordt niets opgeslagen, behalve de notificatie.
soortbetaling	xsd:int	V	Soort betaling Klik hier voor meer info... 23840 Normaal 23841 Pin 23842 Overig Afhankelijk van de soort betaling wordt het bedrag op de bijbehorende journaalrekening geboekt.
transactiekosten	xsd:float	O	Transactiekosten die bij de verrekening horen. Wanneer deze niet gelijk zijn aan 0.00 worden deze transactiekosten op bijbehorende journaalrekeningen geboekt.
versie	xsd:string(40)	O	Vrij op te nemen tekst t.b.v. ontwikkelaar.

Fields

Attribuut	Type	Omschrijving
ds_fw_verrekening_insert_result	xsd:boolean	Indicator of het toevoegen succesvol is.
ds_fw_verrekening_insert_regnr	xsd:int	Registratienummer (idnr) van de verrekening.

Exceptions

Code	Detail	Omschrijving
39045	inschrijver heeft geen rechten voor muteren schuld	Zelfverklarend.
39043	registratienummer en/of schuldnummer	registratienummer en/of schuldnummer onbekend.
39051	saldo van schuld	Geen schuldsaldo aanwezig.
39043	soort betaling	Soortbetaling moet 23840, 23841 of 23842 zijn.
39043	soort betaling niet ingericht	Zelfverklarend.
39043	transactiekosten niet ingericht	Zelfverklarend.
39043	type van transactiekosten	Transactiekosten mogen maximaal 2 decimalen hebben.
39043	type van bedrag	Bedrag mag maximaal 2 decimalen hebben.
39043	geen beschikbaar loonjaar	Er is geen operationeel loonjaar beschikbaar.
39043	bepalen datum journaalpost	Er is geen journaalpost aanwezig.
39054	Probleem met journalisering, deze worden dynamisch teruggegeven in de exception	Journalisering.