Guide pour les producteurs
Ce guide présente pourquoi et comment les producteurs peuvent intégrer directement les photos et données de leurs produits dans la base Open Food Facts.
- Introduction
- Pourquoi ajouter les données de ses produits dans Open Food Facts
- Comment ajouter les données de ses produits dans Open Food Facts
- Questions fréquentes
- Est-ce que le référencement des produits est gratuit ?
- Les données des producteurs vont-elles écraser les données saisies par les contributeurs ?
- Est-il possible de supprimer les produits qui ne sont plus vendus ?
- Est-ce que les produits pour animaux, les produits non alimentaires, les cosmétiques et les autres produits peuvent être intégrés à Open Food Facts ?
Introduction
Les photos et données sur les produits alimentaires référencés dans la base Open Food Facts proviennent de 2 sources :
- la collecte citoyenne (crowdsourcing) à travers les applications mobiles et le site Open Food Facts : les contributeurs scannent les codes barres, envoient les photos du produit, de la liste des ingrédients et du tableau nutritionnel et saisissent ensuite les données de manière structurées.
- l'ajout de données en direct des producteurs, de manière manuelle ou automatisée.
Pourquoi ajouter les données de ses produits dans Open Food Facts
L'import des données en direct des fabricants comporte de nombreux avantages :
- Les données sont complètes, à jour, et sans risque d'erreur.
- Les photos sont de meilleures qualité que les photos prises par les contributeurs dans des conditions très variables.
- Les données sont ensuite disponibles dans plus de 100 applications.
- Vous pouvez obtenir facilement des statistiques sur vos produits et exporter les données de vos produits complétées par des indicateurs calculés par Open Food Facts tel que le Nutri-Score.
Exemples de producteurs qui transmettent les photos et données de leurs produits à Open Food Facts
Un nombre croissant de producteurs nous transmettent les données de leurs produits : Fleury Michon, Sodebo, Système U, Carrefour, Casino, Franprix, Monoprix.
Comment ajouter les données de ses produits dans Open Food Facts
Licence
Toutes les données envoyées à Open Food Facts sont publiées sous licence Open Database Licence (ODbL), et les photos sous licence Creative Commons CC-BY-SA. Ces licences permettent que les données soient librement réutilisables par tous et pour tous usages. Pour plus d'informations, voir les Conditions d'utilisation, de contribution et de réutilisation.
Quelles données
Toutes les données dont vous disposez peuvent être intégrées à Open Food Facts : ingrédients et informations nutritionnels bien sûr, mais aussi labels, matériaux utilisés pour l'emballage, traçabilité des ingrédients, instructions de préparation et de recyclage, empreinte écologique etc.
Nous ajoutons régulièrement de nouveaux champs dans la base de données en fonction des informations présentes sur les emballages ou qui nous sont communiquées par les fabricants.
Nous avons ainsi rajouté recemment des champs sur l'empreinte carbone, et le mode d'emballage des produits, qui sont déjà mis en valeur sur Open Food Facts et dans des applications qui aident à changer les comportements en terme de recyclage.Une base dans toutes les langues
La base, le site et les applications mobiles Open Food Facts sont également entièrement multilingues et disponibles dans tous les pays. Si vous disposez de photos et données en plusieurs langues, nous pouvons également les intégrer dans Open Food Facts.
Photos et Données
Un des principes fondamentaux d'Open Food Facts est que l'utilisateur ou le contributeur doit être en mesure de vérifier l'information à partir d'une photo.
Nous vous demandons donc de nous envoyer des photos du produit et de l'emballage (éventuellement sous forme de fichier à plat / BAT) pour venir en support de la donnée structurée que vous envoyez.
Ajout manuel
Si vous avez un faible nombre de produits dont la formulation ne change pas souvent, vous pouvez créer un compte sur Open Food Facts et ajouter vous même les photos et données de vos produits.
Méthode fortement recommandée: Ajouter les photos et saisir les informations à partir du site Open Food Facts.
Méthode alternative: Utiliser l'application mobile Android pour scanner puis photographier et enfin saisir intégralement un produit.
Merci d'avance de nous prévenir si vous ajoutez vous-même vos produits afin que nous puissions identifier votre compte comme un compte producteur, et indiquer que les informations viennent directement de votre entreprise.
Ajout automatisé
Pour rendre l'import des données le plus facile et rapide, nous avons défini un format standard pour les images et les données :Format des images
Au moins 3 images sont obligatoires :
- Vue de face du produit sur fond blanc (éviter les vues de trois-quart qui ne permettent pas la reconnaissance visuelle des produits sans scan de code barre)
- Liste des ingrédients
- Tableau nutritionnel
La vue de face, des ingrédients et du tableau nutritionnel doivent être fournies dans au moins la langue principale du produit. Il est recommandé de fournir également des images pour d'autres langues lorsqu'elles figurent sur le produit.
Par exemple un produit destiné au marché belge pourra avoir des photos montrant le produit côté écrit en français et côté écrit en néerlandais.
D'autres images peuvent également être inclues :
- Verso et autres vues du produit (elles permettent en particulier de repérer automatiquement les logos des labels etc.)
- Vue à plat de l'emballage / BAT
Format des fichiers images
- Format JPEG ou PNG
- Taille d'au moins 2000 pixels de large ou de haut
Nom des fichiers images
[code barre]_[type d'image]_[code de la langue].[jpg ou png]
Par exemple :
3660140808750_front_fr.jpg pour l'image de face du produit dont le code barre est 3660140808750
Les types d'images sont :
- front : image de face
- ingredients : liste des ingrédients
- nutrition : tableau nutritionnel
- back : version
- nom libre (caractères de a à e, sans espace) pour les autres vues
Format des données
Les données doivent être fournies dans un tableau au format CSV, avec une tabulation comme caractère de séparation des champs et l'encodage de caractères UTF-8.
La 1ère ligne contient l'intitulé des champs, et chacun des produits occupe l'une des lignes suivantes. L'ordre des champs n'a pas d'importance, et il n'est pas nécessaire que toutes les colonnes soient présentes.
Certains champs sont obligatoires et d'autres sont optionnels. Nous vous encourageons à renseigner un maximum de champs afin que les données puissent être utilisées par le plus d'applications possibles. En cas de doute, ou si vous avez des données pour lesquelles il n'y a pas encore de champs dans la base Open Food Facts, vous pouvez nous contacter pour qu'on puisse ajouter des champs et faire la meilleure correspondance possible.
Champs obligatoires
- code : code barre du produit tel qu'il figure sur l'emballage (EAN-13, EAN-8 ou autre)
- lang : code à 2 lettres de la langue principale (la plus présente sur l'emballage) du produit (exemple : fr pour le français)
- product_name_[code à 2 lettres de la langue principale] : nom du produit (dans le champ product_name_fr pour le nom en français)
- generic_name_[code à 2 lettres de la langue principale] : nom générique du produit
- brands : marques (plusieurs valeurs possibles pour les marques et sous-marques, à séparer par des virgules)
- quantity: quantité, préciser l'unité, et éventuellement ajouter entre parenthèses si le produit contient plusieurs unités (exemple : 120 g (4 x 30 g) )
- categories : catégorie du produit, dans la langue principale du produit (exemple : gâteaux au chocolat)
- countries: pays où le produit est vendu, dans la langue principale du produit (plusieurs valeurs possibles, à séparer par des virgules)
- ingredients_text_[code à 2 lettres de la langue principale] : liste des ingrédients (dans le champ ingredients_text_fr pour la liste en français). lsLes allergènes peuvent être indiqués en MAJUSCULES ou entre _tirets bas_
- allergens : allergènes, dans la langue principale du produit, séparés par des virgules
- traces : traces d'allergènes, dans la langue principale du produit, séparés par des virgules
Parmi les champs obligatoires figurent les valeurs nutritionnelles qui figurent sur le paquet, pour 100g / 100 ml de produit tel que vendu.
Toutes les valeurs ne doivent pas avoir d'unité (l'unité est le kJ pour l'énergie et le g pour tous les autres champs).
- energy_100g : énergie, en kJ
- fat_100g : matières grasses
- saturated-fat_100g : matières grasse saturées
- carbohydrates_100g : glucides
- sugars_100g : sucres
- proteins_100g : protéines
- salt_100g : sel
Il est fortement recommandé d'indiquer aussi les fibres et le % de fruits et légumes pour que ces informations puissent être prises en compte dans le calcul du Nutri-Score :
- fiber_100g : fibres
- fruits-vegetables-nuts_100g
Champs optionnels
- labels : labels, dans la langue principale du produit (plusieurs valeurs possibles, à séparer par des virgules) (exemple : AB Bio, MSC, Max Havelaar). A noter : les labels doivent obligatoirement figurer sur l'emballage du produit.
- origins : origines des ingrédients, dans la langue principale du produit (plusieurs valeurs possibles, à séparer par des virgules) (exemple : Pérou, Périgord)
- packagings: matériaux et formes de l'emballage du produit, dans la langue principale du produit (plusieurs valeurs possibles, à séparer par des virgules) (exemple : canette, aluminium)
- manufacturing_places : lieux de fabrication, dans la langue principale du produit (plusieurs valeurs possibles, à séparer par des virgules : noms de villes, pays)
- emb_codes : codes emballeurs et estampiles sanitaires européennes (plusieurs valeurs possibles, à séparer par des virgules)
- stores : lieux de ventes (plusieurs valeurs possibles, à séparer par des virgules : noms de chaînes de supermarchés)
- nutri_score : note Nutri-Score de A à E, seulement dans le cas où elle est indiquée sur l'emballage
- serving_size : quantité d'une portion, préciser l'unité
Les valeurs nutritionnelles peuvent également être indiquées pour le produit préparé (avec de l'eau, du lait etc.). Il faut alors ajouter "_prepared" au nom du champ. Par exemple energy_prepared_100g.
Il est également possible d'indiquer les valeurs pour d'autres nutriments :
- energy-from-fat_100g
- butyric-acid_100g
- caproic-acid_100g
- caprylic-acid_100g
- capric-acid_100g
- lauric-acid_100g
- myristic-acid_100g
- palmitic-acid_100g
- stearic-acid_100g
- arachidic-acid_100g
- behenic-acid_100g
- lignoceric-acid_100g
- cerotic-acid_100g
- montanic-acid_100g
- melissic-acid_100g
- monounsaturated-fat_100g
- polyunsaturated-fat_100g
- omega-3-fat_100g
- alpha-linolenic-acid_100g
- eicosapentaenoic-acid_100g
- docosahexaenoic-acid_100g
- omega-6-fat_100g
- linoleic-acid_100g
- arachidonic-acid_100g
- gamma-linolenic-acid_100g
- dihomo-gamma-linolenic-acid_100g
- omega-9-fat_100g
- oleic-acid_100g
- elaidic-acid_100g
- gondoic-acid_100g
- mead-acid_100g
- erucic-acid_100g
- nervonic-acid_100g
- trans-fat_100g
- cholesterol_100g
- sucrose_100g
- glucose_100g
- fructose_100g
- lactose_100g
- maltose_100g
- maltodextrins_100g
- starch_100g
- polyols_100g
- casein_100g
- serum-proteins_100g
- nucleotides_100g
- sodium_100g - dans le cas ou le champ salt_100g n'est pas renseigné
- alcohol_100g
- vitamin-a_100g
- beta-carotene_100g
- vitamin-d_100g
- vitamin-e_100g
- vitamin-k_100g
- vitamin-c_100g
- vitamin-b1_100g
- vitamin-b2_100g
- vitamin-pp_100g
- vitamin-b6_100g
- vitamin-b9_100g
- folates_100g
- vitamin-b12_100g
- biotin_100g
- pantothenic-acid_100g
- silica_100g
- bicarbonate_100g
- potassium_100g
- chloride_100g
- calcium_100g
- phosphorus_100g
- iron_100g
- magnesium_100g
- zinc_100g
- copper_100g
- manganese_100g
- fluoride_100g
- selenium_100g
- chromium_100g
- molybdenum_100g
- iodine_100g
- caffeine_100g
- taurine_100g
- ph_100g
- collagen-meat-protein-ratio_100g
- cocoa_100g
- chlorophyl_100g
- carbon-footprint_100g
- glycemic-index_100g
- water-hardness_100g
- choline_100g
- phylloquinone_100g
- beta-glucan_100g
- inositol_100g
- carnitine_100g
Envoi des photos et des données
Si le nombre de produits est relativement restreint (moins de 1000 produits) et les mises à jour peu fréquentes (par exemple tous les 6 mois), il est possible de nous envoyer les photos et le fichier CSV par tous moyens (par exemple mail pour le fichier CSV et WeTransfer, Google Drive, DropBox etc. pour les photos).
Pour un nombre de produits plus important ou une mise à jour plus régulière, nous pouvons vous créer un espace SFTP sur lequel vous pouvez envoyer de façon manuelle ou automatisée les données et les photos. Contactez-nous pour que l'on puisse mettre cela en place.
Questions fréquentes
Est-ce que le référencement des produits est gratuit ?
L'import des données est entièrement gratuit. Nous n'acceptons aucune contrepartie pour l'inclusion des données. Nous sommes très heureux que vous ayiez décidé de contribuer les données de vos produits à la transparence alimentaire, et nous vous en remercions.
Les données des producteurs vont-elles écraser les données saisies par les contributeurs ?
Les données des producteurs sont contrôlées automatiquement par les algorithmes de contrôle de cohérence d'Open Food Facts, puis par quelques contributeurs. Nous avons pleinement confiance dans les données communiquées, mais nous avons d'expérience constatés que des coquilles sont possibles.
Une fois contrôlées, elles viendront se substituer et/ou compléter les données saisies par les contributeurs.
Dans le cas d'un import régulier et automatisé, les données viendront à chaque fois écraser les mise à jour par les contributeurs, sauf si une erreur manifeste (qui vous sera remontée) est signalée sur un produit par un contributeur.
Est-il possible de supprimer les produits qui ne sont plus vendus ?
Quand un produit disparait des rayons, il est rapidement consommé, et nous constatons qu'il n'est rapidement plus scanné.
Nous archivons alors le produit pour qu'il reste disponible à titre documentaire pour des utilisations scientifiques dans le cadre de cohortes alimentaires qui peuvent durer sur des dizaines d'années. Il est en effet essentiel de pouvoir obtenir les compositions du produit à une date précise, même si celui ci a changé ou disparu.
Si vous disposez de données historiques sur vos anciens produits ou anciennes versions de vous produits, nous serions également très intéressés par ces données historiques, afin de pouvoir remonter le temps, de permettre des analyses scientifiques sur temps long, et permettre de visualiser l'évolution des produits.
Les producteurs peuvent également nous envoyer les listes des codes barres retirés de la vente afin que nous puissions étiqueter les produits de manière appropriée.
Est-ce que les produits pour animaux, les produits non alimentaires, les cosmétiques et les autres produits peuvent être intégrés à Open Food Facts ?
Nous avons crée des projets spécifiques pour les cosmétiques, pour l'alimentation animale, ainsi que pour les autres produits (respectivement Open Beauty Facts, Open Pet Food Facts et Open Products Facts). Nous sommes donc heureux de pouvoir importer vos produits dans le projet qui leur correspond.