Aller au contenu

Champs

Champs de la catégorie Produit général

Tous les champs d’un passeport de produit général : ce qu’est chaque champ, comment l’envoyer et ce que demande la publication.

Cette page énumère chaque champ que renvoie GET /categories/{category}/schema. Certaines lignes ajoutent ce que le point de terminaison ne renvoie pas, par exemple le format qu’une valeur de texte doit avoir, les symboles d’entretien qu’un champ accepte ou les clés des entrées d’une liste. Ces informations proviennent du code de l’API lui-même. Le point de terminaison renvoie aussi les conditions et les notes qui accompagnent chaque référence juridique. Cette page n’énumère pas les contrôles propres à chaque catégorie. Un tel contrôle peut quand même demander un champ, même quand la ligne du champ ne mentionne pas la publication, ou affiche une exception applicable à votre produit. Un contrôle peut aussi refuser une valeur. POST …/validate exécute ces contrôles sur votre passeport et nomme chaque problème qu’il trouve.

Les chemins, les méthodes, les portées, les noms de champs, les codes d'erreur et les noms des règles de validation sont publiés en anglais, car l'anglais est la langue de l'interface elle-même : c'est ce qu'un appelant saisit ou compare. Il en va de même de chaque exemple de code, de chaque charge utile JSON et de la phrase exacte que porte une réponse d'erreur : /v1 ne lit pas Accept-Language, et traduire ce que l'API envoie réellement en donnerait une description fausse. Tout ce qui est écrit à leur sujet suit la langue de cette page.

Types

text
Une chaîne de caractères. "…" Certains champs texte vérifient aussi le format. Leur ligne indique la vérification.
multiselect
Une liste de chaînes de caractères. ["EU"]
url
Une chaîne de caractères contenant une adresse web. "https://example.com/document.pdf"
number
Un nombre. 50
select
Une chaîne de caractères. "kg_co2e"
array
Une liste. Sa ligne indique ce que contient chaque entrée. ["…"]

Identification du produit

product_nameNom du produit

Dénomination commerciale du produit

Affiché comme titre principal sur le passeport public et dans les résultats de recherche.

Type

text

Publication

La publication le demande.

Niveau d’accès

public Public

gtinGTIN

Vous avez déjà un code-barres ? Le numéro indiqué en dessous est votre GTIN. Requis pour publier.

Le GTIN relie le passeport numérique au code-barres physique présent sur l'étiquette.

Type

text

Format

format_gtin La publication refuse une valeur dans un autre format.

Publication

La publication le demande.

Une taille ou une couleur enregistrée avec son propre code-barres compte aussi.

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

Le statut est la classification propre au point de terminaison.

Niveau d’accès

public Public

serial_numberNuméro de série

Numéro de série au niveau de l'article pour une identification unitaire

Type

text

Sources
  • GPSR (Reg (EU) 2023/988) Art. 9 in_force
Niveau d’accès

public Public

product_descriptionDescription du produit

Description claire du produit et de son utilisation prévue

Type

text

Publication

La publication le demande.

Niveau d’accès

public Public

product_categoryCatégorie de produit

Type de produit général (ex. T-shirt, Veste, Linge de lit). Facultatif — facilite l'organisation de vos passeports.

Type

text

Niveau d’accès

public Public

markets_sold_intoMarchés de commercialisation

Marchés sur lesquels ce produit est mis en vente. Détermine les règles spécifiques applicables (ex. France AGEC). Sélectionnez France (FR) si vous y vendez.

Utilisé uniquement pour adapter les conseils de conformité — jamais affiché sur le passeport public.

Type

multiselect

Valeurs de la liste
Toutes les 11 valeurs
  • EU Union européenne / EEE (général)
  • FR France
  • DE Allemagne
  • IT Italie
  • ES Espagne
  • NL Pays-Bas
  • BE Belgique
  • PL Pologne
  • UK Royaume-Uni
  • US États-Unis
  • OTHER Autre / reste du monde

