Valutazione dei fornitori di DPP — le nostre risposte

TracePass espone un'API REST documentata che copre prodotti, passaporti (campi, parti, ciclo di vita, istantanee, creazione massiva, codici QR, controlli di conformità), misurazioni delle batterie, immissione sul mercato e registrazione nel Registro UE, verifiche dell'ambito DPP, modelli di categoria ed eventi EPCIS. Non replica l'intera dashboard: la pubblicazione di un passaporto, la configurazione dei webhook, la maggior parte delle impostazioni dell'account (eccetto il profilo di conformità), l'importazione CSV e l'esportazione a livello di tenant sono disponibili solo nella dashboard.

L'autenticazione utilizza chiavi API a livello di organizzazione (accesso aziendale) o applicazioni OAuth 2.0 con consenso per ambito tramite la scheda OAuth Apps nella dashboard. La specifica OpenAPI è pubblicata per ogni cliente nel portale per sviluppatori — senza barriere NDA, senza l'attrito del "parlate con il nostro team di integrazione".

Ogni modello di categoria viene fornito con il proprio modello CSV — i nomi delle colonne corrispondono allo schema, tipi e vincoli sono validati al caricamento. Caricate un file CSV o Excel nella dashboard. Per le pipeline automatizzate, la Batch API (POST /api/v1/passports/batch) accetta JSON, fino a 100 passaporti per chiamata; non accetta il file CSV in sé.

La validazione è per riga con segnalazione degli errori a livello di colonna. L'endpoint API batch restituisce un risultato per voce — le righe che superano la validazione vengono create, quelle con errori vengono segnalate singolarmente senza bloccare le restanti.

Ogni piano a pagamento può instradare i codici QR attraverso il dominio del cliente (ad es. id.vostro-marchio.eu/01/...). TracePass risolve sotto il vostro dominio, quindi la portabilità degli URL è permanente — anche se cambiate fornitore, l'URL sulla confezione continua a funzionare.

Gli account gratuiti / di prova risolvono sotto id.tracepass.eu/p/...; il passaggio a un piano a pagamento non interrompe i codici QR già in circolazione che hanno avuto origine sul dominio condiviso. Al termine dell'abbonamento, TracePass continua a risolvere i vostri passaporti esistenti per 30 giorni senza costi (vedere le Condizioni di servizio) — per i clienti a pagamento su un dominio personalizzato, questo offre una finestra per reindirizzare il DNS verso il resolver di un altro fornitore. Dopo il periodo di tolleranza di 30 giorni, gli URL del dominio condiviso restituiscono “scaduto” e TracePass cessa di servire il dominio personalizzato. Riattivando l'abbonamento in qualsiasi momento, i passaporti scaduti tornano online, nei limiti consentiti dal piano. Se passate a un altro fornitore, potete invece reindirizzare gratuitamente i vostri passaporti verso di esso, su ogni piano, Free incluso: TracePass verifica prima ogni nuovo indirizzo, poi le scansioni dei codici stampati vanno direttamente al nuovo fornitore, anche sul dominio condiviso.

Esportazione, acquisizione e interrogazione EPCIS 2.0 sono incluse in ogni piano, Free compreso. Fornitori e sistemi ERP inviano eventi al nostro endpoint di Capture; la nostra interfaccia EPCIS Query risponde alle interrogazioni; gli eventi di qualsiasi passaporto vengono serializzati come documento JSON-LD valido secondo lo standard EPCIS 2.0, pubblicizzato nel risolutore GS1 Digital Link del QR, così un sistema compatibile con EPCIS scopre automaticamente la cronologia.

Il volume è il misuratore: Basic 1.000 eventi/mese, Starter 10.000, Growth 100.000, Scale 1.000.000, Pro 10.000.000, Enterprise illimitato. Free ha 10 eventi/mese come barriera di valutazione. Nei piani a pagamento il raggiungimento del limite è un superamento opt-in a una tariffa per blocco da 1.000 eventi che scende da €5 (Basic) a €1 (Pro) — vedi la tabella prezzi su /pricing. Su Free il raggiungimento del limite richiede un upgrade, senza addebiti a sorpresa.

