API voor veilige digitale communicatie

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.

API-integratie

Verbind uw software met het Aangetekend platform

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.

API-integratie Aangetekend platform

Communicatie vanuit het systeem waar het proces plaatsvindt

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.

Eén aansluiting voor verschillende communicatiestromen

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.

Aantoonbaar verzenden

Aangetekend Mailen

Voor processen waarin verzending, aflevering en de bijbehorende gebeurtenissen aantoonbaar moeten worden vastgelegd.

Aangetekend Mailen Plus

Voor gekwalificeerde elektronische aangetekende bezorging via qERDS, wanneer een hoger betrouwbaarheidsniveau vereist is.

Geregistreerd Mailen

Voor aantoonbare verzending met directe aflevering in de e-mailomgeving van de ontvanger.

Vertrouwelijk communiceren

Beveiligd Mailen

Voor het beveiligd uitwisselen van vertrouwelijke berichten en documenten.

Ondertekenen en machtigen

Digitaal Ondertekenen

Voor het laten ondertekenen van documenten binnen een geautomatiseerd proces.

SEPA-incassomachtigingen

Voor het digitaal aanvragen en verwerken van incassomachtigingen.

Zo werkt de integratie

1. Uw applicatie start de flow

De bronapplicatie levert de benodigde gegevens en documenten aan en geeft aan welke communicatiestroom moet worden uitgevoerd.

2. Aangetekend verwerkt de aanvraag

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.

3. De ontvanger handelt het bericht af

Afhankelijk van de flow leest of downloadt de ontvanger het bericht, ondertekent een document of geeft een machtiging af.

4. Uw systeem verwerkt de uitkomst

Statussen en gebeurtenissen worden teruggekoppeld. Uw software kan vervolgens het dossier bijwerken, een vervolgactie starten, een medewerker informeren of een bewijsstuk archiveren.

API zo werkt het

Voor softwareleveranciers en organisaties

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.

Toepassingen per systeem

API-integratie

Veilige communicatie met burgers en organisaties

API-integratie

Documenten verzenden en laten ondertekenen

API-integratie

Aantoonbare klantcommunicatie vanuit het klantdossier

API-integratie

Ondertekening en SEPA-machtigingen

API-integratie

Formele communicatie en dossierregistratie

API-integratie

Veilige communicatie als geïntegreerde functionaliteit

Aansluiten op vertrouwensnetwerken

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.

Beveiliging en controleerbaarheid

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.

Vertrouwenslabels API

Van eerste flow naar bredere integratie

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.

Stapsgewijs uitbreiden Aangetekend platform

Implementatie begint bij het proces

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.

API implementatie in stappen

Maak veilige communicatie onderdeel van uw eigen software

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.

  1. Welke diensten kan ik via de API gebruiken?

    De huidige documentatie noemt Aangetekend Mailen, Aangetekend Mailen Plus/qERDS, Geregistreerd Mailen, Beveiligd Mailen, Digitaal Ondertekenen en SEPA-incassomachtigingen. Ook zijn gecombineerde flows beschikbaar.

  2. Kan mijn applicatie automatisch statusupdates ontvangen?

    De documentatie beschrijft webhooks, statusinformatie en eventtracking. Daarmee kan het bronsysteem relevante gebeurtenissen verwerken.

  3. Is de API alleen bedoeld voor softwareleveranciers?

    Nee. Ook organisaties met een eigen IT-landschap kunnen de API gebruiken om processen vanuit een CRM, ERP-, HR- of zaaksysteem te automatiseren.

  4. Moeten medewerkers in een aparte omgeving werken?

    De communicatie kan vanuit de eigen applicatie worden gestart en gevolgd. Welke interactie de ontvanger heeft, hangt af van de gekozen flow.

  5. Ondersteunt Aangetekend bij de implementatie?

    JJa. Aangetekend kan ondersteunen bij de keuze van de flow, de statusverwerking en het vertalen van het bedrijfsproces naar een technische integratie.

  6. Is aansluiting op ieder vertrouwensnetwerk hetzelfde?

    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.