Aller au contenu principal
GoCardless

GoCardless et l'automatisation des encaissements : ce que le connecteur centralise dans Odoo

Avec le connecteur GoCardless, Odoo déclenche chaque encaissement sur le mandat du client, et Odoo 20 importe les versements tout seul : une tâche planifiée les récupère chaque jour, avec leurs commissions et leur détail, et une autre tourne toutes les heures.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 17 novembre 2026

L'essentiel

Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du connecteur, version 20.0 · dans les sources citées à la fin
Lecture
5 min

Si vous utilisez GoCardless et n'avez pas encore Odoo, ce qu'il vous faut savoir, c'est où atterrit chaque versement que GoCardless vous paie. Avec le connecteur (fiche sur Odoo Apps), Odoo 20 conserve une fiche par versement : montant, commissions déduites, date d'arrivée, référence, statut et type, ainsi que son détail.

Fiche d'un versement GoCardless dans Odoo, avec la date d'arrivée, le statut paid, le montant net, les commissions déduites, le total des lignes, l'écart à zéro, le détail par encaissement et le bouton Post to accounting
Fiche d'un versement en mode test, avec des données de démonstration d'une salle de sport fictive et l'interface en anglais : date d'arrivée, montant net, commissions, écart à zéro, le détail par encaissement avec sa commission et le bouton Post to accounting.

Ce que contient chaque versement

Lorsque le module importe un nouveau versement, il crée sa fiche avec le montant, les commissions déduites, la date d'arrivée, la référence, le statut et le type fournis par GoCardless, dans la devise du versement. Il récupère ensuite son détail. Chaque fiche est rattachée au compte GoCardless dont elle provient.

L'importation ne renvoie que les versements qu'elle a réellement créés. Si l'importation est exécutée à nouveau, ce qui existait déjà n'est pas compté comme nouveau : le décompte ne déclare pas deux fois le même argent.

How to stop copy-pasting between apps (Odoo)
Vidéo : How to stop copy-pasting between apps (Odoo) (vidéo en anglais)

Deux tâches planifiées, actives dès l'installation

À l'installation du module, deux tâches planifiées sont actives :

  • GoCardless: import payouts s'exécute une fois par jour.
  • GoCardless: recover missed events s'exécute toutes les heures.

La première est celle qui récupère les versements. Elle parcourt les comptes GoCardless qu'elle peut utiliser et, à la fin, compte combien de versements elle a importés et note les échecs avec leur type et un code fixe.

Comment l'encaissement est automatisé

L'encaissement est lui aussi déclenché par Odoo, sur le mandat signé par le client. Quand le client paie avec GoCardless et autorise le mandat, le module l'enregistre comme moyen de paiement et encaisse sur lui. Ensuite, chaque fois qu'Odoo débite ce moyen enregistré, par exemple quand vous enregistrez le paiement d'une facture ou quand un abonnement Odoo se renouvelle, le module envoie l'encaissement à GoCardless avec une clé fixe. Si GoCardless ne répond pas à cette requête, la tâche planifiée qui s'exécute toutes les heures la renvoie avec la même clé, si bien que l'encaissement ne part qu'une fois. La suite, les versements, c'est la tâche planifiée quotidienne qui l'importe.

Les parcours du connecteur, comparés

SituationCe que fait le connecteurDétail
Chaque jourLa tâche GoCardless: import payouts parcourt les comptes utilisables et récupère leurs versementsActive dès l'installation
Toutes les heuresLa tâche GoCardless: recover missed events s'exécuteActive dès l'installation
Compte non connecté, avec un environnement différent de celui de son jeton ou détecté comme une copieLa tâche ne l'appelle pasElle ne ferait que répéter la même exception à chaque exécution
Nouveau versementCrée la fiche avec montant, commissions déduites, date d'arrivée, référence, statut et type, et récupère son détailCompte comme importé
Versement déjà importéMet à jour le statut et la date d'arrivéeNe compte pas comme nouveau ; s'il n'a pas de détail, il le récupère à nouveau
Versement dans une devise archivéeRéactive la deviseOdoo ne valide pas une écriture dans une devise archivée
Versement dans une devise qu'Odoo ne connaît pasL'ignoreNoté dans le journal technique
Nombreux versementsSuit le curseur de GoCardless, page après pageL'importation initiale ne perd pas les plus anciens
Un compte échoueNote l'échec et continue avec les autresNote le type d'échec et un code fixe
GoCardless limite le rythme des requêtesAttend et réessaie, un nombre limité de foisSi les tentatives sont épuisées, cela compte comme un échec de ce compte

Les cas en détail

Un versement en attente peut changer ensuite

Un versement importé alors qu'il était encore en attente peut être rejeté ou payé plus tard. C'est pourquoi, lorsque le versement existe déjà, le module n'en crée pas un autre : il met à jour son statut et sa date d'arrivée. Conserver le premier statut permettrait d'enregistrer en banque comme encaissé un paiement rejeté.

Si une importation précédente a créé l'en-tête et a échoué en récupérant le détail, la suivante le redemande. Sans cette étape, le versement resterait déséquilibré et impossible à comptabiliser.

L'échec d'un compte n'arrête pas les autres

La tâche n'appelle que les comptes GoCardless qui sont connectés, dans l'environnement de leur jeton et qui ne sont pas une copie. Si un compte renvoie une erreur, elle la note et passe au suivant. L'échec est noté avec son type et un code fixe, jamais avec un identifiant GoCardless ni son texte.

Importation initiale complète

GoCardless livre les versements par pages. Le module suit le curseur jusqu'à ce qu'il n'y en ait plus, car s'arrêter à la première page ferait perdre silencieusement tous les versements les plus anciens lors de l'importation initiale.

Devises archivées

Odoo fournit toutes les devises, mais laisse archivées celles qui ne sont pas utilisées. Si GoCardless paie dans l'une d'elles, le module la réactive, car l'argent est arrivé dans cette devise et doit pouvoir être utilisé en comptabilité. Si la devise n'existe pas dans Odoo, le versement est ignoré.

Limite de requêtes

Si GoCardless limite le rythme des requêtes, le module attend et réessaie, mais seulement un nombre limité de fois. S'il n'y parvient toujours pas, la tâche note l'échec de ce compte, avec son type et un code fixe, et continue avec les autres.

Comment FlexigoTech vous aide

Si vous n'utilisez pas encore Odoo, FlexigoTech déploie Odoo 17, 18, 19 et 20 et développe des connecteurs et des intégrations sur mesure : nous pouvons mettre en place Odoo et faire fonctionner le connecteur GoCardless. Vous trouvez le module sur la fiche Odoo Apps et sur la page du connecteur. Le connecteur fonctionne avec l'abonnement à FlexigoTech Cloud.

À lire aussi

Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources

  • Code du module : flexigo_payment_gocardless 20.0 (6fe1a716): data/ir_cron_data.xml
  • Code du module : flexigo_payment_gocardless 20.0 (6fe1a716): models/payment_provider.py
  • flexigotech.com/en/services.html
  • Code du module : flexigo_payment_gocardless 20.0 (6fe1a716): models/gocardless_payout.py