Conectar
En esta página explicamos por sistema (software usado a menudo en las islas como única fuente de verdad), por isla y nuestra API cómo puede integrarse todo: si recibimos datos de su sistema o podemos enviarle datos.
Nuestra API: recibir y enviar
CVR actúa como registro central. La integración es vía REST API v1. Según su rol puede enviarnos datos (recibimos) o solicitarnos datos (enviamos).
Qué recibimos
Los socios nos envían entre otras cosas: estado del seguro (insurance/status), resultados de inspección (inspection/status), documentos de evidencia (upload), confirmaciones de pago, mutaciones (registro, propiedad, matrícula). Autenticación con token Bearer; recomendado: Idempotency-Key para mutaciones.
Qué enviamos
Los socios pueden solicitarnos entre otras cosas: consulta de matrícula, estado del vehículo y del registro, seguro, inspección (APK), estado fiscal, información de aplicación. Para aplicación y municipio se requiere purposeCode; para policía también caseRef.
Por tipo de sistema: recibir o enviar
A continuación, por tipo de software/actor, si CVR recibe datos de ese sistema o envía datos a ese sistema (o ambos).
Aseguradora
Estado del seguro, datos de póliza, documentos de evidencia.
Ontvangen: Recibimos: notificaciones de estado (activo/inactivo/pendiente), póliza + VIN, subidas de evidencia, aprobaciones/rechazos.
Zenden: Enviamos: (opcional) confirmación y estado tras el procesamiento. Consulta de matrícula vía API de aplicación/municipio si está autorizado.
Autoridad fiscal
Impuesto de circulación, liquidaciones, pagos.
Ontvangen: Recibimos: (si está vinculado) confirmación de pago o exención.
Zenden: Enviamos: liquidaciones por persona/año, estado de pago; eventos de inicio/fin de obligación fiscal (en registro/transferencia).
Municipio / Registro
Matrícula, vehículo, propietario, activación.
Ontvangen: Recibimos: creación de vehículo, propiedad/titular, activación/suspensión, emisión de matrícula, transferencias.
Zenden: Enviamos: consulta de matrícula (con purposeCode), estado del vehículo y del registro, seguro, inspección (APK) e impuesto para la toma de decisiones.
Policía / Aplicación
Consulta, bloqueos, acciones.
Ontvangen: Recibimos: acciones de aplicación (bloqueo/incautación) y caseRef para auditoría.
Zenden: Enviamos: consulta completa de matrícula (registro, seguro, inspección/APK, impuesto, bloqueos) vía POST /enforcement/check; estado y acciones por matrícula.
Estación de inspección
Inspección de vehículos (APK); resultados por registro.
Ontvangen: Recibimos: resultado de inspección vía POST /inspection/status (registration_id, inspected_at, valid_until, source opcional).
Zenden: Enviamos: la consulta de matrícula incluye estado de inspección (is_valid, valid_until); los socios con derechos de aplicación pueden solicitarlo.
Por isla: sistemas e integración
Cada isla puede usar paquetes o sistemas locales distintos como única fuente de verdad. A continuación un resumen por isla y cómo funciona la integración con CVR.
Bonaire
A menudo: administración local (Excel, documentos), Autoridad Fiscal CN (impuesto de circulación), aseguradoras (póliza).
CVR recibe de: municipio/registro (vehículo, matrícula, activación), aseguradoras (estado), posiblemente hacienda (pago). CVR envía a: policía (consulta), municipio (estado para decisión), hacienda (eventos). Un registro digital como fuente para todas las partes.
Curaçao
A menudo: ordenanzas nacionales, registro propio, Landsontvanger (impuestos), aseguradoras.
CVR recibe: decisiones de registro, propiedad, estado del seguro. CVR envía: consulta para policía y municipio, eventos fiscales a Landsontvanger, estado para transferencia y aplicación.
Sint Maarten
A menudo: administración gubernamental local, aseguradoras, aplicación.
CVR recibe: datos de vehículo y seguro (p. ej. por cc-mail o API). CVR envía: estado en tiempo real para aplicación y municipio; las aseguradoras no necesitan enlace aparte si informan vía nuestra plataforma.
Saba
Escala reducida: sistemas locales limitados, se desean flujos centralizados.
CVR recibe: estado de registro y seguro (pocas acciones locales). CVR envía: panel y estado para la administración de la isla; se necesita menos TI propia.
Sint Eustatius
Contexto BES: simplicidad y transparencia, normas uniformes.
CVR recibe: mutaciones como en otras islas BES. CVR envía: información de política y estado para gobierno y supervisión.
Cómo conectar
Conecte su sistema vía REST API v1. Consulte la documentación de la API y la Guía de integración para socios para endpoints, autenticación y gobernanza.
- Documentación API — OpenAPI/Swagger en endpoints
docs/PARTNER_INTEGRATION_GUIDE.md— Guía de integración para socios (authenticatie, headers, governance)