Ricevute di consenso

Una ricevuta di consenso è un record a prova di manomissione di una singola decisione di consenso. Ogni volta che un visitatore accetta, rifiuta o modifica il proprio consenso, viene creata una ricevuta.

Contenuto della ricevuta

{
  "id": "rec_01HXYZ123456",
  "property_id": "prop_abc",
  "policy_id": "pol_def",
  "policy_version": 3,
  "banner_version": 7,
  "timestamp": "2026-03-09T12:34:56Z",
  "event_type": "consent.created",
  "choices": {
    "necessary": true,
    "analytics": true,
    "marketing": false,
    "functional": true
  },
  "region": "DE",
  "user_agent_hash": "sha256:a1b2c3...",
  "ip_hash": "sha256:d4e5f6...",
  "previous_receipt_id": null,
  "hmac": "sha256:g7h8i9..."
}

Spiegazione dei campi

Campo	Descrizione
id	Identificatore univoco della ricevuta
policy_version	Versione esatta della policy attiva al momento della decisione
banner_version	Versione della configurazione del banner
timestamp	Timestamp UTC della decisione
event_type	consent.created, consent.updated, o consent.revoked
choices	Decisioni di accettazione/rifiuto per categoria
region	Regione del visitatore rilevata tramite GeoIP
user_agent_hash	SHA-256 della stringa user agent
ip_hash	SHA-256 dell'indirizzo IP
previous_receipt_id	Link alla ricevuta precedente (null per la prima decisione)
hmac	Firma HMAC-SHA256 per il rilevamento delle manomissioni

Visualizzare le ricevute

Dashboard → Proprietà → Prove → Ricevute

Cerca per: intervallo di date, regione, scelta (analytics accettate/rifiutate, ecc.).

Conservazione delle ricevute

Le ricevute vengono conservate per 7 anni a supporto dei requisiti di audit GDPR (Art. 7(1) GDPR richiede di dimostrare che il consenso è stato dato).

Verificare una ricevuta

Il campo hmac ti permette di verificare che una ricevuta non sia stata alterata. Vedi Audit Chain per le istruzioni di verifica.

API delle ricevute

Le ricevute sono disponibili tramite l'API:

GET /api/v1/receipts?property_id=prop_abc&from=2026-01-01
Authorization: Bearer YOUR_API_TOKEN

Richiede scope: receipts:read