Vai al contenuto

Campi

Campi della categoria Prodotto generico

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. ["…"]

Identificazione del prodotto

product_nameNome del prodotto

Denominazione commerciale del prodotto

Compare come titolo sul passaporto pubblico e nelle ricerche.

Tipo

text

Pubblicazione

La pubblicazione lo richiede.

Livello di accesso

public Pubblico

gtinGTIN

Ha già un codice a barre? Il numero sotto è il Suo GTIN. Obbligatorio per la pubblicazione.

Il GTIN collega il passaporto digitale al codice a barre fisico presente sull'etichetta.

Tipo

text

Formato

format_gtin La pubblicazione rifiuta un valore in un altro formato.

Pubblicazione

La pubblicazione lo richiede.

Conta anche una taglia o un colore salvati con un proprio codice a barre.

Fonti
  • GS1 / GTIN GS1 General Specifications voluntary
  • ESPR (Reg (EU) 2024/1781) Annex III(b), (c) anticipated

Lo stato è la classificazione propria dell’endpoint.

Livello di accesso

public Pubblico

serial_numberNumero di serie

Numero di serie a livello di singolo articolo per l'identificazione univoca

Tipo

text

Fonti
  • GPSR (Reg (EU) 2023/988) Art. 9 in_force
Livello di accesso

public Pubblico

product_descriptionDescrizione del prodotto

Descrizione chiara del prodotto e del suo uso previsto

Tipo

text

Pubblicazione

La pubblicazione lo richiede.

Livello di accesso

public Pubblico

product_categoryCategoria di prodotto

Tipologia generale del prodotto (es. T-Shirt, Giacca, Biancheria). Facoltativo — utile per organizzare i passaporti.

Tipo

text

Livello di accesso

public Pubblico

markets_sold_intoMercati di commercializzazione

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
  • EU Unione europea / SEE (generale)
  • FR Francia
  • DE Germania
  • IT Italia
  • ES Spagna
  • NL Paesi Bassi
  • BE Belgio
  • PL Polonia
  • UK Regno Unito
  • US Stati Uniti
  • OTHER Altro / resto del mondo

La pubblicazione può rifiutare un valore fuori dall’elenco. POST …/validate indica quale.

Livello di accesso

restricted Riservato

Fabbricante / Operatore economico

manufacturer_nameNome del fabbricante

Il nome, la denominazione commerciale registrata o il marchio registrato del fabbricante.

Tipo

text

Pubblicazione

La pubblicazione lo richiede.

Fonti
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Livello di accesso

public Pubblico

manufacturer_addressIndirizzo del fabbricante

L'indirizzo postale del fabbricante. Se un punto unico di contatto ha un indirizzo postale diverso, indichi anche quello.

Tipo

text

Pubblicazione

La pubblicazione lo richiede.

Fonti
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Livello di accesso

public Pubblico

manufacturer_countryPaese del fabbricante

Selezioni il paese del fabbricante.

Tipo

text

Formato

format_country_code La pubblicazione rifiuta un valore in un altro formato.

Pubblicazione

La pubblicazione lo richiede.

Fonti
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Livello di accesso

public Pubblico

manufacturer_emailEmail del fabbricante

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.

Fonti
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force_conditional

    Si applicano condizioni. L’endpoint le restituisce in regulatory_basis[].applies_when.

Livello di accesso

public Pubblico

manufacturer_websiteSito web del fabbricante

Il sito web del fabbricante.

Tipo

url

Livello di accesso

public Pubblico

eori_numberNumero EORI

Numero di registrazione e identificazione degli operatori economici per le dogane dell'UE

Tipo

text

Formato

format_eori La pubblicazione rifiuta un valore in un altro formato.

Livello di accesso

restricted Riservato

eu_responsible_personResponsabile UE

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

Tipo

text

Fonti
  • GPSR (Reg (EU) 2023/988) Art. 16(1) in_force
  • Market Surveillance Reg (EU) 2019/1020 Art. 4 in_force
  • ESPR (Reg (EU) 2024/1781) Annex III(k) anticipated
Livello di accesso

public Pubblico

eu_importerImportatore UE

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.

Tipo

text

Fonti
  • GPSR (Reg (EU) 2023/988) Art. 11(3) in_force_conditional

    Si applicano condizioni. L’endpoint le restituisce in regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Art. 29(3) anticipated
  • ESPR (Reg (EU) 2024/1781) Annex III(j) anticipated
Livello di accesso

public Pubblico

Dati ambientali

carbon_footprint_valueImpronta di carbonio

Impronta di carbonio del prodotto. Selezioni l'unità di misura corrispondente nell'elenco.

Tipo

number

Unità di misura

Viene inviato in carbon_footprint_unit.

carbon_footprint_unit: kg_co2e, kg_co2e_per_kg, kg_co2e_per_m2

Livello di accesso

public Pubblico

carbon_footprint_unitUnità di misura dell'impronta di carbonio

Unità di misura del valore dell'impronta di carbonio.

Tipo

select

