Integraties

Het Integraties-scherm beheert de koppelingen die Scrivio met externe systemen verbinden: Certificaten voor de digitale certificaten waarmee Scrivio namens je praktijk beveiligde koppelingen opzet (UZI, Zorgmail), Zivver voor de SMTP-gegevens waarmee je brieven via Zivver veilig verstuurt, en de tabbladen ZorgMail, VECOZO COV, ZorgDomein en SnelStart voor de koppelingen die per praktijk worden aangezet. Het scherm is bedoeld voor de organisatiebeheerder.

Wat elke koppeling vandaag wél en niet kan — uitgaand en inkomend apart — staat in Status van de koppelingen.

Dit scherm vervangt de verouderde "Integrations"-pagina uit de oude admin-guide.

Overzicht

Route	/organization/integrations (open een specifiek tabblad met ?tab=certificates, ?tab=zivver, ?tab=zorgmail, ?tab=vecozo-cov, ?tab=zorgdomein of ?tab=snelstart)
Doelgroep	Organisatiebeheerder
Benodigde rechten	integrations.manage

Standaard opent het scherm op het tabblad Certificaten. Het tabblad ZorgDomein verschijnt alleen voor gebruikers die de ZorgDomein-activering mogen inzien — het toont een verificatiecode voor een klinisch intakekanaal en heeft daarom een eigen recht bovenop integrations.manage. De koppelingen met Zivver en ZorgMail zijn alleen beschikbaar met een FULL-licentie.

Status van de koppelingen

Een koppeling heeft twee richtingen, en die landen zelden tegelijk: versturen kan al werken terwijl ontvangen nog niet bestaat. Daarom staat hieronder per koppeling apart wat uitgaand en inkomend vandaag doet, waar het op wacht, en wat je zelf geregeld moet hebben. Staat een richting hier niet als beschikbaar, dan is hij dat ook niet — ook niet gedeeltelijk.

Status per 9 september 2026.

ZorgMail — brieven naar de huisarts

Uitgaand	Gebouwd, nog niet in gebruik. Een brief uit Scrivio gaat als gestructureerd bericht (MEDVRI) naar de huisarts en komt rechtstreeks in diens systeem terecht, met de behandelaar als afzender.
Inkomend	Niet beschikbaar. Scrivio haalt geen ZorgMail-berichten op. Dat geldt ook voor statusberichten: een bericht dat ZorgMail aanneemt en dat later alsnog strandt, zie je in Scrivio niet terug. Scrivio meldt daarom dat een brief is aangeboden, nooit dat hij is afgeleverd.
Waar het op wacht	Het centrale ZorgMail-account (ASP-account) waarmee Scrivio namens praktijken verstuurt. Zolang dat er niet is, staat het kanaal uit — voor alle praktijken tegelijk.
Wat het vervangt	Niet Zivver. ZorgMail bereikt zorgverleners binnen de ZorgMail-community, in de eerste plaats de huisarts; post aan cliënten loopt via het cliëntportaal of Zivver. Of Scrivio ook cliëntpost via ZorgMail gaat versturen is nog niet besloten.
Wat je zelf regelt	Een ZorgMail-abonnement bij Enovation, toestemming van Enovation dat Scrivio namens jouw praktijk mag versturen, en het ZorgMail Account-ID van de praktijk op het tabblad ZorgMail. Versturen vraagt daarnaast een FULL-licentie.

ZorgDomein — verwijzingen ontvangen

Bijgewerkt op 2 oktober 2026.

