Tutti i campi di un passaporto di prodotto generico: che cos’è ogni campo, come inviarlo e che cosa richiede la pubblicazione.
Questa pagina elenca ogni campo che GET /categories/{category}/schema restituisce. Alcune righe aggiungono ciò che l’endpoint non restituisce, per esempio il formato che deve avere un valore di testo, i simboli di manutenzione che un campo accetta o le chiavi delle voci di un elenco. Queste informazioni provengono dal codice stesso dell’API. L’endpoint restituisce anche le condizioni e le note che accompagnano ogni riferimento normativo. Questa pagina non elenca i controlli propri di ogni categoria. Uno di questi controlli può comunque richiedere un campo, anche quando la riga del campo non riporta alcuna indicazione sulla pubblicazione, oppure riporta un’eccezione che vale per il Suo prodotto. Un controllo può anche rifiutare un valore. POST …/validate esegue questi controlli sul Suo passaporto e indica ogni problema che trova.
Percorsi, metodi, ambiti, nomi dei campi, codici di errore e nomi delle regole di convalida sono pubblicati in inglese, perché l'inglese è la lingua dell'interfaccia stessa: è ciò che un chiamante digita o confronta. Lo stesso vale per ogni esempio di codice, ogni payload JSON e la frase esatta che una risposta di errore porta con sé: /v1 non legge Accept-Language, e tradurre ciò che l'API invia davvero la descriverebbe in modo scorretto. Tutto ciò che viene scritto al riguardo segue la lingua di questa pagina.
Tipi
text
Una stringa."…"Alcuni campi di testo controllano anche il formato. La loro riga indica il controllo.
multiselect
Un elenco di stringhe.["EU"]
url
Una stringa con un indirizzo web."https://example.com/document.pdf"
number
Un numero.50
select
Una stringa."kg_co2e"
array
Un elenco. La sua riga indica che cosa contiene ogni voce.["…"]
I mercati in cui questo prodotto viene immesso sul mercato. Determina quali norme specifiche si applicano (es. AGEC in Francia). Selezionare esplicitamente Francia (FR) se si vende in Francia.
Utilizzato solo per personalizzare la guida alla conformità — non viene mai mostrato sul passaporto pubblico.
Tipo
multiselect
Valori dell’elenco
Tutti i 11 valori
EUUnione europea / SEE (generale)
FRFrancia
DEGermania
ITItalia
ESSpagna
NLPaesi Bassi
BEBelgio
PLPolonia
UKRegno Unito
USStati Uniti
OTHERAltro / resto del mondo
La pubblicazione può rifiutare un valore fuori dall’elenco. POST …/validate indica quale.
L'indirizzo elettronico del fabbricante, ad esempio un indirizzo email.
Quando si applica il regolamento relativo alla sicurezza generale dei prodotti, esso richiede ai fabbricanti un indirizzo postale e un indirizzo elettronico.
Tipo
text
Formato
format_email La pubblicazione rifiuta un valore in un altro formato.
Nome e contatti del responsabile con sede nell'UE — necessario per vendere nell'UE quando il fabbricante è stabilito fuori dall'UE, salvo che indichi un importatore UE in alternativa
Quando è un'impresa diversa da Lei a immettere il prodotto sul mercato dell'UE, inserisca qui tale importatore. Indichi il suo nome, la sua denominazione commerciale registrata o il suo marchio registrato, il suo indirizzo postale e un indirizzo elettronico, ad esempio un indirizzo email.
L'importatore è un operatore economico distinto dal fabbricante: l'impresa stabilita nell'UE che introduce il prodotto nell'Unione.
Metodo utilizzato per calcolare l'impronta di carbonio.
Questo campo registra il metodo di calcolo. Conservi la documentazione a sostegno dell'impronta di carbonio; selezionare un metodo non dimostra la validità del risultato.
Tipo
select
Valori dell’elenco
iso_14067ISO 14067 (impronta di carbonio del prodotto)
pefEU PEF / PEFCR
ghg_protocolGHG Protocol Product Standard
iso_14040_44ISO 14040/44 LCA
supplier_dataDati fornitore / EPD
estimateStima interna
La pubblicazione può rifiutare un valore fuori dall’elenco. POST …/validate indica quale.