Connecter Odoo à Xcellerate OPS : vos factures automatiquement dans Odoo

Connectez Odoo à Xcellerate OPS et chaque facture envoyée depuis OPS apparaît automatiquement comme facture client dans Odoo. Cela fonctionne avec Odoo sur odoo.com comme avec un Odoo auto-hébergé. Ce guide s'adresse aux administrateurs de MSP IT et de PME de services qui tiennent leur comptabilité dans Odoo.

TL;DR

• Il vous faut l'URL d'Odoo, le nom de la base, un login et une clé API, ainsi qu'un rôle d'administrateur dans OPS.
• Quand une facture passe de brouillon à envoyée, OPS la crée comme facture client dans Odoo.
• Vérifiez la TVA dans Odoo après la première synchronisation : OPS n'envoie pas de codes TVA.

Avant de commencer

• Vous êtes administrateur (admin) de votre espace de travail OPS.
• Votre Odoo est accessible en HTTPS depuis Internet et dispose de l'application Facturation ou Comptabilité. Pour importer des devis, l'application Ventes est aussi nécessaire.
• Vous connaissez le nom de la base de données et le login (e-mail ou nom d'utilisateur) de l'utilisateur Odoo dédié.
• Cet utilisateur peut créer des factures et des partenaires, et lire les bons de commande.
• La facturation électronique externe n'est pas activée dans OPS. Tant qu'elle l'est, l'intégration Odoo ne s'applique pas.

Connecter Odoo en 6 étapes

Étape 1 : créez une clé API dans Odoo

Dans Odoo, créez une clé API pour l'utilisateur de l'intégration. En général, cela se fait dans les préférences de l'utilisateur, sous la sécurité du compte. Le menu exact peut varier selon la version d'Odoo.

Étape 2 : ouvrez le tableau des intégrations dans OPS

Allez dans Settings → Integrations (Paramètres → Intégrations). S'il n'y a pas encore de carte Odoo dans la colonne Facturation, ajoutez Odoo depuis le catalogue.

Le tableau des intégrations avec des catégories vides (Mailbox, Authentication, Payments, Billing) et, à droite, le catalogue des intégrations disponibles.

Étape 3 : saisissez vos données

Sur la carte Odoo, remplissez URL (par exemple https://mycompany.odoo.com), Database, Login et API key. Ces libellés restent en anglais, même dans l'interface en français. Cliquez sur Enregistrer.

Étape 4 : testez la connexion

Cliquez sur Tester la connexion. En cas de succès, une confirmation affiche l'identifiant (uid) de votre utilisateur Odoo.

Étape 5 : faites d'Odoo la cible d'envoi

Cliquez sur Utiliser pour l'envoi des factures. La carte affiche le badge Cible d'envoi.

Étape 6 (facultatif) : importez l'existant

Sous Import manuel depuis Odoo, choisissez une date de départ (From date). Cliquez sur Import companies & invoices (importer entreprises et factures) et/ou Import quotes (importer les devis).

Ce qui se passe après la connexion

• Envoi automatique. Quand une facture passe de brouillon à envoyée, OPS crée une facture client dans Odoo avec le client, la date, l'échéance, le numéro de facture OPS comme référence et les lignes (description, quantité, prix unitaire net).
• Clients. OPS recherche le partenaire par nom exact. S'il n'existe pas, OPS le crée comme société, avec numéro de TVA et e-mail.
• Statut sur la facture. Chaque facture indique si la synchronisation a réussi, avec un bouton pour réessayer.
• Import manuel. Les factures client arrivent avec leur statut de paiement. Les devis proviennent des bons de commande Odoo ; les commandes confirmées sont marquées comme acceptées.
• Les devis d'OPS ne sont jamais envoyés vers Odoo.

Bon à savoir

• Vérifiez la TVA après la première synchronisation. OPS envoie les lignes sans codes TVA. Créez donc d'abord une facture de test et contrôlez la TVA dans Odoo avant de facturer à plein régime.
• Les nouveaux partenaires sont toujours créés comme sociétés, même pour un particulier. Adaptez-les dans Odoo si nécessaire.
• Les imports sont synthétiques : chaque document devient une seule ligne au montant hors TVA, avec une TVA supposée de 21 %.
• Un seul logiciel comptable reçoit les factures d'OPS à la fois. Les factures importées ne sont pas renvoyées vers Odoo.
• Pour ne plus envoyer vers Odoo, cliquez sur Arrêter l'envoi des factures.
• Après l'enregistrement, la clé API n'est plus affichée. L'URL, la base et le login restent visibles.

Dépannage

OPS utilise l'adresse JSON-RPC standard d'Odoo (votre URL suivie de /jsonrpc). Les messages ci-dessous sont repris tels qu'ils apparaissent dans l'interface en anglais.

• Odoo authentication failed — check database, login and API key. lors du test : vérifiez le nom de la base, le login et la clé API.
• Odoo authentication failed. ou Odoo RPC error lors d'un envoi ou d'un import : Odoo refuse la requête. Vérifiez que la clé est toujours valide et que l'utilisateur a les droits nécessaires.
• Configure this provider first. ou Configure and connect this provider first. : enregistrez d'abord vos données et testez la connexion.
• Import failed: <error> : lisez l'erreur, corrigez la cause dans Odoo et relancez l'import.

Découvrez les intégrations européennes d'OPS et la partie ventes et facturation. Pas encore d'espace de travail ? Commencez gratuitement, puis connectez Odoo.