# Verzekering controleren (COV)
COV (Controle Op Verzekeringsrecht) is een Vecozo-dienst die op basis van BSN + geboortedatum terugvertelt of een patiënt verzekerd is, bij welke zorgverzekeraar, met welk pakket. Resultaat wordt automatisch opgeslagen als verzekeringsregel in het dossier.
## Wanneer gebruiken
- Vóór elk consult: bevestigen dat patient verzekerd is bij verwachte verzekeraar
- Voor declaratie: weten waar de factuur naar toe moet
- Bij wijziging van verzekeraar: nieuwe regel wordt toegevoegd, oude blijft als historisch
## Hoe het werkt
- Open een patiënt → tab Verzekering
- Patient moet BSN + geboortedatum ingevuld hebben
- Klik "COV-check via Vecozo"
- Binnen 1-2 seconden komt resultaat terug:
- - Gevonden → groene banner met verzekeraar, UZOVI-code, polisnummer, geldigheidsperiode
- - Niet gevonden → controleer BSN/geboortedatum, of patient heeft geen Nederlandse zorgverzekering
- - Fout → meestal toestemmingsverklaring of certificaat-probleem
## Onder de motorkap
- mTLS met PKIoverheid Server G3 certificaat (Vecozo bedrijfscert)
- SOAP 1.1 naar
api.vecozo.nl/cov/vz801802/v1/soap11 - Per tenant zoekt Vecozo op de AGB-code van de praktijk → resultaat moet matchen met de tenant
- BSN wordt versleuteld opgeslagen (AES-256-GCM), alleen voor de SOAP-call ontsleuteld
## Resultaat opgeslagen
Elke COV-call die "Gevonden" geeft, slaat een PatientInsurance record op:
- UZOVI-code (4-cijferig identifier verzekeraar)
- Verzekeraar-naam (CZ, Zilveren Kruis, VGZ, etc.)
- Polisnummer
- Pakketnaam (Basis / Aanvullend / Tand)
- Ingangsdatum + Einddatum
- Actief / Inactief
Oude regels blijven staan als historisch (tab toont alleen actief, audit-log behoudt historie).
## Multi-tenant — verschilt per tenant
Elke praktijk heeft eigen AGB-code (Tenant-instelling → AGB-veld). Vecozo verwerkt namens die AGB. Toestemmingsverklaring per AGB nodig bij Vecozo.
## Foutmeldingen
| Fout | Wat te doen |
|---|---|
| HTTP 403 Unauthorized | Toestemmingsverklaring ontbreekt voor jouw AGB-code. Mail softwarehelpdesk@vecozo.nl. |
| Patient heeft geen BSN | Vul BSN in op tab Gegevens |
| Patient heeft geen geboortedatum | Verplicht voor COV — vul in op tab Gegevens |
| BSN voldoet niet aan elfproef | BSN is onjuist — controleer 9 cijfers + checksum |
| NietGevonden | BSN/geboortedatum komen niet overeen, of geen Nederlandse zorgverzekering |
## Vereiste voor live gebruik
- Vecozo systeemcertificaat geactiveerd voor COV-dienst
- Toestemmingsverklaring geregistreerd voor uw AGB-code bij Vecozo
- AGB-code ingevuld in tenant-instellingen
Zonder deze drie krijgt u 403-fouten.