L'IA di TracePass redige inoltre EPCIS TransformationEvents dalle schede tecniche dei fornitori e dai PDF di specifica per la revisione del vostro approvatore — la stessa barriera «IA suggerisce, umano approva» del resto della piattaforma.

TracePass include un server Model Context Protocol, elencato nell'MCP Registry ufficiale come eu.tracepass/tracepass. Due modi per usarlo: un endpoint ospitato a cui puntare un client MCP, o un pacchetto npm locale eseguito via npx. L'autenticazione supporta chiavi API e OAuth 2.0 (il pulsante "Connect" in Claude.ai e client MCP compatibili).

Espone la piattaforma come strumenti MCP (prodotti, passaporti, campi, parti, EPCIS, modelli, ambito DPP), oltre a risorse e prompt. Le azioni di scrittura sono chiaramente contrassegnate — il server indica all'assistente quali azioni sono a pagamento o irreversibili, così un agente vi avvisa prima di creare passaporti o archiviare qualcosa.

TracePass include un n8n community node — n8n-nodes-tracepass — costruito strettamente secondo l'attuale standard di verifica di n8n per i community node. Routing dichiarativo, zero dipendenze a runtime, licenza MIT, gratuito. Espone cinque risorse (Product, Passport, EPCIS Event, Template, Scope) con le operazioni dell'API v1 su ciascuna.

Installatelo su un'istanza n8n self-hosted tramite Settings → Community Nodes → Install; n8n Cloud consente i community node solo nel piano Enterprise. Autenticatevi con una chiave API `tp_`, come per la REST API, oppure con OAuth2. Le operazioni rischiose riportano note di sicurezza nelle loro descrizioni — Archive, per esempio, è irreversibile. Create su Passport crea una bozza, che non occupa posti del piano e non viene addebitata; il limite del piano ed eventuali eccedenze si applicano alla pubblicazione dalla dashboard, così un flusso non può addebitare l'account a sorpresa.

Le integrazioni per Zapier e Make non sono ancora rilasciate — nel frattempo chiamate direttamente la REST API tramite i loro moduli HTTP; la stessa chiave API `tp_` funziona.

I passaporti a livello di numero di serie sono nativi: per impostazione predefinita un passaporto ha come chiave GTIN + numero di serie (GS1 Digital Link), con SKU/modello come campo secondario per il raggruppamento. Gli identificativi indicano il proprio schema secondo la EN 18219, quindi sono supportati anche identificativi ISO/IEC 15459, IEC 61406, DID e DOI; i passaporti delle batterie accettano GS1 e ISO/IEC 15459.

I passaporti a livello di numero di serie supportano i dati di ciclo di vita per unità: stato di salute, storico delle riparazioni, trasferimenti di proprietà, stato di fine vita. La Batch API crea fino a 100 passaporti per chiamata e l'API v1 può indirizzare ogni singolo passaporto tramite il suo numero di serie. Non esiste un aggiornamento massivo per intervallo di numeri di serie.

Ogni modifica al passaporto viene registrata con marca temporale, autore e diff a livello di campo, e mostrata come cronologia nella pagina di dettaglio del passaporto.

Inoltre, ogni modifica di un passaporto pubblicato, sospeso, scaduto o archiviato viene archiviata come istantanea completa di quanto il passaporto dichiarava, sigillata con un hash SHA-256 del contenuto (riverificato a ogni lettura) e con l'autore della modifica. Anche una modifica avvenuta al di fuori dei normali percorsi di modifica viene registrata, entro un giorno. È l'archivio delle modifiche descritto dalla EN 18221:2026 (punto 4.2).

