Migrer vers Ondes PRO depuis un autre outil, avec l’API et l’IA

Que peut-on reprendre dans Ondes PRO, et dans quel ordre ?

Importer vos données dans Ondes PRO, étape par étape

Exemple suivi tout au long du guide : Atelier Lumen reprend 412 produits, 1 380 clients et 37 factures en attente de paiement.

1. 1

   Exportez depuis l’ancien outil

   Récupérez un fichier CSV par type d’objet : produits, clients, factures ouvertes avec leurs lignes. Gardez les identifiants d’origine dans une colonne : ils serviront de clés d’idempotence et de table de correspondance.

2. 2

   Connectez votre assistant à votre espace

   Connectez Claude Code, Cursor ou un autre client MCP au serveur de votre espace par OAuth (voir les clients compatibles). Pour un script autonome, créez plutôt une clé dédiée avec shop:write et billing:write, à révoquer une fois la migration terminée.

   bashCopier

   claude mcp add --transport http ondes https://votre-espace.ondes.pro/mcp/

3. 3

   Faites établir la correspondance des colonnes

   Donnez l’export à l’assistant. Il lit la fiche de chaque ressource avec ondes_ressource — champs obligatoires, types, valeurs admises — et propose une table de correspondance : « Libellé » vers name, « PV HT » vers price, « Réf. » vers sku. Relisez-la : c’est le seul moment où un humain doit vraiment trancher.

4. 4

   Simulez sur un échantillon

   Demandez à l’assistant de valider une dizaine de lignes avec simuler: true : le serveur vérifie chaque corps et répond comme pour une vraie création, sans rien enregistrer. Les formats fautifs (prix avec symbole, TVA écrite « 20 % », pays en toutes lettres) apparaissent ici, champ par champ.

5. 5

   Importez par lots de 100

   POST /api/v1/<ressource>/lot/ écrit jusqu’à 100 objets dans une transaction : si une ligne est refusée, le lot entier est annulé et la réponse désigne la ligne et la raison. Ajoutez une Idempotency-Key dérivée des identifiants d’origine du lot : relancer après une coupure ne crée aucun doublon.

6. 6

   Reprenez la facturation en dernier

   Créez d’abord les devis et leurs lignes (le numero d’un devis est facultatif : laissé vide, il prend la séquence de la société), puis une facture par devis. Simulez chaque facture avant l’écriture réelle : une fois créée, elle ne se supprime plus.

7. 7

   Contrôlez le résultat

   Comparez les totaux : nombre de produits, de clients, montant des factures en attente. Le filtre ?search= de shop/produits (nom ou SKU) et de billing/clients (nom ou e-mail) retrouve rapidement une ligne manquante. L’assistant peut produire ce rapport de contrôle lui-même.

L’assistant lit l’export et simule avant d’écrire

Le corps d’un lot de clients

Chaque opération porte sa méthode et ses données ; un id n’est exigé que pour modifier ou supprimer un objet existant.

curl -X POST https://votre-espace.ondes.pro/api/v1/billing/clients/lot/ \
  -H "Authorization: ApiKey opk_…" \
  -H "Idempotency-Key: reprise-clients-lot-001" \
  -H "Content-Type: application/json" \
  -d '{
    "operations": [
      {"methode": "POST", "donnees": {"nom": "Brasserie La Canopée", "email": "compta@lacanopee.fr", "ville": "Nantes"}},
      {"methode": "POST", "donnees": {"nom": "Galerie Ressac", "societe": "Ressac SAS", "siret": "…", "ville": "Biarritz"}}
    ]
  }'

Cent opérations au plus par lot. Une seule refusée, et rien n’est écrit.

Les pièges classiques d’une reprise de données

• Les doublons de clients : un même client saisi deux fois dans l’ancien outil. Dédoublonnez sur l’e-mail ou le SIRET avant l’import, l’assistant peut le faire sur le CSV.
• Les montants TTC pris pour du HT : les prix et lignes Ondes PRO sont saisis hors taxes, avec un taux de TVA par ligne. Vérifiez sur deux ou trois factures que les totaux recalculés tombent juste.
• Les images : elles se téléversent à part, en multipart, sur shop/images-produit une fois les produits créés. Un lot ne transporte pas de fichiers.
• Les sociétés : si votre espace porte des filiales, chaque objet appartient à la société de l’appel. Importez société par société, sans mélanger les fichiers.
• La clé oubliée : révoquez la clé de migration à la fin. Une connexion OAuth, elle, se coupe nommément depuis l’onglet MCP.

Et si je n’ai pas de développeur ?

Pour aller plus loin

• Boutique en ligneCommandes, catalogue, codes promo et expéditions pilotés par votre assistant, en mode test par défaut.Lire
• FacturationDevis, factures, relances et avoirs préparés par votre assistant, dans le respect des règles de facturation.Lire
• Gestion des stocksNiveaux, réceptions, nomenclatures et ordres de production consultés et préparés par votre assistant.Lire
• CRMFiches clients, notes de suivi, pipeline et relances tenus à jour par votre assistant.Lire

Questions fréquentes

À lire aussi

• Relier son siteAfficher le catalogue et encaisser par Stripe depuis un site déjà en ligne, sans le reconstruire.Lire
• Construire une intégrationClés à portées, webhooks signés, idempotence et mode test pour un back-office qui ne crée jamais de doublon.Lire
• Automatiser avec l’IARelances, rapports et automatisations décrits en une phrase, toujours relus avant d’agir.Lire