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.

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.

Deux tâches planifiées, actives dès l'installation
À l'installation du module, deux tâches planifiées sont actives :
GoCardless: import payoutss'exécute une fois par jour.GoCardless: recover missed eventss'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
| Situation | Ce que fait le connecteur | Détail |
|---|---|---|
| Chaque jour | La tâche GoCardless: import payouts parcourt les comptes utilisables et récupère leurs versements | Active dès l'installation |
| Toutes les heures | La tâche GoCardless: recover missed events s'exécute | Active dès l'installation |
| Compte non connecté, avec un environnement différent de celui de son jeton ou détecté comme une copie | La tâche ne l'appelle pas | Elle ne ferait que répéter la même exception à chaque exécution |
| Nouveau versement | Crée la fiche avec montant, commissions déduites, date d'arrivée, référence, statut et type, et récupère son détail | Compte comme importé |
| Versement déjà importé | Met à jour le statut et la date d'arrivée | Ne compte pas comme nouveau ; s'il n'a pas de détail, il le récupère à nouveau |
| Versement dans une devise archivée | Réactive la devise | Odoo ne valide pas une écriture dans une devise archivée |
| Versement dans une devise qu'Odoo ne connaît pas | L'ignore | Noté dans le journal technique |
| Nombreux versements | Suit le curseur de GoCardless, page après page | L'importation initiale ne perd pas les plus anciens |
| Un compte échoue | Note l'échec et continue avec les autres | Note le type d'échec et un code fixe |
| GoCardless limite le rythme des requêtes | Attend et réessaie, un nombre limité de fois | Si 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
