Ga naar inhoud

ds_rf_declaratie_regels

Operatie voor het opvragen van alle declaratieregels van een set van declaraties.
Standaard worden de declaratieregels alleen getoond als de flexwerker of de relatie de declaratie mag accorderen.
Indien de parameter rf_decl_plaatsingnummer meegegeven wordt, dan worden alle declaratieregels getoond (ongeacht de instelling voor accordering).
Minstens één van de volgende parameters dient aanwezig te zijn: rf_decl_fwregnr, rf_decl_rlregnr of rf_decl_plaatsingnummer.

Deze call heeft diverse voorwaardes en limiteringen:

- Wanneer het om een flexwerker gaat die het opvraagt, dan moet de instelling die vastligt bij de plaatsing 20481 of 20483 zijn.
- Wanneer het om een relatie of medewerker van de relatie gaat, dan moet de instelling die vastligt bij de plaatsing 20481 of 20482 zijn.
- Wanneer er declaraties worden opgehaald voor 1 plaatsing, dan wordt er geen rekening gehouden met de instellingen voor het accorderen van de declaratie bij de plaatsing.
- Indien de declaratie de status 24846 (vervallen) heeft, dan worden er geen regels geselecteerd.
- Er worden alleen declaraties geselecteerd die kostenplaats bevatten die van toepassing zijn voor de gebruiker. Indien er geen kostenplaatsen zijn vastgelegd, zijn alle kostenplaatsen van toepassing.
- De gebruiker wordt bepaald met het registratienummer van de eerste parameter die aanwezig is: rf_decl_fwregnr of rf_decl_rlregnr.
- Als alleen rf_decl_plaatsingnummer is meegestuurd, dan wordt er voor het bepalen van de gebruiker gekeken naar het registratienummer van de relatie.
- Je kan alleen declaraties ophalen van actieve loonjaren.
- Alleen de regels van looncomponenten die opgehaald mogen worden conform instellingen bij 'Beheer > Urendeclaraties website' of 'Frontoffice > Relatie > Urendeclaraties website' worden getoond.

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_plaatsingnummer xsd:int C Registratienummer (idnr) van de plaatsing.
rf_decl_idnrs array O Filter op een set van declaratienummers.
  • rf_decl_idnr
xsd:int V Registratienummer (idnr) van de declaratie.

Fields

Attribuut Type Omschrijving
rf_decl_idnr xsd:int Registratienummer (idnr) van de declaratie.
rf_decl_uren array Array van alle uren regels [rf_decl_uur] behorende bij deze declaratie.
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.
  • rf_decl_uur_idnr
xsd:int Registratienummer (idnr) van de urenregel. Noodzakelijk indien meerdere kostenplaatsen op dezelfde dag in een declaratie is toegestaan en een update gewenst is.
  • rf_decl_uur_datum
xsd:string De datum van deze urenregel.
  • rf_decl_lc_idnr
xsd:int Registratienummer (idnr) van het looncomponent.
  • rf_decl_lc_type
xsd:string Het type looncomponent.
Klik hier voor meer info...
  • uren
  • vergoeding
  • reservering_uren
  • reservering_geld
  • rf_decl_lc_soort
xsd:string Het soort looncomponent.
  • rf_decl_lc_loonslip_tekst
xsd:string(50) Omschrijving die getoond wordt op de loonspecificatie.
  • rf_decl_lc_factuur_tekst
xsd:string(50) Omschrijving die getoond wordt op de factuur.
  • rf_decl_lc_percentage_fw
xsd:float Het flexwerker percentage.
Let op: reserveringen hebben percentage van 0%
Percentage kan liggen tussen 0,00 en 999,99.
  • rf_decl_lc_percentage_rl
xsd:float Het relatie percentage.
Let op: reserveringen hebben percentage van 0%
Percentage kan liggen tussen 0,00 en 999,99.
  • rf_decl_uur_aantal_fw
xsd:float 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.
  • rf_decl_uur_aantal_rl
xsd:float Het aantal minuten opgegeven door de relatie
Het aantal kan liggen tussen 0 en 1440 minuten.
  • rf_decl_uur_uurloon
xsd:float Het uurloon voor deze urenregel.
  • rf_decl_uur_tarief
xsd:float Het factuurtarief voor deze urenregel.
  • rf_decl_uur_kostenplaats
xsd:int De kostenplaats van deze urenregel.
  • rf_decl_uur_loonspecificatie_idnr
xsd:int Registratienummer (idnr) van de loonspecificatie. Verwerkt in deze urenregel. Met fw_loonspecificaties kan de loonspecificatie zelf opgehaald worden.
  • rf_decl_uur_factuur_idnr
xsd:int Registratienummer (idnr) van de factuur. Verwerkt in deze urenregel. Met rl_facturen kan de factuur zelf opgehaald worden.
  • rf_decl_uur_tvt
