Ga naar hoofdinhoud

Mapping FCID 4.1.0 - UI

In deze documenten wordt de mapping vanuit FCID v4.1.0 naar de schermen beschreven, inclusief de bijbehorende logica.

Het gaat om de volgende schermen (flow):

Schermflow

De mapping betreft alleen de schermen vanaf "Overzicht". De intro- en aanmeldschermen en het account scherm worden hier niet besproken.

Belangrijk:
  • Deze mapping en functionaliteit is het uitgangspunt voor de MVP uitrol van de Vorderingenoverzicht Rijk App. Op hoofdlijnen zal deze werking niet veranderen, maar vanuit het project wordt continue gekeken naar de ervaring van gebruikers. Dit kan betekenen dat op details nog aanpassingen gedaan kunnen worden.
  • Het deel voor overdracht moet nog worden toegevoegd aan de Vorderingenoverzicht Rijk App.

Algemene regels​

Let op

De onderstaande algemene regels gelden voor elk scherm, tenzij in de specificatie er expliciet van afgeweken wordt.

Bedragen​

Voor het tonen van bedragen moet het juiste formaat worden opgesteld.

De inhoud van attributen met bedragen is in eurocenten. Het bedrag in centen wordt omgezet naar de opmaak met 2 decimalen en een duizendtal scheidingsteken. Er wordt een euroteken voorgezet. Bijvoorbeeld: € 1.100,12.

Bij negatieve bedragen wordt het min-teken voor het euroteken gezet. Bijvoorbeeld: − € 1.100,12.

Organisatienaam​

Attributen die verwijzen naar een organisatie zijn gevuld met de OIN. Deze wordt vertaald naar de juiste naam van de organisatie a.d.h.v. de catalogus en vervolgens getoond in het scherm.

Indien het OIN niet in de catalogus staat, dan wordt OIN zelf getoond (tijdelijke situatie).

Type financiële verplichting​

  • Het type van de FinancieleVerplichtingOpgelegd wordt gebruikt. Het betreft dan de primaire verplichting (FVO.primaire_verplichting = TRUE).
  • Zijn er meerdere primaire verplichtingen, dan wordt de oudste (FVO.datumtijd_gebeurtenis) primaire verplichting gebruikt.
  • Is er geen primaire FVO, dan wordt het type gebruikt van de oudste (FVO.datumtijd_gebeurtenis) FinancieleVerplichtingOpgelegd.

Het type van een financiële verplichting bevat de code van het type. Bijvoorbeeld CJIB_WAHV. Deze wordt vertaald via de catalogus naar de leesbare variant en vervolgens getoond. Bijvoorbeeld: Verkeersboete

Indien het type niet in de catalogus staat, dan wordt de inhoud van het FVO.type zelf getoond. Bijv. CJIB_WAHV. (tijdelijke situatie).

Overdracht van zaak​

In de MVP variant van het overdracht proces (FCID v4.1), is er voor gekozen om van de overgedragen zaak geen gebeurtenissen of betalingsverplichtingen te tonen, alleen de gebeurtenissen van de overgenomen zaak worden getoond. Als een zaak dus is overgedragen door bronorganisatie A naar bronorganisatie B, dan wordt er geen enkele gebeurtenis van de overgedragen zaak in het door bronorganisatie A aangeleverde FCID getoond in de app. Bronorganisatie B zal bij een overdracht starten met een gebeurtenis FinancieleZaakOvergenomen. Alle gebeurtenissen die bronorganisatie B voor deze zaak in het FCID worden aangeleverd worden getoond.

De regels:

  • Een zaak heeft de "status" overgedragen als er voor de specifieke zaak een gebeurtenis FinancieleZaakOvergedragen in het FCID voorkomt, zonder dat deze is vervolgd door een gebeurtenis FinancieleZaakOvergenomen voor dezelfde zaak met een latere datumtijd_gebeurtenis . Er worden dan geen gebeurtenissen van deze zaak getoond.

  • Een zaak heeft de "status" overgenomen als er voor de specifieke zaak een gebeurtenis FinancieleZaakOvergenomen in het FCID voorkomt, zonder dat deze is vervolgd door een gebeurtenis FinancieleZaakOvergedragen voor dezelfde zaak met een latere datumtijd_gebeurtenis. De gebeurtenissen bij deze zaak worden dan wel getoond.

Samenvatting in tabelvorm:

Gebeurtenissen FCID
bronorganisatie A		Zichtbaar in app?Gebeurtenissen FCID
bronorganisatie B		Zichtbaar in app?
1FinancieleVerplichtingOpgelegd
BetalingsverplichtingOpgelegd		✅n.a.❌
2FinancieleVerplichtingOpgelegd
BetalingsverplichtingOpgelegd
BetalingsverplichtingIngetrokken
FinancieleZaakOvergedragen		❌FinancieleZaakOvergenomen
FinancieleVerplichtingOpgelegd
BetalingsverplichtingOpgelegd		✅
3FinancieleVerplichtingOpgelegd
BetalingsverplichtingOpgelegd
BetalingsverplichtingIngetrokken
FinancieleZaakOvergedragen
BetalingVerwerkt		❌FinancieleZaakOvergenomen
FinancieleVerplichtingOpgelegd
BetalingsverplichtingOpgelegd
BetalingVerwerkt		✅
4FinancieleVerplichtingOpgelegd
BetalingsverplichtingOpgelegd
BetalingsverplichtingIngetrokken
FinancieleZaakOvergedragen
BetalingVerwerkt
FinancieleZaakOvergenomen
BetalingVerwerkt		✅FinancieleZaakOvergenomen
FinancieleVerplichtingOpgelegd
BetalingsverplichtingOpgelegd
BetalingVerwerkt
FinancieleZaakOvergedragen		❌

Actuele betalingsverplichtingen​

Met actueel voor een gebeurtenis BetalingsverplichtingOpgelegd (BVO) wordt bedoeld dat binnen 1 zaak:

  1. Het saldo van de zaak (financiële_zaak.saldo) is groter dan nul
  2. De BVO is niet ingetrokken door een gebeurtenis BetalingsverplichtingIngetrokken (BVI) met een directe link naar een BVO (via ingetrokken_gebeurtenis_kenmerk).
  3. De zaak niet is overgedragen. Zie Overdracht van zaak voor de regels. NB: BVOs van een zaak met "status" overgenomen zijn wel actueel.
  4. De BVO heeft geen corresponderende gebeurtenis BetalingVerwerkt (BV), d.w.z. geen BV waarbij betalingskenmerk èn het bedrag gelijk zijn aan die van de BVO. Als er meerdere BVOs en BVs zijn, dan wordt deze gematcht op volgorde van datumtijd_gebeurtenis. De oudste BVO wordt (eenmalig!) tegen de oudste BV weggestreept.

Betalingstermijn​

  • Voor een betalingsverplichting met BVO.betaalwijze = "Handmatig" wordt de BVO.vervaldatum gebruikt om het aantal dagen tussen de huidige datum en de vervaldatum te berekenen. Als het aantal dagen kleiner wordt dan 0, dan wordt 0 aangehouden.
    • Als het aantal dagen < 0, dan wordt de tekst "BETAALTERMIJN VERSTREKEN" getoond.
    • Als het aantal dagen = 0, dan wordt de tekst "VANDAAG BETALEN" getoond.
    • Als het aantal dagen > 0 en < = 30, dan wordt het aantal dagen in de volgende tekst gezet: "NOG <aantal dagen> DAGEN OM TE BETALEN".
    • Als het aantal dagen > 30 is, dan wordt de datum uit BVO.vervaldatum met opmaak dd-mm-jjjj in de tekst gezet: "TE BETALEN VOOR <datum>".
  • Voor een betalingsverplichting met BVO.betaalwijze = "Automatische incasso" wordt de datum uit BVO.vervaldatum met opmaak dd-mm-jjjj in de tekst gezet: "AUTOMATISCHE INCASSO ROND <datum>".

Uitgewerkte mappingen​

Voor de volgende schermen is een mapping beschikbaar:

Overzichtsscherm​

Het Overzichtsscherm is het eerste scherm dat getoond wordt na het opstarten/aanmelden. Het toont de belangrijkste betalingsverplichtingen en financiële rechten.

Detailscherm Betalingsverplichting​

Het detailscherm voor een betalingsverplichting bevat de details van 1 specifieke gebeurtenis BetalingsverplichtingOpgelegd.

Dossiers​

Het scherm Dossiers toont een overzicht van de ontvangen financiële zaken met bijbehorende saldo.

Dossier detail​

Het scherm Dossiers toont een overzicht van de ontvangen financiële zaken met bijbehorende saldo.