Valori dell’elenco
  • kg_co2e kg CO₂e (per unità)
  • kg_co2e_per_kg kg CO₂e / kg (per peso)
  • kg_co2e_per_m2 kg CO₂e / m² (per superficie)

La pubblicazione può rifiutare un valore fuori dall’elenco. POST …/validate indica quale.

Livello di accesso

public Pubblico

carbon_footprint_basisBase di calcolo dell'impronta di carbonio

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_14067 ISO 14067 (impronta di carbonio del prodotto)
  • pef EU PEF / PEFCR
  • ghg_protocol GHG Protocol Product Standard
  • iso_14040_44 ISO 14040/44 LCA
  • supplier_data Dati fornitore / EPD
  • estimate Stima interna

La pubblicazione può rifiutare un valore fuori dall’elenco. POST …/validate indica quale.

Fonti
  • UCPD (Dir 2005/29/EC) Art. 12 in_force
Livello di accesso

public Pubblico

recyclable_content_percentageContenuto riciclabile (%)

Percentuale del prodotto riciclabile a fine vita

Tipo

number

Limiti

min: 0 max: 100

Livello di accesso

public Pubblico

recycled_content_percentageContenuto riciclato (%)

Percentuale del prodotto realizzata con materiali riciclati

Tipo

number

Limiti

min: 0 max: 100

Fonti
  • AGEC Décret 2022-748 recycled-material % FR in_force_conditional

    Si applicano condizioni. L’endpoint le restituisce in regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Annex I(h) anticipated
Livello di accesso

public Pubblico

Conformità normativa

substances_of_concernSostanze preoccupanti

Elenco delle sostanze preoccupanti presenti sopra le concentrazioni soglia, oppure "nessuna dichiarata"

Tipo

array item_type: string

Fonti
  • REACH (Reg (EC) 1907/2006) Art. 33 in_force
  • SCIP / WFD (Dir 2008/98/EC) Art. 9(1)(i) in_force
  • AGEC Décret 2022-748 Code de l'environnement art. R. 541-228 IX FR in_force_conditional

    Si applicano condizioni. L’endpoint le restituisce in regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Art. 7(5) anticipated
Livello di accesso

public Pubblico

conformity_declaration_urlURL della dichiarazione di conformità

Link alla dichiarazione di conformità UE, oppure carichi il PDF.

Tipo

url

Livello di accesso

authority Solo autorità

Un documento può sostituirlo

conformity_declaration

L’identificativo del documento viene inviato in conformity_declaration_url__document_id.

compliance_standardsStandard di conformità

Selezioni gli standard a cui il Suo prodotto è conforme.

Tipo

multiselect

Valori dell’elenco
  • reach REACH (CE 1907/2006)
  • eu_ecolabel Ecolabel UE

La pubblicazione può rifiutare un valore fuori dall’elenco. POST …/validate indica quale.

Livello di accesso

public Pubblico

Fine vita

recycling_instructionsIstruzioni per il riciclaggio

Istruzioni per il riciclaggio del prodotto a fine vita

Tipo

text

Livello di accesso

public Pubblico

disposal_instructionsIstruzioni per lo smaltimento

Istruzioni per lo smaltimento sicuro se il prodotto non è riciclabile

Tipo

text

Livello di accesso

public Pubblico

Economia circolare

mono_material_percentagePercentuale monomateriale

Percentuale di prodotto costituita da un singolo materiale riciclabile (0-100). I prodotti oltre l'85% sono notevolmente più facili da riciclare.

Tipo

number

Limiti

min: 0 max: 100

Livello di accesso

public Pubblico

recyclability_gradeGrado di riciclabilità

Campo conservato per i valori già inseriti; non è più richiesto.

Tipo

select

Valori dell’elenco
  • A A — Completamente riciclabile (monomateriale, senza contaminanti)
  • B B — Riciclabile con separazione (parti non riciclabili rimovibili)
  • C C — Parzialmente riciclabile (misto, alcuni componenti recuperabili)
  • D D — Difficile da riciclare (miscele complesse, rivestimenti)
  • E E — Non riciclabile (materiali inseparabili o componenti contaminanti)

La pubblicazione può rifiutare un valore fuori dall’elenco. POST …/validate indica quale.

Livello di accesso

public Pubblico

Non mostrato nella pagina pubblica del passaporto. self_declared_label

disassembly_instructions_urlIstruzioni di disassemblaggio

URL della guida per la separazione dei componenti non riciclabili (cerniere, bottoni, rivestimenti) ai fini del riciclaggio — oppure carichi il file.

Tipo

url

Livello di accesso

public Pubblico

Un documento può sostituirlo

document

L’identificativo del documento viene inviato in disassembly_instructions_url__document_id.

takeback_scheme_urlProgramma di ritiro

URL con informazioni sul programma di raccolta o ritiro — oppure carichi il file.

Tipo

url

Fonti
  • ESPR (Reg (EU) 2024/1781) Art. 7(2)(b)(ii) anticipated
Livello di accesso

public Pubblico

Un documento può sostituirlo

document

L’identificativo del documento viene inviato in takeback_scheme_url__document_id.