4. Componenti, "Components"
- 4.1 Che cos’è un componente? – Definisce un componente e il suo ruolo.
- 4.2 Come identificare componenti unici – Spiega come distinguere i componenti.
- 4.3 Quali dati sono necessari per i componenti? – Elenca i campi richiesti per importare i dati dei componenti.
- 4.4 Dipendenze da altre entità – Descrive i collegamenti tra i componenti e le altre entità.
- Esempio di dati componenti – Mostra un esempio di foglio excel con dati dei componenti.
4.1 Che cos’è un componente ?
I dati dei componenti comprendono tutti gli elementi che compongono i tuoi prodotti — dai tessuti principali e fodere agli accessori come cerniere, bottoni, suole e tomaie. Ogni componente è costituito da una o più materie prime come cotone, pelle bovina, metallo, poliammide, ecc.

Queste informazioni vengono utilizzate per analisi ambientali dettagliate e mappature approfondite della catena di fornitura — essenziali per calcolare con precisione l’impatto ambientale, comprendere l’origine dei materiali e fornire una trasparenza granulare sulla composizione dei tuoi prodotti.
💡 Suggerimento: considera i componenti come i “mattoni” fondamentali dei tuoi prodotti finiti, ciascuno con una propria composizione e filiera.
💡 Suggerimento: concentra la dichiarazione sui componenti più pesanti per ogni prodotto — in genere tessuti principali e fodere. Elementi minori come etichette o filati possono essere omessi poiché il loro impatto ambientale è trascurabile.
4.2 Come identificare componenti unici
Ogni componente necessita di un identificativo univoco chiamato componentRef, che rappresenta caratteristiche specifiche come composizione, categoria e fornitore.
Importante: se una qualsiasi caratteristica del componente cambia, è necessario creare un nuovo componentRef. Per un dato componentRef, tutti gli altri campi devono essere identici.
💡 Suggerimento: Per prodotti "Fully Factored": se lavori con prodotti finiti e non disponi di informazioni dettagliate sui componenti, l'invio dell’elenco componenti è facoltativo. La piattaforma Fairly Made utilizzerà il nostro framework per generare automaticamente un elenco.
Essempio:

Considera il cappotto con cerniera ZC-001 con 4 componenti:
| componentRef | type | category |
|---|---|---|
| POL-RPOL-WOV-345 | TEXTILE | MAIN FABRIC (WOVEN) |
| RPOL-WOV-350 | TEXTILE | LININGS |
| ZIP_001_897 | PLASTIC | ZIPS |
| RPOL-FOA-999 | PLASTIC | STUFFINGS |
| POL-RPOL-WOV-345_Lining | TEXTILE | LININGS |
Se si utilizza lo stesso tessuto del componente POL-RPOL-WOV-345 come fodera, occorre creare una nuova referenza, ad esempio: POL-RPOL-WOV-345_Lining.
4.3 Quali dati sono necessari per i componenti ?
Questa sezione descrive tutti i campi richiesti per importare i dati dei componenti. È essenziale comprenderne le definizioni e i vincoli per garantire un’importazione corretta.
Tutti i campi contrassegnati con ⭐️ sono obbligatori e quelli contrassegnati con ★ sono obbligatori per alcune funzionalità.
💡 Hai bisogno di aiuto? Se non hai informazioni dettagliate su alcuni campi, contatta il tuo analista Fairly Made per ricevere assistenza.
componentRef ⭐️
Codice interno o referenza per questo componente. Rende il componente unico nel sistema Fairly Made.
- Formato: lettere e numeri, massimo 70 caratteri.
supplierRef ⭐️
Codice interno del fornitore di questo componente.
Perché è importante: il fornitore riceverà dei form tecnici (Material Forms) relativi ai componenti.
- Formato: deve corrispondere esattamente a un fornitore esistente nei dati fornitori.
productRef ⭐️
Codice interno del prodotto associato a questo componente.
- Formato: deve corrispondere a un prodotto esistente, massimo 70 caratteri.
productCollectionRef ⭐️
Nome o codice della collezione di appartenenza del prodotto.
- Formato : deve corrispondere esattamente a una collezione esistente.
type ⭐️
Seleziona il tipo di componente dalla lista predefinita (es.: TEXTILE, LEATHER, ecc.)
- Dove trovare le opzioni: Tassonomia COMPONENT_TYPE
category ⭐️
Seleziona la categoria del componente (es.: LININGS, MAIN FABRIC (WOVEN), STUFFINGS, ecc.)
- Dove trovare le opzioni: Tassonomia COMPONENT_CATEGORY
composition ⭐️
La composizione esatta del componente in percentuale per ogni materia prima.
Perché è importante: sarà confrontato con quello dichiarato dal fornitore. Se c'è una discrepanza, si può scegliere quale utilizzare per i calcoli.
- Dove trovare le opzioni: Tassonomia RAW_MATERIALS
- Formato: [NUMBER]% [RAW_MATERIALS] ; [NUMBER]% [RAW_MATERIALS]
productColorCode
Codice o referenza del colore del prodotto. Obbligatorio solo se compilato nel dataset prodotto.
- Formato: deve corrispondere esattamente a un codice colore esistente nei tuoi dati prodotto.
supplierComponentCode
Codice o referenza del componente fornito dal fornitore. Questo sarà il nome visualizzato nel modulo che il fornitore riceverà.
- Formato: alfanumerico
lotReferences
Referenze dei lotti di questo componente, se disponibili.
- Formato: alfanumerico
-
Più lotti: separare con punto e virgola ";"
certifications
Certificazioni relative al componente stesso.
- Dove trovare le opzioni: Tassonomia COMPONENT_CERTIFICATIONS
-
Più certificazioni: separare con punto e virgola ";"
componentWeight
Peso del componente nel prodotto collegato, espresso in grammi.
Perché è importante: necessario per i calcoli LCA e per le dichiarazioni AGEC. Il peso totale dei componenti non deve superare quello del prodotto.
- Formato: numeri accettati (decimali ammessi).
- 💡 Hai bisogno di aiuto? Se non disponibile, Fairly Made applicherà un peso predefinito in base alla categoria definita dal nostro Framework.
componentPrint
Indicare se il componente è stampato.
- Formato: "1" (Sì) o "0" (No)
🔌 Utenti API: questo campo è di tipo “boolean”, indicare true (Sì) o false (No)
printingCountry
Paese in cui il componente è stato stampato (solo per Pronto Moda).
Perché è importante: rilevante per la conformità alla legge AGEC.
- Dove trovare le opzioni: Tassonomia COUNTRY
- Formato: codice paese ISO 3166-1 Alpha-2 (a 2 lettere).
dyeingCountry
Paese in cui il componente è stato tinto (solo per Pronto Moda).
Perché è importante: rilevante per la conformità alla legge AGEC.
- Formato: codice paese ISO 3166-1 Alpha-2 (a 2 lettere).
knittingCountry
Paese in cui il componente è stato lavorato a maglia (solo per Pronto Moda).
Perché è importante: rilevante per la conformità alla legge AGEC.
- Formato: codice paese ISO 3166-1 Alpha-2 (a 2 lettere).
weavingCountry
Paese in cui il componente è stato tessuto (solo per Pronto Moda).
Perché è importante: rilevante per la conformità alla legge AGEC.
- Formato: codice paese ISO 3166-1 Alpha-2 (a 2 lettere).
shoeFinishingCountry
Paese in cui il componente è stato rifinito (solo per calzature).
Perché è importante: rilevante per la conformità alla legge AGEC.
- Formato: codice paese ISO 3166-1 Alpha-2 (a 2 lettere).
shoeStitchingCountry
Paese in cui il componente è stato cucito (solo per calzature).
Perché è importante: rilevante per la conformità alla legge AGEC.
- Formato: codice paese ISO 3166-1 Alpha-2 (a 2 lettere).
4.4 Dipendenze da altre entità
Suppliers
I dati dei componenti includono un collegamento ai fornitori tramite il campo supplierRef.
Perché l’importazione dei componenti abbia successo, le referenze inserite nel campo supplierRef devono corrispondere esattamente a quelle già importate nel sistema Fairly Made tramite il tab SUPPLIERS.
Il sistema utilizza il codice supplierRef per collegare il componente al fornitore corretto già presente nella banca dati.
Products
I componenti sono collegati ai prodotti tramite i campi productRef, productColorCode e productCollectionRef .
Per un’importazione corretta, i codici di riferimento forniti in questi campi devono corrispondere esattamente ai dati già importati nel tab PRODUCTS del sistema Fairly Made.
Se un componente è utilizzato in più prodotti, ci sono due opzioni:
- Utenti Excel: aggiungere una riga separata per ogni combinazione prodotto+colore+collezione
- Utenti API: inviare una richiesta separata per ogni combinazione
Tutti i riferimenti devono già esistere nei dati prodotto importati.
Assicurare il collegamento dei dati
Non è importante quando sono stati importati i dati di fornitori e prodotti, ma è essenziale che prima di importare un Componente, le referenze supplierRef, productRef, productColorCode e productCollectionRef siano già presenti nel sistema.
Esempio di dati dei componenti
Qui sotto un esempio di come i dati potrebbero apparire per alcuni prodotti, con i campi descritti sopra:
| Nome campo | ⭐️ Obbligatorio | Descrizione | Esempio 1 | Esempio 2 | Esempio 3 | Esempio 4 |
|---|---|---|---|---|---|---|
| componentRef | ⭐️ | Codice interno del componente | Main Fabric Woven - JACKET AFTER | Lining - JACKET AFTER | Stuffing - JACKET AFTER | Upper - SNEAKERS NOAH |
| supplierRef | ⭐️ | Codice fornitore | Paolo Tessitura | Paolo Tessitura | Scandicci Trims | João Fábrica de Calçado, Ltd. |
| productRef | ⭐️ | Codice interno prodotto | ZC-001 | ZC-001 | ZC-001 | S-010 |
| productCollectionRef | ⭐️ | Codice o nome collezione | WINTER 2025 | WINTER 2025 | WINTER 2025 | SPRING 2025 |
| type | ⭐️ | Tipo componente | TEXTILE | TEXTILE | PLASTIC | LEATHER |
| category | ⭐️ | Categoria componente | MAIN FABRIC (WOVEN) | LININGS | STUFFINGS | UPPERS |
| composition | ⭐️ | Composizione dettagliata | 70% POLYAMIDE ; 30% RECYCLED POLYAMIDE | 100% RECYCLED POLYAMIDE | 100% RECYCLED POLYESTER | 100% BOVINE LEATHER |
| productColorCode | Obbli. se usato | Codice colore del prodotto | BEIGE | BEIGE | BEIGE | DEFAULT |
| supplierComponentCode | Altamente raccom. | Codice del componente per il fornitore | POL-RPOL-WOV-345 | RPOL-WOV-350 | RPOL-FOA-999 | |
| lotReferences | Altamente raccom. | Codici lotto (se disponibili) | 12345 | |||
| certifications | Altamente raccom. | Certificazioni del componente | GRS | GRS | GRS | LEATHER STANDARD BY OEKO-TEX |
| componentWeight | Altamente raccom. | Peso del componente nel prodotto (in grammi) | 478.32 | 162 | 252 | 98.84 |
| componentPrint | Il componente è stampato ? | NO | NO | NO | NO | |
| printingCountry | Solo RTW | Paese di stampa (codice ISO 3166-1 Alpha-2) | ||||
| dyeingCountry | Solo RTW | Paese di tintura (codice ISO 3166-1 Alpha-2) | IN | IN | ||
| knittingCountry | Solo RTW | Paese di maglieria (codice ISO 3166-1 Alpha-2) | ||||
| weavingCountry | Solo RTW | Paese di tessitura (codice ISO 3166-1 Alpha-2) | IN | IN | ||
| shoeFinishingCountry | Solo calzature | Paese di finitura (codice ISO 3166-1 Alpha-2) | BR | |||
| shoeStitchingCountry | Solo calzature | Paese di cucitura (codice ISO 3166-1 Alpha-2) | BR |