Inkomend	In aanbouw, nog niet in gebruik. Een verwijzing komt digitaal binnen met cliëntgegevens, verzekeraar, verwijzer met AGB-code, verwijsdatum en bijlagen, zodat niemand ze nog hoeft over te typen. De koppeling wordt nu getest op de testomgeving van ZorgDomein, met testverwijzingen en zonder echte cliëntgegevens.
Uitgaand	Geen onderdeel van deze koppeling. Terugkoppeling naar de verwijzer loopt via ZorgMail, niet via ZorgDomein.
Waar het op wacht	Vier dingen: een PKIoverheid-servercertificaat voor het ontvangstadres, dat een certificaatverstrekker uitgeeft en dat weken doorlooptijd kost; de technische validatie door ZorgDomein zelf, op hun testomgeving; de verwijsinbox — het scherm waarop je een binnengekomen verwijzing beoordeelt; en de NEN 7510-certificering van Scrivio, die ZorgDomein vraagt voordat de pilot met echte verwijzingen mag starten. Die certificering verwachten we in december 2026. Zolang deze punten open staan noemen we geen datum.
Altijd door een mens	Een binnengekomen verwijzing wordt klaargezet, niet verwerkt. Iemand van de praktijk beoordeelt hem en zet hem daarna om in een cliënt en een zorgtraject langs de gewone weg. Screen je nu elke verwijzing zelf voordat je hem aanneemt, dan blijf je dat doen.
Wat het vervangt	Niets. Je houdt je eigen ZorgDomein-abonnement; de koppeling levert de verwijzing af in Scrivio in plaats van in een mailbox.
Wat je zelf regelt	Een ZorgDomein-abonnement, de AGB-code van je praktijk bij Praktijkgegevens (ZorgDomein vindt je praktijk op die code; zonder AGB-code lukt de activering niet), en de activering met de verificatiecode op het tabblad ZorgDomein.

Zivver — beveiligde e-mail aan cliënten

Uitgaand	Beschikbaar. Brieven uit Scrivio worden via Zivver beveiligd verstuurd naar cliënten en andere ontvangers.
Inkomend	Niet beschikbaar en niet gepland. Antwoorden komen aan in je eigen Zivver-postbus, niet in Scrivio.
Wat het vervangt	Niets. Scrivio verstuurt via jouw Zivver-account, dus dat abonnement blijft nodig.
Wat je zelf regelt	Een FULL-licentie, een Zivver-account met SMTP-gegevens (tabblad Zivver), en per gebruiker een afzenderadres dat Zivver heeft geverifieerd.

SnelStart — verkoopfacturen in de boekhouding

Bijgewerkt op 5 oktober 2026.

Uitgaand	Gebouwd. Met SnelStart gekoppeld boekt Naar boekhouding bij Declaraties › Batches elke verzekeraarfactuur van een batch als verkoopboeking in je SnelStart-administratie: op de relatie van de verzekeraar, op de grootboekrekening die je kiest, vrijgesteld van btw en met het factuurnummer van Scrivio. Een factuur die al in SnelStart staat, wordt niet nog eens geboekt. Per batch en per factuur zie je of hij geboekt is, en zo niet, waarom. Particuliere facturen en restitutienota's horen er nog niet bij.
Inkomend	Niet beschikbaar. Scrivio leest niets uit SnelStart terug, ook niet of een factuur betaald is.
Waar het op wacht	Naast jouw koppelingssleutel is er een sleutel van Scrivio zelf bij SnelStart nodig. Ontbreekt die nog, dan staat dat op het tabblad SnelStart en wordt er niets geboekt.
Al gemaild?	Een batch die al per e-mail naar de boekhouding is gestuurd, wordt overgeslagen, want anders staat hij er twee keer in. Alleen als je in de bevestiging Toch boeken in SnelStart aanvinkt, wordt hij alsnog geboekt.
Wat het vervangt	De mailroute, voor een praktijk die SnelStart heeft gekoppeld (zie hieronder).
Wat je zelf regelt	Een FULL-licentie en een SnelStart-abonnement. Tijdens een proefperiode van SnelStart kan er niet gekoppeld worden. Op het tabblad SnelStart koppel je met Koppelen met SnelStart, of je plakt een koppelingssleutel die je in SnelStart onder Koppelingen → Maatwerk aanmaakt. Voor zo'n maatwerksleutel heb je inZicht of inControle nodig. Daarna kies je per verzekeraar of per concern een relatie, die in SnelStart een klant moet zijn, en kies je de grootboekrekening uit de rekeningen van je eigen administratie. Staat er 8005 in, dan is die alvast gekozen. Je moet de keuze wel opslaan.
Back-up teruggezet	Zet je in SnelStart een back-up terug, dan wordt de koppelingssleutel ongeldig. Koppel daarna opnieuw op het tabblad SnelStart.

