post Belanghebbende v3

post Belanghebbende v3

Op deze pagina

Beschrijving

Toevoegen van een belanghebbende. Meer info:Werkwijze en lijsten van belanghebbenden

API

https://handhaving.api.test-vlaanderen.be/docs/swagger-ui/index.html#/Belanghebbenden/postBelanghebbendeV3

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.

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 één 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 NIS-code 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 maatschappelijkeZetel 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ë is, dan moet er een ondernemingsnummer opgegeven worden

    • Indien het om een parket gaat mag deze niet worden toegevoegd

  • Voor land verwachten we een ISO2 code

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) gesynchroniseerd met MAGDA. Indien het synchroniseren niet slaagt, kan dit a.d.h.v. een status afgeleid worden.

Codetabellen

Landen en ISO-codes

Versies

Versie

Wijziging t.o.v. vorige versie

Versie

Wijziging t.o.v. vorige versie

v2.0.0

Introductie van semantisch versiebeheer

68

v3.0.0

Parketten mogen niet meer toegevoegd worden

78