Aangetekend Mailen
API voor integratie van Aangetekend-diensten
Integreer veilige, aantoonbare en waar nodig rechtsgeldige digitale communicatie rechtstreeks in uw eigen software, portaal of bedrijfsproces via de API van Aangetekend.














Integreer beveiligde, aantoonbare en waar nodig rechtsgeldige communicatie in uw eigen applicatie, portaal of bedrijfsproces.
Uw software bepaalt wie iets ontvangt, welke documenten worden meegestuurd en welke communicatiestroom nodig is. Aangetekend verzorgt de verwerking, aflevering en terugkoppeling van de relevante statussen.
Zo blijven medewerkers werken in hun eigen systeem en hoeft u de onderliggende communicatie- en vertrouwensinfrastructuur niet zelf te bouwen en beheren.

Organisaties werken steeds vaker vanuit gespecialiseerde software. Medewerkers behandelen Bij veel organisaties begint een communicatieproces in een CRM, zaaksysteem, HR-platform of eigen klantportaal. Zonder koppeling moet een medewerker gegevens overnemen, een andere omgeving openen en later handmatig controleren wat er met het bericht is gebeurd.
Met de API blijft dat proces in de bronapplicatie.
Het systeem levert de ontvangergegevens, het bericht, de documenten en de gewenste flow aan. Na verwerking ontvangt het systeem statussen en gebeurtenissen terug. Daarmee kan het bijvoorbeeld automatisch een dossier bijwerken, een vervolgstap starten of een bewijsstuk opslaan.
De API is daarmee geen los verzendkanaal, maar de verbinding tussen uw bedrijfsproces en de diensten van Aangetekend.
Niet ieder bericht vraagt om dezelfde afhandeling. Soms is bewijs van verzending en aflevering nodig. In een ander proces staat vertrouwelijkheid voorop. Ook kan een ontvanger een document moeten ondertekenen of een machtiging moeten afgeven.
Via de API kunnen verschillende diensten van Aangetekend vanuit dezelfde integratie worden aangestuurd.
Ook gecombineerde flows zijn mogelijk, bijvoorbeeld een aangetekende verzending in combinatie met ondertekening en een SEPA-incassomachtiging. De actuele ondersteunde flows zijn opgenomen in de technische documentatie.
Voor processen waarin verzending, aflevering en de bijbehorende gebeurtenissen aantoonbaar moeten worden vastgelegd.
Voor gekwalificeerde elektronische aangetekende bezorging via qERDS, wanneer een hoger betrouwbaarheidsniveau vereist is.
Voor aantoonbare verzending met directe aflevering in de e-mailomgeving van de ontvanger.
Voor het beveiligd uitwisselen van vertrouwelijke berichten en documenten.
Voor het laten ondertekenen van documenten binnen een geautomatiseerd proces.
Voor het digitaal aanvragen en verwerken van incassomachtigingen.
De bronapplicatie levert de benodigde gegevens en documenten aan en geeft aan welke communicatiestroom moet worden uitgevoerd.
Het platform controleert de aanvraag en voert de gekozen flow uit. De stappen verschillen per dienst. Een beveiligd bericht kent bijvoorbeeld een andere afhandeling dan een aangetekende verzending met ondertekening.
Afhankelijk van de flow leest of downloadt de ontvanger het bericht, ondertekent een document of geeft een machtiging af.
Statussen en gebeurtenissen worden teruggekoppeld. Uw software kan vervolgens het dossier bijwerken, een vervolgactie starten, een medewerker informeren of een bewijsstuk archiveren.