Per rispondere alla domanda "cosa diceva questo passaporto alla data X", richiedere la versione valida in quel momento: nella dashboard oppure tramite l'API con GET /api/v1/passports/{id}/snapshots?at=<data>. L'URL pubblico del passaporto serve sempre la versione corrente.

Ogni piano, Free incluso, può esportare l'intero account da Settings → Data export, qualunque sia lo stato dei pagamenti e anche dopo la disdetta. "Export everything" crea un unico ZIP in background e vi invia un'e-mail quando è pronto; il download resta valido per 7 giorni. Contiene ogni prodotto e passaporto in JSON-LD, gli eventi EPCIS 2.0, ogni documento caricato come file originale, le richieste ai fornitori con le risposte, la cronologia delle versioni dei passaporti con le credenziali firmate, le misurazioni delle batterie e le statistiche giornaliere delle scansioni in CSV. "Download JSON-LD" fornisce subito il documento JSON-LD a livello di tenant: ogni prodotto e passaporto, più un riferimento a ciascun modello utilizzato. Un amministratore avvia queste esportazioni dalla dashboard; non sono disponibili tramite l'API REST o una chiave API, e i dati dei passaporti non si esportano in CSV.

L'esportazione conserva per ogni campo il valore, l'attribuzione della fonte e la traccia di controllo a livello di campo, oltre alle traduzioni; le immagini dei prodotti e il logo aziendale ospitati da TracePass sono inclusi come file originali, mentre un'immagine sul vostro server è indicata con il suo URL. I dati pubblici di ogni passaporto pubblicato sono inoltre serviti come JSON-LD all'URL del passaporto.

I modelli vengono aggiornati direttamente: ogni categoria ha un modello corrente e ogni modifica è registrata nel Changelog normativo pubblico. I passaporti esistenti conservano i loro valori e ogni versione pubblicata è archiviata come snapshot. Un campo che diventa obbligatorio viene segnalato sui passaporti esistenti nella vista di conformità e va compilato prima della loro pubblicazione successiva. Non vengono mantenute versioni separate dello schema per passaporto.

Ogni modifica normativa che tracciamo viene registrata nel Regulatory Changelog pubblico con data, ambito e impatto sulla migrazione. Dal piano Growth in su, le modifiche tracciate per le vostre categorie di prodotto compaiono nelle notifiche della dashboard.

Ogni URL pubblico di passaporto serve JSON-LD valido quando la richiesta porta Accept: application/ld+json. Lo stesso URL serve HTML per i browser e JSON-LD per i crawler e i sistemi delle autorità — nessun endpoint separato da scoprire.

Gli URL seguono la grammatica di GS1 Digital Link (.../01/{GTIN}/21/{serial}). Il comportamento del resolver è auto-testato rispetto alla specifica v2.0 usando uno script pubblicato (tracepass-open/tools/gs1-conformance-check.ts).

Accept: application/json restituisce lo stesso contenuto come JSON semplice — la EN 18216 rende JSON il formato leggibile da macchina obbligatorio — e il contenuto riporta l'intestazione del passaporto della EN 18223 come campi di primo livello (digitalProductPassportId, uniqueProductIdentifier, granularity, dppSchemaVersion, dppStatus, lastUpdated, economicOperatorId). Per le batterie per veicoli elettrici, le batterie per mezzi di trasporto leggeri e le batterie industriali oltre 2 kWh, il JSON semplice restituisce invece la parte pubblica del passaporto nel modello di dati per le batterie della Commissione europea, il formato che legge il registro UE dei DPP; application/ld+json mantiene la vista linked data. I browser sono serviti su HTTP/2 o successivo; i client automatici che non chiedono HTML, come il controllo del link del registro UE dei DPP, anche su HTTP/1.1.

