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

1. Open GoCardless Banking Settings in de zoekbalk.
2. Plak uw Secret ID en Secret Key uit het
   bankaccountdata-dashboard van GoCardless.
3. 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)

1. Ga naar GoCardless Banking Agreement → Nieuw.
2. Bank — zoek en kies uw bank uit de live lijst (opgehaald via
   GoCardless, dus u ziet precies wat ze nu ondersteunen).
3. Opslaan. Het formulier genereert een Requisition Link.
4. Klik op de link — u wordt doorgestuurd naar de online-bankieren-login
   van uw bank (uw echte bank, niet GoCardless). Authenticeer.
5. 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:

1. Wacht op het dagelijkse schema. Elke rekening met Automatic
   Sync aangevinkt synchroniseert eens per dag, doorgaans 's nachts.
2. 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.
3. 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.