Documentazione

Cos'è un Digital Product Passport

Un Digital Product Passport è un documento digitale associato a un prodotto fisico. Contiene informazioni verificabili sull'origine, la composizione, la filiera produttiva e la proprietà. I DPP sono richiesti dalla normativa europea ESPR (Ecodesign for Sustainable Products Regulation) a partire dal 2026-2027 per molte categorie di prodotti.

Perché blockchain

I dati registrati su blockchain sono immutabili, verificabili pubblicamente e non dipendono da nessun intermediario. Una volta registrato, il passaporto digitale di un prodotto esiste per sempre, indipendentemente da TreVerum.

Creare un account

Vai su treverum.com/signup e inserisci email e password. Riceverai una email di conferma. Clicca il link nella email per attivare l'account.

Login

Accedi su treverum.com/login con le tue credenziali. In caso di password dimenticata usa il link "Password dimenticata" nella pagina di login.

Dati organizzazione

Inserisci il nome della tua azienda o brand, il settore di riferimento e i dati di contatto. Questi dati appariranno nelle pagine pubbliche dei tuoi prodotti.

Deploy contratto blockchain

TreVerum deploya automaticamente un contratto ERC-721 su blockchain Base a tuo nome. Questo contratto è dedicato esclusivamente alla tua organizzazione. L'operazione è inclusa nel piano e non richiede conoscenze tecniche.

Scelta del piano

Seleziona il piano più adatto alle tue esigenze. Puoi cambiare piano in qualsiasi momento dalla sezione Billing della dashboard.

Creare un tipo prodotto

Vai in Dashboard → Tipi prodotto → Nuovo tipo. Scegli un template predefinito (Vino, Olio, Abbigliamento, Arte, Gioielleria, Industria) oppure crea un tipo personalizzato da zero.

Campi personalizzati

Ogni tipo prodotto può avere campi di tipo: testo, numero, data, selezione, checkbox, immagine, file, URL, email, peso, dimensioni, GPS, NFC. I campi possono essere pubblici o privati, obbligatori o facoltativi.

Sezioni

I campi possono essere raggruppati in sezioni (es. Informazioni, Specifiche, Certificazioni) per una migliore organizzazione della pagina pubblica.

Step 1 - Categoria

Seleziona il tipo prodotto. Puoi scegliere tra i tipi che hai creato o i preset di sistema.

🔍 Clicca per ingrandire

Step 2 - Dettagli

Compila i campi del prodotto: nome, riferimento interno, e tutti i campi definiti nel tipo prodotto selezionato.

🔍 Clicca per ingrandire

Step 3 - Foto e documenti

Carica le foto del prodotto e i documenti allegati (certificazioni, analisi, schede tecniche). I file vengono salvati automaticamente su Supabase Storage.

🔍 Clicca per ingrandire

Step 4 - Mint

Rivedi il riepilogo e conferma la registrazione su blockchain. Il processo è automatico e richiede 10-30 secondi. Al termine ricevi una email di conferma con il QR code del prodotto.

🔍 Clicca per ingrandire

URL pubblico

La pagina pubblica è accessibile all'indirizzo: treverum.com/v/{contratto}/{tokenId}. Questo URL è permanente e non cambia mai.

Contenuto della pagina

La pagina pubblica mostra: nome e foto del prodotto, tutti i campi marcati come pubblici, storico della proprietà (per L3), dati blockchain (contratto, token ID, hash transazione), QR code per la verifica.

Branding

La pagina pubblica mostra il nome e il colore brand della tua organizzazione. I piani Pro e Business possono personalizzare ulteriormente il branding.

🔍 Clicca per ingrandire

L1 - Origine

Certifica l'origine e l'autenticità del prodotto. Il prodotto è registrato su blockchain con i suoi dati principali. Ideale per alimenti, prodotti agricoli, componenti industriali.

L2 - Autenticità

Include tutto L1 più certificazione di autenticità avanzata, supporto a documenti allegati e campi estesi. Ideale per moda, abbigliamento, accessori, cosmetici.

L3 - Proprietà

Include tutto L2 più trasferimento di proprietà on-chain. Il token può essere trasferito a un nuovo wallet, con storico completo dei passaggi di proprietà visibile pubblicamente. Ideale per opere d'arte, gioielli, orologi, oggetti da collezione.

Download QR

Il QR code è scaricabile in PNG dalla dashboard del prodotto. Puoi stamparlo e applicarlo al prodotto fisico.

Verifica QR

Chiunque scansioni il QR code viene indirizzato alla pagina pubblica del prodotto. Non è richiesta nessuna app — funziona con la fotocamera di qualsiasi smartphone.

Generare una API key

Vai in Dashboard → Impostazioni → API Keys → Nuova API Key. La chiave viene mostrata una sola volta al momento della creazione. Conservala in luogo sicuro.

Autenticazione

Includi la API key nell'header Authorization di ogni richiesta: Authorization: Bearer tvr_live_...

Endpoint disponibili

GET  /api/v1/products          - lista prodotti
POST /api/v1/products          - crea prodotto (auto_mint: true/false)
GET  /api/v1/products/{id}     - dettaglio prodotto

Esempio creazione con mint

POST /api/v1/products
{
  "product_type_id": "uuid",
  "name": "Nome prodotto",
  "auto_mint": true,
  "values": {
    "campo1": "valore1",
    "campo2": "valore2"
  }
}

Piani disponibili

Starter: 200 DPP/mese, livello L1. Pro: 2.000 DPP/mese, livelli L1 e L2. Business: DPP illimitati, tutti i livelli, API pubblica.

Upgrade e downgrade

Puoi cambiare piano in qualsiasi momento da Dashboard → Billing. L'upgrade è immediato. Il downgrade è effettivo dal prossimo rinnovo.

Cancellazione

Puoi cancellare il piano in qualsiasi momento. I DPP già mintati rimangono su blockchain e accessibili pubblicamente per sempre, indipendentemente dallo stato del tuo abbonamento.

I dati sono al sicuro?

I dati dei prodotti sono salvati su Supabase (PostgreSQL) con crittografia a riposo e in transito. I file sono su Supabase Storage. I dati critici sono replicati su blockchain Base.

Cosa succede se TreVerum chiude?

I DPP registrati su blockchain rimangono permanentemente accessibili. La blockchain non dipende da TreVerum. I dati dei prodotti sulla blockchain sono indipendenti dalla nostra piattaforma.

Posso esportare i miei dati?

Sì. Dalla dashboard puoi esportare la lista dei tuoi prodotti in CSV. Per un export completo contatta support@treverum.com.

TreVerum è conforme GDPR?

Sì. TreVerum tratta i dati personali in conformità al GDPR. Per i dettagli consulta la nostra Privacy Policy.

Quanto costa il gas per la blockchain?

Il costo del gas Base blockchain è incluso nel piano TreVerum. Non paghi nulla di extra per la registrazione su blockchain.