Ogni passaporto contiene un blocco strutturale `parties` con chiave per ruolo di operatore economico. Ogni voce ha un GLN GS1 validato (13 cifre, cifra di controllo mod-10), denominazione legale, codice paese ISO 3166-1 e URL opzionale. Il GLN viene emesso sia in `gs1:partyGLN` (GS1 Web Vocabulary, preciso secondo specifica) sia in `schema:identifier` con `propertyID: "GS1:GLN"` (mirror schema.org), così i lettori compatibili con DPP e i crawler schema.org standard vedono ciascuno ciò che si aspetta.

Per i fornitori senza GLN, un campo `legacyOperatorId` accetta una partita IVA, un EORI, un codice fiscale nazionale o un codice fornitore interno — ogni parte resta tracciabile anche prima che l'avvio GS1 del fornitore sia completato.

I ruoli obbligatori sono stabiliti per ciascuna categoria nella piattaforma: i passaporti delle batterie richiedono fabbricante + riciclatore + PRO, mentre importatore, mandatario e distributore sono facoltativi; i giocattoli fabbricante + importatore; le categorie che recano imballaggi (FMCG, imballaggi) fabbricante + PRO. Richiedere un riciclatore e una PRO è una scelta della piattaforma, non un obbligo del diritto UE: i produttori possono adempiere la responsabilità estesa del produttore individualmente o tramite una PRO (Regolamento batterie art. 57(1), PPWR art. 47(1)), anche se uno Stato membro può rendere obbligatoria una PRO per le batterie. Un ruolo obbligatorio mancante viene segnalato ma non blocca mai la pubblicazione. La stessa mappa dei ruoli alimenta l'editor della dashboard, l'API v1 (`PATCH /api/v1/passports/{id}/parties/{role}`) e i modelli di importazione massiva CSV (colonne con chiavi puntate: `manufacturer.gln`, `recycler.legalName` ecc.).

Il codice QR porta a un normale indirizzo web. Lo stesso passaporto si apre in qualsiasi browser su desktop o laptop, su un chiosco in negozio o su un tablet, senza installare alcuna app.

Ogni passaporto pubblico offre il download in PDF dei campi mostrati dal visualizzatore, nella lingua scelta e con le immagini incorporate, così un rivenditore o un banco del servizio clienti può stamparlo su richiesta.

Il visualizzatore è pensato anche per le tecnologie assistive: supera un audit automatizzato WCAG 2.1 AA, è pienamente utilizzabile da tastiera, si adatta a schermi stretti o a uno zoom del 400% e dichiara la lingua del passaporto, così che lo screen reader usi la voce giusta (la EN 18216 richiede la EN 301 549 per il passaporto leggibile dall'uomo).

Due obiettivi di disponibilità distinti sui piani a pagamento (il piano Free non ne ha): 99,9% per il portale dell'applicazione in cui voi e il vostro team lavorate; 99,95% per il resolver pubblico che le autorità e i consumatori raggiungono tramite codici QR. Entrambi sono ospitati nell'UE (Germania) e non sono replicati su più regioni; la disponibilità è monitorata sulla pagina di stato pubblica.

La pagina di stato traccia entrambe le superfici in modo indipendente. I crediti per interruzione si applicano per superficie — i crediti del portale non richiedono un'interruzione del resolver, e viceversa.

Applicazione e database: la piattaforma TracePass, il suo database e il sito web di marketing sono ospitati nell'UE, in Germania. Consegna delle email: Resend (UE). L'archiviazione dei file — caricamenti, documenti, PDF generati e backup del database — è su Cloudflare R2 nella sua giurisdizione UE; solo le immagini pubbliche mostrate dai passaporti sono archiviate senza limitazione all'UE. Elenco completo dei subincaricati del trattamento con relative giurisdizioni nella pagina trust.

L'elaborazione dei documenti con IA (estrazione e traduzioni) passa per Anthropic negli USA. Avviene solo sui dati inviati dal cliente (un documento caricato, una richiesta di ricerca o un passaporto pubblicato che viene poi tradotto), mai di propria iniziativa; è regolata da un DPA con Anthropic, e Anthropic figura nel registro dei subincaricati del trattamento della pagina trust.

DPA standard per responsabile del trattamento disponibile; firmato prima che fluiscano i dati del cliente. Il registro dei subincaricati del trattamento nella pagina trust elenca ogni responsabile con ruolo e giurisdizione; le aggiunte attivano una notifica preventiva ai sensi dell'Articolo 28.

Le richieste di accesso e di cancellazione dell'interessato vengono gestite su richiesta nel quadro del processo DPA (il contenuto del passaporto in sé è costituito da dati di prodotto, non da dati personali; la superficie rilevante è l'analisi delle scansioni). Notifica delle violazioni: 72 ore dall'incidente confermato, codificata nel DPA.

