Importer des produits (variantes, images, TVA) — guide pas à pas pour développeur Odoo freelance France

Introduction

Tu es développeur Odoo freelance en France et on te demande d'importer 3 000 références avec variantes, images et règles de TVA ? Ce tutoriel te guide pas à pas pour réussir l'import via CSV depuis l'interface Odoo, avec des exemples concrets et des vérifications simples.

Prérequis

• Accès à l'instance Odoo avec droits d'import sur Produits.
• Mode développeur activé pour consulter les noms techniques si besoin.
• Un fichier CSV propre (UTF-8) et, si possible, un échantillon de 10 lignes pour tests.
• Images accessibles via URL publique ou converties en base64.

Exemple de fichier CSV

En-tête conseillé : default_code,name,attribute_value_ids/name,image_1920,tax_id/name,lst_price

Exemple de ligne : SKU-001,Chaise bois,Couleur/Noir|Taille/M,https://monsite.com/img1.jpg,TVA 20%,59.90

Étapes

1. Préparer et tester sur un petit échantillon

   Avant d'importer tout le catalogue, fais un essai avec 5 à 10 lignes. Cela évite les mauvaises surprises et te permet d'ajuster le mapping.

2. Vérifier l'encodage et le séparateur

   Odoo attend souvent UTF-8 et un séparateur « , » ou « ; ». Ouvre le CSV avec un éditeur simple et enregistre en UTF-8.

3. Gérer les variantes

   Utilise la colonne attribute_value_ids/name avec le format Attribut/Valeur|Attribut2/Valeur2 pour créer des variantes liées au produit template.

4. Importer les images

   Si tu fournis une URL accessible, Odoo télécharge l'image. Sinon, encode les images en base64 dans la colonne image_1920. Pour des imports massifs, privilégie les URLs pour la performance.

5. Mapper la TVA (pour la France)

   Utilise la colonne tax_id/name et indique l'intitulé exact présent dans Odoo (ex. « TVA 20% »). Si les taxes n'existent pas, crée-les avant l'import ou utilise des external IDs.

6. Importer et corriger

   L'interface te propose un aperçu du mapping. Si un champ n'est pas reconnu, mappe-le manuellement. Lance l'import sur l'échantillon, corrige, puis importe le fichier complet.

Erreurs fréquentes et comment les corriger

• Erreur d'encodage : caractères bizarres -> ré-enregistrer en UTF-8.
• Échec image : URL inaccessible -> tester l'URL dans un navigateur ou convertir en base64.
• Taxes non reconnues : noms différents -> vérifier l'intitulé exact ou créer la taxe avant import.
• Doublons de variantes : format d'attribut incorrect -> uniformiser séparateurs (| pour séparer les paires, / pour attribut/valeur).
• Problème de droits : import bloqué -> vérifier les droits utilisateur sur Produits.

Vérification finale

Après import, fais ces contrôles rapides :

• Ouvre 10 produits au hasard : image, prix, et taux de TVA doivent être corrects.
• Test de vente : créer une commande client pour vérifier que les taxes se calculent et que les variantes s'affichent.
• Contrôle des stocks si tu importes également les quantités : rapprocher quelques références avec l'inventaire physique.

Astuce pratique

Garde un script ou une macro pour convertir des images locales en base64 si tu dois répéter cette opération souvent. Pour les imports réguliers, documente le format exact du CSV attendu.

Si tu veux que je regarde ton fichier CSV ou que l'on programme ensemble un import fiable et réutilisable, on peut faire un diagnostic Odoo sans engagement. Réserver un diagnostic