Zonder SnelStart: de mailroute. Heb je SnelStart niet gekoppeld, dan stuurt Naar boekhouding elke verzekeraarfactuur als PDF in een eigen e-mail naar het adres dat je bij de declaratie-instellingen op de pagina Contracten invult, bijvoorbeeld de inlees-mailbox van je boekhoudpakket. Het pakket zelf moet de factuur dan herkennen en boeken. Dat lukt niet altijd goed, en daarvoor is de SnelStart-koppeling gebouwd. De mails komen van noreply@scrivio.nl. Laat je inlees-mailbox mail van dat adres toe, anders komt er niets aan.

Voor lezers met toegang tot de repository staat de onderbouwing in ADR-040 (ontvangende koppeling met ZorgDomein) en ADR-041 (ZorgMail als tweede verzendkanaal).

Hoe het werkt

Dit scherm beheert geen Scrivio-gegevens, maar de vertrouwensrelatie met externe systemen: de certificaten die je organisatie-identiteit bewijzen en het kanaal waarlangs Scrivio beveiligde brieven verstuurt. Een verkeerd of verlopen certificaat breekt niet dit scherm, maar de processen die erop leunen (zoals het opvragen van cliëntgegevens bij het BSN-register). Daarom is het belangrijk te begrijpen waar elke koppeling voor dient.

Certificaten: wie authenticeer je waarvoor

Een certificaat is een digitaal identiteitsbewijs waarmee Scrivio zich namens jouw organisatie aanmeldt bij een externe partij. Elk type authenticeert voor een eigen keten:

Type	Authenticeert bij	Waarvoor
UZI-servercertificaat	SBV-Z en andere zorgkoppelingen	Het aantonen van een geldige zorgaanbiederidentiteit bij beveiligde koppelingen in de zorginfrastructuur.
Zorgmail	Zorgmail	Beveiligde berichtuitwisseling in de zorg.

VECOZO staat hier niet tussen: daarvoor is geen certificaat van de praktijk nodig. VECOZO werkt met een machtiging (toestemmingsverklaring): je geeft Scrivio in het VECOZO-portaal toestemming om namens de AGB-code van de praktijk te declareren, en Scrivio gebruikt daarbij zijn eigen systeemcertificaat. Wat er wél nodig is, staat in De VECOZO-aansluiting.

Het certificaat zelf is een PKCS#12-bestand (.p12/.pfx) dat de sleutel én de bijbehorende beveiliging bevat; bij het uploaden geef je het wachtwoord (passphrase) op waarmee het bestand is beveiligd. Scrivio gebruikt dit bestand om de verbinding namens jou op te zetten; Test verbinding controleert of die keten daadwerkelijk werkt.

Vervaldatum-lifecycle en de downstream-breuk

Elk certificaat heeft een vervaldatum en doorloopt drie statussen. De status is geen cosmetisch label — hij voorspelt of de bovenstaande ketens blijven werken:

Status	Betekenis	Gevolg
Geldig	Het certificaat is bruikbaar.	De koppelingen die op het certificaat leunen werken normaal.
Verloopt binnenkort	De vervaldatum nadert.	Nog bruikbaar, maar dit is je signaal om tijdig te Vervangen — vóór het verloopt.
Verlopen	De vervaldatum is gepasseerd.	De afhankelijke processen (bijv. cliëntgegevens opvragen bij het BSN-register met een UZI-servercertificaat) falen tot een geldig certificaat is geüpload.

Omdat een verlopen certificaat afhankelijke processen stillegt zonder dat er op dit scherm iets "kapot" lijkt, is Verloopt binnenkort bedoeld als ruime waarschuwingsmarge: vervang het certificaat in dat venster in plaats van te wachten tot er fouten optreden, bijvoorbeeld bij het opvragen van cliëntgegevens.

Zivver als verzendkanaal

Het Zivver-tabblad is geen certificaat maar een SMTP-kanaal: de gebruikersnaam en het wachtwoord van je Zivver-account waarmee Scrivio brieven beveiligd verstuurt. Deze configuratie is het enige kanaal voor Zivver-verzending — verwijder je de configuratie, dan kunnen er geen brieven meer via Zivver worden verstuurd. Verwijder de configuratie daarom alleen als je dit kanaal bewust wilt uitschakelen.

Licentie en geheim-afhandeling

De Zivver-koppeling valt onder FULL-licentie-gating: zonder die licentie is het tabblad zichtbaar maar het formulier niet beschikbaar. De certificaten-tab staat los van deze gating.

Geheimen worden write-only behandeld. Het certificaatwachtwoord en het Zivver-wachtwoord worden veilig opgeslagen en daarna nooit teruggetoond: het formulier wist ze na opslaan of verwijderen. Bij een wijziging vul je het wachtwoord daarom altijd opnieuw in — Scrivio kan het bestaande geheim niet voor je voorinvullen.

Certificaten-tab openen

Klik op het tabblad Certificaten (of open het scherm via /organization/integrations?tab=certificates). Je ziet een lijst met de geüploade certificaten van je organisatie met per rij het type, de status, de vervaldatum en wanneer en door wie het certificaat is geüpload.

De status geeft aan of een certificaat nog bruikbaar is:

Status	Betekenis
Geldig	Het certificaat is geldig en bruikbaar.
Verloopt binnenkort	Het certificaat verloopt op korte termijn; vervang het tijdig.
Verlopen	Het certificaat is verlopen en moet worden vervangen.

Zivver-tab openen

Klik op het tabblad Zivver (of open het scherm via /organization/integrations?tab=zivver). Hier configureer je de SMTP-gegevens van je Zivver-account waarmee Scrivio brieven veilig verstuurt.

Zivver is alleen beschikbaar met een FULL-licentie. Zonder deze licentie toont het tabblad een melding en is het formulier niet beschikbaar. Neem contact op om je abonnement uit te breiden.

Certificaat configureren

Op het tabblad Certificaten klik je rechtsboven op + Nieuw om een certificaat te uploaden. Er opent een venster waarin je het type kiest, het certificaatbestand selecteert en het wachtwoord invult.

Veld	Verplicht	Toelichting
Certificaattype	Ja	UZI-servercertificaat of Zorgmail. Bij het vervangen van een bestaand certificaat ligt het type vast.
Certificaatbestand	Ja	Een PKCS#12-bestand met de extensie .p12 of .pfx. Sleep het bestand naar het uploadvak of klik om te bladeren.
Wachtwoord	Ja	Het wachtwoord (passphrase) waarmee het certificaatbestand is beveiligd.

Het persoonlijke VECOZO-certificaat waarmee je zelf inlogt in het VECOZO-portaal hoort hier niet: dat installeer je op je eigen computer, binnen 20 dagen na de aanvraag. Zie Het persoonlijk certificaat, en de 20 dagen.

Klik op Uploaden om het certificaat op te slaan. Na het uploaden beheer je het certificaat met de acties in de lijst:

• Test verbinding — controleert of het certificaat een werkende verbinding opzet.
• Vervangen — opent hetzelfde uploadvenster om het certificaatbestand te vernieuwen (het type ligt vast).
• Verwijderen — verwijdert het certificaat na bevestiging. Dit kan niet ongedaan worden gemaakt.

Zivver configureren

Op het tabblad Zivver vul je de SMTP-gegevens van je Zivver-account in. Standaard staan de host en poort al ingevuld op de Zivver-standaardwaarden.

Veld	Verplicht	Toelichting
SMTP-host	Nee	De SMTP-host van Zivver. Standaard smtp.zivver.com.
Poort	Nee	De SMTP-poort. Standaard 587.
Gebruikersnaam	Ja	De door Zivver uitgegeven gebruikersnaam (een UUID).
Wachtwoord	Ja	Het door Zivver uitgegeven wachtwoord. Dit wordt veilig opgeslagen en nooit getoond; vul het opnieuw in om de configuratie op te slaan.

Klik op Opslaan om de configuratie te bewaren. Daarna zijn twee extra acties beschikbaar:

• Verbinding testen — controleert of Scrivio met de opgegeven gegevens een verbinding met Zivver kan opzetten.
• Verwijderen — verwijdert de Zivver-configuratie na bevestiging. Daarna kunnen er geen brieven meer via Zivver worden verstuurd.

Het wachtwoord wordt na het opslaan of verwijderen om veiligheidsredenen uit het formulier gewist en is nooit zichtbaar.