GoCardless Banking

GoCardless Banking verbindt ERPNext met uw echte bank via de GoCardless Bank Account Data API (voorheen Nordigen). Het ondersteunt 2.500+ banken in het VK en de EU via Open Banking — inclusief alle grote Nederlandse banken (ABN AMRO, ING, Rabobank, Bunq, Knab, Triodos, ASN, SNS, RegioBank, Volksbank).

Transacties synchroniseren automatisch elke nacht; geen handmatige CSV-exports uit het portaal van uw bank.

Wat u nodig heeft

Een GoCardless Bank Account Data-account (apart van een gewoon GoCardless-betaalaccount — meld u aan op bankaccountdata.gocardless.com).
De inloggegevens van uw online bankieren (u wordt tijdens de setup doorgestuurd naar uw bank voor authenticatie, niet gevraagd om gegevens met ERPNext te delen).
Een geconfigureerde ERPNext Bankrekening voor elke bankrekening die u wilt synchroniseren.

GoCardless' Bank Account Data API is gratis voor kleine volumes — zie hun prijspagina voor actuele limieten.

Eenmalige setup: verbinden met GoCardless

Open GoCardless Banking Settings in de zoekbalk.
Plak uw Secret ID en Secret Key uit het bankaccountdata-dashboard van GoCardless.
Klik op Generate Access Token. De app wisselt het geheime paar in voor een access-token + refresh-token, geldig voor respectievelijk ~24 uur / 30 dagen. Ze worden vanaf dat moment dagelijks vernieuwd via een schema.

Een bankrekening koppelen (per bank)

Ga naar GoCardless Banking Agreement → Nieuw.
Bank — zoek en kies uw bank uit de live lijst (opgehaald via GoCardless, dus u ziet precies wat ze nu ondersteunen).
Opslaan. Het formulier genereert een Requisition Link.
Klik op de link — u wordt doorgestuurd naar de online-bankieren-login van uw bank (uw echte bank, niet GoCardless). Authenticeer.
Uw bank stuurt u via de OAuth-callback terug naar ERPNext. De overeenkomst gaat naar status Authenticated, en er worden GoCardless Banking Accounts aangemaakt voor elke bankrekening in scope.

Configuratie per rekening

Na authenticatie wordt elke ontdekte rekening een GoCardless Banking Account-record. Open elke en:

Link Bank Account — kies de overeenkomstige ERPNext-Bankrekening. Dit is de koppeling waarmee transacties in ERPNext stromen.
Automatic Sync — vink aan om de rekening op te nemen in de dagelijkse geplande fetch. Vink uit voor rekeningen die u alleen handmatig wilt synchroniseren.
Sync Frequency — dagelijks is de standaard; de GoCardless-API limiteert gratis-tier-verzoeken op 4 fetches per rekening per 24 uur, dus dagelijks is de sweet spot.

Transacties ophalen

Drie manieren:

Wacht op het dagelijkse schema. Elke rekening met Automatic Sync aangevinkt synchroniseert eens per dag, doorgaans 's nachts.
Handmatige fetch vanaf het rekening-formulier. Open een GoCardless Banking Account, klik Fetch Transactions. Handig wanneer u vandaag transacties wilt zien voordat de geplande run van morgen draait.
Bulk handmatige fetch. Voer Fetch Transactions for All Accounts uit vanuit GoCardless Banking Settings om alle rekeningen tegelijk te verversen.

Elke fetch:

Haalt transacties op uit de GoCardless-API (tot 90 dagen op de eerste sync; incrementeel daarna).
Maakt ERPNext-Banktransactie-records aan, met deduplicatie op GoCardless-transactie-ID.
Zet de status van elke nieuwe transactie op Niet gereconcilieerd.

Nadat transacties zijn binnengekomen

Eenmaal in ERPNext als Banktransacties zijn de transacties klaar voor reconciliatie. Heeft u ook Advanced Bank Reconciliation geïnstalleerd, dan draait de auto-reconcile-job als onderdeel van het dagelijkse schema en matcht de meeste transacties tegen uw bestaande betalingen.

Zo niet, gebruik de standaard Bank Reconciliation Tool van ERPNext.

Tokenbeheer

GoCardless-access-tokens vervallen na ongeveer 24 uur. De app:

Bewaart access- + refresh-tokens in GoCardless Banking Settings (het geheim is versleuteld opgeslagen).
Vernieuwt het access-token dagelijks via een geplande taak voordat het vervalt.
Regenereert vanuit het geheime paar als het refresh-token ook is vervallen (na ~30 dagen niet-gebruik).

Ziet u ooit authenticatiefouten in het integration-request-log, dan is de handmatige fix: open GoCardless Banking Settings → klik weer op Generate Access Token. De scheduler moet dit in normale werking zonder ingrijpen afhandelen.

Beperkingen

Alleen EU/VK. GoCardless' Bank Account Data API dekt de VS, APAC of LATAM niet. Gebruik voor die regio's CSV / camt.053-import direct in ERPNext.
Alleen-lezen. Deze app haalt transacties op; het initieert geen betalingen. Voor Nederlandse SEPA-uitgaande betalingen, zie de SEPA-betalingen-functie van erpnext_netherlands.
90 dagen begin-historie. Eerste sync trekt maximaal 90 dagen — oudere transacties moeten met een CSV / camt.053-import worden aangevuld.
Bank-specifieke eigenaardigheden. Een handvol EU-banken levert inconsistente transactiebeschrijvingen of past rollende vertragingen toe. Als data van uw bank er raar uitziet, check het integration-request-log voor de ruwe respons.