La publication peut refuser une valeur hors de la liste. POST …/validate indique laquelle.

Niveau d’accès

restricted Restreint

Fabricant / Opérateur économique

manufacturer_nameNom du fabricant

Nom, raison sociale ou marque déposée du fabricant.

Type

text

Publication

La publication le demande.

Sources
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Niveau d’accès

public Public

manufacturer_addressAdresse du fabricant

L'adresse postale du fabricant. Si un point de contact unique a une autre adresse postale, indiquez-la aussi.

Type

text

Publication

La publication le demande.

Sources
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Niveau d’accès

public Public

manufacturer_countryPays du fabricant

Sélectionnez le pays du fabricant.

Type

text

Format

format_country_code La publication refuse une valeur dans un autre format.

Publication

La publication le demande.

Sources
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Niveau d’accès

public Public

manufacturer_emailE-mail du fabricant

L'adresse électronique du fabricant, par exemple son adresse e-mail.

Lorsqu'il s'applique, le règlement relatif à la sécurité générale des produits demande aux fabricants une adresse postale et une adresse électronique.

Type

text

Format

format_email La publication refuse une valeur dans un autre format.

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

    Des conditions s’appliquent. Le point de terminaison les renvoie dans regulatory_basis[].applies_when.

Niveau d’accès

public Public

manufacturer_websiteSite web du fabricant

Le site web du fabricant.

Type

url

Niveau d’accès

public Public

eori_numberNuméro EORI

Numéro d'enregistrement et d'identification des opérateurs économiques pour les douanes de l'UE

Type

text

Format

format_eori La publication refuse une valeur dans un autre format.

Niveau d’accès

restricted Restreint

eu_responsible_personPersonne responsable dans l'UE

Nom et coordonnées de la personne responsable établie dans l'UE — nécessaire pour vendre dans l'UE lorsque le fabricant est établi hors de l'UE, sauf si vous indiquez un importateur UE à la place

Type

text

Sources
  • 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
Niveau d’accès

public Public

eu_importerImportateur UE

Lorsqu'une entreprise autre que vous met le produit sur le marché de l'UE, indiquez ici cet importateur. Donnez son nom, sa raison sociale ou sa marque déposée, son adresse postale et une adresse électronique, par exemple une adresse e-mail.

L'importateur est un opérateur économique distinct du fabricant : l'entreprise établie dans l'UE qui introduit le produit dans l'Union.

Type

text

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

    Des conditions s’appliquent. Le point de terminaison les renvoie dans regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Art. 29(3) anticipated
  • ESPR (Reg (EU) 2024/1781) Annex III(j) anticipated
Niveau d’accès

public Public

Données environnementales

carbon_footprint_valueEmpreinte carbone

Empreinte carbone du produit. Sélectionnez l'unité de mesure correspondante dans la liste.

Type

number

Unité de mesure

Envoyé dans carbon_footprint_unit.

carbon_footprint_unit: kg_co2e, kg_co2e_per_kg, kg_co2e_per_m2

Niveau d’accès

public Public

carbon_footprint_unitUnité de mesure de l'empreinte carbone

Unité de mesure de la valeur de l'empreinte carbone.

Type

select

Valeurs de la liste
  • kg_co2e kg CO₂e (par unité)
  • kg_co2e_per_kg kg CO₂e / kg (par poids)
  • kg_co2e_per_m2 kg CO₂e / m² (par surface)

La publication peut refuser une valeur hors de la liste. POST …/validate indique laquelle.

Niveau d’accès

public Public

carbon_footprint_basisBase de calcul de l'empreinte carbone

Méthode utilisée pour calculer l'empreinte carbone.

Ce champ indique la méthode de calcul. Conservez les justificatifs de l'empreinte carbone ; sélectionner une méthode ne suffit pas à étayer le résultat.

Type

select

Valeurs de la liste
  • iso_14067 ISO 14067 (empreinte carbone produit)
  • pef EU PEF / PEFCR
  • ghg_protocol GHG Protocol Product Standard
  • iso_14040_44 ISO 14040/44 LCA
  • supplier_data Données fournisseur / EPD
  • estimate Estimation interne

