Algemeen

Header Parameters

Naam

Verplicht

Omschrijving

x-correlatation-id

Ja

Referte (uuid) om de actie uniek te identificeren

Bron

Ja

Code die aangeeft welke bron aangesproken wordt.

STAT : registreer een dossier bij DOSIS
SUB : registreer een dossier bij Subsidieregister
STATSUB : registreer een dossier bij Subsidieregister en DOSIS

Op deze pagina

1 Algemeen
2 Header Parameters
3 Elementen
4 Validaties op vraag
5 Voorbeeld

Met vragen kunt u steeds terecht bij de MAGDA Service Desk.

Elementen

MAGDA element				Verplicht	Omschrijving

MAGDA element				Verplicht	Omschrijving
@Context				Ja	Publieke link naar de OSLO context file
Algemeen				Ja
	Agenten			Ja	Een lijst van ondernemingen of burgers die bij het dossier betrokken zijn. Er moet minstens 1 agent gedefinieerd zijn op het dossier.
		Identificatie		Ja	De identificatie van de agent (ondernemingsnummer of rijksregisternummer). Indien in de vraag 9 cijfers is doorgegeven, voorloopnul toevoegen. Formaat : 10 of 11 cijfers
		Toegangsrechten		Ja	Lijst van applicatiespecifieke rollen waartoe een gebruiker moet behoren om het dossier te mogen raadplegen. Indien je geen toegangsrecht opgeeft zal het dossier zichtbaar zijn voor gebruikers met de rol Wettelijk Vertegenwoordiger die een werkrelatie hebben met de identificatie van de agent. De applicatiespecifieke rollen worden beheerd in het Digitaal Gebruikersbeheer van de Vlaamse Overheid (IDM). Opmerking: er moet minstens 1 toegangsrecht gedefinieerd zijn voor de desbetreffende agent.
			Code	Ja	De rol waartoe een gebruiker moet behoren om het dossier te mogen raadplegen.
	DossierIdentificatie			Ja	De identificatie van het dossier.
		Bron		Ja	De bron (namespace) van het dossier, bv. http://www.agentschap.vl/applicatie. Deze namespace wordt aangemaakt bij de aansluiting aan DOSIS.
		Dossiernummer		Ja	Het dossiernummer
	Producten			Ja	Een lijst van id's van de producten waarop het dossier betrekking heeft. Opmerking: Minstens 1 product is verplicht in geval TypeDossierCode= DossierStatus
		Id		Ja	Een IPDC id is een getal (vb. 100). De IPDC id van het product waarop het dossier betrekking heeft. Enkel geldige IPDC codes zijn toegelaten. Zie http://productencatalogus.vlaanderen.be/ voor meer informatie.
	Status			Neen	De status van het dossier. Opmerking: verplicht in geval TypeDossierCode = DossierStatus EN indien source= ‘STAT’. DOSIS doet hier zelf een validatie op. Indien enkel Subsidieregister (source= SUB) , of Subsidieregsiter+DOSIS (Source= STATSUB) gevoed wordt, is Status verplicht
		VlaamsCode		Ja	De Vlaamse status - Code. Mogelijke waarden.
		VlaamsFase		Ja	De Vlaamse status - Fase. Mogelijke waarden.
		EDRL		Neen	De Europese dienstenrichtlijn status. Mogelijke waarden.
		Detail1		Neen	De detailstatus 1.
		Detail2		Neen	De detailstatus 2.
		WijzigingsDatum		Neen	Datum en tijdstip van de laatste statuswijziging. Opmerking: indien opgegeven, moet de status-wijzigingsdatum voor de wijzigingsdatum van het ganse dossier vallen.
		Actie		Neen
			ActieNodig	Neen	Aanduiding of de huidige status impliceert dat er actie van burger of onderneming nodig is.
			Actie	Neen	Omschrijving van de uit te voeren actie. Opmerking: Verplicht indien er actie nodig is, leeg indien er geen actie nodig is.
