Data Contract
exploration-product-explored-id
Open Data Contract Standard v3.1.0
Fundamentals
Basic information about the data contract
- Name
- Product Explored
- Version
- 1.0.0
- Status
- active
- Tenant
- FairlyMade
- Purpose
- Product with its Analysis, its Supply Chain and its Supply Chain Analysis considered as the truth for the customer at a current time
- Usage
- Exposes product explored to several interfaces (App Products Table, Extracts)
- Limitations
- Provides near-real time data
Entity Relationship Diagram
Visual representation of data model relationships
erDiagram
"**products_mart**" {
idππ string
unique_identifier string
collection string
registry_customer_id string
registry_customer_id_hash integer
product_name string
product_ref string
product_public_name object
color_code string
purchase_order string
gtins array
product_category string
product_weight number
number_of_components integer
components_categories array
number_of_materials integer
materials array
composition string
declared_suppliers array
produced_quantity object
product_certifications array
market_segment string
eco_modulation string
product_status string
product_picture string
qr_code_link_ref string
web_link_ref string
is_dpp_activated boolean
traceability_start_date timestamp
theoretical_traceability_end_date timestamp
created_at timestamp
updated_at timestamp
is_rearchi boolean
}
"**products_analysis_mart**" {
idππ string
unique_identifier string
collection string
registry_customer_id string
registry_customer_id_hash integer
lca_fr object
lca_pef object
pef_single_score number
traceability_score number
fec_declaration object
fec_calculation object
lca_calculation object
lca_created_at timestamp
lca_updated_at timestamp
is_rearchi boolean
}
"**products_agec_mart**" {
idππ string
unique_identifier string
collection string
registry_customer_id string
registry_customer_id_hash integer
microplastics_percentage number
recycled_materials_percentage number
hazardous_substances string
is_product_in_agec_scope boolean
is_product_agec_compliant boolean
is_rearchi boolean
}
"**products_packaging_mart**" {
idππ string
unique_identifier string
collection string
registry_customer_id string
registry_customer_id_hash integer
packagingπ array
is_rearchi boolean
}
Schema
The data schema and structure
|
products_mart
table
This table contains all products analyzed by Fairly Made
Granularity: One row per customer product
|
||||
|---|---|---|---|---|
| Property | Business Name | Type | Required | Description |
|
id
Primary Key
|
- |
string
|
Yes | Unique identifier (generated by Fairly Made) of the product |
unique_identifier
|
- |
string
|
No | Unique identifier of the product |
collection
|
- |
string
|
Yes | Name of the collection the product belongs to |
registry_customer_id
|
- |
string
|
Yes | Unique registry identifier (generated by Fairly Made) of the customer |
registry_customer_id_hash
|
- |
integer
|
Yes | Customer hash of the registry customer unique identifier |
product_name
|
- |
string
|
No | Name of the product |
product_ref
|
- |
string
|
No | Reference of the product in the customer's system |
product_public_name
|
- |
object
|
No | Name of the product, as displayed to the final customer (website, hangtag, ...) |
|
β³
en
|
- |
string
|
No | Name of the product (EN) |
β³
fr
|
- |
string
|
No | Name of the product (FR) |
β³
it
|
- |
string
|
No | Name of the product (IT) |
β³
es
|
- |
string
|
No | Name of the product (ES) |
|
color_code
|
- |
string
|
No | Color of the product, as declared by the customer |
purchase_order
|
- |
string
|
No | Purchase order number of the product, as declared by the customer or the supplier |
gtins
|
- |
array
|
No | Global Trade Item Numbers of the product. There are multiple GTINs per product because of the different product formats |
|
β³
items
|
- |
string
|
No | - |
|
product_category
|
- |
string
|
Yes | The category of product, according to Fairly Made taxonomy |
product_weight
|
- |
number
|
No | Weight of the product |
number_of_components
|
- |
integer
|
No | Number of components in the product |
components_categories
|
- |
array
|
No | Categories of the components in the product |
|
β³
items
|
- |
string
|
No | - |
|
number_of_materials
|
- |
integer
|
No | Number of materials in the product |
materials
|
- |
array
|
No | Materials in the product |
|
β³
items
|
- |
string
|
No | - |
|
composition
|
- |
string
|
No | The composition of the product, component per component |
declared_suppliers
|
- |
array
|
No | Suppliers of the product, as declared by the customer |
|
β³
items
|
- |
object
|
No | - |
|
β³
supplier_id
|
- |
string
|
No | Unique identifier (generated by Fairly Made) of the supplier |
β³
name
|
- |
string
|
No | Name of the declared supplier |
β³
ref
|
- |
string
|
No | Declared supplier reference in the customer systems |
|
produced_quantity
|
- |
object
|
No | Quantity produced of the product |
|
β³
amount
|
- |
number
|
No | Amount of quantity produced of the product |
β³
unit
|
- |
string
|
No | Unit of quantity produced of the product |
β³
is_produced_quantity_from_customer_settings
|
- |
boolean
|
No | True if the produced quantity is the default value set in the customer setting |
|
product_certifications
|
- |
array
|
No | Standard of the product certificates, according to Fairly Made taxonomy (e.g. GOTS) |
|
β³
items
|
- |
string
|
No | - |
|
market_segment
|
- |
string
|
No | Market segment of the product (Menswear, Womenswear...) |
eco_modulation
|
- |
string
|
No | Eco-modulation of the product as declared by the customer, following the Fairly Made taxonomy |
product_status
|
- |
string
|
No | The status of the analysis |
product_picture
|
- |
string
|
No | URL of the product picture |
qr_code_link_ref
|
- |
string
|
No | Ref of the QR Code showcase link of the product |
web_link_ref
|
- |
string
|
No | Ref of the web showcase link of the product |
is_dpp_activated
|
- |
boolean
|
No | True if the showcase has been published |
traceability_start_date
|
- |
timestamp
|
No | Date and time when the supplier data collection started |
theoretical_traceability_end_date
|
- |
timestamp
|
No | Theoretical date and time when the supplier data collection ends, it is 49 days after the start |
created_at
|
- |
timestamp
|
Yes | Date and time when the record was created in operational database |
updated_at
|
- |
timestamp
|
Yes | Date and time when the record was updated in operational database |
is_rearchi
|
- |
boolean
|
Yes | True if the product comes from the rearchi data |
|
products_analysis_mart
table
This table contains the analysis of all products analyzed by Fairly Made
Granularity: One row per customer product
|
||||
|---|---|---|---|---|
| Property | Business Name | Type | Required | Description |
|
id
Primary Key
|
- |
string
|
Yes | Unique identifier (generated by Fairly Made) of the product |
unique_identifier
|
- |
string
|
No | Unique identifier of the product |
collection
|
- |
string
|
Yes | Name of the collection the product belongs to |
registry_customer_id
|
- |
string
|
Yes | Unique registry identifier (generated by Fairly Made) of the customer |
registry_customer_id_hash
|
- |
integer
|
Yes | Customer hash of the registry customer unique identifier |
lca_fr
|
- |
object
|
No | PEF impacts of the Life Cycle Assessment calculated with the LCAll tool |
|
β³
acidification
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on acidification |
β³
climate_change_biogenic
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on biogenic climate change |
β³
climate_change_fossil
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on fossil climate change |
β³
climate_change
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on climate change |
β³
climate_change_land_use
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on land use climate change |
β³
ecotoxicity_fresh_water
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on fresh water ecotoxicity |
β³
particulate_matter
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on particulate matter |
β³
eutrophication_fresh_water
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on fresh water eutrophication |
β³
eutrophication_marine
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on marine eutrophication |
β³
eutrophication_terrestrial
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on terrestrial eutrophication |
β³
human_toxicity_cancer
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on human toxicity, cancer |
β³
human_toxicity_non_cancer
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on human toxicity, non cancer |
β³
ionising_radiation
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on ionising radiation |
β³
land_use
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on land use |
β³
ozone_depletion
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on ozone depletion |
β³
photochemical_ozone_formation
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on photochemical ozone formation |
β³
resource_use_fossils
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on fossils resource use |
β³
resource_use_minerals_metals
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on minerals metals resource use |
β³
water_use
|
- |
number
|
No | Value of the impact of an analysis calculated with the ADEME methodology v.2025 on water use |
|
lca_pef
|
- |
object
|
No | PEF impacts of the Life Cycle Assessment computed according to the PEF methodology |
|
β³
acidification
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on acidification |
β³
climate_change
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on climate change |
β³
ecotoxicity_fresh_water
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on fresh water ecotoxicity |
β³
particulate_matter
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on particulate matter |
β³
eutrophication_fresh_water
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on fresh water eutrophication |
β³
eutrophication_marine
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on marine eutrophication |
β³
eutrophication_terrestrial
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on terrestrial eutrophication |
β³
human_toxicity_cancer
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on human toxicity, cancer |
β³
human_toxicity_non_cancer
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on human toxicity, non cancer |
β³
ionising_radiation
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on ionising radiation |
β³
land_use
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on land use |
β³
ozone_depletion
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on ozone depletion |
β³
photochemical_ozone_formation
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on photochemical ozone formation |
β³
resource_use_fossils
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on fossils resource use |
β³
resource_use_minerals_metals
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on minerals metals resource use |
β³
water_use
|
- |
number
|
No | Value of the impact of an analysis calculated with the PEF methodology on water use |
|
pef_single_score
|
- |
number
|
No | It is the result of an impact calculation initiated by the European Commission (based on PEFCR Apparel & Footwear 3.1 methodology). The PEF Single Score is expressed in micro-points, ensuring high precision in environmental scoring |
traceability_score
|
- |
number
|
No | The traceability grade of the product |
fec_declaration
|
- |
object
|
No | French environmental cost impact declaration of the product lifecycle |
|
β³
is_french_environmental_cost_published_to_government_platform
|
- |
boolean
|
No | True if the french environmental cost has been published to the government platform |
β³
government_platform_publication_date
|
- |
timestamp
|
No | Date at which the French environmental cost of the product has been published |
β³
published_french_environmental_cost
|
- |
number
|
No | Published value of the score in micro points. It is the sum of the impact of each sub-step of the product |
β³
published_french_environmental_cost_per_100_grams
|
- |
number
|
No | Published value of the score in micro points. It is the sum of the impact of each sub-step of the product for 100g |
β³
published_french_environmental_cost_pictogram
|
- |
string
|
No | Link to the pictogram of the published french environmental cost |
|
fec_calculation
|
- |
object
|
No | French environmental cost impact calculation of the product lifecycle |
|
β³
adjusted_duration_service
|
- |
number
|
No | The number of days this product category is expected to last when factoring the reference duration of service and the extrinsic durability coefficient |
β³
bonus_malus_service_duration
|
- |
number
|
No | The difference between the adjusted duration of service and the reference duration of service, in days |
β³
durability_coefficient
|
- |
number
|
No | Extrinsic (non-physical) durability coefficient influencing the product number of use and lifespan as defined in the French environmental cost methodology |
β³
company_size
|
- |
string
|
No | Setting the brand can update to compute the promotion to repair coefficient, it is related to the company size |
β³
last_calculated_french_environmental_cost
|
- |
number
|
No | Last calculated value of the score in micro points. It is the sum of the impact of each sub-step of the product |
β³
last_calculated_french_environmental_cost_per_100_grams
|
- |
number
|
No | Last calculated value of the score in micro points. It is the sum of the impact of each sub-step of the product for 100g |
β³
last_calculated_french_environmental_cost_pictogram
|
- |
string
|
No | Link to the pictogram of the last calculated french environmental cost |
β³
last_calculated_french_environmental_cost_computation_date
|
- |
timestamp
|
No | Date at which the last French environmental cost of the product has been computed by Fairly Made |
β³
edited_by_customer_user_first_name
|
- |
string
|
No | First name of the user that edited the brand settings |
β³
edited_by_customer_user_name
|
- |
string
|
No | Name of the user that edited the brand settings |
β³
fec_brand_settings_edited_at
|
- |
timestamp
|
No | Date and time when the brand settings was last updated in operational database |
β³
lca_score
|
- |
number
|
No | Environmental score obtained solely from the Life Cycle Analysis |
β³
market_segment
|
- |
string
|
No | Market segment of the product (Menswear, Womenswear...) |
β³
max_references_number
|
- |
number
|
No | Setting the brand can update to compute the repair service coefficient, it is related to the display of products traceability |
β³
microfibers_score
|
- |
number
|
No | Additional parameter representing the environmental impacts of microfibers released from the product during its life cycle |
β³
out_of_europe_export_score
|
- |
number
|
No | Additional parameter representing the environmental impact of product ending as wastes exported outside of Europe |
β³
is_product_in_legal_scope
|
- |
boolean
|
No | True if the product is in the regulation law for the french environmental cost display |
β³
product_market_price
|
- |
number
|
No | Average selling price of the product category, in euros |
β³
product_score
|
- |
number
|
No | Environmental score obtained from the aggregation of the Life Cycle Analysis results |
β³
repair_promotion_coefficient
|
- |
number
|
No | Indicator related to the incentives for product repair. Based on the ratio between product price with the average repair costs and the availability of repair services from the brand |
β³
product_range_coefficient
|
- |
number
|
No | Indicator related to the maximum number of references used in the brand score computation |
β³
reference_service_duration
|
- |
number
|
No | The number of days this product category is expected to last according to the french government standards |
β³
repair_service
|
- |
boolean
|
No | Setting the brand can update to compute the promotion to repair coefficient, it is related to the existence of a reparation service |
|
lca_calculation
|
- |
object
|
No | Impact calculation of the product lifecycle with LCAll |
|
β³
deadstock
|
- |
number
|
No | Quantity of finished products and semi-finished products (e.g. fabrics, yarn) that could not be sold through traditional sales channels, in % |
|
lca_created_at
|
- |
timestamp
|
Yes | Date and time when the record was created in operational database |
lca_updated_at
|
- |
timestamp
|
Yes | Date and time when the record was updated in operational database |
is_rearchi
|
- |
boolean
|
Yes | True if the product comes from the rearchi data |
|
products_agec_mart
table
This table contains the agec claims of all products analyzed by Fairly Made
Granularity: One row per customer product
|
||||
|---|---|---|---|---|
| Property | Business Name | Type | Required | Description |
|
id
Primary Key
|
- |
string
|
Yes | Unique identifier (generated by Fairly Made) of the product |
unique_identifier
|
- |
string
|
No | Unique identifier of the product |
collection
|
- |
string
|
Yes | Name of the collection the product belongs to |
registry_customer_id
|
- |
string
|
Yes | Unique registry identifier (generated by Fairly Made) of the customer |
registry_customer_id_hash
|
- |
integer
|
Yes | Customer hash of the registry customer unique identifier |
microplastics_percentage
|
- |
number
|
Yes | Percentage of synthetic fibers in the product |
recycled_materials_percentage
|
- |
number
|
Yes | Percentage of recycled materials in the product |
hazardous_substances
|
- |
string
|
No | Allegation on the presence of hazardous substances in the product, if applicable, as declared by the brand |
is_product_in_agec_scope
|
- |
boolean
|
Yes | True if the product is concerned by the AGEC law |
is_product_agec_compliant
|
- |
boolean
|
No | True if the product meets the AGEC requirements regarding traceability |
is_rearchi
|
- |
boolean
|
Yes | True if the product comes from the rearchi data |
|
products_packaging_mart
table
This table contains the packagings of all products analyzed by Fairly Made
Granularity: One row per customer product
|
||||
|---|---|---|---|---|
| Property | Business Name | Type | Required | Description |
|
id
Primary Key
|
- |
string
|
Yes | Unique identifier (generated by Fairly Made) of the product |
unique_identifier
|
- |
string
|
No | Unique identifier of the product |
collection
|
- |
string
|
Yes | Name of the collection the product belongs to |
registry_customer_id
|
- |
string
|
Yes | Unique registry identifier (generated by Fairly Made) of the customer |
registry_customer_id_hash
|
- |
integer
|
Yes | Customer hash of the registry customer unique identifier |
packaging
|
- |
array
|
Yes | Packagings linked to the product |
|
β³
items
|
- |
object
|
No | - |
|
β³
id
|
- |
string
|
No | Unique identifier (generated by Fairly Made) of the packaging |
β³
ref
|
- |
string
|
No | The reference of the packaging in the brand's system, written as [account id]_[client ref] |
β³
type
|
- |
string
|
No | Type of the packaging in Fairly Made taxonomy |
β³
channel
|
- |
string
|
No | Distribution channel of the packaging in Fairly Made taxonomy |
β³
compostability
|
- |
string
|
No | Is the packaging compostable, as declared by the brand |
β³
eco_modulation
|
- |
string
|
No | Eco-modulation of the packaging, as declared by the brand |
β³
recycled_materials_percentage
|
- |
number
|
No | Recycled materials in the product, in % |
β³
recyclability
|
- |
string
|
No | Is the packaging recyclable, as declared by the brand |
β³
reusability
|
- |
string
|
No | Is the packaging reusable, as declared by the brand |
β³
hazardous_substances_status
|
- |
string
|
No | Does the package contains hazardous substances, as declared by the brand |
β³
hazardous_substances_value
|
- |
string
|
No | The name of the substance the package contains, as declared by the brand |
|
is_rearchi
|
- |
boolean
|
Yes | True if the product comes from the rearchi data |
Support
Support channels and resources
-
#tech-support
slack
Team
Team members and their roles
Exploration Squad
Providing access to customers and end-customers to aggregated data. Helping our customers to take data-driven decisions thanks to data visualisation, interaction and ecodesign scenarios.
| Username | Role | Date In | Date Out | Comment |
|---|---|---|---|---|
| Martin Boby | Product Manager | 2026-01-01 | - | - |
| Alice Haupais | Tech Lead | 2026-01-01 | - | - |
| Charlie Beltran | Analytics Engineer | 2026-01-01 | - | - |
| Gustave Constans | Software Engineer | 2026-01-01 | - | - |
Servers
Infrastructure servers of the data contract
-
- Server
- dev
- Type
- bigquery
- Project
- fairlymade-data-platform-dev
- Dataset
- dev_exploration_product_explored
- Location
- europe-west1
-
- Server
- stg
- Type
- bigquery
- Project
- fairlymade-data-platform-dev
- Dataset
- stg_exploration_product_explored
- Location
- europe-west1
-
- Server
- prd
- Type
- bigquery
- Project
- fairlymade-data-platform-prd
- Dataset
- exploration_product_explored
- Location
- europe-west1
-
- Server
- sandbox
- Type
- bigquery
- Project
- fairlymade-data-platform-dev
- Dataset
- data_product_dataset
- Location
- europe-west1
Created at 20 May 2026 15:50:04 UTC with Data Contract CLI v0.11.1