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. |
|
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. |
|
xsd:int | Registratienummer (idnr) van de urenregel. Noodzakelijk indien meerdere kostenplaatsen op dezelfde dag in een declaratie is toegestaan en een update gewenst is. |
|
xsd:string | De datum van deze urenregel. |
|
xsd:int | Registratienummer (idnr) van het looncomponent. |
|
xsd:string | Het type looncomponent.Klik hier voor meer info...
|
|
xsd:string | Het soort looncomponent. |
|
xsd:string(50) | Omschrijving die getoond wordt op de loonspecificatie. |
|
xsd:string(50) | Omschrijving die getoond wordt op de factuur. |
|
xsd:float | Het flexwerker percentage. Let op: reserveringen hebben percentage van 0% Percentage kan liggen tussen 0,00 en 999,99. |
|
xsd:float | Het relatie percentage. Let op: reserveringen hebben percentage van 0% Percentage kan liggen tussen 0,00 en 999,99. |
|
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. |
|
xsd:float | Het aantal minuten opgegeven door de relatie Het aantal kan liggen tussen 0 en 1440 minuten. |
|
xsd:float | Het uurloon voor deze urenregel. |
|
xsd:float | Het factuurtarief voor deze urenregel. |
|
xsd:int | De kostenplaats van deze urenregel. |
|
xsd:int | Registratienummer (idnr) van de loonspecificatie. Verwerkt in deze urenregel. Met fw_loonspecificaties kan de loonspecificatie zelf opgehaald worden. |
|
xsd:int | Registratienummer (idnr) van de factuur. Verwerkt in deze urenregel. Met rl_facturen kan de factuur zelf opgehaald worden. |
|
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...
|
| 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. |
|
xsd:int | Registratienummer (idnr) van de vergoeding. |
|
xsd:int | Registratienummer (idnr) van het looncomponent. |
|
xsd:string | Het type looncomponent.Klik hier voor meer info...
|
|
xsd:string | Het soort looncomponent. |
|
xsd:string(50) | Omschrijving die getoond wordt op de loonspecificatie. |
|
xsd:string(50) | Omschrijving die getoond wordt op de factuur. |
|
xsd:string | Eenheid van het looncomponent.Klik hier voor meer info...
|
|
xsd:float | Het aantal opgegeven door de flexwerker. |
|
xsd:float | Het aantal opgegeven door de relatie. |
|
xsd:float | Het flexwerker tarief voor deze vergoeding. In geval van een vergoeding met eenheid "Bedrag" bevat dit het opgegeven bedrag. |
|
xsd:float | Het relatie tarief voor deze vergoeding. In geval van een vergoeding met eenheid "Bedrag" bevat dit het opgegeven bedrag. |
|
xsd:float | Het onbelaste bedrag voor deze vergoeding. |
|
xsd:float | Het belaste bedrag van deze vergoeding. |
|
xsd:int | De kostenplaats van deze vergoedingsregel. |
|
xsd:int | Registratienummer (idnr) van de loonspecificatie. Verwerkt in deze vergoeding. Met fw_loonspecificaties kan de loonspecificatie zelf opgehaald worden. |
|
xsd:int | Registratienummer (idnr) van de factuur. Verwerkt in deze vergoeding. Met rl_facturen kan de factuur zelf opgehaald worden. |
|
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. |
|
xsd:int | Registratienummer (idnr) van de opname. |
|
xsd:string | Risicogroepnummer. |
|
xsd:string | Premiegroep. |
|
xsd:int | Registratienummer (idnr) van het looncomponent. |
|
xsd:string | Het type looncomponent.Klik hier voor meer info...
|
|
xsd:string | Het soort looncomponent. |
|
xsd:string | Omschrijving die getoond wordt op de loonspecificatie. |
|
xsd:float | De extra opname in geld, indien het gaat om een reservering in geld. |
|
xsd:int | De extra opname in minuten, indien het gaat om een reservering in tijd. |
|
xsd:int | Registratienummer (idnr) van de loonspecificatie. Verwerkt in deze opname. Met fw_loonspecificaties kan de loonspecificatie zelf opgehaald worden. |
|
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. |