Valutazione dei fornitori di DPP — le nostre risposte

TracePass espone un'API REST documentata che copre passaporti, prodotti, modelli, organizzazioni e webhook. Le superfici di lettura e scrittura sono simmetriche — tutto ciò che si può fare nell'interfaccia può essere gestito tramite l'API.

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. Trascinate un file nell'interfaccia; l'endpoint di importazione massiva accetta lo stesso CSV tramite API per pipeline automatizzate.

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 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. Dopo la cancellazione, 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.

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; il nostro nodo di interrogazione risponde all'interfaccia EPCIS Query; 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'agente 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), 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 tre risorse (Product, Passport, EPCIS Event) con le operazioni dell'API v1 su ciascuna.

Installatelo da qualsiasi istanza n8n tramite Settings → Community Nodes → Install. Autenticatevi con la stessa chiave API `tp_` della REST API. Le operazioni rischiose riportano note di sicurezza nelle loro descrizioni — Create su Passport è a pagamento, Archive è irreversibile — e includono un interruttore opt-in «Confirm Overage Charge» così un flusso non addebita 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.

Ogni passaporto in TracePass ha come chiave il numero di serie. gs1.serialNumber è il join primario canonico, con SKU/modello come campo secondario per il raggruppamento. Il modello di dati è stato progettato con il numero di serie come priorità, perché la direzione normativa è quella.

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 creazione massiva e l'aggiornamento massivo per intervallo di numeri di serie sono operazioni di prima classe.

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. Un controllo notturno intercetta qualsiasi modifica avvenuta al di fuori dei normali percorsi di modifica. È 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 passaporto si esporta come JSON-LD tramite l'API o il download dall'interfaccia. L'esportazione conserva i metadati dei campi, l'attribuzione delle fonti, la cronologia delle versioni e le traduzioni.

L'esportazione massiva a livello di tenant raccoglie ogni passaporto, ogni prodotto, ogni modello che avete creato. Gli allegati multimediali (immagini, rapporti di prova, PDF) vengono forniti con URL stabili che restano risolvibili durante il periodo di tolleranza di 30 giorni dopo la cessazione — abbastanza a lungo da migrare a un fornitore successore.

I modelli sono versionati. L'aggiunta di un campo non comporta interruzioni; modificare o rimuovere un campo crea una nuova versione dello schema con un percorso di migrazione esplicito. I passaporti in circolazione restano validi rispetto al loro schema originale; i passaporti modificati vengono validati rispetto alla versione più recente.

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/packages/gs1-utils).

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). Le URL dei passaporti sono servite su HTTP/2 o successivo.

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.

L'applicazione dei ruoli obbligatori per categoria corrisponde al regolamento: i passaporti delle batterie richiedono fabbricante + riciclatore + PRO; i giocattoli richiedono fabbricante + importatore; le categorie che recano imballaggi (FMCG, imballaggi) richiedono il PRO. I ruoli opzionali compaiono nell'editor ma non bloccano 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: 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 primario: la piattaforma TracePass e il suo database sono ospitati su Hetzner a Norimberga, Germania. Il sito web di marketing è servito da Vercel; le sue funzioni server girano a Francoforte. Consegna delle email: Resend (UE). Elenco completo dei subincaricati del trattamento con relative giurisdizioni nella pagina trust.

Non utilizziamo alcun subincaricato del trattamento esclusivamente statunitense nei percorsi dei dati di produzione. Il percorso di elaborazione IA di Anthropic (usato per l'estrazione delle categorie e le traduzioni) viene invocato solo su richiesta del cliente ed è regolato da un esplicito DPA — la pagina trust lo documenta in dettaglio.

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: un backup logico automatizzato giornaliero del database primario viene scritto in un archivio oggetti UE cifrato (Cloudflare R2), conservato fuori dal server del database con retention di 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.

L'isolamento predefinito è logico: ogni lettura e scrittura è delimitata da companyId, applicato in ogni route che tocca i dati del tenant e verificato da un test automatico che fallisce se una route lo omette.

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 JSON-LD completa di ogni passaporto, prodotto, modello e allegato multimediale è disponibile su richiesta senza costi. Nessuna "tariffa di esportazione".

Dopo la cancellazione, TracePass continua a risolvere i vostri passaporti esistenti per 30 giorni senza costi (codificato nel Contratto quadro di servizio). 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.

Il cliente è il titolare del trattamento per tutta la durata del rapporto e dopo la cessazione. Source escrow opzionale disponibile su Enterprise: una copia con tag del codice sorgente della nostra applicazione è conservata da una terza parte indipendente, rilasciabile a voi al verificarsi di eventi scatenanti definiti.

Le condizioni di responsabilità sono stabilite nei Termini di servizio. La pagina trust elenca le esclusioni dall'indennizzo (rivendicazioni di proprietà intellettuale di terzi, sanzioni normative riconducibili a un errore del fornitore).

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

I dati sono vostri. Ogni piano a pagamento include un'esportazione JSON-LD completa di ogni passaporto, prodotto e modello — con provenienza e cronologia delle versioni preservate — senza costi, 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.

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 i clienti Enterprise possono aggiungere il source escrow con trigger di rilascio definiti (insolvenza, violazione non sanata, interruzione prolungata). 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 sono progettati per allinearsi alle raccomandazioni del vocabolario CIRPASS; un documento formale di allineamento campo per campo non è ancora stato pubblicato.

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 è nella roadmap build-on-first-ask), la lacuna viene nominata esplicitamente con una versione obiettivo.

Per le categorie in cui l'atto delegato non è ancora definitivo, manteniamo nel modello marcatori espliciti per i campi speculativi. I clienti Pro ed Enterprise possono presentare proposte a livello di campo che, dopo una breve revisione, confluiscono nella versione successiva del modello.

Le proposte accettate confluiscono in una nuova versione del pacchetto pubblico @tracepass/dpp-schemas.

I clienti Enterprise possono optare per il source escrow tramite un agente di deposito terzo e indipendente. Una copia con tag del codice sorgente dell'applicazione viene depositata e aggiornata con cadenza ricorrente.

Gli eventi di rilascio sono definiti nell'accordo di escrow e includono tipicamente: insolvenza del fornitore, violazione sostanziale non sanata o interruzione prolungata oltre una soglia definita.