post Kennisgeving

post Kennisgeving

Op deze pagina

Beschrijving

Aanvraag van een kennisgeving voor de opgelijste stukken aan de opgelijste belanghebbenden.

Informatie:

Met dit endpoint wordt de kennisgeving aangevraagd. De verwerking gebeurt via de MAGDA documentendienst.

API

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

Validaties

  • Opgegeven stukken bestaan

  • Opgegeven belanghebbenden bestaan

  • De combinatie stuk en belanghebbende moet uniek zijn (een stuk kan niet 2 keer naar dezelfde belanghebbende gestuurd worden)

  • Er is minstens 1 stuk opgegeven

  • Er is minstens 1 belanghebbende opgegeven

  • Elke meegegeven belanghebbende moet een unieke id hebben

  • Entiteit heeft toegang tot alle opgegeven stukken

  • Totale grootte van de opgegeven stukken is maximaal 105 Mb

  • Er zijn maximaal 20 stukken toegelaten

  • Indien correspondentieadres opgegeven dan moeten:

    • de verplichte velden ingevuld zijn

    • naam, voornaam of organisatie moet opgegeven zijn

  • Indien er geen correspondentieadres opgegeven is dan moet de belanghebbende een insz of kbonummer of adres hebben

  • Indien retouradres opgegeven dan moeten:

    • de verplichte velden ingevuld zijn

    • Retour adres land in iso2 formaat zijn (bvb 'BE')

  • Indien er geen retouradres opgegeven is, moet het adres van de entiteit die de kennisgeving aanmaakt, gekend zijn (deze wordt opgehaald uit wegwijs of KBO)

  • terAttentieVanEBox is enkel van toepassing bij een onderneming of overheidsdienst

  • Indien terAttentieVanEBox opgegeven is dan moet insz of naam ingevuld zijn

  • Als het afleiden reeds gefaald is voor een van de stukken in de kennisgeving weten we bij het aanmaken al dat de kennisgeving niet zal slagen. In dit geval geven we bij het aanmaken een foutmelding terug.

  • Als het ophalen van authentieke data reeds gefaald is voor een van de belanghebbenden in de kennisgeving weten we bij het aanmaken al dat de kennisgeving niet zal slagen. In dit geval geven we bij het aanmaken een foutmelding terug.

Uitzonderingen

Indien de adresgegevens of de ISO2 code van het land van de belanghebbende niet gekend is bij verzending via PAPER zal dit leiden tot een functionele fout, dit kan opgevangen worden door het meegeven van een correspondentieadres waar deze informatie wel ingevuld is.

Codetabellen

Landen en ISO-codes

Versies

Versie

Wijziging t.o.v. vorige versie

Versie

Wijziging t.o.v. vorige versie

v1.0.0

Introductie van semantisch versiebeheer

68

v1.1.0

De id’s voor de ebox- en paperStatus werden opgenomen in de response

73