Overslaan naar inhoud

How to - Enable banking setup

Volg deze stappen om de enable banking module in te stellen
13 februari 2026 in
How to - Enable banking setup
Administrator

Handleiding: Enable Banking koppelen in Odoo

Inhoud

  1. Wat je gaat doen
  2. Vereisten
  3. Private key en certificaat aanmaken
  4. Applicatie registreren bij Enable Banking
  5. Setup in Odoo invullen
  6. Verbinding testen
  7. Bankkoppeling starten en synchroniseren
  8. Beveiliging en beheer
  9. Veelvoorkomende fouten en oplossingen
  10. Snelle checklist

1. Wat je gaat doen

In deze handleiding koppel je Odoo aan Enable Banking via de nieuwe Enable Banking app in Odoo. Je stelt alles in vanuit de app zelf, zonder losse systeemparameters.

Na deze stappen kun je:

  • verbinding maken met je bank(en),
  • transacties synchroniseren,
  • de status van de koppeling controleren,
  • en problemen sneller oplossen.

2. Vereisten

Zorg dat je het volgende hebt:

  • Odoo met de module account_enable_banking geïnstalleerd.
  • Toegang tot een terminal om OpenSSL-commando’s uit te voeren.
  • Rechten om een applicatie aan te maken op Enable Banking.
  • Een gebruiker met voldoende rechten in Odoo (bij voorkeur boekhoudbeheerder).

3. Private key en certificaat aanmaken

3.1 Maak een private RSA key

openssl genrsa -out private.key 4096

3.2 Maak een self-signed certificaat

openssl req -new -x509 -days 365 \
  -key private.key \
  -out public.crt \
  -subj "/C=NL/ST=State/L=City/O=Organization/CN=api.domain.tld"

3.3 Maak een PKCS#12 bestand (optioneel, vaak handig voor upload/workflow)

openssl pkcs12 -export \
  -out enable_banking_sandbox.p12 \
  -inkey private.key \
  -in public.crt \
  -name "enable_banking_production"

Belangrijk:

  • Bewaar private.key veilig.
  • Deel de private key nooit via e-mail of chat.
  • Gebruik bij voorkeur een secrets vault voor productie.

4. Applicatie registreren bij Enable Banking

  1. Log in op Enable Banking.
  2. Upload je publieke certificaat (public.crt).
  3. Maak/registreer je applicatie.
  4. Kopieer de Application ID (kid).

Je hebt straks in Odoo nodig:

  • Application ID
  • Private Key (PEM-inhoud van private.key)

5. Setup in Odoo invullen

  1. Open in Odoo de app Enable Banking.
  2. Ga naar Setup.
  3. Vul minimaal deze velden in:
  • Application ID
  • Private Key (PEM)
  • API Base URL (standaard: https://api.enablebanking.com)
  • JWT Issuer (standaard: enablebanking.com)
  • JWT Audience (standaard: api.enablebanking.com)
  • JWT TTL (seconds) (bijv. 300, max 86400)
  • Request Timeout
  • Widget URL (de URL van de Enable Banking widget)
  1. Klik op Save.

Tip:


6. Verbinding testen

  1. Klik op Test Connection in het Setup-scherm.
  2. Odoo voert een JWT-auth test uit tegen Enable Banking.
  3. Controleer de statusbalk:
  • Not Configured
  • Configured
  • Verified
  • Error

Controleer ook:

  • Last Test
  • Test Message

Bij Verified is je technische setup correct.


7. Bankkoppeling starten en synchroniseren

  1. Ga naar Enable Banking > Synchronizations.
  2. Start een nieuwe koppeling.
  3. Doorloop de bankautorisatie (consent flow).
  4. Koppel de gevonden bankrekening(en) aan de juiste dagboeken.
  5. Voer een eerste synchronisatie uit.

Daarna kun je:

  • handmatig transacties ophalen,
  • of automatische synchronisatie gebruiken (indien geactiveerd).

8. Beveiliging en beheer

Aanbevolen werkwijze:

  • Geef alleen beheerders toegang tot setup.
  • Roteer keys periodiek.
  • Gebruik aparte credentials voor sandbox en productie.
  • Log nooit private keys in plaintext.
  • Controleer regelmatig op verlopen consent/sessie.

9. Veelvoorkomende fouten en oplossingen

Fout: “Invalid private key format”

Oorzaak: verkeerd geplakte sleutel of verkeerd formaat.

Oplossing: plak volledige PEM inclusief:

  • -----BEGIN PRIVATE KEY-----
  • -----END PRIVATE KEY-----

Fout: “JWT TTL must be between 1 and 86400”

Oorzaak: TTL buiten toegestane grens.

Oplossing: zet JWT TTL op een geldige waarde, bijvoorbeeld 300.

Fout: 401/403 bij Test Connection

Oorzaak: onjuiste Application ID, verkeerde key, of certificaat mismatch.

Oplossing:

  • Controleer of het geüploade public cert matcht met private key in Odoo.
  • Controleer kid (Application ID).

Fout: synchronisatie werkt niet na setup

Oorzaak: consent/sessie niet correct afgerond of verlopen.

Oplossing:

  • Herstart autorisatie vanuit Synchronizations.
  • Controleer status en testbericht in Setup.

10. Checklist

  • [ ] Private key aangemaakt en veilig opgeslagen
  • [ ] Public cert geüpload naar Enable Banking
  • [ ] Application ID ontvangen
  • [ ] Setup in Odoo ingevuld
  • [ ] Test Connection = Verified
  • [ ] Bank geautoriseerd en rekening gekoppeld
  • [ ] Eerste transacties succesvol gesynchroniseerd