Se usi GoCardless e non hai ancora Odoo, ti serve sapere dove finisce ogni payout che GoCardless ti versa. Con il connettore (scheda su Odoo Apps), Odoo 20 conserva una scheda per ogni payout: importo, commissioni trattenute, data di arrivo, riferimento, stato e tipo, oltre al suo dettaglio.

Post to accounting.Cosa porta ogni payout
Quando il modulo importa un nuovo payout, crea la sua scheda con importo, commissioni trattenute, data di arrivo, riferimento, stato e tipo forniti da GoCardless, nella valuta del payout. Poi recupera il suo dettaglio. Ogni scheda resta associata al conto GoCardless da cui proviene.
L'importazione restituisce solo i payout che ha davvero creato. Se l'importazione viene eseguita di nuovo, ciò che era già presente non conta come nuovo: il conteggio non dichiara due volte lo stesso denaro.

Due azioni pianificate, attive dall'installazione
All'installazione del modulo sono attive due azioni pianificate:
GoCardless: import payoutsgira una volta al giorno.GoCardless: recover missed eventsgira ogni ora.
La prima è quella che porta i payout. Scorre i conti GoCardless utilizzabili e, al termine, conta quanti payout ha importato e annota gli errori con il loro tipo e un codice fisso.
Come si automatizza l'incasso
Anche l'incasso lo avvia Odoo, sul mandato firmato dal cliente. Quando il cliente paga con GoCardless e autorizza il mandato, il modulo lo salva come metodo di pagamento e incassa su di esso. Poi, ogni volta che Odoo addebita quel metodo salvato, per esempio quando registri il pagamento di una fattura o quando si rinnova un abbonamento di Odoo, il modulo invia l'incasso a GoCardless con una chiave fissa. Se GoCardless non risponde a quella richiesta, l'azione pianificata che gira ogni ora la rimanda con la stessa chiave, così l'incasso parte una sola volta. Quello che viene dopo, i payout, lo porta l'azione pianificata giornaliera.
I percorsi del connettore a confronto
| Situazione | Cosa fa il connettore | Dettaglio |
|---|---|---|
| Ogni giorno | L'azione GoCardless: import payouts scorre i conti utilizzabili e ne importa i payout | È attiva dall'installazione |
| Ogni ora | Gira l'azione GoCardless: recover missed events | È attiva dall'installazione |
| Conto non collegato, con un ambiente diverso da quello del suo token o rilevato come copia | L'azione non lo chiama | Ripeterebbe solo la stessa eccezione a ogni esecuzione |
| Nuovo payout | Crea la scheda con importo, commissioni trattenute, data di arrivo, riferimento, stato e tipo, e ne recupera il dettaglio | Conta come importato |
| Payout già importato | Aggiorna lo stato e la data di arrivo | Non conta come nuovo; se non ha dettaglio, lo recupera di nuovo |
| Payout in una valuta archiviata | Riattiva la valuta | Odoo non convalida una registrazione in una valuta archiviata |
| Payout in una valuta che Odoo non conosce | Lo salta | Resta annotato nel registro tecnico |
| Molti payout | Segue il cursore di GoCardless, pagina per pagina | L'importazione iniziale non perde i più vecchi |
| Un conto fallisce | Annota l'errore e prosegue con gli altri | Annota il tipo di errore e un codice fisso |
| GoCardless limita il ritmo delle richieste | Attende e riprova, un numero limitato di volte | Se i tentativi si esauriscono, conta come errore di quel conto |
I casi in dettaglio
Un payout in sospeso può cambiare dopo
Un payout importato quando era ancora in sospeso può essere stornato o pagato più tardi. Per questo, quando il payout esiste già, il modulo non ne crea un altro: aggiorna il suo stato e la sua data di arrivo. Tenere il primo stato permetterebbe di registrare in banca come incassato un pagamento stornato.
Se un'importazione precedente ha creato l'intestazione ma non è riuscita a recuperare il dettaglio, quella successiva lo richiede di nuovo. Senza questo passaggio, il payout resterebbe non quadrato e impossibile da contabilizzare.
Un errore su un conto non ferma gli altri
L'azione chiama solo i conti GoCardless collegati, nell'ambiente del loro token e che non sono una copia. Se un conto dà errore, lo annota e passa al successivo. L'errore viene annotato con il suo tipo e un codice fisso, mai con un identificatore di GoCardless né con il suo testo.
Importazione iniziale completa
GoCardless consegna i payout a pagine. Il modulo segue il cursore fino a esaurimento, perché fermarsi alla prima pagina farebbe perdere in silenzio tutti i payout più vecchi nell'importazione iniziale.
Valute archiviate
Odoo include tutte le valute, ma lascia archiviate quelle che non si usano. Se GoCardless paga in una di esse, il modulo la riattiva, perché il denaro è arrivato in quella valuta e deve poter essere usato in contabilità. Se la valuta non esiste in Odoo, il payout viene saltato.
Limite di richieste
Se GoCardless limita il ritmo delle richieste, il modulo attende e riprova, ma solo un numero limitato di volte. Se continua a non riuscire, l'azione annota l'errore di quel conto, con il suo tipo e un codice fisso, e prosegue con gli altri.
Come ti aiuta FlexigoTech
Se non usi ancora Odoo, FlexigoTech implementa Odoo 17, 18, 19 e 20 e sviluppa connettori e integrazioni su misura: possiamo configurare Odoo e far funzionare il connettore GoCardless. Trovi il modulo nella scheda su Odoo Apps e nella pagina del connettore. Il connettore funziona con l'abbonamento a FlexigoTech Cloud.
Continua a leggere
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate
Fonti
- Codice del modulo: flexigo_payment_gocardless 20.0 (6fe1a716): data/ir_cron_data.xml
- Codice del modulo: flexigo_payment_gocardless 20.0 (6fe1a716): models/payment_provider.py
- flexigotech.com/en/services.html
- Codice del modulo: flexigo_payment_gocardless 20.0 (6fe1a716): models/gocardless_payout.py
