Situering
De POST messages laat een verzender toe om documenten te verzenden naar burgers, bedrijven en organisaties (inclusief overheden).
De documenten kunnen digitaal (via ebox en aangetekende e-mail) als per papier verzonden worden.
De verzender kan de documenten eveneens aangetekend verzenden indien gewenst.
Verwante diensten
POST statusRequest
POST eboxPreferences/search
Achterliggende diensten
Deze dienst gaat achterliggend naar FOD BOSA (eBox burger), de Rijksdienst voor Sociale Zekerheid (eBox onderneming) en naar IPEX (papieren verzending en verzending per mail).
Gebruiksvoorwaarden
Afnemers moeten aan volgende voorwaarden voldoen om deze dienst te mogen gebruiken:
Toelating tot het MAGDA platform
scope: msg_msg_v1_P, msg_mailbox_v1_P (dit is nodig indien het kanaal “Automatisch” gebruikt wordt, zodat er kan gecontroleerd worden of de bestemmeling consent heeft gegeven voor het gebruik van ebox).
Toelating om de diensten te gebruiken bij de externe partijen.
Indien een verzender wil starten met het versturen van berichten in productie, vragen we aan de verzender om vooraf in productie een aantal testen te doen om na te gaan dat alles correct functioneert. Dit om te vermijden dat er gestart wordt met een massale verzending in productie voor er een sanity test is gebeurd.
Indien een verzender meer dan 1000 verzendingen op 1 dag zal doen in productie, vragen we dat de verzender een realistische loadtest uitvoert in de acceptatie omgeving, waarbij de maximaal mogelijke load op 1 dag wordt uitgetest. Voor we de opzet in productie doen, kijken we na of deze loadtest goed is verlopen.
Bij een eerste grote verzending in productie, vragen we dat dit gefaseerd gebeurt, dus in batches (bijvoorbeeld eerst 10, erna 100, erna 1000,…). Dit hoeft enkel bij de eerste verzending. Het is steeds mogelijk om hiervoor de nodige afspraken te maken zodat we dit mee kunnen monitoren.
Werking
Aandachtspunten
RESTful service
Opties
De verzender bepaalt zelf op welke manier hij wil verzenden: via ebox, per papier, per e-mail of automatisch (= via ebox en indien de ontvanger geen toestemming heeft gegeven voor het gebruik van ebox, wordt er eveneens per papier verzonden).
Alle documenten die verzonden zijn naar de ebox burger (ook voordat deze toestemming heeft gegeven) zijn beschikbaar in de ebox (let wel: de documenten zijn pas rechtsgelding indien ze verstuurd zijn naar de ebox nadat de burger toestemming heeft gegeven). Een burger kan de toestemming voor ebox burger op elk gewenst moment terug intrekken.
Een onderneming kan de toestemming voor ebox onderneming niet intrekken.
Opvraging
Het antwoord van deze dienst wordt gemaakt op basis van het antwoord dat we ontvangen van de achterliggende dienst (BOSA voor eBox Burger, RSZ voor eBox onderneming, IPEX voor verzending per papier en per mail).
Responsetijden & Beschikbaarheid
Logging
De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".
Ondersteunde talen
Documenten verstuurd via eBox voor Burgers, kunnen aangeleverd worden in 3 verschillende talen (Nederlands, Frans of Duits).
Documenten verstuurd via eBox voor Ondernemingen, kunnen aangeleverd worden in 1 taal: het Nederlands.