Backup operativi: i dati dei clienti vengono salvati automaticamente ogni giorno, cifrati, in un archivio separato, e ogni backup viene conservato per 7 giorni.

Conservazione lungo il ciclo di vita del prodotto: mentre l'abbonamento è attivo, i passaporti restano attivi e interrogabili per l'intera durata di vita normativa applicabile a ciascuna categoria di prodotto. Dopo la cessazione dell'abbonamento, i passaporti pubblicati restano risolvibili pubblicamente per 30 giorni senza costi aggiuntivi; dopo di che i codici QR restituiscono un avviso di "scaduto". Il rinnovo dell'abbonamento ripristina l'accesso in qualsiasi momento. Fanno eccezione i passaporti che reindirizzate a un nuovo fornitore: i loro codici portano al nuovo fornitore per tutto il tempo in cui il passaporto deve restare disponibile.

L'isolamento predefinito è logico: ogni lettura e scrittura è limitata ai dati della vostra organizzazione, e questa limitazione viene testata di continuo.

Se avete bisogno di isolamento fisico, contattateci.

Quota di passaporti a fasce. Ogni piano include un numero di passaporti; l'eccedenza è misurata a una tariffa pubblicata che diminuisce con la scala. Non addebitiamo mai per scansione — il volume di scansioni dei consumatori è imprevedibile, e non vi invieremo una fattura a sorpresa quando uno dei vostri prodotti diventa di tendenza.

Per i fabbricanti di batterie, veicoli elettrici e pneumatici ad alto volume con obblighi a livello di numero di serie, offriamo un pacchetto a volume di serie con prezzi a costo marginale che rendono sostenibile l'economia su larga scala. Contattateci.

L'esportazione completa dell'account (ogni passaporto e prodotto in JSON-LD, più i documenti, gli eventi EPCIS e la cronologia delle versioni) è disponibile su richiesta dalla dashboard, su ogni piano incluso Free e anche dopo la disdetta, senza costi. Nessuna "tariffa di esportazione".

Potete disdire in qualsiasi momento; il piano termina alla fine del mese di fatturazione in corso. Se in quel momento è ancora in corso una durata minima (3, 6 e 12 mesi su Scale, Pro ed Enterprise) o un anno prepagato, si applica una commissione di uscita anticipata fino a 3 canoni mensili; con fatturazione annuale viene detratta dal rimborso dei mesi non utilizzati. Su richiesta, il servizio prosegue per un periodo transitorio fino a 30 giorni alle spese standard di servizio del piano, e i vostri dati restano poi recuperabili per almeno 30 giorni (Termini di servizio, §10a, ai sensi del regolamento UE sui dati). Se TracePass viola in modo sostanziale i Termini di servizio e non pone rimedio alla violazione entro 30 giorni dalla vostra comunicazione scritta, potete risolvere il contratto con effetto immediato, anche durante una durata minima: non è dovuto alcun ulteriore corrispettivo, e i corrispettivi prepagati per il periodo non utilizzato vengono rimborsati pro rata (Termini di servizio, §10).