xsd:int 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...
  • 24970 Uitbetalen
  • 24971 Alles sparen
  • 24972 Alleen toeslagdeel sparen
rf_decl_vergoedingen array Array van alle vergoeding regels [rf_decl_geld] behorende bij deze declaratie.
Een vergoedingsregel is alleen uniek te identificeren a.h.v. rf_decl_geld_idnr.
  • rf_decl_geld_idnr
xsd:int Registratienummer (idnr) van de vergoeding.
  • rf_decl_lc_idnr
xsd:int Registratienummer (idnr) van het looncomponent.
  • rf_decl_lc_type
xsd:string Het type looncomponent.
Klik hier voor meer info...
  • uren
  • vergoeding
  • reservering_uren
  • reservering_geld
  • rf_decl_lc_soort
xsd:string Het soort looncomponent.
  • rf_decl_lc_loonslip_tekst
xsd:string(50) Omschrijving die getoond wordt op de loonspecificatie.
  • rf_decl_lc_factuur_tekst
xsd:string(50) Omschrijving die getoond wordt op de factuur.
  • rf_decl_lc_eenheid
xsd:string Eenheid van het looncomponent.
Klik hier voor meer info...
  • 24169 Relatie uur
  • 24170 Uur
  • 24171 Dag (ma t/m vr)
  • 24172 Gewerkte dag
  • 24173 Stuk
  • 24174 Kilometer
  • 24175 Loontijdvak
  • 24176 Declaratie
  • 24177 Kalenderdag
  • 24178 Gewerkt uur
  • 24179 Bedrag
  • rf_decl_geld_aantal_fw
xsd:float Het aantal opgegeven door de flexwerker.
  • rf_decl_geld_aantal_rl
xsd:float Het aantal opgegeven door de relatie.
  • rf_decl_geld_bedrag_fw
xsd:float Het flexwerker tarief voor deze vergoeding.
In geval van een vergoeding met eenheid "Bedrag" bevat dit het opgegeven bedrag.
  • rf_decl_geld_bedrag_rl
xsd:float Het relatie tarief voor deze vergoeding.
In geval van een vergoeding met eenheid "Bedrag" bevat dit het opgegeven bedrag.
  • rf_decl_geld_onbelast_fw
xsd:float Het onbelaste bedrag voor deze vergoeding.
  • rf_decl_geld_belast_fw
xsd:float Het belaste bedrag van deze vergoeding.
  • rf_decl_geld_kostenplaats
xsd:int De kostenplaats van deze vergoedingsregel.
  • rf_decl_geld_loonspecificatie_idnr
xsd:int Registratienummer (idnr) van de loonspecificatie. Verwerkt in deze vergoeding. Met fw_loonspecificaties kan de loonspecificatie zelf opgehaald worden.
  • rf_decl_geld_factuur_idnr
xsd:int Registratienummer (idnr) van de factuur. Verwerkt in deze vergoeding. Met rl_facturen kan de factuur zelf opgehaald worden.
  • rf_decl_geld_datum
xsd:date De datum van deze vergoedingregel.
rf_decl_opnamen array Array van alle opname regels [rf_decl_opn] behorende bij deze declaratie.
Een opnameregel is uniek te identificeren a.d.h.v. rf_decl_opn_idnr of de combinatie van rf_decl_opn_speccode, rf_decl_opn_premiegroep en rf_decl_lc_idnr.
  • rf_decl_opn_idnr
xsd:int Registratienummer (idnr) van de opname.
  • rf_decl_opn_speccode
xsd:string Risicogroepnummer.
  • rf_decl_opn_premiegroep
xsd:string Premiegroep.
  • rf_decl_lc_idnr
xsd:int Registratienummer (idnr) van het looncomponent.
  • rf_decl_lc_type
xsd:string Het type looncomponent.
Klik hier voor meer info...
  • uren
  • vergoeding
  • reservering_uren
  • reservering_geld
  • rf_decl_lc_soort
xsd:string Het soort looncomponent.
  • rf_decl_lc_loonslip_tekst
xsd:string Omschrijving die getoond wordt op de loonspecificatie.
  • rf_decl_opn_geld
xsd:float De extra opname in geld, indien het gaat om een reservering in geld.
  • rf_decl_opn_tijd
xsd:int De extra opname in minuten, indien het gaat om een reservering in tijd.
  • rf_decl_opn_loonspecificatie_idnr
xsd:int Registratienummer (idnr) van de loonspecificatie. Verwerkt in deze opname. Met fw_loonspecificaties kan de loonspecificatie zelf opgehaald worden.
  • rf_decl_opn_opsnr
xsd:int 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.

Exceptions

Code Detail Omschrijving
39043 rf_decl_fwregnr, rf_decl_rlregnr of rf_decl_plaatsingnummer Rf_decl_fwregnr of rf_decl_rlregnr of rf_decl_plaatsingnummer moet aanwezig zijn.