ds_rf_declaratie_regels_update
Operatie om één of meerdere regels van een declaratie te wijzigen. Er wordt alleen iets gewijzigd als er ook iets aangegeven is om te wijzigen.
Als bijvoorbeeld alleen de uren op vrijdag gewijzigd moeten worden, hoeft alleen de regel van vrijdag meegestuurd te worden, de overige regels zullen niet wijzigen.
Wel is het zo dat als alleen de kostenplaats van een regel aangepast moet worden, ook de aantallen/bedragen meegestuurd moeten worden van flexwerker en/of relatie, afhankelijk van attribuut keuze, omdat ze anders worden gewist.
Één van de parameters rf_decl_fwregnr of rf_decl_rlregnr dient aanwezig te zijn.
Declaratieregels met betrekking tot de relatie kunnen niet gewijzigd worden als "Geen factuur" aanstaat en/of "Aantal" bij relatie 0,00 is.
rf_decl_uur
Iedere urenregel is uniek te identificeren a.d.h.v. rf_decl_uur_idnr, of de combinatie van rf_decl_uur_datum, rf_decl_lc_idnr, rf_decl_lc_percentage_fw en rf_decl_lc_percentage_rl.
Indien meerdere kostenplaatsen op dezelfde dag in een declaratie is toegestaan, is rf_decl_uur_idnr noodzakelijk indien een declaratieregel moet worden aangepast, want als deze niet wordt meegegeven zal er een regel worden aangemaakt, indien mogelijk.
Een urenregel kan alleen maar aangepast worden, een urenregel kan niet handmatig toegevoegd of verwijderd worden. Dit is een gevolg van de wijziging die gedaan wordt.
Als er bijvoorbeeld 8 uur wordt ingevuld voor een bepaald looncomponent en datum waarvoor er nog geen regel bestaat, dan wordt er automatisch een regel aangemaakt.
Als een bepaalde regel voor de flexwerker op 0 gezet wordt, en het aantal van de relatie is ook 0, dan zal de regel verwijderd worden.
Niet alle velden kunnen aangepast worden, alleen de volgende velden zijn te wijzigen:
- rf_decl_lc_loonslip_tekst
De omschrijving zoals die getoond gaat worden op de loonspecificatie
- rf_decl_lc_factuur_tekst
De omschrijving zoals die getoond gaat worden op de factuur
- rf_decl_uur_aantal_fw
Het aantal minuten opgegeven door de flexwerker, kan alleen door de flexwerker gewijzigd worden.
Wordt automatisch 0 als er voor de geldende loon- en tariefafspraak geen flexwerkeruren gevuld mogen worden.
- rf_decl_uur_aantal_rl
Het aantal minuten opgegeven door de relatie, kan alleen door de relatie gewijzigd worden.
- rf_decl_uur_kostenplaats
Een urenregel kan gekoppeld zijn aan een kostenplaats, er is geen splitsing tussen relatie en flexwerker. Om de kostenplaats te wissen moet de waarde 0 worden toegekend.
Let op: als er geen waarde wordt meegegeven zal het veld niet wijzigen.
rf_decl_geld
Een vergoedingsregel is alleen uniek te identificeren a.d.h.v. rf_decl_geld_idnr.
Een vergoedingsregel kan normaal alleen aangepast worden, er kan wel een vergoeding worden toegevoegd indien de parameter rf_decl_geld_tariefregelnr gebruikt wordt.
De vergoeding wordt dan vanuit de loon- en tariefafspraak gekopieerd naar de declaratie.
Het is ook mogelijk een specifieke dag te kiezen met de parameter rf_decl_geld_datum. Het nummer is op te vragen met behulp van de service ds_rl_plaatsing_looncomponent.
Het is mogelijk het aantal van de vergoeding op 0 te zetten, maar de vergoeding zelf zal hierdoor niet verwijderd worden.
Niet alle velden kunnen aangepast worden, alleen de volgende velden zijn te wijzigen:
* Indien veld rf_decl_geld_bedrag_fw wordt gebruikt zijn de velden rf_decl_geld_onbelast_fw en rf_decl_geld_belast_fw niet mogelijk en vice versa.
- rf_decl_lc_loonslip_tekst
De omschrijving zoals die getoond gaat worden op de loonspecificatie
- rf_decl_lc_factuur_tekst
De omschrijving zoals die getoond gaat worden op de factuur
- rf_decl_geld_kostenplaats
Een vergoeding kan gekoppeld zijn aan een kostenplaats, er is geen splitsing tussen relatie en flexwerker. Om de kostenplaats te wissen moet de waarde 0 worden toegekend.
- rf_decl_geld_aantal_fw
Het aantal zoals opgegeven door de flexwerker, kan alleen door de flexwerker gewijzigd worden.
Voor vergoedingen met eenheid bedrag is het aantal eveneens niet te wijzigen, in dat geval kan alleen uurloon gewijzigd worden.
- rf_decl_geld_aantal_rl
Het aantal zoals opgegeven door de relatie, kan alleen door de relatie gewijzigd worden.
Voor vergoedingen met eenheid bedrag is het aantal eveneens niet te wijzigen, in dat geval kan alleen tarief gewijzigd worden.
- rf_decl_geld_bedrag_fw *
Het bedrag zoals opgegeven door de flexwerker, kan alleen door de flexwerker gewijzigd worden. Kan alleen gewijzigd worden voor vergoedingen met eenheid "bedrag".
- rf_decl_geld_bedrag_rl
Het bedrag zoals opgegeven door de relatie, kan alleen door de relatie gewijzigd worden. Kan alleen gewijzigd worden voor vergoedingen met eenheid "bedrag".
- rf_decl_geld_onbelast_fw *
Het onbelaste bedrag van de vergoeding.
- rf_decl_geld_belast_fw *
Het belaste bedrag van de vergoeding.
Afhankelijk van de eenheid liggen er bepaalde restricties op aantal en bedrag:
- uur
Aantal moet een geheel getal zijn, maximaal 59999, bedrag moet leeg zijn.
Het totaal (aantal minuten / 60 * bedrag) mag niet hoger worden dan € 99.999,99!
- dag / gewerkte-dag
Aantal mag 2 decimalen hebben, maximaal 999,99; bedrag moet leeg zijn.
Het totaal (aantal dagen * bedrag) mag niet hoger worden dan € 99.999,99!
- stuk
Aantal mag 2 decimalen hebben, maximaal 99999,99; bedrag moet leeg zijn.
Het totaal (aantal stuks * bedrag) mag niet hoger worden dan € 99.999,99!
- km
Aantal moet een geheel getal zijn, maximaal 9999, bedrag moet leeg zijn.
Het totaal (aantal km * bedrag) mag niet hoger worden dan € 99.999,99!
- bedrag
Aantal moet leeg zijn, bedrag mag 2 decimalen hebben, maximaal € 99.999.99!
- relatie-uur
Aantal moet een geheel getal zijn, maximaal 59999, bedrag moet leeg zijn. Het totaal (aantal minuten / 60 * bedrag) mag niet hoger worden dan € 99.999,99!
rf_decl_opn
Een opnameregel is uniek te identificeren a.h.v. rf_decl_opn_idnr of de combinatie van rf_decl_opn_speccode, rf_decl_opn_premiegroep en rf_decl_lc_idnr.
Bij cao-reserveringen is rf_decl_opn_opsnr aanvullend nodig om de juiste opnamenregel te kunnen bepalen.
Niet alle velden kunnen aangepast worden, alleen de volgende velden zijn te wijzigen:
- rf_decl_opn_geld
Extra opname in geld, kan alleen ingevuld voor looncomponenten van het type "reservering_geld".
Maximaal € 99.999,99!
- rf_decl_opn_tijd
Extra opname in minuten, kan alleen ingevuld voor looncomponenten van het type "reservering_uren"
Maximaal 599999 minuten!
Parameters
| Attribuut | Type | Verplicht | Omschrijving |
|---|---|---|---|
| rf_decl_fwregnr | xsd:int | C | Registratienummer (idnr) van de flexwerker. |
| rf_decl_rlregnr | xsd:int | C | Registratienummer (idnr) van de relatie. |
| rf_decl_fwrl | xsd:boolean | O | Indien dit attribuut 'true' is kunnen voor zowel de flexwerker als relatie gegevens aangeleverd worden. Zowel rf_decl_fwregnr als rf_decl_rlregnr dienen dan aanwezig te zijn. |
| rf_decl_idnr | xsd:int | V | Registratienummer (idnr) van de declaratie. |
| rf_decl_uren | array | O | Een array van urenregels [rf_decl_uur] die gewijzigd moeten worden. |
|
xsd:int | O | Registratienummer (idnr) van de urenregel. Noodzakelijk indien meerdere kostenplaatsen op dezelfde dag in een declaratie is toegestaan en een update gewenst is. |
|
xsd:string | O | De datum van deze urenregel. |
|
xsd:int | O | Registratienummer (idnr) van het looncomponent. |
|
xsd:string | O | Het type looncomponent.Klik hier voor meer info...
|
|
xsd:string | O | Het soort looncomponent. |
|
xsd:string(50) | O | Omschrijving die getoond wordt op de loonspecificatie. |
|
xsd:string(50) | O | Omschrijving die getoond wordt op de factuur. |
|
xsd:float | O | Het flexwerker percentage. Let op: reserveringen hebben percentage van 0% Percentage kan liggen tussen 0,00 en 999,99. |
|
xsd:float | O | Het relatie percentage. Let op: reserveringen hebben percentage van 0% Percentage kan liggen tussen 0,00 en 999,99. |
|
xsd:float | O | Het aantal minuten opgegeven door de flexwerker Het aantal kan liggen tussen 0 en 1440 minuten. Wordt automatisch 0 als er voor de geldende loon- en tariefafspraak geen flexwerkeruren gevuld mogen worden. |
|
xsd:float | O | Het aantal minuten opgegeven door de relatie Het aantal kan liggen tussen 0 en 1440 minuten. |
|
xsd:float | O | Het uurloon voor deze urenregel. |
|
xsd:float | O | Het factuurtarief voor deze urenregel. |
|
xsd:int | O | De kostenplaats van deze urenregel. |
|
xsd:int | O | Registratienummer (idnr) van de loonspecificatie. Verwerkt in deze urenregel. Met fw_loonspecificaties kan de loonspecificatie zelf opgehaald worden. |
|
xsd:int | O | Registratienummer (idnr) van de factuur. Verwerkt in deze urenregel. Met rl_facturen kan de factuur zelf opgehaald worden. |
|
xsd:int | O | Instelling die aangeeft hoe er moet worden omgegaan met de uren bij de looncomponenten van het type overwerkuren en onregelmatige uren.Klik hier voor meer info...
|
| rf_decl_vergoedingen | array | O | Een array van vergoedingsregels [rf_decl_geld] die gewijzigd moeten worden. |
|
xsd:int | O | Registratienummer (idnr) van de loon- en tariefafspraak. (tariefregelnummer) |
|
xsd:int | O | Registratienummer (idnr) van de vergoeding. |
|
xsd:int | O | Registratienummer (idnr) van het looncomponent. |
|
xsd:string | O | Het type looncomponent.Klik hier voor meer info...
|
|
xsd:string | O | Het soort looncomponent. |
|
xsd:string(50) | O | Omschrijving die getoond wordt op de loonspecificatie. |
|
xsd:string(50) | O | Omschrijving die getoond wordt op de factuur. |
|
xsd:string | O | Eenheid van het looncomponent.Klik hier voor meer info...
|
|
xsd:float | O | Het aantal opgegeven door de flexwerker. |
|
xsd:float | O | Het aantal opgegeven door de relatie. |
|
xsd:float | O | Het flexwerker tarief voor deze vergoeding. In geval van een vergoeding met eenheid "Bedrag" bevat dit het opgegeven bedrag. |
|
xsd:float | O | Het relatie tarief voor deze vergoeding. In geval van een vergoeding met eenheid "Bedrag" bevat dit het opgegeven bedrag. |
|
xsd:float | O | Het onbelaste bedrag voor deze vergoeding. |
|
xsd:float | O | Het belaste bedrag van deze vergoeding. |
|
xsd:int | O | De kostenplaats van deze vergoedingsregel. |
|
xsd:int | O | Registratienummer (idnr) van de loonspecificatie. Verwerkt in deze vergoeding. Met fw_loonspecificaties kan de loonspecificatie zelf opgehaald worden. |
|
xsd:int | O | Registratienummer (idnr) van de factuur. Verwerkt in deze vergoeding. Met rl_facturen kan de factuur zelf opgehaald worden. |
|
xsd:date | O | De datum van deze vergoedingregel. |
| rf_decl_opnamen | array | O | Een array van opnameregels [rf_decl_opn] die gewijzigd moeten worden. |
|
xsd:int | O | Registratienummer (idnr) van de opname. |
|
xsd:string | O | Risicogroepnummer. |
|
xsd:string | O | Premiegroep. |
|
xsd:int | O | Registratienummer (idnr) van het looncomponent. |
|
xsd:string | O | Het type looncomponent.Klik hier voor meer info...
|
|
xsd:string | O | Het soort looncomponent. |
|
xsd:string | O | Omschrijving die getoond wordt op de loonspecificatie. |
|
xsd:float | O | De extra opname in geld, indien het gaat om een reservering in geld. |
|
xsd:int | O | De extra opname in minuten, indien het gaat om een reservering in tijd. |
|
xsd:int | O | Registratienummer (idnr) van de loonspecificatie. Verwerkt in deze opname. Met fw_loonspecificaties kan de loonspecificatie zelf opgehaald worden. |
|
xsd:int | O | Reservering / opslagnummer. Verplicht bij cao-reserveringen waarbij voor hetzelfde looncomponent meerdere reserveringen mogelijk zijn, om deze van elkaar te onderscheiden. Voor reguliere reserveringen mag het veld leeg blijven; de waarde wordt dan automatisch bepaald. |
Fields
| Attribuut | Type | Omschrijving |
|---|---|---|
| rf_decl_result | xsd:string | Resultaatcode die aangeeft of het aanpassen gelukt is. Zal altijd de waarde success bevatten. Als er een fout optreedt wordt er namelijk een exception gegeven. |
Exceptions
| Code | Detail | Omschrijving |
|---|---|---|
| 39043 | rf_decl_fwregnr en rf_decl_rlregnr | Rf_decl_fwrl is true, hiervoor dienen zowel rf_decl_fwregnr en rf_decl_rlregnr meegestuurd te worden. |
| 39043 | rf_decl_fwregnr of rf_decl_rlregnr | Rf_decl_fwrl is false, hierdoor mogen rf_decl_fwregnr en rf_decl_rlregnr niet beiden gevuld zijn. |
| 39043 | Declaratie kan niet gewijzigd worden. | Declaratie kan niet worden gewijzigd. |