Import de boutique vers Odoo — socle de migration (gratuit)

Guide utilisateur — Import de boutique vers Odoo (socle)

Ce module conduit une migration. Il ne sait parler à aucune boutique tout seul : chaque plateforme est apportée par un module satellite. Il sait en revanche lire un fichier CSV ou JSON, et cela suffit à s'en servir dès l'installation.

1. Le chemin le plus court

1. Migration de boutique → Migrations → Nouveau.
2. Choisissez la boutique d'origine. Si vous partez d'un export, prenez « Fichier CSV ou JSON ».
3. Cochez le périmètre : ce que vous voulez reprendre.
4. Déposez vos fichiers dans l'onglet Fichiers déposés, un par type, puis cliquez Analyser : le module affiche les colonnes qu'il a trouvées, l'encodage et le séparateur qu'il a détectés.
5. Renseignez la correspondance des champs.
6. Préparer, puis Lancer. Le mode essai est coché : rien n'entrera dans la base.
7. Lisez le Rapport. Corrigez ce qui doit l'être.
8. Décochez Mode essai, relancez. C'est fait.

2. Le mode essai, et pourquoi il n'est pas une simulation

En mode essai, le module fait réellement l'écriture dans Odoo, puis l'annule. C'est plus lent qu'un simple calcul, et c'est voulu : une taxe absente, une devise inconnue, un champ rendu obligatoire par un autre module installé chez vous ne se devinent pas. Ils se constatent.

Un essai qui se contenterait de simuler vous annoncerait trois mille créations, et la vraie migration en rejetterait trois cents. Ici, le rapport d'essai est le rapport que vous obtiendrez.

Aucune trace n'est laissée : ni produit, ni ligne au registre. Un essai ne « consomme » rien.

3. Relancer sans rien casser

C'est la promesse centrale du module, et elle n'a pas d'astérisque.

Chaque enregistrement importé est inscrit dans un registre — menu Suivi → Ce qui a déjà été importé — qui associe l'identifiant de la boutique d'origine à l'enregistrement Odoo correspondant. Au second passage, le module retrouve et met à jour. Il ne recrée rien.

Conséquences pratiques :

Ne supprimez le registre que si vous voulez réellement tout recréer. C'est le seul geste qui casse la garantie.

4. Reprendre un import interrompu

Chaque étape range son curseur après chaque page réellement écrite. Si un import de vingt mille produits s'arrête à douze mille — coupure réseau, quota de la plateforme, redémarrage du serveur —, il repart à douze mille.

• La migration passe en Suspendue et le message dit pourquoi.
• Corrigez la cause, puis cliquez Lancer : elle reprend au curseur.
• Le bouton Curseur à zéro, sur une étape, fait relire la source depuis le début. C'est sans danger : tout ce qui existe est mis à jour, rien n'est recréé.

5. Lire le rapport

Une ligne par enregistrement traité, y compris les inchangés — sans eux, vous ne pourriez pas prouver au second passage que rien n'a été dupliqué.

Les issues possibles :

Les motifs de rejet :

Exporter le rapport produit un CSV ouvrable directement dans un tableur français, accents compris.

6. La correspondance des champs

C'est le cœur du module. Chaque ligne dit : ce champ de la source va vers ce champ Odoo, avec cette transformation.

• Le champ Odoo est son nom technique (name, list_price, default_code), pas son libellé. Il est vérifié dès l'enregistrement : un nom inexistant est refusé tout de suite.
• La transformation ne se devine pas. Une colonne « prix » contenant « 12,50 € » n'est un nombre que si vous le dites.
• Obligatoire fait rejeter cette ligne-là, pas la migration.
• Une valeur par défaut remplace le vide, y compris sur un champ obligatoire : c'est le moyen d'importer un catalogue auquel il manque une colonne.

Transformations disponibles : aucune, texte, HTML vers texte brut, nombre décimal, nombre entier, oui/non, date, date et heure.

7. Fichiers CSV et JSON

• L'encodage est détecté : UTF-8 avec ou sans marque d'ordre des octets, Windows-1252, et latin-1 en dernier recours. La marque d'ordre des octets que pose Excel est retirée — sans quoi votre première colonne s'appellerait « id » et resterait introuvable.
• Le séparateur est détecté : virgule, point-virgule, tabulation, barre verticale.
• JSON : une liste d'objets, ou un objet enveloppant une liste sous n'importe quel nom (products, data, items…).
• La colonne d'identifiant : le module cherche id, identifiant, reference, ref, sku, puis code. Si votre export la nomme autrement, dites-le dans le champ prévu.

8. La file d'attente

Les imports ne partent jamais depuis l'écran : ils passent par une file, servie par une tâche planifiée toutes les cinq minutes. C'est ce qui permet de lancer vingt mille produits sans bloquer Odoo. Le bouton Traiter maintenant fait avancer la migration sans attendre.

Trois règles gouvernent cette file, et elles sont volontairement strictes :

• Un lot pris porte son horodatage.
• Un lot échoué ne repart jamais tout seul : il faut cliquer Relancer.
• Un lot orphelin — resté en cours au-delà de trente minutes, parce que son processus est mort — est signalé et compté, jamais relancé. Pour le reprendre, il faut d'abord l'annuler : cela vous oblige à constater que vous abandonnez un travail dont on ignore où il s'est arrêté.

9. Qui a le droit de quoi

• Opérateur : prépare et conduit les migrations, dépose les fichiers, règle la correspondance, lit et exporte les rapports.
• Administrateur : en plus, déclare les plateformes et leurs accès, et purge le registre.

La frontière passe entre conduire et brancher. Brancher une plateforme, c'est décider à quelle boutique le serveur parle et avec quel jeton — ce qui ouvre le catalogue et la liste des clients d'un commerçant. Cela ne se délègue pas.

10. Ce que le module ne fait pas

• Il ne se connecte à aucune boutique sans son module satellite.
• Il ne synchronise rien en continu : c'est un outil de reprise.
• Il n'envoie rien d'Odoo vers une boutique.