ds_fw_vaste_beloning_update

Operatie voor het uitvoeren van een vaste beloning.
Dit is alleen mogelijk bij de volgende types:
20815 vast loon
20830 vergoedingen belast
20831 reiskostenvergoedingen belast/onbelast
20832 vergoedingen belast/onbelast
20833 vergoedingen in natura
20860 vergoedingen onbelast
20861 inhoudingen
20877 reiskostenvergoeding onbelast

Parameters

Attribuut	Type	Verplicht	Omschrijving
medewerker	xsd:int	V	Registratienummer (idnr) van de medewerker.
beloningnummer	xsd:int	V	Registratienummer (idnr) van de vaste beloning.
eenheid	xsd:int	O	Eenheid Klik hier voor meer info... 24170 Uur 24171 Dag (ma t/m vr) 24172 Gewerkte dag 24174 Kilometer 24175 Loontijdvak
bedrag	xsd:float	F	Belaste bedrag. Verplicht indien het een bruto looncomponent betreft.
bedragonbelast	xsd:float	F	Onbelaste bedrag. Verplicht indien het een netto looncomponent óf een looncomponent van type 20831 of 20832 betreft.
percentage	xsd:float	F	Percentage van het uurloon bij vergoedingen belast (bruto looncomponenten). Verplicht indien er geen bedrag is meegestuurd. Bij vast loon betreft dit het deeltijdpercentage. Standaard is het 100% bij vast loon.
inhouden	xsd:int	C	Indien het een inhouding betreft die begint ná 01-10-2018 dient inhouden meegestuurd te worden. Default = 25510. Klik hier voor meer info... 25510 Ja, volledig 25512 Ja, tot toegestaan minimum
startdatum	xsd:date	O	Startdatum van de vaste beloning.
einddatum	xsd:date	F	Einddatum van de vaste beloning.
loonsliptekst	xsd:string(50)	F	Afwijkende tekst op de loonstrook.
plaatsingnummer	xsd:int	F	Registratienummer (idnr) van de plaatsing waaraan vast loon dient te worden gekoppeld.
geenfactuur	xsd:boolean	O	Indicator of facturatie gewenst is.
kostenplaats	xsd:int	F	Registratienummer (idnr) van de kostenplaats van de relatie.
rekenwijze	xsd:int	O	Rekenwijze ten behoeve van de tariefcalculator. Klik hier voor meer info... 24110 Factor 24111 Marge 24112 Tarief
tarieffactor	xsd:float	O	Tarieffactor.
margeeuro	xsd:float	O	Marge in Euro.
margeperc	xsd:float	O	Marge percentage.
resultaat	xsd:float	O	Gewenste resultaat.
peildatumresultaat	xsd:date	O	Peildatum voor bepaling van de kostprijs(factor).
versie	xsd:string(40)	O	Vrij op te nemen tekst t.b.v. ontwikkelaar.
maxdagen	xsd:int	F	Indien eenheid 24172 is en looncomponent van type 20860 kan maxdagen (maximum dagen per week) worden meegestuurd.
jaarurennorm	xsd:boolean	O	Indicator of het toepassen van de jaarurennorm gewenst is. Mogelijk vanaf 01-01-2024. Standaard false, tenzij er al jaaruren waren opgeslagen.
loondispensatie	xsd:float	F	Loondispensatie in procenten.
werkuren Klik hier voor meer info... Bij een lege einddatum of bij een einddatum vanaf 2024, is dit veld verplicht bij vast loon, tenzij de jaarurennorm wordt toegepast.	xsd:int(5)	C	Standaard werkweek (uren). Dient bij vast loon ingevuld te zijn in minuten als er niet wordt gekozen voor het toepassen van de jaarurennorm. De standaard werkweek kan gevonden worden bij de relatie als er sprake is van een gekoppelde plaatsing.
jaaruren	xsd:int(6)	O	Jaaruren. Dient bij vast loon ingevuld te zijn in minuten als er wordt gekozen voor het toepassen van de jaarurennorm (vanaf 01-01-2024). De uren worden gebruikt voor de berekening van het minimumloon.
urenmaandag Klik hier voor meer info... Bij een lege einddatum of bij een einddatum vanaf 2024, dienen er standuurduren (per dag) voor vast loon aanwezig te zijn als er niet voor het toepassen van de jaarurennorm is gekozen.	xsd:int(4)	C	Hoeveelheid standaard minuten op maandag.
urendinsdag Klik hier voor meer info... Bij een lege einddatum of bij een einddatum vanaf 2024, dienen er standuurduren (per dag) voor vast loon aanwezig te zijn als er niet voor het toepassen van de jaarurennorm is gekozen.	xsd:int(4)	C	Hoeveelheid standaard minuten op dinsdag.
urenwoensdag Klik hier voor meer info... Bij een lege einddatum of bij een einddatum vanaf 2024, dienen er standuurduren (per dag) voor vast loon aanwezig te zijn als er niet voor het toepassen van de jaarurennorm is gekozen.	xsd:int(4)	C	Hoeveelheid standaard minuten op woensdag.
urendonderdag Klik hier voor meer info... Bij een lege einddatum of bij een einddatum vanaf 2024, dienen er standuurduren (per dag) voor vast loon aanwezig te zijn als er niet voor het toepassen van de jaarurennorm is gekozen.	xsd:int(4)	C	Hoeveelheid standaard minuten op donderdag.
urenvrijdag Klik hier voor meer info... Bij een lege einddatum of bij een einddatum vanaf 2024, dienen er standuurduren (per dag) voor vast loon aanwezig te zijn als er niet voor het toepassen van de jaarurennorm is gekozen.	xsd:int(4)	C	Hoeveelheid standaard minuten op vrijdag.
urenzaterdag Klik hier voor meer info... Bij een lege einddatum of bij een einddatum vanaf 2024, dienen er standuurduren (per dag) voor vast loon aanwezig te zijn als er niet voor het toepassen van de jaarurennorm is gekozen.	xsd:int(4)	C	Hoeveelheid standaard minuten op zaterdag.
urenzondag Klik hier voor meer info... Bij een lege einddatum of bij een einddatum vanaf 2024, dienen er standuurduren (per dag) voor vast loon aanwezig te zijn als er niet voor het toepassen van de jaarurennorm is gekozen.	xsd:int(4)	C	Hoeveelheid standaard minuten op zondag.
doorvoeren_decl	xsd:boolean	O	Indicator of de bijgewerkte vaste beloning direct wordt doorgevoerd in declaraties. Standaard false. Indien true, dan worden er in de array 'beloning_declaraties' declaraties getoond die aan de voorwaardes voldoen. Op basis van de vaste beloning, zal er in getoonde declaraties een vergoeding/inhouding zijn aangemaakt. Als de start- en/of einddatum zijn aangepast, dan kan er ook zijn toegevoegd of verwijderd. Bij een lcnr met looncomponentype 20815, dient er een plaatsing te zijn gekoppeld om doorgevoerd te kunnen worden. Bij een lcnr met looncomponentype 20860 of 20861, wordt er niet doorgevoerd bij eenheid 24175. Er wordt alleen doorgevoerd voor declaraties met een van de volgende statussen. Bij status 24840 dient de declaratie al eens bewerkt of geopend te zijn. Klik hier voor meer info... 24840 Urendeclaratie ontbreekt 24841 Accordering onvolledig 24842 Gereed voor eindaccordering 24843 Wachten 24846 Vervallen

