Overzicht basisbegrippen DOSIS

Overzichtsarchitectuur

Open

Overzichtsarchitectuur DOSIS + Notificaties

Use cases

Lexicon

Aanvrager (alleen voor verenigingen)

Door het verloop van functionarissen binnen verenigingen is het mogelijk om de initiële aanvrager (naam + voornaam) van een dossier vast te leggen. Zo weet de nieuwe vertegenwoordiger bij wie hij terecht kan in de vereniging met vragen over het dossier van die initiële aanvrager.

📌 Deze functionaliteit is alleen beschikbaar binnen de context van verenigingen.

Agent

Geeft aan wie een dossier kan consulteren en/of aanpassen. Een agent is opgebouwd uit:

• Identificatie (wie)

  • Rijksregisternummer voor burgers

  • KBO-nummer voor ondernemingen en vzw’s

  • V-code voor feitelijke verenigingen en afdelingen

• 1 of meer toegangsrechten (wat mag)

1 DOSIS-call kan combinaties van agenten bevatten.

Zie ook: Hoe DOSIS voeden via RegistreerDossierBasis | AgentPreview

Bron

Een bron voor de DOSIS API is elke Vlaamse of lokale overheidsdienst die dienstverlening biedt aan:

• een burger die in Vlaanderen woont

• een onderneming of vereniging gevestigd in Vlaanderen

Om dossierstatussen aan te leveren, moet de bron van de dossierstatussen geregistreerd zijn. De bron-URI wordt toegewezen bij aansluiting op Dossierstatusinformatie (DOSIS), samen met bron-ID.

De combinatie bron-URI en dossiernummer of de combinatie bron-ID en dossiernummer vormen de unieke dossieridentificatie binnen DOSIS. De bron-URI of de bron-ID + het dossiernummer zijn verplichte velden.

Digitaal Vlaanderen geeft altijd de bron-URI, de bron-ID en het dossiernummer bij elke opvraging van een dossier.

DOSIS

DOSIS staat voor DossierStatusInformatieSysteem. Het centraliseert en ontsluit de status van dossiers bij Vlaamse en lokale overheidsdiensten. Het biedt burgers en organisaties transparantie over de voortgang van hun dienstverleningsaanvragen via de digitale loketten: Mijn Burgerprofiel, e-loket ondernemers en Verenigingsloket.

Daarnaast kunt u gebruikers automatisch informeren over dossierupdates via notificaties, afgestemd op hun gekende contactvoorkeuren. Dit versterkt de proactieve dienstverlening en verhoogt de betrokkenheid.

Welke gebeurtenissen (statussen) in DOSIS worden getoond, kiest de bron. De dossiers zelf zitten bij de beheerders van die dossiers.

Dossierstatus

De status van een DOSIS-dossier kan meerdere agenten bevatten. Dat kan een mix zijn van agenten met als identificatie rijksregisternummer, KBO-nummer en/of V-code. De toegang tot een dossier gebeurt daarnaast ook op basis van de toegangsrechten (IDM).

• Wie is aangemeld via Mijn Burgerprofiel heeft toegang tot een dossier als:

  • agent identificatie = rijksregisternummer

  • agent toegangsrecht = “Raadpleger” (vaste string / case sensitive)

• Wie is aangemeld via ondernemingsloket/verenigingsloket heeft toegang tot een dossier als:

  • agent identificatie = ondernemingsnummer of vestigingsnummer binnen die onderneming

  • agent toegangsrecht = Wettelijk vertegenwoordiger

• Wie is aangemeld via ondernemingsloket/verenigingsloket heeft toegang tot een dossier als de ACM/IDM-rol identiek is aan de agent identificatie + toegangsrecht

Doorverwijs-URL

Eigenschap van een dossierstatus en link om direct naar de detailinfo van een dossier te gaan in het eigen systeem. Dit is een optioneel veld dat bij voorkeur ook achter ACM/IDM zit zodat toegang kan binnen een SSO-ervaring.

Dossieridentificatie

De dossieridentificatie moet altijd uniek zijn. Het bestaat uit een combinatie van de toepassingsnaam en het dossiernummer.

Werkt u met 2 toepassingen waarin dossiers beheerd worden, met dossiernummers die alleen uniek zijn binnen de toepassing, maar niet over de beide toepassingen heen, dan moet u twee bronnen registreren in DOSIS.

DOSIS kent voor elke bron een namespace toe:

• urn://www.agentschap/toepassing1

• urn://www.agentschap/toepassing2

Zo kunnen twee verschillende dossiers met hetzelfde dossiernummer toch een unieke identificatie krijgen. De identificatie van de dossiers wordt dan:

• urn://www.agentschap/toepassing1/BE123

• urn://www.agentschap/toepassing2/BE123

DossierStatus - eigenschappen

Dossierbeheerder

Je kan optioneel een dossierbeheerder meegeven. Als je hem invult, dan wordt minstens één contactgegeven verwacht.

Endpoints

Gebruik deze endpoints voor de DOSIS API-calls:

• TNI:  https://dosis.api.tni-vlaanderen.be

• Productie: https://dosis.api.vlaanderen.be

Meer informatie

• over de API-calls DOSISPreview

• in de Swagger-documentatie TNI en productie

IPDC

De Interbestuurlijke Producten- en dienstencatalogus (IPDC)  biedt een beknopte omschrijving van alle ‘producten en dienstverleningen’ van de Vlaamse overheid en lokale besturen.

Een overheidsproduct wordt gedefinieerd als elke

• overheidsdienstverlening

• voor een externe doelgroep

• voor meerdere klanten

• waarbij er interactie is tussen de klant en de dienstverlenende overheid

DOSIS opzetten kan voor producten en diensten die voorkomen in de IPDC. U kiest voor welke dienstverlening u de dossierstatussen wilt delen en voor welke doelgroep: burgers, ondernemers of verenigingen. Door met de IPDC-catalogus te werken, zorgen we voor een uniforme communicatie naar de gekozen doelgroep. Bovendien kunnen we op basis van IPDC thematisch werken en waar nodig, de informatie valideren.

👉 https://productencatalogus.vlaanderen.be/

Mandaten

Als een agent (burger, ondernemer of vertegenwoordiger van een vereniging) een mandaat kreeg vanuit het Vlaams MandatenSysteem (VMS), dan zal de mandaatnemer ook de dossiers kunnen zien van de mandaatgever. Hiervoor gelden een aantal beperkingen, 👉 Mandaten in DOSISPreview.

OAuth client

De OAuth client is de applicatie van de afnemer die data opvraagt bij de Resource server (DOSIS REST-API) via het OAuth 2.0 protocol, beveiligd door ACM/IDM en de Client Credentials Grant flow.

OVO-code

OVO staat voor “Organisatie Vlaamse Overheid”. Elke organisatie-éénheid of suborganisatie binnen de Vlaamse overheid beschikt over zo'n OVO-code die verwijst naar het organisatieregister.

REST API

DOSIS is raadpleegbaar via een restful API die door verschillende loketten of (mobile) devices kan worden aangesproken. Welke informatie wordt ontsloten en voor wie, wordt geregeld via ACM/IDM.

De DOSIS API is een REST API, beveiligd via het OAuth 2.0 protocol. Voor de authenticatie en autorisatie van gebruikers die gegevens aanleveren, maakt DOSIS gebruik van het Vlaams Toegangsbeheer (ACM/IDM)

Upload-ID

Uniek ID dat u zelf genereert of terugkrijgt van DOSIS (als u zelf geen uniek ID kan genereren), en dat dient om achteraf het resultaat van de upload van dossierstatusinformatie te controleren.