post Belanghebbende
Â
Situering
Toevoegen van een belanghebbende.
Op deze pagina
- 1 Situering
- 2 Beschrijving input
- 2.1 Algemeen
- 2.2 Validaties
- 2.3 Codetabellen
- 3 Beschrijving resultaat
- 3.1 Uitzonderingen
- 3.2 Codetabellen
- 4 Versies
Beschrijving input
Algemeen
Validaties
Indien insz, ondernemingsnummer of ovoCode opgegeven is, moet deze voldoen aan het geldig formaat
Indien insz, ondernemingsnummer of ovoCode opgegeven is, en de belanghebbende bestaat reeds, wordt de informatie van die belanghebbende teruggestuurd
natuurlijkPersoon, rechtspersoon of overheidsdienst is verplicht
Maximum 1 type van belanghebbende mag worden meegestuurd
Voor een natuurlijkPersoon:
Indien insz is ingevuld dan mogen enkel nationaliteit en geboorteplaats ingevuld worden
Indien insz niet is ingevuld dan zijn voornaam en naam verplicht
voornaam is maximum 50 karakters lang
naam is maximum 50 karakters lang
geboortedatum mag niet in de toekomst liggen
Indien geboorteplaats wordt ingegeven dan is geboorteplaats - land verplicht
geboorteplaats - land verwachten we een ISO2 code
er mogen maximaal 4 nationaliteiten opgegeven zijn
de nationaliteit moet een bestaande niscode van een land zijn
Voor een rechtspersoon:
Indien een ondernemingsnummer opgegeven is, moeten de andere attributen leeg zijn
Het ondernemingsnummer moet een correct gekend Belgisch formaat zijn.
Indien er geen ondernemingsnummer opgegeven is, moet de naam opgegeven worden.
Indien de maatschappelijke zetel opgegeven wordt dan moeten straatnaam, huisnummer, postcode, gemeentenaam en land opgegeven worden.
naam is maximaal 250 karakters lang
Indien bij een rechtspersoon het land = België dan moet er een ondernemingsnummer opgegeven worden
Voor land verwachten we een ISO2 code
Codetabellen
Beschrijving resultaat
Statuscode 200: De belanghebbende bestond al in ons systeem. De gegevens van de bestaande belanghebbende werden teruggegeven in het resultaat.
Statuscode 201: De belanghebbende werd toegevoegd aan ons systeem. Het resultaat bevat de data die werd meegestuurd in de input.
Uitzonderingen
Indien insz, ondernemingsnummer of ovoCode opgegeven is, en de belanghebbende bestaat nog niet dan wordt de belanghebbende toegevoegd en wordt deze op een later tijdstip (asynchroon) gesynct met Magda. Indien het synchroniseren niet slaagde, kan dit adhv status afgeleid worden.
Codetabellen
Versies
Versie | Wijziging tov vorige versie | Datum release | Release |
---|---|---|---|
v01 | initiële versie | 14/06/2023 | 24 |
v02 | validaties voor natuurlijke persoon wijzigen + geboorteplaats aanpassingen (idem aan v1) | 02/11/2023 | 33 |
 | Indien geboorteplaats is opgegeven dan is land verplicht | 15/11/2023 | 34 |
 | Andere identificatienummers kunnen optioneel ingegeven worden | 13/12/2023 | 36 |
 | Digipostadres bij overheidsdienst | 03/04/2024 | 44 |
 | Belanghebbende synchronisatiestatus uitgebreid | 02/05/2024 | 46 |
 | Wanneer de opgeladen belanghebbende reeds bestaat krijg je status code 200 terug ipv 201 | Oct 18, 2024 | 61 |