Algemeen				Ja
	Agenten			Ja	Er moet 1 en slechts 1 agent in de MAGDA request zitten.
		Identificatie		Neen	Het ondernemingsnummer waaraan de subsidie wordt/werd toegekend. Indien in de vraag 9 cijfers gebruikt wordt een voorloopnul toegevoegd Formaat : 10 cijfers Minstens 1 Ondernemingsnummer of 1 VOPnummer moet voorkomen.
		VOPNummer		Neen	Het VO-nummer van de instelling (organisatie zonder ondernemingsnummer/buitenlandse onderneming) waaraan de subsidie wordt/werd toegekend. Minstens 1 Ondernemingsnummer of 1 VOPnummer moet voorkomen.
	DossierIdentificatie			Ja
		Bron		Ja	De bron (namespace) van het dossier
		DossierNummer		Ja	Unieke referentie van randsysteem
	Producten			Ja
		Id		Ja	Product waarop de subsidie betrekking heeft. Enkel geldige IPDC codes zijn toegelaten. Zie http://productencatalogus.vlaanderen.be voor meer informatie.
	Status			Neen	De status van het dossier.
		VlaamsCode		Ja	De Vlaamse status - Code. Zie Mogelijke waarden
		VlaamsFase		Ja	De Vlaamse status - Fase. Zie Mogelijke waarden
DossierOpvolging				Neen
	Naam			Neen	De titel van het dossier.
	WijzigingsDatum			Neen	Datum en tijdstip van de laatste dossierwijziging. Opmerking: verplicht in geval TypeDossierCode= DossierStatus.
	StreefDatum			Neen	Datum en tijdstip tegen wanneer logischerwijze het dossier afgerond zal zijn.
	TypeDossierCode			Ja	Het type van dossier (een dossier met een status of een verwijzing naar een dossier of een cluster van dossiers, zonder status). Mogelijke waarden.
	DossierBeheerder			Neen	De contactgegevens van de dossierbeheerder.
		Naam		Neen	De naam van de dossier beheerder.
		Dienst		Neen	De dienst van de dossier beheerder.
		Telefoon		Neen	Het telefoonnummer van de dossier beheerder. Opmerking: indien ingevuld moet de waarde een geldig telefoonnummer-formaat hebben
		Email		Neen	Het e-mail adres van de dossier beheerder. Opmerking: indien ingevuld moet de waarde een geldig email-formaat hebben
		Website		Neen	De website van de dossier beheerder. Opmerking: indien ingevuld moet de waarde een geldig URL-formaat hebben
		Adres		Neen	Het adres van de dossierbeheerder.
			Straat	Neen
			Nummer	Neen
			Postcode	Neen
			Gemeente	Neen
	ExtraInformatie			Neen	Extra informatie over het dossier.
	Doorverwijzing			Neen	Hyperlink naar een applicatie waar er meer informatie over het dossier beschikbaar is.
	IsVertrouwelijk			Neen	Aanduiding of het dossier vertrouwelijk is en enkel door bevoegde ambtenaren geraadpleegd kan worden. (default= false)
	IsPubliek			Neen	Aanduiding of het dossier publiek is en door iedereen geraadpleegd mag worden. (default= false)
	IsNietRaadpleegbaar			Neen	Aanduiding of het dossier niet-raadpleegbaar mag zijn door DOSISraadpleger en wettelijk vertegenwoordiger (default= false)
	ProjectBedrag			Neen	Het toegezegde bedrag van het project gekoppeld aan dit dossier
	LaatstBetaaldDeelBedrag			Neen	Het laatst uitbetaalde bedrag voor het project gekoppeld aan dit dossier
	LaatsteDeelBetalingDatum			Neen	De datum van het laatst uitbetaalde bedrag voor het project gekoppeld aan dit dossier Opmerking: verplicht indien LaatstBetaaldDeelBedrag is ingevuld.
	ReedsBetaaldDeelBedrag			Neen	Het totaal van de reeds uit betaalde deelbedragen
	TypeSubsidieCode			Neen	Over welk soort subsidie gaat het ? (Deminimis, Staatsteun) Mogelijke waarden.