Fields

Attribuut	Type	Omschrijving
result	xsd:boolean	Indicator of de update succesvol is.
update_beloning_problemen	array	Array met mogelijke problemen van de bewerkte vaste beloning.
problem_fwnr	xsd:int	Registratienummer (idnr) van de flexwerker.
problem_nr	xsd:int	Het nummer van het probleem.
problem_type	xsd:string	De ernst van het probleem.
problem_message	xsd:string	De omschrijving van het probleem.
beloning_declaraties	array	Array met de declaratiegegevens die zijn bijgewerkt door de parameter doorvoeren_decl
decl_nummer	xsd:int	Registratienummer (idnr) van de declaratie.
decl_periode_soort	xsd:int	Soort declaratieperiode. Klik hier voor meer info... 29770 Week 29771 4-weken 29772 Maand
decl_periode_nummer	xsd:int	Het nummer van de periode waarbinnen de declaratie valt. Als het gaat om een weekdeclaratie, dan is dat 1 tot en met 53, bij een 4-weken declaratie is het 1 t/m 13 en bij een maanddeclaratie is het 1 t/m 12.
decl_periode_start	xsd:date	De startdatum van de declaratie.
decl_periode_eind	xsd:date	De einddatum van de declaratie.
decl_job_nummer	xsd:int	Registratienummer (idnr) van de plaatsing.

Exceptions

