Overzicht
Service om mandaten tussen natuurlijke personen, een mandaatgever en een mandaatnemer, te raadplegen.
Externe communicatie
SubdomeinVeiligheid
TypologieService & API
Service ownerFOD Financiën
2021
Hergebruik5
Waarvoor dient het?
Als overheidsinstelling bied je gebruikers van je toepassing de mogelijkheid om personen aan te wijzen die namens hen rechtsgeldige handelingen mogen verrichten. De REST-service fpsFinanceGateway maakt dit beheer van mandaten tussen burgers onderling mogelijk. Op deze manier kunnen mandaatnemers– aangewezen door mandaatgevers – binnen een duidelijk afgebakend kader een dossier inzien en/of een aanvraag indienen namens de mandaatgever.
Functionele beschrijving
De REST-service fpsFinanceGateway is een façade boven op de REST service MandatesExternalImplService van de FOD Financiën.
De service biedt de volgende functionaliteit:
- Raadplegen van alle actieve mandaten op voor een natuurlijk persoon.
-> Raadplegen van de mandaten per de mandaatgever
-> Raadplegen van de mandaten per de mandaatnemer
De service MandatesExternalImplService laat toe alle mandaten op te vragen voor een mandaatgever, voor een mandaatnemer, een mandaat te consulteren op basis van een mandaat-ID, voor een ingevoerde datum een lijst van mandaten op te vragen die sinds deze datum zijn gewijzigd, te valideren of er een mandaat bestaat voor een specifieke mandaatgever en mandaatnemer.
De mandaten worden aangemaakt in de toepassing Self Service Mandates (afkorting: SSM) van de FOD Financiën en worden ondertekend door beide partijen.
Een mandaatgever kan een nieuw mandaat aanmaken, de mandaatnemer aanduiden of het mandaat aanvaarden door een handtekening. Om een mandaat te activeren, dient het steeds door beide partijen (mandaatgever en mandaatnemer) getekend te worden. Beide partijen kunnen het mandaat op elk ogenblik wijzigen of stopzetten.
Er bestaan verschillende types van mandaten, naargelang de service die ervan gebruik maakt.
Volgende domeinen/contexten zijn al geïntegreerd: FOD Financiën, Gezondheidszorg (eHealth), Vlaanderen, Myhandicap (FOD Sociale Zekerheid), SFPD.
Technische beschrijving
Beveiligde REST-service die OAuth 2.0/OpenId-authenticatie vereist, geïmplementeerd op de API Gateway SocSec van de sociale zekerheid
Doelpubliek
Alle openbare instellingen
Integratievoorwaarden
De toepassing van de instelling wordt gehost binnen de tenant SOCSEC.
Om gebruik te maken van je passthrough, dien je contact op te nemen met de FOD Financiën om een toepassingsdomein aan te maken (bijv. MyHandicap, MyPension).
De URN van de toepassing moet toegevoegd worden aan de toegangsregels van de service via het ‘Uniek dossier’.
Documentatie
- API documentatie
- G-Cloud - CSAM Self Service Mandaten
- CSAM - Self Service Mandatensysteem
- Toegang - CSAM Self Service Mandaten
Andere interessante componenten
Contact
Contact : ReuseOperational@smals.be
