Dossierstatusinformatie via een vereenvoudigde interface

1 Over de vereenvoudigde interface
2 Link naar de Swagger-documentatie
3 Overzicht velden vereenvoudigde interface
- 3.1 Dossierstatus
- 3.2 Dossieridentificatie
- 3.3 Contact
- 3.4 Adres
- 3.5 Agent
  - 3.5.1 BurgerAgent
  - 3.5.2 OndernemerAgent
  - 3.5.3 VerenigingsAgent
- 3.6 Aanvrager
- 3.7 Niet-gemapte verplichte velden
- 3.8 Niet-gemapte optionele velden

Over de vereenvoudigde interface

Voor nieuwe DOSIS-aansluitingen wordt altijd de synchrone RegistreerDossierBasis gebruikt. Een dossier wordt herkend op basis van een bron en een uniek dossiernummer. Dankzij de beperkte payload, met alleen de essentiële velden, ziet u meteen de verwerking van het dossier in DOSIS.

Deze vereenvoudigde interface volstaat voor de meeste DOSIS-implementaties.

Zie ook: API-calls DOSIS | API call bij een standaard DOSIS integratie met een vereenvoudigde interface.

Link naar de Swagger-documentatie

Zie: https://tni.notificatie.dev-vlaanderen.be/Dosis

Overzicht velden vereenvoudigde interface

Hieronder vindt u een overzicht van de (niet-)functionele velden, inclusief de mapping op de uitgebreide interface.

{
  "DossierIdentificatie": {
    "Bron": "string",
    "Nummer": "string"
  },
  "Naam": "string",
  "WijzigingsDatum": "2022-03-10T11:38:11.676Z",
  "ProductId": 1,
  "VlaamseFase": "string",
  "VlaamseCode": "string",
  "DetailStatus": "string",
  "Actie": "string",
  "DoorverwijzingUrl": "string",
  "DossierBeheerder": {
    "Naam": "string",
    "Dienst": "string",
    "Telefoon": "string",
    "Email": "string",
    "Website": "string",
    "Adres": {
      "Straat": "string",
      "Nummer": "string",
      "Postcode": "string",
      "Gemeente": "string"
    }
  },
  "Agenten": [
    {
      "Rijksregisternummer": "01234567891",
      "$type": "Burger"
    },
    {
      "KboNummer": "0123456789",
      "ToegangsRechten": [
        {
          "Code": "1"
        }
      ],
      "$type": "Onderneming"
    }
  ]
}

Wens je dossierstatussen in een andere taal dan het Nederlands te sturen, volg dan de instructies op Overzicht basisbegrippen DOSIS | Meertaligheid

Dossierstatus

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op huidige uitgebreide interface

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op huidige uitgebreide interface
DossierIdentificatie	Identificatie van het dossier waarbinnen deze dossierstatus hoort	Dossier-Identificatie	Verplicht	/
Naam	De titel van het dossier	String	Verplicht String (0 - 255)	Dossier.Naam
Wijzigingsdatum	Datum en tijdstip van de laatste dossierwijziging. Vergeet de tijdzone niet mee te geven (via de Z achteraan)	DateTime	Verplicht	Dossier.WijzigingsDatum Dossier.Status.WijzigingsDatum
ProductId	De IPDC-ID (getal) van het product of de dienst waarop het dossier betrekking heeft.	Integer	Verplicht	Dossier.Producten[0].ProductId
VlaamseFase	OSLO-standaard - Vlaamse status - Fase	String	Verplicht String (0 - 255)	Dossier.Status.VlaamseFase
VlaamseCode	OSLO standaard - Vlaamse status - Code	String	Verplicht String (0 - 255)	Dossier.Status.VlaamseCode
DetailStatus	Vrij in te vullen detailinformatie over de dossierstatus	String	Optioneel String (0 - 255)	Dossier.Status.Detail1
Actie	Omschrijving van de uit te voeren actie	String	Optioneel String (0 - 255)	Indien ingevuld en lengte > 0 en niet enkel whitespace: Dossier.Status.Actie.ActieNodig = true Dossier.Status.Actie.Actie = Actie Indien niet ingevuld of lengte = 0 of enkel whitespace: Dossier.Status.Actie.ActieNodig = false Dossier.Status.Actie.Actie = null
DoorverwijzingUrl	Hyperlink naar een applicatie waar er meer informatie over het dossier beschikbaar is. Moet een geldige URL zijn	URL	Optioneel String (0 - 255)	Dossier.Doorverwijzing
DossierBeheerder	De contactgegevens van de dossierbeheerder	Contact	Optioneel	Dossier.DossierBeheerder
Agenten	Een lijst van burgers, ondernemingen of verenigingen die bij het dossier betrokken zijn. Er moet minstens 1 agent gedefinieerd zijn op het dossier.	Lijst van Agent	Verplicht	Dossier.Agenten
Aanvrager	De naam van de aanvrager van het dossier enkel voor verenigingen	Aanvrager	Optioneel	Dossier.Aanvrager

Dossieridentificatie

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface
Bron	De bron (namespace) van het dossier, bv. http://www.agentschap.vl/applicatie. Deze namespace wordt aangemaakt bij de aansluiting aan DOSIS.	URL	Verplicht String (0 - 255)	Dossier.Identificatie.Bron
Nummer	Het unieke nummer van het dossier binnen de gekozen bron	String (Geen white-space)	Verplicht String (1 - 255)	Dossier.Identificatie.DossierNummer