Code	Detail	Omschrijving
39043	beloningnummer	Beloningnummer is onbekend.
39043	einddatum	De einddatum moet op of na de startdatum liggen.
39043	bedrag	Bedrag moet leeg of > 0 en < 100000 zijn.
39043	percentage	Belaste vergoeding percentage moet leeg of >= 0 en =< 100 zijn.
39043	bedrag/percentage	Belaste vergoeding bedrag en percentage mogen niet beide leeg zijn.
39043	percentage	Vast loon percentage moet leeg of > 0 en =< 100 zijn.
39043	kostenplaats	Kostenplaats is onbekend.
39043	margeeuro	Margeeuro moet leeg of >= 0 en < 10000 zijn.
39043	tarieffactor	Tarieffactor moet >= 0 en < 1000 zijn.
39043	margeperc	Margeperc moet leeg of >= 0 en < 100 zijn.
39043	resultaat	Resultaat moet leeg of >= 0 en < 100000 zijn.
39043	overschrijding maximum factuurtarief	Tariefresultaat moet < 100000 zijn.
39043	bedragonbelast	Bedragonbelast moet leeg of > 0 en < 100000 zijn.
39043	bedragonbelast	Bedragonbelast moet > 0 en < 100000 zijn.
39043	bedrag/bedragonbelast/percentage	Bedrag, bedragonbelast en percentage mogen niet allemaal leeg zijn.
39043	bedrag/bedragonbelast	Bedrag en bedragonbelast mogen niet beide leeg zijn.
39043	eenheid/percentage	Eenheid en percentage mogen niet beide leeg zijn.
39043	Probleem met maximum bedrag per kilometer, deze wordt dynamisch teruggegeven in de exception.	Het bedrag onbelast is meer dan het maximum bedrag per kilometer dat onbelast mag worden vergoed.
39043	Probleem met peildatumresultaat/startdatum en ingangsdatum loon- en tariefafspraak, deze wordt dynamisch teruggegeven in de exception.	peildatumresultaat of startdatum moet liggen op of na de ingangsdatum van de huidige loon- en tariefafspraak van de plaatsing
39043	Het is niet mogelijk om overlappende vaste beloningen te hebben waarbij verschillende instellingen bij 'bedrag inhouden' worden toegepast	Zelfverklarend.
39043	Rekeningspecificatie ontbreekt voor dit looncomponent (rekeninggroep: 'Correctie WAS'). Voeg deze toe in 'Beheer > bedrijfsinstellingen > looncomponenten'	Zelfverklarend.
39043	Let op: het is niet mogelijk om deze actie uit te voeren. Er ligt al een inhouding of vaste beloning met hetzelfde looncomponent vast met gelijke instellingen bij 'Bedrag' en 'Bedrag inhouden' per 'Loontijdvak/Declaratie'.	Zelfverklarend.
39043	Let op: het is niet mogelijk om deze actie uit te voeren. Bij de plaatsing ligt al een inhouding of vaste beloning met hetzelfde looncomponent vast met gelijke instellingen bij 'Bedrag' en 'Bedrag inhouden' per 'Loontijdvak/Declaratie'.	Zelfverklarend.
39043	maxdagen	Maximum dagen moet een getal zijn tussen de 1 en de 7.
39043	maxdagen	LcType is ongelijk aan 20860 en Eenheid is ongelijk aan 24172
39043	eenheid	Er is een onjuiste eenheid meegegeven.
39043	plaatsingnummer	Plaatsingnummer is onbekend of niet definitief (en geaccordeerd).
39043	vast loon is niet mogelijk omdat er sprake is van een loontijdvak van een dag	Er is een plaatsingnummer meegestuurd en er ligt een loontijdvak vast van een dag.
39043	Koppelen van een plaatsing is niet mogelijk omdat er op een datum soort loontijdvak niet bekend is, zie exception voor exacte waarden.	Zelfverklarend.
39043	niet geautoriseerd	De medewerker is niet geautoriseerd voor de optie 'ja, volledig'.
39043	lcnr	Lcnr is onbekend, van verkeerde type of niet beschikbaar voor de medewerker/flexwerker/vaste medewerker.
39043	standaarduren	Er zijn geen standaarduren ingevuld of de input is niet toegestaan. De standaarduren zullen in minuten moeten worden ingevuld om de beloning op te kunnen slaan.
39043	jaaruren	Er is voor gekozen om de jaarurennorm toe te passen, maar jaaruren zijn niet ingevuld.
39043	werkuren	Er zijn geen standaard werkweekuren ingevuld of gevonden bij de relatie of de input is niet toegestaan.
39043	werkuren afwijking	De standaarduren komen opgeteld niet overeen met het aantal uur wat de flexwerker volgens de standaard werkweek, in combinatie met het deeltijdpercentage, moet werken. Uren van de standaard werkweek x deeltijdpercentage = verplichte aantal standaarduren.
39043	loondispensatie	Loondispensatie moet groter zijn dan 0 en kleiner of gelijk aan 100.
39043	Het is niet mogelijk om voor een gedetacheerde overlappende vaste beloningen voor vast loon vast te leggen.	Zelfverklarend.