Enable Banking

Enable Banking koppelt ERPNext aan uw echte bank via de Enable Banking PSD2-API. Het ondersteunt 2.500+ banken in de EU en EEA via Open Banking — de grote Nederlandse banken (ABN AMRO, ING, Rabobank, Bunq, Knab, Triodos, ASN, SNS, RegioBank, Volksbank), plus Belgische, Duitse, Franse, Scandinavische en andere EEA-banken.

Transacties synchroniseren elke nacht automatisch; geen handmatige CSV-exports uit uw bankportaal.

Wat u nodig heeft

• Een Enable Banking-applicatie — meld u aan op enablebanking.com en maak er één aan in het Control Panel. Sandbox is gratis.
• Drie gegevens van de applicatiepagina:
  • application_id (UUID)
  • kid (de key ID)
  • De RS256 private key PEM — downloadbaar wanneer u de applicatie aanmaakt. Bewaar hem direct; later opnieuw downloaden kan niet.
• Online-banking-credentials van uw bank (u authenticeert bij uw bank tijdens de inrichting; ERPNext ziet uw wachtwoord nooit).
• Een ingerichte ERPNext Bankrekening voor elke bankrekening die u wilt synchroniseren.

Vergelijking met GoCardless Banking

Beide halen transacties op via PSD2 Open Banking. De belangrijkste verschillen:

• Authenticatie — Enable Banking ondertekent per API-call een verse JWT (lokaal, met uw private key). GoCardless geeft u een access token dat ERPNext dagelijks ververst.
• Dekking — Enable Banking heeft sterkere Scandinavische en EEA-dekking; GoCardless is sterker in het VK. Beide dekken de grote Nederlandse en Belgische banken.
• Consent-duur — beide PSD2-gemaximeerd op ~180 dagen. Daarna re-authoriseert u bij de bank.

Werkt GoCardless Banking al goed voor u? Dan is overstappen niet nodig. Kies Enable Banking als u EEA-brede dekking wilt of het simpelere stateless auth-model prefereert.

Eenmalige inrichting: koppel met Enable Banking

1. Open Enable Banking Settings in de awesomebar.
2. Vul Application ID, KID en Private Key in (plak de PEM, inclusief de -----BEGIN PRIVATE KEY------regels).
3. Zet Environment op Sandbox voor tests of Production voor echte banken.
4. Kopieer de automatisch ingevulde Redirect URL en plak die in uw Enable Banking Control Panel bij de toegestane redirect URLs van de applicatie. De twee moeten exact gelijk zijn.
5. Klik op Test Connection — de app ondertekent een JWT, doet GET /application en meldt succes of foutmelding.

Een bankrekening koppelen (per bank)

1. Klik in Enable Banking Settings op Browse Banks.
2. Kies land en PSU-type (personal voor consument, business voor zakelijk).
3. Kies een bank (ASPSP) uit de lijst. De app maakt een Enable Banking Session met status PENDING en een authenticatie-URL.
4. Open de auth-URL — u (of de rekeninghouder) authenticeert bij de bank. De bank redirect terug naar /api/method/enable_banking.api.handle_auth_callback.
5. De callback doet POST /sessions om de auth-code in te wisselen voor een sessie, zet de status op AUTHORIZED, en maakt automatisch één Enable Banking Account per gevonden bankrekening aan.

Per-rekening-inrichting

Na authenticatie opent u elke Enable Banking Account en:

• Bankrekening koppelen — kies de bijbehorende ERPNext-bankrekening. Dit is de koppeling waardoor transacties binnenlopen.
• Automatische synchronisatie — vink aan om deze rekening in de dagelijkse run mee te nemen.
• Klik eenmalig op Fetch Account Details om IBAN, rekeninghouder en saldo te vullen.

Transacties ophalen

Drie manieren:

1. Wacht op de dagelijkse run — elke rekening met Automatische synchronisatie draait éénmaal per dag.
2. Handmatig — open een Enable Banking Account en klik op Sync Transactions.
3. Bulk handmatig — draai Fetch for All Accounts in Enable Banking Settings.

Elke run trekt transacties op uit /accounts/{uid}/transactions, gepagineerd via de continuation_key van Enable Banking totdat alles binnen is. Nieuwe transacties landen als ERPNext Banktransactie-records (ontdubbeld op de stabiele referentie van Enable Banking), met debiteur/crediteur-namen en IBAN's al ingevuld voor reconciliatie.

Wat daarna

Eenmaal in ERPNext zijn de banktransacties klaar voor reconciliatie. Heeft u ook Advanced Bank Reconciliation geïnstalleerd, dan matcht die de meeste transacties automatisch tegen uw bestaande betalingen.

Anders gebruikt u de standaard Bankreconciliatie-tool.

Sessie-vervaldatum

PSD2 maximeert consents op 180 dagen. Wanneer een sessie verloopt, markeert de dagelijkse run hem als EXPIRED en stopt de synchronisatie. Hervatten:

1. Start een nieuwe authorisatie via Browse Banks voor dezelfde bank.
2. Koppel de nieuwe Enable Banking Account-records aan dezelfde ERPNext-bankrekeningen.

→ Volledige inrichting, troubleshooting en architectuur staan in de Enable Banking app README.