forked from aleene/openfoodfacts-server
-
Notifications
You must be signed in to change notification settings - Fork 0
/
producers.html
370 lines (267 loc) · 18 KB
/
producers.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
<html dir="ltr"><head></head><body dir="ltr"><div id="main_column" class="xxlarge-11 xlarge-10 large-9 medium-8 columns" style="padding-top:1rem;height:11489px" data-equalizer-watch="">
<!-- main column content - comment used to remove left column and center content on some pages -->
<h1>Guide for producers</h1>
<p>This guide explains why and how producers can directly integrate photos and product data into the Open Food Facts database.</p>
<ul><li><a href="#introduction">Introduction</a></li>
<li><a href="#pourquoi_ajouter_les_donnees_de_ses_produits_dans_open_food_facts">Why add your product data to Open Food Facts</a></li>
<ul>
<li><a href="#exemples_de_producteurs_qui_transmettent_les_photos_et_donnees_de_leurs_produits_a_open_food_facts">Examples of producers who submit photos and product data to Open Food Facts</a></li>
</ul>
<li><a href="#comment_ajouter_les_donnees_de_ses_produits_dans_open_food_facts">How to add data for your products in Open Food Facts</a></li>
<ul>
<li><a href="#licence">Licence</a></li>
<li><a href="#quelles_donnees">What data ?</a></li>
<ul>
<li><a href="#une_base_dans_toutes_les_langues">A database in all languages</a></li>
<li><a href="#photos_et_donnees">Photos and Data</a></li>
</ul>
<li><a href="#ajout_manuel">Manual addition</a></li>
<li><a href="#ajout_automatise">Automated addition</a></li>
<ul>
<li><a href="#format_des_images">Picture format</a></li>
<ul>
<li><a href="#format_des_fichiers_images">Format of image files</a></li>
<li><a href="#nom_des_fichiers_images">Name of the image files</a></li>
</ul>
<li><a href="#format_des_donnees">Data format</a></li>
<ul>
<li><a href="#champs_obligatoires">Required fields</a></li>
<li><a href="#champs_optionnels">Optional fields</a></li>
</ul>
<li><a href="#envoi_des_photos_et_des_donnees">Sending photos and data</a></li>
</ul>
</ul>
<li><a href="#questions_frequentes">Frequently Asked Questions</a></li>
<ul>
<li><a href="#est_ce_que_le_referencement_des_produits_est_gratuit">Is the listing of products free?</a></li>
<li><a href="#les_donnees_des_producteurs_vont_elles_ecraser_les_donnees_saisies_par_les_contributeurs">Will producer data overwrite data entered by contributors?</a></li>
<li><a href="#est_il_possible_de_supprimer_les_produits_qui_ne_sont_plus_vendus">Is it possible to delete products that are no longer sold?</a></li>
<li><a href="#est_ce_que_les_produits_pour_animaux_les_produits_non_alimentaires_les_cosmetiques_et_les_autres_produits_peuvent_etre_integres_a_open_food_facts">Can animal products, non-food products, cosmetics and other products be integrated into Open Food Facts?</a></li>
</ul>
</ul>
<h2 id="introduction">Introduction</h2>
<p>The photos and data on the food products referenced in the Open Food Facts database come from 2 sources:</p>
<ul>
<li>crowdsourcing through mobile apps and the Open Food Facts website: contributors scan barcodes, send product photos, ingredient lists and nutrition charts and then enter the data in a structured way.</li>
<li>the addition of data directly from the producers, either manually or automatically.</li>
</ul>
<h2 id="pourquoi_ajouter_les_donnees_de_ses_produits_dans_open_food_facts">Why add product data to Open Food Facts</h2>
<p>There are many benefits to importing date directly from manufacturers:</p>
<ul>
<li>The data is complete, up to date, and without risk of error.</li>
<li>The photos are of better quality than the photos taken by the contributors in very variable conditions.</li>
<li>The data is then available in more than 100 applications.</li>
<li>You can easily obtain statistics about your products and export the data of your products supplemented by indicators calculated by Open Food Facts such as the Nutri-Score.</li>
</ul>
<h3 id="exemples_de_producteurs_qui_transmettent_les_photos_et_donnees_de_leurs_produits_a_open_food_facts">Examples of producers who submit photos and product data to Open Food Facts</h3>
<p>A growing number of high level French producers are sending us the data of their products: Fleury Michon, Sodebo, System U, Carrefour, Casino, Franprix, Monoprix.</p>
<h2 id="comment_ajouter_les_donnees_de_ses_produits_dans_open_food_facts">How to add the data of your products in Open Food Facts</h2>
<h3 id="licence">Licence</h3>
<p>All data sent to Open Food Facts is published under the Open Database License (ODbL), and the photos under the Creative Commons License CC-BY-SA. These licenses allow the data to be freely reusable by all and for all purposes. For more information, see the <a href="https://fr.openfoodfacts.org/conditions-d-utilisation">Terms of Use, Contribution, and Reuse.</a></p>
<h3 id="quelles_donnees">What data</h3>
<p>All the data you have can be integrated into Open Food Facts: ingredients and nutritional information of course, but also labels, materials used for packaging, traceability of ingredients, instructions for preparation and recycling, ecological footprint etc.</p>
<p>We regularly add new fields to the database based on the information on the packages or provided by the manufacturers.</p>
We have recently added fields on the carbon footprint, and the packaging of products, which are already highlighted on Open Food Facts and in applications that help to change the behavior in terms of recycling.<p></p>
<h4 id="une_base_dans_toutes_les_langues">A database in all languages</h4>
<p>The Open Food Facts database, site and mobile applications are also fully multilingual and available in all countries. If you have photos and data in multiple languages, we can also integrate them into Open Food Facts.</p>
<h4 id="photos_et_donnees">Photos and Data</h4>
<p>One of the fundamental principles of Open Food Facts is that the user or contributor must be able to verify the information from a photo.</p>
<p>We therefore ask you to send us photos of the product and packaging (possibly as a flat file of the packaging) to support the structured data you send.</p>
<h3 id="ajout_manuel">Manual addition</h3>
<p>If you have a small number of products whose formulation does not change often, you can create an account on Open Food Facts and add yourself photos and data of your products.</p>
<p>Highly recommended method: Add photos and enter information from the <a href="https://fr.openfoodfacts.org">Open Food Facts website</a> .</p>
<p>Alternative method: Use the Android mobile application to scan and then photograph and finally enter a product completely.</p>
<p>Thank you in advance for telling us if you add your products yourself so that we can identify your account as a producer account, and indicate that the information comes directly from your company.</p>
<h3 id="ajout_automatise">Automated addition</h3>
To make importing data easier and faster, we have defined a standard format for images and data:
<h4 id="format_des_images">Picture format</h4>
<p>At least 3 images are required:</p>
<ul>
<li>Front view of product on white background (avoid three-quarter views that do not allow visual recognition of products without barcode scanning)</li>
<li>List of ingredients</li>
<li>Nutritional table</li>
</ul>
<p>The front view, ingredients and nutrition chart must be provided in at least the main language of the product. It is recommended that you also provide images for other languages when they appear on the product.</p>
<p>For example, a product intended for the Belgian market may have photos showing the product written in French and written in Dutch.</p>
<p>Other images may also be included:</p>
<ul>
<li>Verso and other views of the product (they allow in particular to automatically identify labels logos etc.)</li>
<li>Flat view of the packaging</li>
</ul>
<h5 id="format_des_fichiers_images">Format of image files</h5>
<ul>
<li>JPEG or PNG format</li>
<li>Size at least 2000 pixels wide or tall</li>
</ul>
<h5 id="nom_des_fichiers_images">Name of the image files</h5>
<pre>[barcode]_[type of image]_[language code].[jpg or png]</pre>
<p>For example :</p>
<p>3660140808750_front_en.jpg for the front image of the product whose barcode is 3660140808750</p>
<p>The types of images are:</p>
<ul>
<li>front: front image</li>
<li>ingredients: list of ingredients</li>
<li>nutrition: nutritional chart</li>
<li>back: version</li>
<li>any name you see fit (characters from a to e, no spaces) for other views</li>
</ul>
<h4 id="format_des_donnees">Data format</h4>
<p>The data must be provided in a table in CSV format, with tabulation as field separator character and UTF-8 character encoding.</p>
<p>The first line contains the field names, and each of the products occupies one of the following lines. The order of the fields does not matter, and not all columns need to be present.</p>
<p>Some fields are mandatory and others are optional. We encourage you to fill in as many fields as possible so that the data can be used by as many applications as possible. If in doubt, or if you have data for which there are not yet fields in the Open Food Facts database, you can contact us so that we can add fields and make the best possible match.</p>
<h5 id="champs_obligatoires">Required fields</h5>
<ul>
<li>code: product barcode as it appears on the packaging (EAN-13, EAN-8 or other)
</li><li>lang: 2-letter code of the main language (most present on the packaging) of the product (example: fr for French)
</li><li>product_name_ [2-letter code of the main language]: product name (in the field product_name_en for the name in French)
</li><li>generic_name_ [2-letter code of the main language]: Generic product name
</li><li>brands: brands (several possible values for brands and sub-brands, to be separated by commas)
</li><li>quantity: quantity, specify the unit, and possibly add in parentheses if the product contains several units (example: 120 g (4 x 30 g))
</li><li>categories: product category, in the main product language (example: chocolate cakes)
</li><li>countries: country where the product is sold, in the main language of the product (several possible values, to be separated by commas)
</li><li>ingredients_text_ [2-letter code of the main language]: list of ingredients (in the ingredients_text_fr field for the list in French). Allergens may be indicated in CAPITAL LETTERS or between
</li><li>allergens: allergens, in the main language of the product, separated by commas
</li><li>traces: traces of allergens, in the main language of the product, separated by commas
</li></ul>
<p>Among the mandatory fields are the nutritional values that appear on the package, per 100g / 100ml of product as sold.</p>
<p>All values must have no unit (the unit is kJ for energy and g for all other fields).</p>
<ul>
<li>energy_100g: energy, in kJ
</li><li>fat_100g: fat
</li><li>saturated-fat_100g: saturated fat
</li><li>carbohydrates_100g: carbohydrates
</li><li>sugars_100g: sugars
</li><li>proteins_100g: proteins
</li><li>salt_100g: salt
</li></ul>
<p>It is strongly recommended to also indicate the fibers and the % of fruits and vegetables so that this information can be taken into account in the calculation of Nutri-Score:</p>
<ul>
<li>fiber_100g: fibers
</li><li>fruits-vegetables-nuts_100g
</li></ul>
<h5 id="champs_optionnels">Optional fields</h5>
<ul>
<li>labels: labels, in the main language of the product (several possible values, to be separated by commas) (example: AB Bio, MSC, Max Havelaar). Note: the labels must appear on the packaging of the product.
</li><li>origins: origins of the ingredients, in the main language of the product (several possible values, to be separated by commas) (example: Peru, Périgord)
</li><li>packaging: materials and forms of the product packaging, in the main language of the product (several possible values, to be separated by commas) (example: can, aluminum)
</li><li>manufacturing_places: manufacturing locations, in the main language of the product (several possible values, to be separated by commas: city names, countries)
</li><li>emb_codes: packager codes and European sanitary stamps (several possible values, to be separated by commas)
</li><li>stores: places of sale (several possible values, to be separated by commas: names of supermarket chains)
</li><li>nutri_score: Nutri-Score rating from A to E, only in case it is indicated on the package
</li><li>serving_size: quantity of a serving, specify the unit
</li></ul>
<p>Nutritional values can also be indicated for the prepared product (with water, milk etc.). Then add "_prepared" to the name of the field. For example energy_prepared_100g.</p>
<p>It is also possible to indicate the values for other nutrients:</p>
<ul>
<li>Energy-from-fat_100g
</li><li>butyric-acid_100g
</li><li>caproic-acid_100g
</li><li>caprylic-acid_100g
</li><li>capric-acid_100g
</li><li>lauric-acid_100g
</li><li>myristic-acid_100g
</li><li>palmitic-acid_100g
</li><li>stearic-acid_100g
</li><li>arachidic-acid_100g
</li><li>behenic-acid_100g
</li><li>lignoceric-acid_100g
</li><li>cerotic-acid_100g
</li><li>montanic-acid_100g
</li><li>melissic-acid_100g
</li><li>monounsaturated-fat_100g
</li><li>polyunsaturated-fat_100g
</li><li>omega-3-fat_100g
</li><li>alpha-linolenic-acid_100g
</li><li>eicosapentaenoic-acid_100g
</li><li>docosahexaenoic-acid_100g
</li><li>omega-6-fat_100g
</li><li>linoleic-acid_100g
</li><li>arachidonic-acid_100g
</li><li>gamma-linolenic-acid_100g
</li><li>dihomo-gamma-linolenic-acid_100g
</li><li>omega-9-fat_100g
</li><li>oleic-acid_100g
</li><li>elaidic-acid_100g
</li><li>gondoic-acid_100g
</li><li>Mead-acid_100g
</li><li>erucic-acid_100g
</li><li>nervonic-acid_100g
</li><li>trans-fat_100g
</li><li>cholesterol_100g
</li><li>sucrose_100g
</li><li>glucose_100g
</li><li>fructose_100g
</li><li>lactose_100g
</li><li>maltose_100g
</li><li>maltodextrins_100g
</li><li>starch_100g
</li><li>polyols_100g
</li><li>casein_100g
</li><li>serum-proteins_100g
</li><li>nucleotides_100g
</li><li>sodium_100g - in case the salt_100g field is not filled
</li><li>alcohol_100g
</li><li>vitamin-a_100g
</li><li>beta-carotene_100g
</li><li>vitamin-d_100g
</li><li>vitamin-e_100g
</li><li>vitamin-k_100g
</li><li>vitamin-c_100g
</li><li>vitamin-b1_100g
</li><li>vitamin-b2_100g
</li><li>vitamin-pp_100g
</li><li>vitamin-b6_100g
</li><li>vitamin-b9_100g
</li><li>folates_100g
</li><li>vitamin-b12_100g
</li><li>biotin_100g
</li><li>pantothenic-acid_100g
</li><li>silica_100g
</li><li>bicarbonate_100g
</li><li>potassium_100g
</li><li>chloride_100g
</li><li>calcium_100g
</li><li>phosphorus_100g
</li><li>iron_100g
</li><li>magnesium_100g
</li><li>zinc_100g
</li><li>copper_100g
</li><li>manganese_100g
</li><li>fluoride_100g
</li><li>selenium_100g
</li><li>chromium_100g
</li><li>molybdenum_100g
</li><li>iodine_100g
</li><li>caffeine_100g
</li><li>taurine_100g
</li><li>ph_100g
</li><li>collagen-meat-protein-ratio_100g
</li><li>cocoa_100g
</li><li>chlorophyl_100g
</li><li>Carbon-footprint_100g
</li><li>glycemic-index_100g
</li><li>Waterpolo hardness_100g
</li><li>choline_100g
</li><li>phylloquinone_100g
</li><li>beta-glucan_100g
</li><li>inositol_100g
</li><li>carnitine_100g
</li></ul>
<h4 id="envoi_des_photos_et_des_donnees">Sending photos and data</h4>
<p>If the number of products is relatively small (less than 1000 products) and the updates are infrequent (for example every 6 months), it is possible to send us the photos and the CSV file by any means (for example mail for CSV file and WeTransfer, Google Drive, DropBox etc. for photos).</p>
<p>For a larger number of products or a more regular update, we can create an SFTP space where you can manually or automatically send data and photos. Contact us so that we can put this in place.</p>
<h2 id="questions_frequentes">Frequently asked Questions</h2>
<h3 id="est_ce_que_le_referencement_des_produits_est_gratuit">Is the listing of products free?</h3>
<p>The import of the data is completely free. We do not accept any retribution for the inclusion of data. We are very pleased that you have decided to contribute the data of your products to the food transparency, and we thank you for it.</p>
<h3 id="les_donnees_des_producteurs_vont_elles_ecraser_les_donnees_saisies_par_les_contributeurs">Will producer data overwrite data entered by contributors?</h3>
<p>Producer data is automatically controlled by Open Food Facts with consistency checking algorithms, and then by some contributors. We have full confidence in the data you send us, but we know by experience that typos are possible.</p>
<p>Once checked, they will replace and / or supplement the data entered by the contributors.</p>
<p>In the case of a regular and automated import, the data will replace at every import the updates by contributors, unless a manifest error (which will be reported to you) is reported on a product by a contributor.</p>
<h3 id="est_il_possible_de_supprimer_les_produits_qui_ne_sont_plus_vendus">Is it possible to delete products that are no longer sold?</h3>
<p>When a product disappears from the shelves, it is quickly consumed, and we find that it is quickly no longer scanned.</p>
<p>We then archive the product so that it remains available as an archive for scientific purposes in the context of food cohorts that can last for decades. It is indeed essential to be able to obtain the compositions of the product at a precise date, even if it has changed or disappeared.</p>
<p>If you have historical data on your old products or old versions of your products, we would also be very interested in this historical data, in order to be able to go back in time, to allow scientific analyzes on long time, and to make it possible to visualize the evolution some products.</p>
<p>Producers can also send us the lists of barcodes removed from the sale so that we can label the products appropriately.</p>
<h3 id="est_ce_que_les_produits_pour_animaux_les_produits_non_alimentaires_les_cosmetiques_et_les_autres_produits_peuvent_etre_integres_a_open_food_facts">Can animal products, non-food products, cosmetics and other products be integrated into Open Food Facts?</h3>
<p>We have created specific projects for cosmetics, for animal feed, as well as for other products (Open Beauty Facts, Open Pet Food Facts and Open Products Facts respectively). We are therefore happy to be able to import your products into the project that suits them.</p>
</div></body></html>