Contact

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface
Naam	De naam van de dossierbeheerder	String	Optioneel String (0 - 255)	Dossier.DossierBeheerder.Naam
Dienst	De dienst van de dossierbeheerder	String	Optioneel String (0 - 255)	Dossier.DossierBeheerder.Dienst
Telefoon	Het telefoonnummer van de dossierbeheerder Moet een geldig telefoonnummer-formaat zijn	String	Optioneel String (0 - 255)	Dossier.DossierBeheerder.Telefoon
Email	Het e-mailadres van de dossierbeheerder Moet een geldig e-mailformaat zijn eldig email-formaat hebben	String	Optioneel String (0 - 255)	Dossier.DossierBeheerder.Email
Website	De website van de dossierbeheerder Moet een geldige URL zijn	String	Optioneel String (0 - 255)	Dossier.DossierBeheerder.Website
Adres	Zie hieronder:	Adres	Optioneel	Dossier.DossierBeheerder.Adres

Adres

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface
Straat	De straatnaam in het adres van de dossierbeheerder	String	Optioneel String (0 - 255)	Dossier.DossierBeheerder.Adres. Straat
Nummer	Het huisnummer (en eventueel het busnummer) in het adres van de dossierbeheerder.	String	Optioneel String (0 - 255)	Dossier.DossierBeheerder.Adres. Nummer
Postcode	De postcode in het adres van de dossierbeheerder.	String	Optioneel String (0 - 255)	Dossier.DossierBeheerder.Adres. Postcode
Gemeente	De gemeentenaam in het adres van de dossierbeheerder	String	Optioneel String (0 - 255)	Dossier.DossierBeheerder.Adres. Gemeente

Agent

BurgerAgent

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface
Rijksregister-nummer	Uniek persoonsnummer	String	Verplicht String (11)	Dossier.Agenten.Identificatie
$type	Het type agent; voor een BurgerAgent is dit “Burger” (case insensitive)	String	Verplicht

OndernemerAgent

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface

Naam

Omschrijving

Type

Verplicht/
Optioneel

Mapping op uitgebreide interface

KboNummer

Uniek ondernemingsnummer

String

Verplicht
String (10)

Dossier.Agenten.Identificatie

Toegangsrechten

De rollen waarmee een gebruiker toegang krijgt om het dossier te raadplegen

In principe kan je dit leeg laten. Enkel als je een bepaalde rol meegeeft, dan zullen niet-vertegenwoordigers die deze rol hebben het dossier kunnen inkijken.

per default leeg laten. Wil je rollen gebruiken, stem dan eerst af met de collega’s van het VLAIO Eloket ondernemers.

Lijst met strings

Verplicht
String (
1 - 255)

Niet enkel whitespace

Dossier.Agenten.Toegangsrechten.Code

$type

Het type agent; voor een OndernemerAgent is dit “Onderneming” (case insensitive)

String

Verplicht

VerenigingsAgent

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface

Naam

Omschrijving

Type

Verplicht/
Optioneel

Mapping op uitgebreide interface

VCodeNummer

Uniek verenigingsnummer, met als prefix “V”, aangevuld met 7 tot 9 cijfers. Bijvoorbeeld “V1234567”

Voor vzw’s wordt altijd het KBO-nummer gebruikt.
Voor feitelijke verenigingen en afdelingen wordt altijd en alleen de V-Code gebruikt.

String

Verplicht
String (10)

Dossier.Agenten.Identificatie

Toegangsrechten

De rollen waarmee een gebruiker toegang krijgt om het dossier te raadplegen

In principe kan je dit leeg laten. Enkel als je een bepaalde rol meegeeft, dan zullen niet-vertegenwoordigers die deze rol hebben het dossier kunnen inkijken. Een voorbeeld van zo’n rol is: CJM_Vloket_VER_CompEnt_DossierLezer

per default leeg laten. Wil je rollen gebruiken, stem dan eerst af via aansluitingen.verenigingsloket@vlaanderen.be of via het technisch spreekuur.

Lijst met strings

Verplicht
String (
1 - 255)

Niet enkel whitespace

Dossier.Agenten.Toegangsrechten.Code

$type

Het type agent; voor een VerenigingsAgent is dit “Vereniging” (case insensitive)

String

Verplicht

Aanvrager

optioneel veld, dat enkel te gebruiken is in de context van verenigingen. Meer info.

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface

Naam	Omschrijving	Type	Verplicht/ Optioneel	Mapping op uitgebreide interface
Naam	De familienaam van de persoon die het dossier heeft gestart/aangevraagd	String	Optioneel String (0 - 255)	Dossier.Aanvrager
Voornaam	De voornaam van de persoon die het dossier heeft gestart/aangevraagd	String	Optioneel String (0 - 255)	Dossier.Aanvrager

Niet-gemapte verplichte velden

TypeDossierCode = “DossierStatus”

Niet-gemapte optionele velden

Deze velden kan je negeren en dien je niet mee te geven in de payload:

IsVertrouwelijk = false
IsPubliek = false
IsNietRaadpleegbaar = false

Documentatie voor partners en klanten van Digitaal Vlaanderen - bouwstenen Mijn Burgerprofiel, Verenigingsloket en e-loketondernemers

Documentatie voor klanten en partners van Digitaal Vlaanderen - bouwstenen Mijn Burgerprofiel, Verenigingsloket en e-loketondernemers

Dossierstatusinformatie via een vereenvoudigde interface

Over de vereenvoudigde interface

Link naar de Swagger-documentatie

Overzicht velden vereenvoudigde interface

Dossierstatus

Dossieridentificatie

Contact

Adres

Agent

BurgerAgent

OndernemerAgent

VerenigingsAgent

Aanvrager

Niet-gemapte verplichte velden

Niet-gemapte optionele velden

Related content