De API kan worden gebruikt door softwareleveranciers die functionaliteit aan hun platform willen toevoegen, maar ook door organisaties die hun eigen applicatielandschap willen koppelen.
Denk onder meer aan:
Voor een softwareleverancier kan de functionaliteit onderdeel worden van de eigen oplossing en gebruikerservaring. Voor een organisatie kan de koppeling een bestaand intern proces automatiseren.
In beide gevallen blijft het uitgangspunt hetzelfde: de gebruiker werkt in de eigen software, terwijl Aangetekend de gekozen communicatiestroom op de achtergrond uitvoert.
Zaaksysteem
Veilige communicatie met burgers en organisaties
HR-platform
Documenten verzenden en laten ondertekenen
CRM
Aantoonbare klantcommunicatie vanuit het klantdossier
Financiële applicatie
Ondertekening en SEPA-machtigingen
Juridische software
Formele communicatie en dossierregistratie
SaaS-platform
Veilige communicatie als geïntegreerde functionaliteit
Een bruikbare integratie vraagt meer dan een lijst endpoints. Ontwikkelaars moeten ook weten hoe aanvragen worden opgebouwd, welke flows beschikbaar zijn, welke statussen kunnen ontstaan en hoe fouten en uitzonderingen worden afgehandeld.
De developer-documentatie bevat onder meer:
Een gestructureerd technisch overzicht van de beschikbare API-functionaliteit.
Voorbeelden die laten zien hoe aanvragen worden opgebouwd en welke informatie door de API wordt teruggegeven.
Uitleg over het terugkoppelen van gebeurtenissen en statuswijzigingen naar uw eigen systeem.
Inzicht in de beschikbare communicatiestromen en de statussen die binnen een proces kunnen ontstaan.
Informatie om technische fouten, uitzonderingen en ongeldige verzoeken gecontroleerd af te handelen.
Mogelijkheden om gebeurtenissen binnen de communicatiestroom te volgen en in het eigen proces te verwerken.
Deze onderdelen staan ook op de huidige support- en documentatiepagina’s vermeld.
Digitale communicatie vindt steeds minder plaats via één universeel kanaal.
Naast e-mail ontstaan gespecialiseerde infrastructuren en vertrouwensnetwerken voor specifieke processen. Denk aan gekwalificeerde elektronische bezorging, digitale wallets en sectorale omgevingen zoals het Aansluitpunt Rechtspraak.
Voor organisaties betekent dit dat hun software in toenemende mate moet kunnen communiceren met verschillende afleverkanalen, betrouwbaarheidsniveaus en externe infrastructuren.
Aangetekend ontwikkelt zich daarom als verbindende vertrouwenslaag waarin de API een centrale rol speelt. Zij maakt het mogelijk om communicatie vanuit het eigen proces aan te sturen en relevante statussen terug te ontvangen.
Niet ieder vertrouwensnetwerk gebruikt daarbij noodzakelijk exact dezelfde technische route. De onderliggende aansluiting kan per netwerk verschillen. Voor de klant blijft het uitgangspunt echter hetzelfde: communiceren vanuit de eigen vertrouwde werkomgeving, met Aangetekend als veilige integratie- en afleverlaag.
De API maakt gebruik van de infrastructuur en processen waarmee Aangetekend zijn communicatiediensten uitvoert.
Afhankelijk van de gekozen dienst en inrichting gaat het onder meer om:
Voor gekwalificeerde elektronische aangetekende bezorging kan de qERDS-flow worden gebruikt welke in de documentatie wordt beschreven.

Een integratie hoeft niet direct alle diensten te omvatten. Veel organisaties beginnen met één concreet proces, bijvoorbeeld aangetekende verzending vanuit een zaaksysteem of digitale ondertekening vanuit een HR-platform.
Vanuit dezelfde technische basis kunnen later andere flows worden toegevoegd. Zo kan de koppeling meegroeien met het proces, zonder dat voor iedere nieuwe toepassing opnieuw een volledig afzonderlijke infrastructuur nodig is.

Voordat een koppeling wordt gebouwd, moet duidelijk zijn:
Aangetekend kan ondersteunen bij het vertalen van deze functionele eisen naar een passende flow en technische inrichting. Daarbij kijken we naar de hele keten: van de aanvraag vanuit het bronsysteem tot de verwerking van de uitkomst.

Wilt u één proces automatiseren of veilige communicatie structureel opnemen in uw softwareplatform? Samen bepalen we welke flow, inrichting en aansluiting bij uw toepassing passen.
De huidige documentatie noemt Aangetekend Mailen, Aangetekend Mailen Plus/qERDS, Geregistreerd Mailen, Beveiligd Mailen, Digitaal Ondertekenen en SEPA-incassomachtigingen. Ook zijn gecombineerde flows beschikbaar.
De documentatie beschrijft webhooks, statusinformatie en eventtracking. Daarmee kan het bronsysteem relevante gebeurtenissen verwerken.
Nee. Ook organisaties met een eigen IT-landschap kunnen de API gebruiken om processen vanuit een CRM, ERP-, HR- of zaaksysteem te automatiseren.
De communicatie kan vanuit de eigen applicatie worden gestart en gevolgd. Welke interactie de ontvanger heeft, hangt af van de gekozen flow.
JJa. Aangetekend kan ondersteunen bij de keuze van de flow, de statusverwerking en het vertalen van het bedrijfsproces naar een technische integratie.
Nee. De technische aansluiting en voorwaarden kunnen per vertrouwensnetwerk verschillen. Aangetekend treedt op als integratie- en communicatielaag, maar de onderliggende route kan afhankelijk zijn van het netwerk, de toepassing en de gekozen dienst.
Aangetekend – Secure Communication
Ontdek hoe Aangetekend API je kan helpen met integreren.
