post Belanghebbende

 

Situering

Toevoegen van een belanghebbende.

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

Landen en ISO-codes

Standaard belanghebbenden

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.

get BelanghebbendeById

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

Landen en ISO-codes

Versies

Versie

Wijziging tov vorige versie

Datum release

Release

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