Documentation / Importer des données

Importer des produits

Vous pouvez importer des produits au format CSV. Cette fonctionnalité peut vous être utile si vous utilisiez d'autres logiciels avant Ouvretaferme ou si vous voulez concevoir plus facilement votre gamme de produits sur tableur !

Importer des produits au format CSV

Les produits que vous importez au format CSV sont ajoutés à la liste de vos produits existants, à l'exception de ceux que vous tentez d'importer sous une référence déjà existante. Les produits concernés ne seront pas ajoutés une deuxième fois mais seront modifiés avec les nouvelles valeurs, à l'exception de l'unité de vente qui ne peut pas être modifiée par un import.

Si vous réimportez un produit avec une référence identique, toutes les valeurs seront mises à jour y compris celles qui ne sont pas présentes dans votre fichier CSV. Soyez donc vigilant car si vous importez un fichier sans la colonne quality par exemple, tous les produits réimportés avec une référence identique perdront leur signe de qualité.

Le fichier CSV que vous importez doit comporter une ligne par produit, et les colonnes de ce fichier doivent correspondre à la liste des données à fournir décrite plus bas.

  • La première ligne du fichier CSV correspond aux en-têtes qui doivent être recopiées sans modification
  • Le séparateur des colonnes dans le fichier est la virgule (,)
  • Le fichier doit être enregistré au format UTF-8 ou UTF-16

Télécharger un exemple CSV

Vous utilisiez Elzeard ?

Un import des produits depuis Elzeard est également possible avec un convertisseur proposé par Alexis, qui transformera le format d'export de Elzeard vers le format de Ouvretaferme (voir le script en Python sur Github)

Liste des données à fournir

Type de donnée Nom de l'entête Description Exemple
Type de produit type Les valeurs possibles :
plant → Produit d'origine végétale
animal → Produit d'origine animale
food → Produit alimentaire transformé
product → Produit non alimentaire
service → Prestation de service
plant
Nom du produit name Le nom du produit Tomate
Référence du produit reference Une référence interne pour le produit (uniquement des chiffres, des lettres et des tirets). Une même référence ne peut pas être utilisée pour plusieurs produits. TOMCDB
Unité de vente unit L'unité de vente doit correspondre à une des unités de vente de votre ferme. Vous devez utiliser le nom de l'unité au singulier. kg
Prix pour les particuliers price_private Le prix en € TTC du produit pour les particuliers.
Vous devez renseigner au moins un prix, qu'il soit professionnel ou particulier, pour votre produit.
5
Prix pour les professionnels price_pro Le prix en € HT du produit pour les professionnels.
Vous devez renseigner au moins un prix, qu'il soit professionnel ou particulier, pour votre produit.
3
Taux de TVA vat_rate Le taux de TVA du produit (peut être laissé à 0 si vous avez indiqué que votre ferme n'est pas redevable de la TVA) 5,5
Complément d'information sur le produit additional Un court texte pour compléter le nom du produit Environ 400 grammes
Origine du produit origin L'origine géographique du produit La ferme du voisin (63)
Signe de qualité quality Les valeurs possibles :
organic → Agriculture biologique
nature-progres → Nature & Progrès
conversion → En conversion vers l'agriculture biologique
organic

Autres données que vous pouvez fournir

Certaines données qui ne s'appliquent qu'à certains profils de produits peuvent être ajoutées à votre fichier CSV.
Par exemple, la colonne pour définir la variété d'un produit ne sera prise en compte que pour les produits d'origine végétale.

Type de donnée Nom de l'entête Description Exemple
Mode de distribution distribution Le mode de distribution du produit parmi :
production → Produit issu de votre production
resale → Produit en achat-revente
Si ce champ n'est pas fourni, le produit sera considéré comme issu de votre propre production.
Utilisable pour : Produit d'origine végétale, Produit d'origine animale, Produit alimentaire transformé, Produit non alimentaire, Autre produit
production
Espèce species Le nom de l'espèce dont fait partie ce produit et qui doit correspondre à une espèce existante de votre ferme.
Utilisable pour : Produit d'origine végétale
Tomate
Variété variety Un nom de variété
Utilisable pour : Produit d'origine végétale
Coeur de boeuf
Surgelé frozen yes si le produit est vendu surgelé, no ou vide sinon
Utilisable pour : Produit d'origine animale, Produit alimentaire transformé
false
Conditionnement packaging Le conditionnement du produit
Utilisable pour : Produit d'origine végétale, Produit d'origine animale, Produit alimentaire transformé, Produit non alimentaire
Pack de 6 bouteilles
Composition composition La composition du produit
Utilisable pour : Produit alimentaire transformé, Produit non alimentaire
Purée de noisette (90 %), Sucre de canne (10 %)
Allergènes allergen Les allergènes du produit
Utilisable pour : Produit alimentaire transformé
Traces de fruits à coques
Description description La description du produit en texte simple Facile à cuisiner, cette pomme de terre ravira vos papilles.