[{"data":1,"prerenderedAt":947},["ShallowReactive",2],{"page-\u002Fit\u002Fguide\u002Fapi-del-registro-dpp":3,"related-\u002Fit\u002Fguide\u002Fapi-del-registro-dpp":926},{"id":4,"title":5,"author":6,"body":7,"category":912,"description":913,"extension":914,"heading":915,"heroImage":912,"heroImageAlt":916,"howTo":912,"layout":917,"meta":918,"navigation":317,"ogImage":919,"path":920,"publishedAt":921,"sections":912,"seo":922,"sourcePath":923,"stem":924,"updatedAt":921,"videoPosition":912,"videos":912,"__hash__":925},"pages\u002Fit\u002Fguide\u002Fapi-del-registro-dpp.md","API del registro DPP: cosa comporta davvero l'integrazione","Mia",{"type":8,"value":9,"toc":889},"minimark",[10,17,30,33,42,47,57,143,146,155,159,162,178,181,185,188,194,197,203,217,221,228,231,267,270,274,277,391,402,421,463,470,473,480,597,600,604,607,614,621,629,634,641,645,648,665,678,682,691,700,708,712,715,718,722,725,767,770,774,825,833,837,841,844,848,851,855,861,865,871,875,878,882,885],[11,12,13],"p",{},[14,15,16],"strong",{},"TL;DR",[18,19,20,24,27],"ul",{},[21,22,23],"li",{},"Il 30 ottobre 2026 la Commissione europea ha pubblicato le specifiche tecniche dell'API del registro DPP: una guida all'integrazione, i file OpenAPI, le guide all'autenticazione per gli account di servizio e per i passaporti ospitati in proprio, e i modelli di dati semantici per le batterie.",[21,25,26],{},"La registrazione è asincrona e «tutto o niente»: invii fino a 100 passaporti per richiesta, il registro recupera e convalida ciascun passaporto dal suo indirizzo web e, se un solo elemento non supera i controlli, nessuno viene registrato.",[21,28,29],{},"Le batterie sono finora l'unico gruppo di prodotti definito. Le batterie per veicoli elettrici, quelle LMT e quelle industriali superiori a 2 kWh devono avere un passaporto registrato dal 18 febbraio 2027, e la tua organizzazione deve essere verificata con un sigillo elettronico qualificato prima che qualsiasi chiamata API funzioni.",[11,31,32],{},"L'API del registro DPP è il modo in cui un fabbricante, un importatore o la piattaforma che lavora per loro registra i passaporti digitali di prodotto presso l'UE senza compilare un modulo web un prodotto alla volta. Il registro in sé è operativo dal 20 luglio 2026. Ciò che è arrivato il 30 ottobre è il dettaglio che serve a uno sviluppatore per integrarsi: endpoint, autenticazione, codici di errore, regole di polling e i modelli di dati rispetto ai quali il registro convalida i passaporti.",[11,34,35,36,41],{},"Questa guida è per chi deve far comparire i passaporti delle batterie nel registro entro febbraio. Segue i documenti nell'ordine in cui li incontrerai e separa ciò che è deciso da ciò che è ancora aperto. Per sapere cos'è il registro e perché esiste, consulta la nostra ",[37,38,40],"a",{"href":39},"\u002Fit\u002Fguide\u002Fregistro-europeo-dpp\u002F","guida al registro DPP dell'UE",". Tutto quanto segue è aggiornato a novembre 2026.",[43,44,46],"h2",{"id":45},"che-cosa-ha-pubblicato-la-commissione-il-30-ottobre","Che cosa ha pubblicato la Commissione il 30 ottobre?",[11,48,49,50,56],{},"Sei documenti tecnici sono comparsi sulla ",[37,51,55],{"href":52,"rel":53},"https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport\u002Fresources-documentation_en",[54],"nofollow","pagina delle risorse DPP"," della Commissione, senza una notizia ad annunciarli. Si affiancano alla User Guide for Economic Operators di settembre 2026.",[58,59,60,76],"table",{},[61,62,63],"thead",{},[64,65,66,70,73],"tr",{},[67,68,69],"th",{},"Documento",[67,71,72],{},"Versione",[67,74,75],{},"Cosa ti offre",[77,78,79,91,102,112,123,133],"tbody",{},[64,80,81,85,88],{},[82,83,84],"td",{},"API Integration Guide for Economic Operators",[82,86,87],{},"1.0",[82,89,90],{},"Il flusso di registrazione, il monitoraggio delle attività, le intestazioni, il polling e la gestione degli errori",[64,92,93,96,99],{},[82,94,95],{},"OpenAPI Specifications (ZIP)",[82,97,98],{},"1.0.0, EUPL-1.2",[82,100,101],{},"Tre file OpenAPI 3.1.0: registry, dashboard (monitoraggio delle attività) e common",[64,103,104,107,109],{},[82,105,106],{},"Semantic Data Guide",[82,108,87],{},[82,110,111],{},"Come i dati del passaporto vengono modellati, serializzati e convalidati",[64,113,114,117,120],{},[82,115,116],{},"Semantic Data Artifacts (ZIP)",[82,118,119],{},"core 1.0.0, batteries 1.0.0",[82,121,122],{},"JSON Schema, contesti JSON-LD, shape SHACL e vocabolari SKOS, con i sottogruppi EV, LMT e industriali",[64,124,125,128,130],{},[82,126,127],{},"Service Account Technical Integration Guide",[82,129,87],{},[82,131,132],{},"Autenticazione machine-to-machine per i tuoi sistemi",[64,134,135,138,140],{},[82,136,137],{},"Self-Hosted Authentication Guide",[82,139,87],{},[82,141,142],{},"Come il tuo server dei passaporti deve gestire le richieste provenienti dal registro",[11,144,145],{},"Il 19 ottobre la Commissione ha inoltre pubblicato la versione 3.2 delle sue linee guida sul passaporto della batteria, che elenca i dati per categoria di batteria. Ne parliamo più avanti.",[11,147,148,149,154],{},"La parte vincolante è il ",[37,150,153],{"href":151,"rel":152},"https:\u002F\u002Feur-lex.europa.eu\u002Feli\u002Freg_impl\u002F2026\u002F1778\u002Foj\u002Fita",[54],"regolamento di esecuzione (UE) 2026\u002F1778"," del 16 luglio 2026. L'articolo 3, lettera b), prevede un'API per la registrazione, l'articolo 8, paragrafo 6, consente la registrazione tramite l'interfaccia utente o l'API, e l'articolo 8, paragrafo 7, impone controlli automatici della semantica e della granularità. Le specifiche sono il modo in cui la Commissione attua quegli articoli.",[43,156,158],{"id":157},"che-cosa-fa-il-registro-con-il-tuo-passaporto","Che cosa fa il registro con il tuo passaporto?",[11,160,161],{},"Il registro è un indice, non un archivio. Gli invii un identificativo univoco del prodotto (UPI) per ogni passaporto, e l'API richiede che quell'UPI sia un URL HTTPS. Al momento dell'invio, il registro va a quell'URL, recupera il passaporto e lo convalida rispetto al modello di dati del gruppo di prodotti. Nelle parole della guida all'integrazione, il registro «non conserva in modo persistente il contenuto del payload DPP recuperato».",[11,163,164,165,168,169,173,174,177],{},"Questa sola scelta progettuale determina gran parte del lavoro di ingegneria. Il passaporto deve essere online, completo e valido ",[14,166,167],{},"nel momento in cui lo invii",", non dopo. Se il registro non riesce a raggiungerlo, l'elemento fallisce con ",[170,171,172],"code",{},"UPI_NOT_RESOLVABLE",". Se il contenuto non corrisponde allo schema, fallisce come ",[170,175,176],{},"ITEM_NON_COMPLIANT",". Un flusso che prima registra e poi pubblica il passaporto non funzionerà.",[11,179,180],{},"Una volta riuscita la registrazione, l'articolo 9 del regolamento di esecuzione ti fornisce una prova di registrazione sigillata con il sigillo elettronico qualificato della Commissione, disponibile per 90 giorni. Scaricala e archiviala: è la tua prova che il passaporto è stato registrato, e di quando.",[43,182,184],{"id":183},"che-cosa-deve-essere-pronto-prima-della-prima-chiamata-api","Che cosa deve essere pronto prima della prima chiamata API?",[11,186,187],{},"Più di quanto la maggior parte dei team si aspetti, e quasi nulla di tutto ciò è codice.",[11,189,190,193],{},[14,191,192],{},"Un'organizzazione verificata."," Gli utenti accedono con EU Login, ma l'API rifiuta con un 403 le richieste di un'organizzazione non verificata. Ai sensi dell'articolo 4 del regolamento di esecuzione, una persona giuridica dimostra la propria identità e il proprio stabilimento con un sigillo elettronico qualificato (o con un attestato elettronico di attributi); un'impresa individuale può usare una firma elettronica qualificata o un'eID con livello di garanzia eIDAS «elevato». In pratica, il registro ti fornisce una dichiarazione sigillata dalla Commissione, e tu la firmi o la sigilli. Lo stato di verifica dura fino alla scadenza dei tuoi mezzi di identificazione, e non oltre tre anni, dopodiché devi verificarti di nuovo.",[11,195,196],{},"Un sigillo qualificato viene rilasciato da un prestatore di servizi fiduciari qualificato, con i propri controlli di identità. Se la tua azienda non ne possiede uno, inizia da qui.",[11,198,199,202],{},[14,200,201],{},"Un amministratore e un account di servizio."," L'amministratore della tua organizzazione crea gli account di servizio nell'interfaccia del registro. Un account di servizio è un'identità non umana legata alla tua organizzazione verificata, e ha bisogno del ruolo che consente di registrare i DPP. L'organizzazione viene ricavata dal token di accesso, quindi non passi mai un ID di organizzazione nella richiesta.",[11,204,205,208,209,212,213,216],{},[14,206,207],{},"Classificazione del prodotto."," Ogni invio indica un gruppo e un sottogruppo di prodotti, che ricavi da ",[170,210,211],{},"GET \u002Fapi\u002Fv1\u002Fdpp\u002Fproduct-groups"," anziché codificarli a mano. Oggi quella chiamata restituisce un solo gruppo, ",[170,214,215],{},"BATTERIES",", con i sottogruppi EV, LMT e industriali.",[43,218,220],{"id":219},"come-si-autentica-un-account-di-servizio","Come si autentica un account di servizio?",[11,222,223,224,227],{},"Il registro usa le credenziali client OAuth 2.0 con ",[170,225,226],{},"private_key_jwt",". La guida è netta: «I client secret condivisi non sono supportati.» Il tuo sistema conserva una chiave privata, firma un'asserzione di breve durata e la scambia con un token di accesso.",[11,229,230],{},"I dettagli che coglieranno in fallo molti:",[18,232,233,239,249,255,261],{},[21,234,235,238],{},[14,236,237],{},"Solo chiavi a curva ellittica"," (ES256, ES384 o ES512). Le chiavi RSA non sono accettate. Carichi la chiave pubblica come JWK o PEM, e la guida raccomanda di conservare la chiave privata in un modulo di sicurezza hardware.",[21,240,241,244,245,248],{},[14,242,243],{},"Asserzioni brevi."," L'asserzione client dovrebbe scadere tra 60 e 120 secondi, mai oltre 5 minuti, con un ",[170,246,247],{},"jti"," nuovo ogni volta.",[21,250,251,254],{},[14,252,253],{},"Un indicatore di risorsa."," La richiesta di token deve indicare il registro come risorsa, usando il valore pubblicato per ciascun ambiente.",[21,256,257,260],{},[14,258,259],{},"Token brevi."," I token di accesso durano al massimo 15 minuti, quindi il tuo client deve rinnovarli durante le esecuzioni di batch lunghe.",[21,262,263,266],{},[14,264,265],{},"Limiti."," Fino a 5 account di servizio per organizzazione e 2 credenziali attive per account, ed è questo che rende possibile la rotazione delle chiavi senza interruzioni. Si raccomanda che le credenziali durino un anno, al massimo due.",[11,268,269],{},"Se una piattaforma registra i passaporti per tuo conto, il modello descritto dai documenti della versione 1.0 è un account di servizio all'interno della tua organizzazione verificata. È così che funziona l'integrazione oggi, ma non è l'unica via consentita dalla legge. Il regolamento di esecuzione prevede anche terzi verificati che agiscono per conto di un operatore: l'articolo 6, paragrafo 1, consente agli operatori verificati di delegare diritti di accesso a terzi laddove il diritto dell'Unione lo preveda, l'articolo 8, paragrafo 2, consente in tal caso a un terzo verificato di eseguire azioni di registrazione, e l'articolo 19, paragrafo 4, impone a un terzo autorizzato da un operatore di sottoporsi a una propria verifica. Il registro terrà inoltre un elenco dei fornitori di servizi DPP verificati (articolo 3, lettera f)). Come funzionerà tecnicamente tale delega non è ancora descritto nelle guide all'integrazione. Qualunque sia la via utilizzata, l'operatore economico resta pienamente responsabile della conformità.",[43,271,273],{"id":272},"come-funziona-un-invio-di-registrazione","Come funziona un invio di registrazione?",[11,275,276],{},"Il flusso prevede quattro chiamate. Recuperi i gruppi di prodotti, invii, poi monitori l'attività tramite quella che la Commissione chiama Activity Dashboard API.",[278,279,284],"pre",{"className":280,"code":281,"language":282,"meta":283,"style":283},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","POST \u002Fapi\u002Fv1\u002Fdpp\u002Fsubmission\nAuthorization: Bearer \u003Caccess token>\nIdempotency-Key: 7f3c9a2e-batch-2027-02-01-001\nContent-Type: application\u002Fjson\n\n{\n  \"productGroup\": \"BATTERIES\",\n  \"productSubGroup\": \"EV\",\n  \"submissionItems\": [\n    {\n      \"uniqueProductIdentifier\": \"https:\u002F\u002Fexample.com\u002Fdpp\u002Fbattery\u002F0001\",\n      \"granularity\": \"item\",\n      \"batchIdentifier\": \"xxx-000\",\n      \"modelIdentifier\": \"yyy-111\"\n    }\n  ]\n}\n","http","",[170,285,286,294,300,306,312,319,325,331,337,343,349,355,361,367,373,379,385],{"__ignoreMap":283},[287,288,291],"span",{"class":289,"line":290},"line",1,[287,292,293],{},"POST \u002Fapi\u002Fv1\u002Fdpp\u002Fsubmission\n",[287,295,297],{"class":289,"line":296},2,[287,298,299],{},"Authorization: Bearer \u003Caccess token>\n",[287,301,303],{"class":289,"line":302},3,[287,304,305],{},"Idempotency-Key: 7f3c9a2e-batch-2027-02-01-001\n",[287,307,309],{"class":289,"line":308},4,[287,310,311],{},"Content-Type: application\u002Fjson\n",[287,313,315],{"class":289,"line":314},5,[287,316,318],{"emptyLinePlaceholder":317},true,"\n",[287,320,322],{"class":289,"line":321},6,[287,323,324],{},"{\n",[287,326,328],{"class":289,"line":327},7,[287,329,330],{},"  \"productGroup\": \"BATTERIES\",\n",[287,332,334],{"class":289,"line":333},8,[287,335,336],{},"  \"productSubGroup\": \"EV\",\n",[287,338,340],{"class":289,"line":339},9,[287,341,342],{},"  \"submissionItems\": [\n",[287,344,346],{"class":289,"line":345},10,[287,347,348],{},"    {\n",[287,350,352],{"class":289,"line":351},11,[287,353,354],{},"      \"uniqueProductIdentifier\": \"https:\u002F\u002Fexample.com\u002Fdpp\u002Fbattery\u002F0001\",\n",[287,356,358],{"class":289,"line":357},12,[287,359,360],{},"      \"granularity\": \"item\",\n",[287,362,364],{"class":289,"line":363},13,[287,365,366],{},"      \"batchIdentifier\": \"xxx-000\",\n",[287,368,370],{"class":289,"line":369},14,[287,371,372],{},"      \"modelIdentifier\": \"yyy-111\"\n",[287,374,376],{"class":289,"line":375},15,[287,377,378],{},"    }\n",[287,380,382],{"class":289,"line":381},16,[287,383,384],{},"  ]\n",[287,386,388],{"class":289,"line":387},17,[287,389,390],{},"}\n",[11,392,393,394,397,398,401],{},"Questo corpo segue l'esempio ufficiale. ",[170,395,396],{},"uniqueProductIdentifier"," e ",[170,399,400],{},"granularity"," (articolo, lotto o modello) sono obbligatori per ogni elemento; gli identificativi di lotto e di modello sono facoltativi.",[11,403,404,405,408,409,412,413,416,417,420],{},"Il registro risponde ",[170,406,407],{},"202 Accepted"," con un ",[170,410,411],{},"taskId",". Un 202 significa soltanto che la richiesta è stata accettata per l'elaborazione. Poi interroghi ",[170,414,415],{},"GET \u002Fapi\u002Fv1\u002Ftasks\u002F{taskId}"," e, quando ti serve sapere quali elementi sono stati accettati, ",[170,418,419],{},"GET \u002Fapi\u002Fv1\u002Ftasks\u002F{taskId}\u002Fitems",", che restituisce JSON o CSV.",[11,422,423,424,427,428,431,432,431,435,438,439,442,443,446,447,438,450,453,454,456,457,459,460,462],{},"Contano due campi di stato, e significano cose diverse. Lo ",[170,425,426],{},"status"," dell'attività passa per ",[170,429,430],{},"PENDING",", ",[170,433,434],{},"PROCESSING",[170,436,437],{},"COMPLETED"," o ",[170,440,441],{},"ERROR",". Una volta completata, ",[170,444,445],{},"outcomeResult"," indica ",[170,448,449],{},"SUCCEEDED",[170,451,452],{},"FAILED",". Un'attività può essere ",[170,455,437],{}," con esito ",[170,458,452],{},": l'elaborazione ha funzionato, ma i tuoi dati non hanno superato i controlli. ",[170,461,441],{}," è un guasto tecnico lato registro.",[11,464,465,466,469],{},"Non ci sono webhook. La guida raccomanda di interrogare a 1, 1, 2, 3, 5, 8, 13, 21, 34 e 55 secondi, poi al massimo ogni 60 secondi, e un'intestazione ",[170,467,468],{},"Retry-After"," prevale sempre sulla tua pianificazione.",[11,471,472],{},"La regola che dovrebbe guidare la progettazione dei batch è l'atomicità. Un invio contiene da 1 a 100 passaporti dello stesso gruppo e sottogruppo di prodotti e, se anche uno solo non è conforme, nessuno viene registrato, compresi quelli che hanno superato i controlli. Un record errato in un batch da 100 blocca 99 record validi. Noi convalideremmo ogni passaporto in locale rispetto agli schemi pubblicati prima dell'invio, terremmo i batch più piccoli finché i dati non si sono stabilizzati e reinvieremmo rapidamente gli elementi corretti dopo un fallimento.",[11,474,475,476,479],{},"L'intestazione ",[170,477,478],{},"Idempotency-Key"," è obbligatoria, fino a 128 caratteri. Riprovare con la stessa chiave restituisce l'attività originale anziché crearne un duplicato, ed è ciò che vuoi dopo un timeout o un 500. Un invio modificato richiede una nuova chiave; riutilizzare una chiave per contenuti diversi restituisce un 409.",[58,481,482,492],{},[61,483,484],{},[64,485,486,489],{},[67,487,488],{},"Limite o regola",[67,490,491],{},"Valore",[77,493,494,502,510,518,526,534,541,549,557,565,573,581,589],{},[64,495,496,499],{},[82,497,498],{},"Passaporti per invio",[82,500,501],{},"Da 1 a 100, stesso gruppo e sottogruppo di prodotti",[64,503,504,507],{},[82,505,506],{},"Dimensione massima del corpo della richiesta",[82,508,509],{},"10 MB",[64,511,512,515],{},[82,513,514],{},"Comportamento del batch",[82,516,517],{},"Tutto o niente",[64,519,520,523],{},[82,521,522],{},"Formato dell'UPI",[82,524,525],{},"URL HTTPS, raggiungibile al momento dell'invio",[64,527,528,531],{},[82,529,530],{},"Granularità",[82,532,533],{},"Obbligatoria: articolo, lotto o modello",[64,535,536,538],{},[82,537,478],{},[82,539,540],{},"Obbligatoria, max 128 caratteri",[64,542,543,546],{},[82,544,545],{},"Durata del token di accesso",[82,547,548],{},"Max 15 minuti",[64,550,551,554],{},[82,552,553],{},"Durata dell'asserzione client",[82,555,556],{},"Da 60 a 120 secondi raccomandati, max 5 minuti",[64,558,559,562],{},[82,560,561],{},"Tipi di chiave",[82,563,564],{},"Solo EC: ES256, ES384, ES512",[64,566,567,570],{},[82,568,569],{},"Account di servizio",[82,571,572],{},"Max 5 per organizzazione, 2 credenziali attive ciascuno",[64,574,575,578],{},[82,576,577],{},"Aggiornamenti di stato",[82,579,580],{},"Solo polling, nessun webhook",[64,582,583,586],{},[82,584,585],{},"Reindirizzamenti seguiti nel recupero di un passaporto",[82,587,588],{},"Max 3 sull'intera catena",[64,590,591,594],{},[82,592,593],{},"Prova di registrazione",[82,595,596],{},"Sigillata dalla Commissione, disponibile per 90 giorni",[11,598,599],{},"I codici di errore sono quelli convenzionali (400, 403, 409, 413, 422, 429, 500), e per ciascuno la guida indica se riprovare con la stessa chiave o con una nuova. Un 403 di solito significa che l'organizzazione non è verificata o che l'account di servizio non ha il ruolo di registrazione.",[43,601,603],{"id":602},"che-cosa-cambia-se-ospiti-i-passaporti-in-proprio","Che cosa cambia se ospiti i passaporti in proprio?",[11,605,606],{},"I passaporti delle batterie contengono dati pubblici e riservati, e il registro li legge entrambi durante la convalida. Se il passaporto si trova sul tuo server, quel server deve riconoscere il registro e mostrargli più di quanto mostra al pubblico.",[11,608,609,610,613],{},"Il tuo host dei passaporti funge da resource server OAuth 2.0. Il registro richiede prima l'UPI senza credenziali e si aspetta il passaporto pubblico. Poi richiede lo stesso URL con un bearer token emesso dal servizio di autenticazione della Commissione, e si aspetta i dati pubblici più quelli riservati. Il token è breve (ES384, al massimo 120 secondi), riporta lo scope ",[170,611,612],{},"dpp:registry:read"," ed è indirizzato all'origine HTTPS del tuo host. Lo convalidi solo rispetto alle chiavi del JWKS pubblicato dalla Commissione, mai rispetto a chiavi indicate all'interno del token.",[11,615,616,617,620],{},"Le regole di risposta sono rigide. Nessun token: restituisci il passaporto pubblico. Token valido e richiedente autorizzato: restituisci dati pubblici più riservati. Un token presente ma non valido: restituisci 401, senza ripiego sulla vista pubblica. Token valido con scope o richiedente sbagliati: 403. Invia ",[170,618,619],{},"Vary: Authorization"," in modo che le cache tengano separate le due versioni, e usa TLS 1.2 o successivo. JSON è il formato di risposta di base; sono accettati anche JSON-LD e XML.",[11,622,623,624,628],{},"La guida descrive un solo chiamante, il registro stesso. Non spiega come si autenticheranno le autorità, i riciclatori o le altre parti con un interesse legittimo, quindi ti servirà una risposta separata per loro; la nostra guida ai ",[37,625,627],{"href":626},"\u002Fguides\u002Fdigital-product-passport-access-rights\u002F","diritti di accesso al passaporto digitale di prodotto"," spiega chi ha diritto a cosa. Nemmeno gli identificativi univoci degli operatori vengono ancora elaborati; la guida li prevede per una versione futura.",[630,631,633],"h3",{"id":632},"dove-si-inserisce-gs1-digital-link","Dove si inserisce GS1 Digital Link",[11,635,636,637,640],{},"Il registro segue i reindirizzamenti, al massimo tre sull'intera risoluzione, e risolve l'UPI e ogni reindirizzamento senza credenziali, quindi ogni passaggio deve essere raggiungibile pubblicamente. Questo è compatibile con un resolver. Un URI GS1 Digital Link sul tuo dominio, come ",[170,638,639],{},"https:\u002F\u002Fid.yourbrand.com\u002F01\u002F09520123456788\u002F21\u002FSN0001",", è un modo per dare a ogni batteria un identificativo HTTPS persistente che porta al suo passaporto e funziona anche come QR code sul prodotto. Non è obbligatorio; qualsiasi URL HTTPS stabile soddisfa la regola di formato dell'API. Se usi un resolver, conta i passaggi: una catena dal dominio del QR al resolver al fornitore di hosting all'URL finale li usa già tutti e tre. La guida consiglia inoltre di evitare reindirizzamenti dopo l'autenticazione, quindi la richiesta autorizzata dovrebbe arrivare direttamente al passaporto.",[43,642,644],{"id":643},"rispetto-a-quali-modelli-di-dati-convalida-il-registro","Rispetto a quali modelli di dati convalida il registro?",[11,646,647],{},"Lo ZIP Semantic Data Artifacts contiene i modelli che il registro verifica. Oggi ne esistono solo due: un modello core e un modello batteries, entrambi 1.0.0, con schemi per i sottogruppi delle batterie EV, LMT e industriali. Ciascuno è fornito come JSON Schema (draft 2020-12), contesti JSON-LD, shape SHACL e vocabolari SKOS, più un catalogo DCAT-AP. La guida descrive anche XSD, che non è incluso in questa versione.",[11,649,650,651,654,655,431,658,431,661,664],{},"Gli schemi sono suddivisi per livello di accesso: una vista pubblica (",[170,652,653],{},"pub",") e tre viste riservate (",[170,656,657],{},"res1",[170,659,660],{},"res2",[170,662,663],{},"res3","). Il tuo passaporto deve presentare i campi giusti al richiedente giusto, e lo schema ti dice quali campi stanno dove. Lo ZIP include anche istanze di esempio conformi a ciascuno schema, che sono un buon primo set di dati di test.",[11,666,667,668,672,673,677],{},"Sono descritte quattro serializzazioni (JSON, JSON-LD, XML e RDF), ma solo JSON è obbligatorio per la registrazione, in linea con la EN 18216:2026. La guida cita anche la EN 18223:2026 sull'interoperabilità. Spieghiamo entrambe le norme nella ",[37,669,671],{"href":670},"\u002Fit\u002Fguide\u002Fnorme-cen-dpp\u002F","guida alle norme CEN sul DPP",", e perché i dati strutturati sono importanti nella nostra guida al ",[37,674,676],{"href":675},"\u002Fit\u002Fguide\u002Fpassaporto-digitale-prodotto-leggibile-da-macchina\u002F","passaporto digitale di prodotto leggibile da macchina",". L'articolo 12 del regolamento di esecuzione aggiunge che il repository semantico è di uso gratuito e dispone di API pubbliche.",[43,679,681],{"id":680},"che-cosa-aggiungono-le-linee-guida-sulle-batterie-v32","Che cosa aggiungono le linee guida sulle batterie v3.2?",[11,683,684,685,690],{},"Il documento ",[37,686,689],{"href":687,"rel":688},"https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport\u002Fbatteries_en",[54],"Guidance Document: Digital Batteries Passport, data points by category",", versione 3.2 del 19 ottobre 2026, elenca 71 dati per le batterie EV, LMT e industriali. Si tratta di linee guida e dichiara esso stesso di non essere giuridicamente vincolante; gli obblighi derivano dal regolamento sulle batterie (UE) 2023\u002F1542.",[11,692,693,694,397,696,699],{},"Per ogni dato e categoria di batteria indica uno stato: obbligatorio; facoltativo, da compilare se il dato è disponibile; se applicabile; solo per determinati tipi di batteria; oppure da non compilare né visualizzare a febbraio 2027. Quest'ultimo stato è quello utile per la pianificazione. La dichiarazione e l'etichetta relative all'impronta di carbonio, per esempio, sono indicate come da non compilare a febbraio 2027 perché il loro formato attende ancora un atto di esecuzione, e le istruzioni per l'uso sono sospese in attesa dell'Omnibus. Ogni dato riporta anche un livello di accesso: pubblico, riservato alle persone con un interesse legittimo, agli organismi notificati, alle autorità degli Stati membri e alla Commissione, oppure livelli riservati più ristretti. Sono questi i livelli che le viste di schema ",[170,695,653],{},[170,697,698],{},"res"," implementano.",[11,701,702,703,707],{},"La nostra ",[37,704,706],{"href":705},"\u002Fit\u002Fguide\u002Fpassaporto-della-batteria\u002F","guida al passaporto della batteria"," tratta i requisiti giuridici. Per il lavoro di integrazione, usa la v3.2 come tabella di corrispondenza tra i tuoi dati di prodotto e i campi dello schema.",[43,709,711],{"id":710},"che-cosa-è-deciso-e-che-cosa-è-ancora-aperto","Che cosa è deciso e che cosa è ancora aperto?",[11,713,714],{},"Deciso: gli endpoint, il modello di autenticazione, la regola del batch atomico, il polling, il modello di dati delle batterie e il requisito che i passaporti siano online al momento dell'invio. La verifica tramite sigillo qualificato è prevista dal regolamento di esecuzione stesso.",[11,716,717],{},"Ancora aperto a novembre 2026: come funzionerà tecnicamente la registrazione da parte di terzi verificati per conto di un operatore, i modelli di dati per tutto ciò che non sono batterie, il formato dell'impronta di carbonio, come le altre parti si autenticano presso i passaporti ospitati in proprio e gli identificativi univoci degli operatori. Il regolamento di esecuzione copre anche i prodotti da costruzione, i giocattoli e i detergenti, che non hanno ancora un modello di dati; per i prodotti diversi dalle batterie, gli obblighi decorrono almeno 18 mesi dopo ciascun atto delegato. Gli Stati membri devono designare i propri amministratori nazionali del registro entro il 18 febbraio 2027 (articolo 7).",[43,719,721],{"id":720},"le-imperfezioni-dei-documenti-della-versione-10","Le imperfezioni dei documenti della versione 1.0",[11,723,724],{},"Una prima versione presenta sempre incoerenze, e queste conviene conoscerle prima di scrivere codice:",[18,726,727,742,745,756],{},[21,728,729,730,733,734,737,738,741],{},"La guida Service Account indica come base dell'API ",[170,731,732],{},"reg.product-passport.ec.europa.eu",", mentre i file OpenAPI usano ",[170,735,736],{},"registry.product-passport.ec.europa.eu"," (e ",[170,739,740],{},"registry.acc.product-passport.ec.europa.eu"," per l'ambiente di accettazione). Verifica il valore attuale nel registro prima di configurare la produzione.",[21,743,744],{},"Il limite di 100 elementi è indicato nella guida ma non imposto nello schema OpenAPI, quindi un client generato dallo schema costruirà senza problemi una richiesta da 101 elementi.",[21,746,747,748,751,752,755],{},"La guida all'integrazione dice che gli errori restituiscono l'identificativo come ",[170,749,750],{},"traceId",", mentre lo schema di errore OpenAPI lo chiama ",[170,753,754],{},"correlationId",". Registrali entrambi nei log.",[21,757,758,759,762,763,766],{},"L'API usa il codice di sottogruppo ",[170,760,761],{},"EV",", mentre gli artefatti semantici usano ",[170,764,765],{},"evb"," nei loro percorsi. Mappali esplicitamente.",[11,768,769],{},"Nessuno di questi punti blocca l'integrazione, ma ricontrollali a ogni nuova versione dei documenti.",[43,771,773],{"id":772},"che-cosa-fare-adesso","Che cosa fare adesso",[775,776,777,783,789,795,801,807,813,819],"ol",{},[21,778,779,782],{},[14,780,781],{},"Ottieni un sigillo elettronico qualificato"," da un prestatore di servizi fiduciari qualificato, se la tua azienda non ne possiede già uno, e verifica la tua organizzazione nel registro. È la voce con i tempi più lunghi di tutto questo elenco.",[21,784,785,788],{},[14,786,787],{},"Iscriviti all'ambiente di accettazione"," e nomina un amministratore che possa creare account di servizio.",[21,790,791,794],{},[14,792,793],{},"Decidi dove risiedono i passaporti:"," sul tuo server, che dovrà allora implementare le regole di autenticazione per l'hosting in proprio, oppure presso un fornitore che lo fa già.",[21,796,797,800],{},[14,798,799],{},"Definisci i tuoi UPI."," Scegli uno schema di URL HTTPS stabile per ogni batteria, decidi la granularità per articolo, lotto o modello e conta i reindirizzamenti nella catena.",[21,802,803,806],{},[14,804,805],{},"Mappa i tuoi dati sulla v3.2 e sugli schemi batteries,"," campo per campo, comprese le viste pubbliche e riservate. Segna ciò che non è richiesto a febbraio 2027, così nessuno ci perde tempo.",[21,808,809,812],{},[14,810,811],{},"Convalida in locale prima di inviare,"," rispetto ai JSON Schema forniti, e progetta i batch in modo che un record errato non blocchi gli altri.",[21,814,815,818],{},[14,816,817],{},"Costruisci il client come si deve:"," chiavi EC in un HSM, rinnovo dei token, chiavi di idempotenza riproducibili, polling secondo Fibonacci e archiviazione di ogni prova di registrazione.",[21,820,821,824],{},[14,822,823],{},"Esegui un test completo nell'ambiente di accettazione"," con largo anticipo rispetto al 18 febbraio 2027, compresi un batch fallito e una rotazione delle chiavi.",[11,826,827,828,832],{},"Digital Link è un solution partner GS1, e la nostra piattaforma costruisce passaporti delle batterie e dei prodotti su un identificativo GS1 Digital Link persistente per ogni prodotto, con dati pubblici e riservati serviti dallo stesso record. Stiamo preparando la nostra integrazione con il registro. Questo comporta tre passaggi distinti: ottenere il nostro sigillo elettronico qualificato, completare la nostra verifica nel registro, e costruire e testare la connessione API. Non siamo ancora collegati al registro. Se vuoi pianificare la tua integrazione con il registro, o verificare se i dati dei tuoi passaporti supereranno la convalida, ",[37,829,831],{"href":830},"mailto:support@digital-link.com","contattaci"," e il nostro team esaminerà il tuo caso.",[43,834,836],{"id":835},"domande-frequenti","Domande frequenti",[630,838,840],{"id":839},"lapi-del-registro-dpp-è-obbligatoria","L'API del registro DPP è obbligatoria?",[11,842,843],{},"No. L'articolo 8, paragrafo 6, del regolamento di esecuzione (UE) 2026\u002F1778 consente la registrazione tramite l'interfaccia utente o l'API. In pratica, chiunque registri più di una manciata di passaporti vorrà usare l'API.",[630,845,847],{"id":846},"il-registro-conserva-i-dati-del-mio-passaporto","Il registro conserva i dati del mio passaporto?",[11,849,850],{},"No. Recupera il passaporto dal suo URL al momento dell'invio per convalidarlo, e la guida all'integrazione afferma che non conserva in modo persistente il contenuto recuperato. Il passaporto resta dove lo ospiti, ed è per questo che deve essere raggiungibile al momento dell'invio.",[630,852,854],{"id":853},"posso-usare-una-chiave-rsa-o-un-client-secret-per-il-mio-account-di-servizio","Posso usare una chiave RSA o un client secret per il mio account di servizio?",[11,856,857,858,860],{},"No. Gli account di servizio si autenticano con ",[170,859,226],{}," usando chiavi a curva ellittica (ES256, ES384 o ES512). I client secret condivisi e le chiavi RSA non sono supportati.",[630,862,864],{"id":863},"che-cosa-succede-se-un-passaporto-di-un-batch-non-supera-la-convalida","Che cosa succede se un passaporto di un batch non supera la convalida?",[11,866,867,868,870],{},"L'intero invio fallisce e nessuno dei suoi passaporti viene registrato. L'attività si completa con esito ",[170,869,452],{},", e i risultati per elemento ti dicono quali elementi l'hanno causato. Correggili e reinvia con una nuova chiave di idempotenza.",[630,872,874],{"id":873},"mi-serve-gs1-digital-link-per-registrare-un-passaporto","Mi serve GS1 Digital Link per registrare un passaporto?",[11,876,877],{},"No. L'identificativo univoco del prodotto deve essere un URL HTTPS che risolve al passaporto. Un URI GS1 Digital Link sul tuo dominio è un modo per soddisfare questo requisito, e funge anche da QR code del prodotto, ma è accettato qualsiasi URL HTTPS stabile.",[630,879,881],{"id":880},"quando-devono-essere-registrati-i-passaporti-delle-batterie","Quando devono essere registrati i passaporti delle batterie?",[11,883,884],{},"Per le batterie per veicoli elettrici, le batterie LMT e le batterie industriali superiori a 2 kWh, l'obbligo del passaporto della batteria ai sensi del regolamento (UE) 2023\u002F1542 si applica dal 18 febbraio 2027. Il registro e il suo ambiente di accettazione sono già aperti, quindi c'è tempo per testare prima.",[886,887,888],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":283,"searchDepth":302,"depth":302,"links":890},[891,892,893,894,895,896,899,900,901,902,903,904],{"id":45,"depth":296,"text":46},{"id":157,"depth":296,"text":158},{"id":183,"depth":296,"text":184},{"id":219,"depth":296,"text":220},{"id":272,"depth":296,"text":273},{"id":602,"depth":296,"text":603,"children":897},[898],{"id":632,"depth":302,"text":633},{"id":643,"depth":296,"text":644},{"id":680,"depth":296,"text":681},{"id":710,"depth":296,"text":711},{"id":720,"depth":296,"text":721},{"id":772,"depth":296,"text":773},{"id":835,"depth":296,"text":836,"children":905},[906,907,908,909,910,911],{"id":839,"depth":302,"text":840},{"id":846,"depth":302,"text":847},{"id":853,"depth":302,"text":854},{"id":863,"depth":302,"text":864},{"id":873,"depth":302,"text":874},{"id":880,"depth":302,"text":881},null,"Le specifiche dell'API del registro DPP sono uscite. Registrazione, account di servizio, passaporti ospitati in proprio e cosa fare prima del 18 febbraio 2027.","md","API del registro DPP: come registrare i passaporti delle batterie presso l'UE, passo dopo passo","Due ingegneri in un laboratorio di prova per batterie: lei indica un portatile, lui tiene un modulo batteria con una piccola etichetta con codice QR","article",{},"\u002Fimages\u002F2026\u002F11\u002Fdpp-registry-api-hero.webp","\u002Fit\u002Fguide\u002Fapi-del-registro-dpp","2026-11-10T13:00:00+01:00",{"title":5,"description":913},"\u002Fit\u002Fguide\u002Fapi-del-registro-dpp\u002F","it\u002Fguide\u002Fapi-del-registro-dpp","2_F5xBhWCXuJHgaKThm5CM6ntGSvt2HYfS9ysy_AWk8",[927,934,940],{"path":928,"sourcePath":929,"title":930,"heading":931,"ogImage":932,"publishedAt":933},"\u002Fit\u002Fguide\u002Fcommercio-agentico","\u002Fit\u002Fguide\u002Fcommercio-agentico\u002F","Commercio agentico: come comprano gli agenti IA","Commercio agentico: come comprano gli agenti IA e cosa serve al tuo prodotto","\u002Fimages\u002F2026\u002F11\u002Fagentic-commerce-hero.webp","2026-11-03T12:13:00+01:00",{"path":935,"sourcePath":675,"title":936,"heading":937,"ogImage":938,"publishedAt":939},"\u002Fit\u002Fguide\u002Fpassaporto-digitale-prodotto-leggibile-da-macchina","Il passaporto digitale del prodotto leggibile da macchina","Il passaporto digitale del prodotto leggibile da macchina: cosa richiede l'ESPR e perché lo leggeranno gli agenti IA","\u002Fimages\u002F2026\u002F11\u002Fmachine-readable-digital-product-passport-hero.webp","2026-11-02T11:00:00+01:00",{"path":941,"sourcePath":942,"title":943,"heading":944,"ogImage":945,"publishedAt":946},"\u002Fit\u002Fguide\u002Fautenticazione-prodotti-agenti-ia","\u002Fit\u002Fguide\u002Fautenticazione-prodotti-agenti-ia\u002F","Autenticazione dei prodotti per agenti IA: cosa si verifica","Autenticazione dei prodotti per agenti IA: come un agente verifica che un prodotto sia autentico","\u002Fimages\u002F2026\u002F11\u002Fproduct-authentication-for-ai-agents-hero.webp","2026-10-30T12:13:00+01:00",1794322890684]