Integraties

Het Integraties-scherm beheert de koppelingen die Scrivio met externe systemen verbinden. Het bestaat uit twee tabbladen: Certificaten voor de digitale certificaten waarmee je beveiligd declareert en verstuurt (VECOZO, UZI, Zorgmail), en Zivver voor de SMTP-gegevens waarmee je brieven via Zivver veilig verstuurt. Het scherm is bedoeld voor de organisatiebeheerder.

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

Overzicht

Route	/organization/integrations (open een specifiek tabblad met ?tab=certificates of ?tab=zivver)
Doelgroep	Organisatiebeheerder
Benodigde rechten	integrations.manage

Bovenaan het scherm staan twee tabbladen — Certificaten en Zivver. Standaard opent het scherm op het tabblad Certificaten. De Zivver-koppeling is alleen beschikbaar met een FULL-licentie.

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 (declareren, verzekeringscontroles, versturen). 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
VECOZO systeemcertificaat	VECOZO	Het controleren van verzekeringsgegevens (COV) en het uitwisselen van declaraties met zorgverzekeraars.
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.

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.	Declareren, verzekeringscontroles en versturen 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. declareren of een COV-controle bij VECOZO) 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 in bijvoorbeeld het declaratieproces.

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, VECOZO systeemcertificaat 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.

Voor VECOZO: exporteer het certificaat uit je browser als PKCS#12-bestand (.p12) met wachtwoord.

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.