Konektá
Na e página aki nos ta ekspliká pa sistema (software ku ta wòrdu usa hopi na e islanan komo single source of truth), pa isla i nos API kon tur kos por ser integrá: òf nos ta risibí dato for di bo sistema òf nos por manda dato na bo.
Nos API: risibí i manda
CVR ta fungi komo e registro sentral. Integrashon ta via e REST API v1. Segun bo rol bo por manda dato na nos (nos ta risibí) òf pidi dato na nos (nos ta manda).
Loke nos ta risibí
Partnernan ta manda nos entre otro: status di seguro (insurance/status), resultadonan di keuring (inspection/status), dokumentonan di evidensia (upload), konfirmashon di pago, mutashonnan (registrashon, propiedat, plaka). Autentikashon via Bearer token; rekomendá: Idempotency-Key pa mutashonnan.
Loke nos ta manda
Partnernan por pidi na nos entre otro: lookup di plaka, status di béhikel i registrashon, seguro, keuring di béhikel (APK), status di impuesto, informashon di enforcement. Pa enforcement i munisipio un purposeCode ta obligatorio; pa polisia tambe caseRef.
Pa tipo di sistema: risibí òf manda
Abou pa tipo di software/aktor si CVR ta risibí dato di e sistema ei òf ta manda dato na e sistema ei (òf ambos).
Asiguradó
Status di seguro, dato di polis, dokumentonan di evidensia.
Ontvangen: Nos ta risibí: notifikashon di status (aktivo/inaktivo/pending), polis + VIN, upload di evidensia, aprobashon/rechaso.
Zenden: Nos ta manda: (opshonal) konfirmashon i status después di prosesamento. Lookup di plaka via API di enforcement/munisipio si autorisá.
Fisko
MRB, kalkulashonnan, pagonan.
Ontvangen: Nos ta risibí: (si konektá) konfirmashon di pago òf kwijtschelding.
Zenden: Nos ta manda: kalkulashonnan pa persona/aña, status di pago; eventnan na kuminsamento/fin di obligashon di impuesto (na registrashon/transferensia).
Munisipio / Registrashon
Plaka, béhikel, dueño, aktivashon.
Ontvangen: Nos ta risibí: kreado di béhikel, propiedat/tenedor, aktivashon/suspenshon, otorgamentu di plaka, transferensianan.
Zenden: Nos ta manda: lookup di plaka (ku purposeCode), status di béhikel i registrashon, seguro, keuring (APK) i impuesto pa desishon.
Polisia / Enforcement
Lookup, blokeonan, akshonnan.
Ontvangen: Nos ta risibí: akshonnan di enforcement (block/impound) i caseRef pa audit.
Zenden: Nos ta manda: lookup kompleto di plaka (registrashon, seguro, keuring/APK, impuesto, blokeonan) via POST /enforcement/check; status i akshonnan pa plaka.
Estashon di keuring
Keuring di béhikel (APK); resultadonan di keuring pa registrashon.
Ontvangen: Nos ta risibí: resultado di keuring via POST /inspection/status (registration_id, inspected_at, valid_until, opshonal source).
Zenden: Nos ta manda: lookup di plaka inklui status di keuring (is_valid, valid_until); partnernan ku derechonan di enforcement por pidi esaki.
Pa isla: sistemanan i integrashon
Na kada isla otro pakettenan òf sistemanan lokal por ser usá komo single source of truth. Abou un overzicht pa isla i kon integrashon ku CVR ta funshoná.
Boneiru
Hopi biaha: administrashon lokal (Excel, dokumentonan), Fisko CN (MRB), asiguradónan (polis).
CVR ta risibí di: munisipio/registrashon (béhikel, plaka, aktivashon), asiguradónan (status), eventualmente impuesto (pago). CVR ta manda na: polisia (lookup), munisipio (status pa desishon), impuesto (eventnan). Un registro digital komo fuente pa tur parti.
Kòrsou
Hopi biaha: landsverordeningen, registro propio, Landsontvanger (impuesto), asiguradónan.
CVR ta risibí: desishonnan di registrashon, propiedat, status di seguro. CVR ta manda: lookup pa polisia i munisipio, eventnan di impuesto na Landsontvanger, status pa transferensia i enforcement.
Sint Maarten
Hopi biaha: administrashon di gobièrnu lokal, asiguradónan, enforcement.
CVR ta risibí: dato di béhikel i seguro (ei. via cc-mail òf API). CVR ta manda: status den real time pa enforcement i munisipio; asiguradónan no mester link aparte si nan ta reportá via nos plataforma.
Saba
Eskala chikí: sistemanan lokal limitá, workflow sentral desead.
CVR ta risibí: registrashon i status di seguro (poko akshonnan lokal). CVR ta manda: dashboard i status pa administrashon di isla; menos IT propio nesesario.
Sint Eustatius
Konteksto BES: simplicidat i transparensia, reglannan unforme.
CVR ta risibí: mutashonnan manera na otro islanan BES. CVR ta manda: informashon di polítika i status pa gobièrnu i supervisión.
Kon konektá
Konektá bo sistema via e REST API v1. Wak e dokumentashon di API i e Partner Integration Guide pa endpointnan, autentikashon i governance.
- Dokumentashon API — OpenAPI/Swagger en endpoints
docs/PARTNER_INTEGRATION_GUIDE.md— Partner Integration Guide (authenticatie, headers, governance)