我们的 API：接收与发送
CVR 作为中央登记处。集成通过 REST API v1。根据您的角色，您可向我们发送数据（我们接收）或向我们请求数据（我们发送）。
我们接收的内容
合作伙伴向我们发送包括：保险状态 (insurance/status)、检验结果 (inspection/status)、证据文件（上传）、付款确认、变更（登记、所有权、车牌）。认证使用 Bearer token；建议：变更请求使用 Idempotency-Key。
我们发送的内容
合作伙伴可向我们请求包括：车牌查询、车辆与登记状态、保险、车辆检验 (APK)、税务状态、执法信息。执法与市政需 purposeCode；警方还需 caseRef。
按系统类型：接收或发送
以下按软件/主体类型说明 CVR 是从该系统接收数据还是向该系统发送数据（或两者）。
保险公司
保险状态、保单数据、证据文件。
Ontvangen: 我们接收：状态通知（有效/无效/待处理）、保单 + VIN、证据上传、批准/拒绝。
Zenden: 我们发送：（可选）处理后的确认与状态。经授权可通过执法/市政 API 进行车牌查询。
税务机构
路税、评估、付款。
Ontvangen: 我们接收：（若已对接）付款或豁免确认。
Zenden: 我们发送：按人/年评估、付款状态；税务义务开始/结束事件（登记/转移时）。
市政 / 登记
车牌、车辆、车主、激活。
Ontvangen: 我们接收：车辆创建、所有权/持有人、激活/暂停、车牌发放、转移。
Zenden: 我们发送：车牌查询（含 purposeCode）、车辆与登记状态、保险、检验 (APK) 及税务以供决策。
警方 / 执法
查询、封锁、操作。
Ontvangen: 我们接收：执法操作（封锁/扣押）及用于审计的 caseRef。
Zenden: 我们发送：通过 POST /enforcement/check 的完整车牌查询（登记、保险、检验/APK、税务、封锁）；每车牌的状态与操作。
检验站
车辆检验 (APK)；每笔登记的检验结果。
Ontvangen: 我们接收：通过 POST /inspection/status 的检验结果（registration_id、inspected_at、valid_until，可选 source）。
Zenden: 我们发送：车牌查询包含检验状态 (is_valid, valid_until)；具执法权限的合作伙伴可请求。
按岛屿：系统与集成
各岛屿可能将不同套件或本地系统作为单一事实来源。以下为各岛屿概览及与 CVR 的集成方式。
博内尔
常见：本地管理（Excel、文档）、CN 税务机构（路税）、保险公司（保单）。
CVR 接收自：市政/登记（车辆、车牌、激活）、保险公司（状态），可能还有税务（付款）。CVR 发送至：警方（查询）、市政（决策用状态）、税务（事件）。一个数字登记处作为各方来源。
库拉索
常见：国家条例、自有登记、Landsontvanger（税务）、保险公司。
CVR 接收：登记决定、所有权、保险状态。CVR 发送：警方与市政查询、税务事件至 Landsontvanger、转移与执法状态。
圣马丁
常见：地方政府管理、保险公司、执法。
CVR 接收：车辆与保险数据（如通过抄送邮件或 API）。CVR 发送：执法与市政的实时状态；通过我们平台报告的保险公司无需单独对接。
萨巴
小规模：本地系统有限，需要集中工作流。
CVR 接收：登记与保险状态（少量本地操作）。CVR 发送：岛屿管理的仪表板与状态；所需自有 IT 更少。
圣尤斯特歇斯
BES 背景：简洁透明、统一规则。
CVR 接收：与其他 BES 岛屿相同的变更。CVR 发送：政府与监督的政策信息与状态。
如何连接
通过 REST API v1 连接您的系统。请参阅 API 文档与合作伙伴集成指南了解端点、认证与治理。
- API 文档 — OpenAPI/Swagger en endpoints
docs/PARTNER_INTEGRATION_GUIDE.md— 合作伙伴集成指南 (authenticatie, headers, governance)