Subsidie				Neen
	Begunstigde_Vestigingseenheid			Neen	Andere begunstigde dan maatschappelijke zetel, verduidelijking waar de subsidiemaatregel terechtkomt
		Naam		Neen	Naam van de andere begunstigde dan maatschappelijke zetel
		Vestigingseenheid_nummer		Neen	Nummer van de vestiging van de andere begunstigde dan maatschappelijke zetel
		Vestigingseenheid_postcode		Neen	Postcode van de vestiging van de andere begunstigde dan maatschappelijke zetel
	Bedrijfsnaam			Neen	De bedrijfsnaam van de Organisatie
	Land			Neen	Landcode van de Organisatie (ISO 3166-1 alpha-2 codes)
	Postcode			Neen	Postcode van de Organisatie, indien Organisatie in België gevestigd
	Postcode_buitenland			Neen	Postcode van de Organisatie (ISO 3166-1 alpha-2 codes), indien Organisatie in buitenland gevestigd
	InhoudelijkDescreet			Ja	Een verwijziging naar de rechtsgrond i.k.v. de uitvoering van de subsidie
	Aggregatie_subsidiemaatregel			Ja	Interne groepering i.k.v. rapportering: Wat wij gaan bepalen
	Deminimis			Neen	Vanuit europa om gegevensvervalsing tegen te gaan
	ESR_code			Ja	Het Europees stelsel van nationale en regionale rekeningen (ESR) bevat de registratieregels die moeten worden toegepast om een onderling samenhangende, betrouwbare en vergelijkbare kwantitatieve beschrijving van de ecoNeenmieën van de lidstaten te verkrijgen.
	ISE_code			Ja	Inhoudelijk zinvolle clustering van kredieten of deelbevoegdheden binnen een programma
	Beleidsdomein_code			Ja	code beleidsdomein
	Minister_code			Ja	Ministercode
	Toegekend_bedrag			Neen
	Bedrag_VAK			Neen	VAK= Dit is het krediet, ingeschreven in de uitgavenbegroting, ten belope waarvan tijdens het begrotingsjaar verbintenissen kunnen worden aangegaan. Het volledige subsidiebedrag
	Bedrag_VEK			Neen	VEK= Het krediet, ingeschreven in de uitgavenbegroting, ten belope waarvan verplichtingen tot betaling ten gevolge van tijdens het lopende of eerdere begrotingsjaren aangegane verbintenissen kunnen worden vereffend.
	IO_nummer			Neen	Inkoopordernummer, vastleggingsnummer
	Datum_inhoudelijke_beslissing			Ja	Datum beslissing toekenning subsidie aan begunstigde
	Bedrag_betaald			Neen	Werkelijk betaalde uitgaven
	Datum_betaald			Neen	Datum betaald bedrag
	Bedrag_terugvordering			Neen	Bedrag terugvordering
	Datum_terugvordering			Neen	Datum terugvordering

Validaties op vraag

	Element	Omschrijving van de validatie	Mogelijke Foutcodes

	Element	Omschrijving van de validatie	Mogelijke Foutcodes