Al termine dell'abbonamento, TracePass continua a risolvere i vostri passaporti esistenti per 30 giorni senza costi (Termini di servizio, sezione 10). Durante quella finestra, i codici QR sugli imballaggi già stampati continuano a risolvere verso i vostri dati mentre migrate; su un dominio personalizzato reindirizzate il DNS verso un fornitore successore e i codici stampati non si interrompono mai. Oppure, su ogni piano, reindirizzate gratuitamente i vostri passaporti al nuovo fornitore: TracePass verifica prima ogni nuovo indirizzo, poi i codici stampati portano direttamente lì, anche sul dominio condiviso. Aggiornare le vostre voci nei registri UE resta compito vostro, perché la registrazione non può essere delegata.

Il cliente è il titolare del trattamento per tutta la durata del rapporto e dopo la cessazione. Il source escrow può essere negoziato nell'ambito di un contratto Enterprise (Termini di servizio, §13); oggi non è incaricato alcun agente di escrow, quindi le condizioni si concordano contratto per contratto.

Se state trasferendo passaporti da un altro fornitore DPP a TracePass, potete importarli dalla dashboard: incollate fino a 100 URL di passaporti o caricate i file (JSON / JSON-LD). TracePass legge i formati supportati e crea bozze per la vostra revisione; ogni valore importato è in attesa di approvazione prima della pubblicazione. La copertura dipende da ciò che pubblica il fornitore di origine.

Le condizioni di responsabilità sono stabilite nei Termini di servizio.

L'assicurazione E&O non è ancora in essere.

I dati sono vostri. Ogni piano, Free incluso, può esportare l'intero account senza costi, anche dopo la disdetta: ogni passaporto e prodotto in JSON-LD — con provenienza e traccia di controllo di ogni campo preservate — più i documenti originali e la cronologia delle versioni, scaricati da un amministratore dalla dashboard (non tramite l'API REST). Nessuna tariffa di esportazione e nessun formato proprietario illeggibile altrove.

L'URL è vostro. In ogni piano a pagamento il GS1 Digital Link si risolve sotto il vostro dominio tramite DNS che controllate. Se ve ne andate, reindirizzate quel DNS verso un successore e i codici QR già stampati sui prodotti spediti continuano a funzionare — il più grande e meno discusso rischio di lock-in nei DPP, neutralizzato per progettazione. Su ogni piano, anche sul dominio condiviso, potete inoltre reindirizzare i vostri passaporti al nuovo fornitore, così i codici già stampati portano lì.

La continuità è contrattuale. Una finestra di tolleranza di 30 giorni dopo la cessazione mantiene risolvibili i vostri passaporti durante la migrazione; restate titolari del trattamento per tutto il tempo; e il source escrow può essere negoziato in un contratto Enterprise. Ciascuno di questi è dettagliato in una risposta dedicata qui sotto.

Pubblichiamo il risultato del test di conformità a GS1 Digital Link nella pagina trust. Lo Schema.org JSON-LD viene emesso su ogni URL pubblico di passaporto. I modelli per batterie, pneumatici e tessili sono mappati campo per campo alle ontologie CIRPASS-2, in tabelle di allineamento pubblicate nel repository aperto degli schemi.

Gli identificatori GS1 GLN (Global Location Number) sono campi di prima classe su ogni passaporto — rigorosa validazione mod-10 a 13 cifre, con chiavi per più ruoli (fabbricante / importatore / mandatario / distributore / riciclatore / organizzazione per la responsabilità del produttore) ed emessi sia nella forma gs1:partyGLN sia in schema:identifier 'GS1:GLN', così i lettori compatibili con DPP e i crawler schema.org standard vedono ciascuno ciò che si aspetta.

Dove la conformità è parziale (ad es. raccomandazioni CIRPASS successive alla nostra ultima revisione di allineamento, o il percorso resolver /414/{gln}, che non è ancora supportato), la lacuna viene nominata esplicitamente.