Algemeen

Opmerking:

De beschrijving van het antwoord hieronder bevat alle mogelijke velden. Het antwoord dat u als gebruiker zal ontvangen bevat mogelijks niet al deze velden. U zal steeds enkel de velden ontvangen waarvoor u een machtiging heeft.

Antwoord in detail

Het antwoord bevat de details van 1 control.

Element		Opmerkingen
controlId		Id van de control. Identiek aan de pad parameter
controlType		Type van de control. Zie de mogelijke waarden op Beschrijving Antwoord (GET company/ubo/companyCompositions/controls-v1)
beginDate		Startdatum van de control
endDate		Einddatum van de control
percentInVote		Percent aandeel in stemrecht
percent		Percent aandeel in kapitaal
beneficiary
	identifier	Identificator van de begunstigde
	type	Zie hieronder voor de andere elementen van de beneficiary. De struictuur is afhankelijk van de geselecteerde waarde van het type element Mogelijke waarden. PERSON COMPANY CATEGORY
	…..	Zie hieronder
companyIdentifier		Indentificator van de bevraagde binnenlandse of buitenlandse onderneming
group
	id	ID van de groep
	name	Naam van de groep
comment		Commentaar
derogated		Definieer de afwijkingsstatus van de regeling
documents		Lijst van documenten
	name	Naam van het document
	uuid	Identificator in UUID formaat van het document. Deze is nodig om het document op te vragen. Het opvragen van het document is niet ondersteund door MAGDA
	controlId	ID van de begunstigde
	type	Type document
	dueDate	De vervaldatum mvan het document
	documentId	ID van het document
	removed	Aanduiding of het document verwijderd is

Beneficiary type PERSON

Element		Opmerkingen
identifier		Identificator van de gebunstigde
type		=”PERSON”
firstName		Voornaam van de persoon
lastName		Familienaam van de persoon
birthDate		geboortedatum van de persoon
nationalities		lijst van nationaliteiten ven de persoon
	string	Nationaliteit in tekst

Beneficiary type COMPANY

Element			Opmerkingen
identifier			KBO nummer van de onderneming
type			=”COMPANY”
name			Naam van de onderneming
sitranNames			array van Sitran names van de onderneming
creationDate			Aanmaakdatum van de onderneming
companyType			Onderneming Type Mogelijk waarden NON_PROFIT ARTICLE2 FOREIGN_TRUST FOREIGN NONE
nacebelCodes			Lijst van NACEBEL codes
	additionalProperties		SubLijst van NACEBEL codes
		additionalProperties	Sub-Sublijst van NACEBEL codes

Beneficiary type CATEGORY

Element	Opmerkingen
identifier	Identificator van de cetegory
type	=”CATEGORY”
name	Naam van de category

Voorbeelden

Voorbeeld met type PERSON

{
  "controlId": 0,
  "controlType": "string",
  "beginDate": "string",
  "endDate": "string",
  "percentInVote": 0,
  "percent": 0,
  "beneficiary": {
    "identifier": "string",
    "firstName": "string",
    "lastName": "string",
    "birthDate": "string",
    "nationalities": [
      "string"
    ]
  },
  "companyIdentifier": "string",
  "group": {
    "id": "string",
    "name": "string"
  },
  "comment": "string",
  "derogated": true,
  "documents": [
    {
      "name": "string",
      "uuid": "string",
      "controlId": 0,
      "type": "string",
      "dueDate": "2023-04-24",
      "documentId": 0,
      "removed": true
    }
  ]
}

Voorbeeld met type COMPANY

{
  "controlId": 0,
  "controlType": "string",
  "beginDate": "string",
  "endDate": "string",
  "percentInVote": 0,
  "percent": 0,
  "beneficiary": {
    "identifier": "string",
    "name": "string",
    "sitranNames": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "creationDate": "2023-04-24",
    "companyType": "NON_PROFIT",
    "nacebelCodes": {
      "additionalProp1": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "additionalProp2": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "additionalProp3": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    }
  },
  "companyIdentifier": "string",
  "group": {
    "id": "string",
    "name": "string"
  },
  "comment": "string",
  "derogated": true,
  "documents": [
    {
      "name": "string",
      "uuid": "string",
      "controlId": 0,
      "type": "string",
      "dueDate": "2023-04-24",
      "documentId": 0,
      "removed": true
    }
  ]
}

Voorbeeld met type CATEGORY

{
  "controlId": 0,
  "controlType": "string",
  "beginDate": "string",
  "endDate": "string",
  "percentInVote": 0,
  "percent": 0,
  "beneficiary": {
    "identifier": "string",
    "name": "string"
  },
  "companyIdentifier": "string",
  "group": {
    "id": "string",
    "name": "string"
  },
  "comment": "string",
  "derogated": true,
  "documents": [
    {
      "name": "string",
      "uuid": "string",
      "controlId": 0,
      "type": "string",
      "dueDate": "2023-04-24",
      "documentId": 0,
      "removed": true
    }
  ]
}

Op deze pagina

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

Beschrijving Antwoord (GET company/ubo/controls/{controlId}-v1)