1	Algemeen.Agenten.Agent.Identificatie	Lengte 9 of 10 cijfers → Checksum97 op ondernemingsnummer Lengte 11 cijfers → Checksum97 op Rijksregisternummer	Status Code : 400 Description : Agent heeft foutief formaat
2	Algemeen.Agenten.Agent.Identificatie Algemeen.Agenten	IF ((Source = “STATSUB“ OR Source = “SUB“) AND Length(Identificatie) > 10)	Status Code : 400 Description : Subsidiregister verwacht een KBO nummer
3	Algemeen.Agenten	IF (Source = “SUB” OR Source=”STATSUB”) AND count(Agent) > 1	Status Code : 400 Description : Subsidiregister verwacht een KBO nummer
4	Algemeen.Producten.ProductID	IF source ‘SUB’ or ‘STATSUB’ has count (productID) >1	Status Code : 400 Description : Slechts 1 ProductID toegelaten voor bron [Bron]
5	Algemeen.Agenten.Agent.VOPnummer Algemeen.Agenten.Agent.Identificatie	IF not exist(Identificatie) AND not exist(VOPnummer)	Status Code : 400 Description : Een Identificatie of VOPnummer moet meegegeven worden
6	Algemeen.Agenten.Agent.VOPnummer Algemeen.Agenten.Agent.Identificatie	IF exist(Identificatie) AND exist(VOPnummer)	Status Code : 400 Description : Identificatie EN VOPnummer mogen niet samen voorkomen voor bron [Bron]
7	Algemeen.Agenten.Agent.VOPnummer	IF (Source<>”SUB”) AND exist(VOPnummer)	Status Code : 400 Description : Een VOPnummer kan enkel meegegeven worden met bron SUB
8	Algemeen.Agenten.Agent.Toegangsrechten.Toegangsrecht	IF (Source = “STAT” OR Source=”STATSUB”)	Status Code : 400 Description : Minimum 1 Toegangsrecht moet meegegeven worden voor bron [Bron]
9	Subsidie.Postcode Subsidie_postcode_buitenland	IF (Source = “SUB” OR Source=”STATSUB”) AND exist(Postcode) AND exist(postcode_buitenland)	Status Code : 400 Description : 1 postcode of 1 postcode_buitenland moet meegegeven worden voor bron [Bron]
10	Subsidie	IF (Source = “SUB” OR Source=”STATSUB”) AND not exist(Subsidie)	Status Code : 400 Description : Het deel ‘Subsidie’ ontbreekt in de vraag voor bron [Bron]
11	Dossieropvolging	IF (Source = “STAT” OR Source=”STATSUB”) AND not exist(Dossieropvolging)	Status Code : 400 Description : Het deel ‘Dossieropvolging’ ontbreekt in de vraag voor bron [Bron]
12	Algemeen.Status	IF (Source = “SUB” OR Source=”STATSUB” ) AND not exist( Algemeen.Status )	Status Code : 400 Description : Het deel ‘Status’ ontbreekt in de vraag voor bron [Bron]
13	Algemeen.Agenten.Agent.Identificatie	IF ((Source = “STAT” OR Source = “STATSUB”) AND not exists(agent.Identificatie)	Status Code : 400 Description : Er moet minstens 1 Ondernemingsnummer/INSZ gedefinieerd zijn voor bron [Bron]

Voorbeeld

{
  "@context": "https://vlaamseoverheid.atlassian.net/wiki/download/attachments/485883970/dossier-context.jsonld",
  "Algemeen": {
    "Agenten": [
      {
        "Identificatie": "string",
        "VOPnummer": "string",
        "Toegangsrechten": [
          {
            "Code": "string"
          }
        ]
      }
    ],
    "DossierIdentificatie": {
      "Bron": "string",
      "DossierNummer": "string"
    },
    "Producten": [
      {
        "Id": "string"
      }
    ],
    "Status": {
      "VlaamsCode": "string",
      "VlaamsFase": "string",
      "EDRL": "string",
      "Detail1": "string",
      "Detail2": "string",
      "WijzigingsDatum": "2022-04-25T15:46:00.328Z",
      "Actie": {
        "ActieNodig": true,
        "Actie": "string"
      },
      "StreefDatum": "2022-04-25T15:46:00.328Z"
    }
  },
  "Dossieropvolging": {
    "Naam": "string",
    "WijzigingsDatum": "2022-04-25T15:46:00.328Z",
    "StreefDatum": "2022-04-25T15:46:00.328Z",
    "TypeDossierCode": "string",
    "DossierBeheerder": {
      "Naam": "string",
      "Dienst": "string",
      "Telefoon": "string",
      "Email": "string",
      "Website": "string",
      "Adres": {
        "Straat": "string",
        "Nummer": "string",
        "Postcode": "string",
        "Gemeente": "string"
      }
    },
    "ExtraInformatie": "string",
    "Doorverwijzing": "string",
    "IsVertrouwelijk": true,
    "IsPubliek": true,
    "IsNietRaadpleegbaar": true,
    "ProjectBedrag": 0,
    "LaatstBetaaldDeelBedrag": 0,
    "LaatsteDeelBetalingDatum": "2022-04-25T15:46:00.330Z",
    "ReedsBetaaldDeelBedrag": 0,
    "TypeSubsidieCode": "string"
  },
  "Subsidie": {
    "Begunstigde_Vestigingseenheid": {
      "Naam": "string",
      "Vestigingseenheid_nummer": "string",
      "Vestigingseenheid_postcode": "string"
    },
    "Bedrijfsnaam": "string",
    "Land": "st",
    "Postcode": "stri",
    "Postcode_buitenland": "string",
    "InhoudelijkDecreet": "string",
    "Aggregatie_Subsidiemaatregel": "string",
    "Deminimis": true,
    "ESR_code": 9999,
    "ISE_code": "strin",
    "Beleidsdomein_code": "s",
    "Minister_code": "s",
    "Bedrag_VAK": 0,
    "Toegekend_bedrag": 0,
    "Bedrag_VEK": 0,
    "IO_nummer": "string",
    "Datum_inhoudelijke_beslissing": "2022-04-25T15:46:00.330Z",
    "Bedrag_betaald": 0,
    "Datum_betaald": "2022-04-25T15:46:00.330Z",
    "Bedrag_terugvordering": 0,
    "Datum_terugvordering": "2022-04-25T15:46:00.330Z",
    "Bedrag_ontvangen": 0,
    "Ontvangstdatum": "2022-04-25T15:46:00.330Z",
    "Factuurdatum": "2022-04-25T15:46:00.330Z",
    "Factuurnummer": "string",
    "Datum_binnengekomen": "2022-04-25T15:46:00.330Z",
    "Begrotingsartikel": "oe5-CaTiaoB-Jd",
    "Economische_rekening": "string"
  }
}

MAGDA Gebruikersomgeving

Beschrijving Vraag (POST dossier/dossiers)

Algemeen

Header Parameters

Elementen

Validaties op vraag

Voorbeeld

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid