post Kennisgeving

Situering

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 MagdaDocumentendienst.

Productie

Beschrijving input

Algemeen

 

image-20240603-105458.png

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 30 Mb

  • Er zijn maximaal 6 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 verblijfplaats 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

Codetabellen

Landen en ISO-codes

Beschrijving resultaat

Algemeen

get KennisgevingById

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 tov vorige versie

Datum release

Release

Versie

Wijziging tov vorige versie

Datum release

Release

v00.01

initiële versie

14/06/2023

24

 

Validaties werden aangepast: Het adres van de belanghebbende moet niet gekend zijn op het ogenblik van de post alsook het stuk moet nog niet afgeleid zijn

20/09/2023

30

 

Als resultaat wordt uitgebreid met eboxStatus en paperStatus

02/11/2023

33

 

Opgeven van een optioneel retouradres

20/03/2023

43

 

Toevoegen attribuut redenKennisgevingFunctioneelGefaald

02/05/2024

46

 

stukStatus uitgebreid naar 3 waarden: in_behandeling, geslaagd, gefaald

RedenKennisgevingFunctioneelGefaald zijn de waarden uitgebreid

belanghebbendeStatus zijn de waarden gewijzigd naar: in_behandeling, geslaagd, gefaald

Aanvullen validaties

29/05/2024

48

 

Aanduiden dat de kennisgeving ook op papier dient verstuurd te worden: via garandeerKennisgevingOpPapier

12/06/2024

49

 

Uitbreiding van de 201 met bezorgingDocumentSoort
Nieuwe waardes in enum redenenKennisgevingFunctioneelGefaald

Jul 10, 2024

51

 

Uitbreiding met contactgegevens in de POST en GET

Jun 27, 2024

52

 

Verzendadres is toegevoegd aan de response

Oct 2, 2024

59