Gebruik je GoCardless en heb je nog geen Odoo, dan moet je vooral weten waar elke uitbetaling van GoCardless terechtkomt. Met de connector (vermelding in Odoo Apps) bewaart Odoo 20 per uitbetaling een kaart: bedrag, ingehouden kosten, aankomstdatum, referentie, status en type, plus de specificatie.

Post to accounting.Wat elke uitbetaling meebrengt
Wanneer de module een nieuwe uitbetaling importeert, maakt hij de kaart aan met het bedrag, de ingehouden kosten, de aankomstdatum, de referentie, de status en het type dat GoCardless doorgeeft, in de valuta van de uitbetaling. Daarna haalt hij de specificatie op. Elke kaart blijft gekoppeld aan de GoCardless-account waar hij vandaan komt.
De import geeft alleen de uitbetalingen terug die hij echt heeft aangemaakt. Draait de import opnieuw, dan telt wat er al was niet als nieuw: de telling meldt hetzelfde geld nooit twee keer.

Twee geplande acties, actief na installatie
Bij het installeren van de module zijn twee geplande acties actief:
GoCardless: import payoutsdraait één keer per dag.GoCardless: recover missed eventsdraait elk uur.
De eerste haalt de uitbetalingen op. Ze loopt langs de GoCardless-accounts die ze kan gebruiken en telt aan het eind hoeveel uitbetalingen ze heeft geïmporteerd en noteert de fouten met hun type en een vaste code.
Hoe de incasso wordt geautomatiseerd
Ook de incasso start Odoo, met het mandaat dat de klant heeft getekend. Als de klant met GoCardless betaalt en het mandaat autoriseert, slaat de module het op als betaalmethode en incasseert ermee. Daarna stuurt de module telkens als Odoo die opgeslagen methode belast, bijvoorbeeld als je de betaling van een factuur registreert of als een Odoo-abonnement wordt verlengd, de incasso met een vaste sleutel naar GoCardless. Antwoordt GoCardless niet op dat verzoek, dan stuurt de geplande actie die elk uur draait het opnieuw met dezelfde sleutel, zodat de incasso maar één keer vertrekt. Wat daarna komt, de uitbetalingen, haalt de dagelijkse geplande actie op.
De routes van de connector naast elkaar
| Situatie | Wat de connector doet | Detail |
|---|---|---|
| Elke dag | De actie GoCardless: import payouts loopt langs de bruikbare accounts en haalt hun uitbetalingen op | Is actief na installatie |
| Elk uur | De actie GoCardless: recover missed events draait | Is actief na installatie |
| Account niet verbonden, met een andere omgeving dan die van zijn token of herkend als kopie | De actie roept hem niet aan | Zou bij elke uitvoering alleen dezelfde uitzondering herhalen |
| Nieuwe uitbetaling | Maakt de kaart aan met bedrag, ingehouden kosten, aankomstdatum, referentie, status en type, en haalt de specificatie op | Telt als geïmporteerd |
| Reeds geïmporteerde uitbetaling | Werkt de status en de aankomstdatum bij | Telt niet als nieuw; heeft ze geen specificatie, dan wordt die opnieuw opgehaald |
| Uitbetaling in een gearchiveerde valuta | Heractiveert de valuta | Odoo valideert geen boeking in een gearchiveerde valuta |
| Uitbetaling in een valuta die Odoo niet kent | Slaat ze over | Wordt in het technische logboek vermeld |
| Veel uitbetalingen | Volgt de cursor van GoCardless, pagina voor pagina | De eerste import mist de oudste niet |
| Een account faalt | Noteert de fout en gaat door met de andere | Noteert het type fout en een vaste code |
| GoCardless beperkt het aantal verzoeken | Wacht en probeert opnieuw, een beperkt aantal keer | Zijn de pogingen op, dan telt het als fout van die account |
De gevallen in detail
Een uitbetaling in behandeling kan later nog veranderen
Een uitbetaling die werd geïmporteerd toen ze nog in behandeling was, kan alsnog terugkomen of later worden uitbetaald. Daarom maakt de module, als de uitbetaling al bestaat, geen tweede aan: hij werkt de status en de aankomstdatum bij. Bij de eerste status blijven zou toelaten dat een teruggekomen betaling als geïnd op de bank wordt geboekt.
Heeft een eerdere import de kop aangemaakt maar is het ophalen van de specificatie mislukt, dan vraagt de volgende import die opnieuw op. Zonder die stap zou de uitbetaling niet sluitend zijn en niet te boeken.
Een fout in één account houdt de andere niet tegen
De actie roept alleen de GoCardless-accounts aan die verbonden zijn, in de omgeving van hun token, en die geen kopie zijn. Geeft een account een fout, dan noteert ze die en gaat ze door met de volgende. De fout wordt genoteerd met haar type en een vaste code, nooit met een GoCardless-identificatie of met de tekst ervan.
Volledige eerste import
GoCardless levert de uitbetalingen per pagina. De module volgt de cursor tot er geen meer zijn, want bij de eerste pagina blijven zou bij de eerste import alle oudste uitbetalingen ongemerkt laten verdwijnen.
Gearchiveerde valuta
Odoo brengt alle valuta mee, maar laat de ongebruikte gearchiveerd. Betaalt GoCardless in een daarvan uit, dan heractiveert de module die, omdat het geld in die valuta is aangekomen en in de boekhouding bruikbaar moet zijn. Bestaat de valuta niet in Odoo, dan wordt de uitbetaling overgeslagen.
Beperking van het aantal verzoeken
Beperkt GoCardless het aantal verzoeken, dan wacht de module en probeert hij het opnieuw, maar slechts een beperkt aantal keer. Lukt het nog steeds niet, dan noteert de actie de fout van die account, met haar type en een vaste code, en gaat ze door met de andere.
Zo helpt FlexigoTech je
Gebruik je Odoo nog niet, dan implementeert FlexigoTech Odoo 17, 18, 19 en 20 en ontwikkelt het connectoren en integraties op maat: wij kunnen Odoo opzetten en de GoCardless-connector laten draaien. Je vindt de module in de vermelding in Odoo Apps en op de pagina van de connector. De connector werkt met het FlexigoTech Cloud-abonnement.
Lees verder
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen
Bronnen
- Broncode van de module: flexigo_payment_gocardless 20.0 (6fe1a716): data/ir_cron_data.xml
- Broncode van de module: flexigo_payment_gocardless 20.0 (6fe1a716): models/payment_provider.py
- flexigotech.com/en/services.html
- Broncode van de module: flexigo_payment_gocardless 20.0 (6fe1a716): models/gocardless_payout.py
