Financial claims information document
Een document type met informatie over financiële verplichtingen van organisatie op burgers.
Versies
Datum geaccepteerd | Versie | Publicatiestatus | Gebruik | Documentatie | OAS3 | Changelog |
---|---|---|---|---|---|---|
t.b.d. | vDraft | concept | experimental | documentatie | N/A | changelog |
15 mei 2024 | v4.1.0 | accepted | experimental | documentatie | specificatie | changelog |
8 februari 2024 | v4.0.0 | deprecated | deprecated | documentatie | N/A | changelog |
21 November 2023 | V3.1.0 | deprecated | deprecated | documentatie | N/A | changelog |
10 mei 2023 | v3.0.0 | accepted | current | documentatie | specificatie | changelog |
3 mei 2023 | v2.0.1 | accepted | deprecated | documentatie | specificatie | changelog |
24 april 2023 | v2.0.0 | accepted | deprecated | documentatie | specificatie | changelog |
14 februari 2023 | v1 | accepted | deprecated | documentatie | specificatie | changelog |
Changelog
vDraft
Wijzigingen t.o.v.conceptversie v4.1.0.
-
Er is een nieuwe gebeurtenis toegevoegd:
BetalingsverplichtingBijgewerkt
In het overzicht in VORijk is het belangrijk om alleen die betalingsverplichtingen te zien die ook daadwerkelijk betaald moeten worden. (Deels) betaalde betalingsverplichtingen moeten zichtbaar zijn met het juiste bedrag of helemaal niet meer zichtbaar zijn. In versie 4.1.0 van het FCID wordt dit gedaan met gebeurtenissen betaling verwerkt en betalingsverplichting ingetrokken. Maar deze aanpak is te beperkt. Bijvoorbeeld bij deelbetalingen waarbij de betalingsverplichting alleen moet worden bijgewerkt, schiet de betalingverwerkt en het intrekken van een betalingsverplichting te kort.Een verwerkte betaling heeft niet per se een 1-op-1 relatie met een betalingsverplichting. Er kan met 1 betaling meerdere betalingsverplichtingen voldaan worden. Of maar een deel van een betalingsverplichting. Ook kan het zijn dat een betaling op verschillende zaken wordt bestemd of dat er andere gebeurtenissen zijn die van invloed zijn op de betalingsverplichting zonder dat deze komt te vervallen.
Dit willen we oplossen met een nieuwe gebeurtenis BetalingsverplichtingBijgewerkt (BVB). De BVB heeft een directe koppeling met een BVO of een andere BVB o.b.v. het gebeurtenis_kenmerk. Verder bevat de BVB als belangrijkste gegeven het nieuwe bedrag voor de betalingsverplichting en eventueel aangepaste attributen zoals vervaldatum.
Als een BVB is meegestuurd, dan wordt de BVO (of een eerdere BVB) waar naar verwezen wordt, niet meer getoond in de UI. De meest recente BVB wordt getoond als betalingsverplichting in de UI. Als het bedrag in de BVB gelijk is aan nul, dan wordt de actuele BVB ook niet getoond.
[NB]De betaling verwerkt gebeurtenis heeft geen invloed meer op de BetalingsverplichtingOpgelegd. De BV wordt in het detailscherm als betaling getoond.
-
Er is een nieuw optioneel attribuut toegevoegd aan
BetalingsverplichtingOpgelegd
:incassodatum
De datum waarop een bedrag wordt geïncasseerd is vaak anders dan de vervaldatum van een betalingsverplichting. Daarom is er een apart attribuutincassodatum
beschikbaar in de gebeurtenissenBetalingsverplichtingOpgelegd
enBetalingsverplichtingBijgewerkt
. Dit attribuut is verplicht als betaalwijze "Automatische incasso" is. Deze datum wordt in de UI getoond bij een automatische incasso (i.p.v. de vervaldatum). -
Beschikkingsnummer is toegevoegd in de overdracht gebeurtenissen zodat dezelfde zaak uit twee bronnen, die van de oorspronkelijke bronorganisatie en die van de uitvoerende bronorganisatie, in VO Rijk kan worden gekoppeld.
- In
FinancieleZaakOvergedragen
is het attribuutbeschikkingsnummer
opgenomen. - In
FinancieleZaakOvergenomen
is het attribuutbeschikkingsnummer
opgenomen. - In
FinancieleZaakOvergedragenAanDeurwaarder
is het attribuutbeschikkingsnummer
opgenomen.
- In
-
Er is een nieuwe gebeurtenis toegevoegd:
InformatieMedegedeeld
Hier kunnen bronorganisaties informatie meedelen aangaande de zaak (maximaal 200 tekens). Dit kan bijvoorbeeld een waarschuwing zijn voor verhogingen of een mededeling dat er ook in termijnen betaald kan worden. De InformatieMedegedeeld gebeurtenis heeft een attribuutgeldig_tot_datumtijd
. Daarmee kan worden aangegeven tot welke datum de informatie geldig is. Vanaf deze datum wordt in de app of de website de informatie niet meer getoond, of getoond als 'niet meer geldig'.[NB]Voor nu is gekozen om 1 algemene gebeurtenis te specificeren voor informatie. Afhankelijk van het gebruik wordt gekeken of we dat in de toekomst verder willen specificeren per type mededeling.
-
Attribuut
FinancieleZaakOvergedragenAanDeurwaarder.saldo_bij_overdracht
hernoemt naarsaldo_bij_overdracht_aan_deurwaarder
Doordat de verplichte attributen inFinancieleZaakOvergedragenAanDeurwaarder
enFinancieleZaakOvergedragen
gelijk waren, trad er een fout op bij het verwerken van deze twee gebeurtenissen. De verplichte attributen moeten onderscheidend zijn binnen de OAS3 specificatie.
De eerder voorgestelde aanpassing aan de gebeurtenis BetalingVerwerkt
komt te vervallen.
v4.1.0
Wijzigingen t.o.v.conceptversie v4.0.0.
-
Het attribuut
contactopties.omschrijving
is optioneel geworden. -
In
financiële_zaken
is de werkwijze van de totalen is aangepast en vereenvoudigd:- Het attribuut
financiele_zaken.totaal_opgelegd
is hernoemd naarfinanciele_zaken.totaal_financieel_verplicht
en de omschrijving is aangepast om de nieuwe gebeurtenissen te ondersteunen. - Het attribuut
financiele_zaken.totaal_financieel_vereffend
is toegevoegd om de nieuwe en bestaande gebeurtenissen te ondersteunen.
- Het attribuut
-
In
BetalingsverplichtingOpgelegd
:- Nieuw optioneel attribuut
BetalingsverplichtingOpgelegd.omschrijving
voor extra informatie over de betalingsverplichting, zoals bijvoorbeeld de betreffende termijn. - Nieuw verplicht attribuut
BetalingsverplichtingOpgelegd.type
waarin type van de betalingsverplichting is aangegeven. Mogelijke waarden: "Aanschrijving", "Herinnering" en "Aanmaning"
- Nieuw optioneel attribuut
-
Nieuwe typen gebeurtenissen toegevoegd:
-
FinancieleVerplichtingKwijtgescholden
Als een financiële verplichting (deels) is kwijtgescholden, dan kan dat met deze gebeurtenis worden aangegeven. De gebeurtenis bevat o.a. het bedrag dat is kwijtgescholden.
-
FinancieleVerplichtingGecorrigeerd
Als een financiële verplichting is gecorrigeerd, dan kan dat met deze gebeurtenis worden aangegeven. De gebeurtenis bevat o.a. het nieuw opgelegde bedrag. De eerdere financiële verplichting is daardoor aangepast.
-
FinancieleZaakOvergedragen
Wanneer een zaak is overgedragen aan een andere organisatie die de verdere uitvoering op zich neemt, kan dat met deze gebeurtenis worden aangegeven. De gebeurtenis bevat o.a. het bedrag op het moment van overdracht. Vanuit het perspectief van de burger is, bij overdracht van organisatie A naar B, wanneer organisatie A de gebeurtenis FinancieleZaakOvergedragen meldt, en organisatie B de gebeurtenis FinancieleZaakOvergenomen meldt, de zaak met instemming van beide partijen daadwerkelijk overgedragen.
-
FinancieleZaakOvergenomen
Op het moment dat een organisatie een zaak van een andere organisatie heeft overgenomen, dan kan dat met deze gebeurtenis worden aangegeven. De gebeurtenis bevat o.a. het bedrag op het moment van overdracht. Vanuit het perspectief van de burger is, bij overdracht van organisatie A naar B, wanneer organisatie B de gebeurtenis FinancieleZaakOvergenomen meldt, en organisatie A de gebeurtenis FinancieleZaakWordtOvergedragen meldt, de zaak inderdaad met instemming van beide partijen daadwerkelijk overgedragen.
-
FinancieleZaakOvergedragenAanDeurwaarder
Wanneer een zaak is overgedragen aan een deurwaarder die de verdere uitvoering op zich neemt, kan dat met deze gebeurtenis worden aangegeven. De gebeurtenis bevat o.a. het bedrag op het moment van overdracht. In de gebeurtenis kunnen contactgegevens van de deurwaarder worden meegegeven. ⚠️ TODO: KBvG-nummer of KVK-nummer?
-
FinancieelRechtVastgesteld
Wanneer is vastgesteld dat de burger recht heeft op een bepaald bedrag, dan kan dat in deze gebeurtenis worden aangegeven. De gebeurtenis bevat o.a. het bedrag waar de burger recht op heeft.
-
BedragUitbetaald
Wanneer een bedrag aan de burger is uitbetaald, dan kan dat in deze gebeurtenis worden aangegeven. De gebeurtenis bevat o.a. het aan de burger betaalde bedrag en naar welke rekening het bedrag is overgemaakt.
-
VerrekeningVerwerkt
Als er een verrekening heeft plaatsgevonden op een financiële verplichting, dan kan dat in deze gebeurtenis worden aangegeven. De gebeurtenis bevat o.a. het verrekende bedrag.
-
v4.0.0
Wijzigingen t.o.v.conceptversie v3.1.0.
- Nieuwe array toegevoegd voor
beschikbaarheid
binnen de body. De beschikbaarheid is per type financiële verplichting altijd aangegeven als beschikbaar, niet beschikbaar, storing (tijdelijk niet beschikbaar). - Nieuwe array toegevoegd voor
contactopties
binnen een financiële zaak. Hier kan een bronorganisatie 1 of meer contactopties aanbieden. Er zijn vier verschillende typen beschikbaar. NB: dit vervangt de opzet van handelingsperspectieven van versie 3.1.0.
v3.1.0
Wijzigingen t.o.v.conceptversie v3.0.0.
- Nieuwe array toegevoegd voor
handelingsperspectieven
; dit biedt ruimte voor handelingen die de burger kan doen rondom de financiële zaak. - Eerste handelingsperspectief toegevoegd:
ContactOptieAangeboden
. Dit biedt bronorganisatie de mogelijkheid om contactinformatie specifiek voor de financiële zaak aan te bieden. Er zijn een viertal opties:telefoon
,e_mail
,mijn_omgeving
enorganisatie_website
.
==NB: n.a.v. review commentaar en nieuwe inzichten is versie 3.1.0 van het FCID deprecated geworden. Dat betekent dat deze versie nooit naar productie zal gaan.==
v3.0.0
Wijzigingen t.o.v.conceptversie v2.0.1.
- De verschillende arrays met gebeurtenissen (
financiele_verplichtingen
,betalingsverplichtingen
enbetalingen
) zijn samengevoegd tot één arraygebeurtenissen
. - Velden die in elk type gebeurtenissen met verschillende namen aanwezig waren zijn gelijkgetrokken. Elk gebeurtenistype heeft nu de velden
gebeurtenis_type
,gebeurtenis_kenmerk
endatumtijd_gebeurtenis
. - Het veld
datumtijd_gebeurtenis
registreert het moment waarop de gebeurtenis is vastgelegd. Dit moment kan afwijken van het moment waarop de gebeurtenis formeel gezien heeft plaatsgevonden. - Het gebeurtenistype
BetalingsverplichtingIngetrokken
is toegevoegd.
v2.0.1
Wijzigingen t.o.v.conceptversie v2.0.0.
- Beschikkingsnummer toegevoegd.
- Valuta zijn altijd in euro's, alle
*_valuta
velden zijn vervallen. - Aan de gebeurtenistypen
FinancieleVerplichtingOpgelegd
enBetalingsverplichtingOpgelegd
is het veldbsn
toegevoegd.
v2.0.0
- Eerste versie met uitgebreide informatie over financiële verplichtingen.
v1
- Initiële versie met alleen saldo.