# Huisarts AGB-lookup
Elke patiënt heeft een huisarts. Voor doorverwijzingen, terugkoppeling en de medische context is het belangrijk om te weten welke huisarts en welke praktijk. In plaats van handmatig invullen, koppelen we automatisch via de Vektis AGB-Raadpleegdienst.
## Workflow
- Open patient → tab Gegevens
- Scroll naar Huisarts sectie onderaan
- Vul de 8-cijferige AGB-code van de huisarts in (te vinden op verwijsbrief / patient zelf)
- Klik "Opzoeken"
- Vektis retourneert binnen 1 seconde:
- - Naam huisarts (academische titel + voornamen + achternaam)
- - Specialisme
- - Adres + postcode + woonplaats van de praktijk
- - Telefoonnummer + e-mailadres (van de vestiging, niet de huisarts zelf — AVG)
- Klik "Ontkoppelen" om de koppeling te verwijderen
## Wat wordt opgeslagen
Achter de schermen wordt een HealthcareProvider record aangemaakt of bijgewerkt en gekoppeld aan de patiënt. Dezelfde huisarts kan aan meerdere patiënten gekoppeld zijn — bij update werkt het door op alle records.
## Privacy (AVG)
Vektis levert geen persoonlijke contactgegevens van de zorgverlener (privé email/telefoon). Alleen praktijk-/vestigingsgegevens. Adressen van zorgverleners staan niet in het AGB-register.
## Andere AGB-lookup plekken in het EPD
| Plek | Doel | |---|---| | Patient → Gegevens → Huisarts | Huisarts koppelen | | Verwijzingen → Nieuw | Doorverwijzer/specialist opzoeken | | Zorgaanbieders | Algemene database van zorgaanbieders die we kennen | | Tenant instellingen | AGB-code van uw eigen praktijk | | /beheer/vektis-test (superadmin) | Verbinding testen + ad-hoc lookup |
## Vereisten
- Vektis API token (gratis aan te vragen op vektis.nl/agb-register)
- mTLS certificaat — Vektis accepteert ook ons Vecozo bedrijfscert (bevestigd door Vektis support)
Token + cert in Vercel: VEKTIS_API_TOKEN + VEKTIS_MODE=test (of production).
## Foutmeldingen
| Fout | Wat te doen | |---|---| | AGB-code moet 8 cijfers zijn | Controleer of de code 8 cijfers heeft (1ste 2 = zorgverlenersoort) | | AGB-code niet gevonden | Code bestaat niet in register — typfout of inactief | | Vektis API 401 | Token klopt niet — vraag nieuwe via referentieproducten@vektis.nl | | Vektis API 403 Invalid client certificate | mTLS-cert niet geregistreerd voor uw aansluiting bij Vektis | | Vektis niet geconfigureerd | Superadmin moet eerst VEKTIS_API_TOKEN in Vercel zetten |