La publication peut refuser une valeur hors de la liste. POST …/validate indique laquelle.

Sources
  • UCPD (Dir 2005/29/EC) Art. 12 in_force
Niveau d’accès

public Public

recyclable_content_percentageContenu recyclable (%)

Pourcentage du produit recyclable en fin de vie

Type

number

Limites

min: 0 max: 100

Niveau d’accès

public Public

recycled_content_percentageContenu recyclé (%)

Pourcentage du produit fabriqué à partir de matériaux recyclés

Type

number

Limites

min: 0 max: 100

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

    Des conditions s’appliquent. Le point de terminaison les renvoie dans regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Annex I(h) anticipated
Niveau d’accès

public Public

Conformité réglementaire

substances_of_concernSubstances préoccupantes

Liste des substances préoccupantes présentes au-delà des seuils de concentration, ou « aucune déclarée »

Type

array item_type: string

Sources
  • 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

    Des conditions s’appliquent. Le point de terminaison les renvoie dans regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Art. 7(5) anticipated
Niveau d’accès

public Public

conformity_declaration_urlURL de la déclaration de conformité

Lien vers la déclaration de conformité UE, ou téléversez le PDF.

Type

url

Niveau d’accès

authority Autorités uniquement

Un document peut en tenir lieu

conformity_declaration

L’identifiant du document est envoyé dans conformity_declaration_url__document_id.

compliance_standardsNormes de conformité

Sélectionnez les normes auxquelles votre produit est conforme.

Type

multiselect

Valeurs de la liste
  • reach REACH (CE 1907/2006)
  • eu_ecolabel Label écologique de l'UE

La publication peut refuser une valeur hors de la liste. POST …/validate indique laquelle.

Niveau d’accès

public Public

Fin de vie

recycling_instructionsConsignes de recyclage

Instructions pour le recyclage du produit en fin de vie

Type

text

Niveau d’accès

public Public

disposal_instructionsConsignes d'élimination

Instructions pour l'élimination sûre du produit s'il ne peut être recyclé

Type

text

Niveau d’accès

public Public

Économie circulaire

mono_material_percentagePourcentage mono-matériau

Pourcentage du produit constitué d'un seul matériau recyclable (0-100). Les produits au-dessus de 85 % sont nettement plus faciles à recycler.

Type

number

Limites

min: 0 max: 100

Niveau d’accès

public Public

recyclability_gradeClasse de recyclabilité

Champ conservé pour les valeurs déjà saisies ; il n'est plus demandé.

Type

select

Valeurs de la liste
  • A A — Entièrement recyclable (mono-matériau, sans contaminants)
  • B B — Recyclable avec séparation (éléments non recyclables amovibles)
  • C C — Partiellement recyclable (mélange, certains composants récupérables)
  • D D — Difficilement recyclable (mélanges complexes, enductions)
  • E E — Non recyclable (matériaux inséparables ou composants contaminants)

La publication peut refuser une valeur hors de la liste. POST …/validate indique laquelle.

Niveau d’accès

public Public

Non affiché sur la page publique du passeport. self_declared_label

disassembly_instructions_urlInstructions de démontage

URL du guide de séparation des composants non recyclables (fermetures à glissière, boutons, enductions) en vue du recyclage — ou téléversez le fichier.

Type

url

Niveau d’accès

public Public

Un document peut en tenir lieu

document

L’identifiant du document est envoyé dans disassembly_instructions_url__document_id.

takeback_scheme_urlProgramme de reprise

URL des informations sur le programme de collecte ou de reprise — ou téléversez le fichier.

Type

url

Sources
  • ESPR (Reg (EU) 2024/1781) Art. 7(2)(b)(ii) anticipated
Niveau d’accès

public Public

Un document peut en tenir lieu

document

L’identifiant du document est envoyé dans takeback_scheme_url__document_id.