Odoo koppelen

Cifer leest je boekhouding uit Odoo met een API-sleutel. Die maak je in Odoo, in vier stappen. Je hebt er een beheerder van je Odoo voor nodig. Kijk eerst bij stap 3 of je Odoo een koppeling toelaat.

1. De gebruiker

Maak in Odoo een aparte gebruiker voor Cifer, die alleen mag lezen.

1. Ga naar Settings → Users & Companies → Users en klik op New.
2. Geef de gebruiker de naam cifer-bot. Geef als e-mailadres een adres dat je zelf leest: Odoo stuurt daar een uitnodiging om een wachtwoord te kiezen. Dat wachtwoord heb je nodig in stap 2.
3. In de tab Access Rights: kies bij Accounting de rechten Show Accounting Features - Readonly, en zet Analytic Accounting aan. Zonder Analytic Accounting kan Cifer je kostenplaatsen niet lezen en weigert het formulier de sleutel.
4. Zie je een van die twee niet, zet dan eerst de ontwikkelaarsmodus aan (Settings, helemaal onderaan: Activate the developer mode) en open de gebruiker opnieuw.
5. Geef de gebruiker geen rechten op andere apps. Cifer heeft alleen deze nodig.
6. Heeft je Odoo meer dan één bedrijf, kies dan bij Allowed Companies alle bedrijven die Cifer mag lezen. Cifer leest alleen de bedrijven die deze gebruiker ziet.
7. Klik op Save.

2. De sleutel

1. Meld je aan in Odoo als de gebruiker van stap 1.
2. Klik rechtsboven op je avatar en kies My Preferences (in sommige versies Preferences).
3. Open de tab Account Security en klik op New API Key. Odoo vraagt eerst je wachtwoord.
4. Geef de sleutel een omschrijving, bijvoorbeeld Cifer.
5. Toont Odoo een keuze Scope, kies dan RPC. Cifer leest via de gewone koppeling van Odoo, niet via MCP.
6. Kies een duur. Wij raden 1 Year aan: dan vernieuw je de sleutel één keer per jaar, en Cifer stuurt je vooraf een mail. Met Never vervalt de sleutel niet, maar werkt hij ook als hij ooit uitlekt, tot je hem intrekt. Odoo laat een gebruiker die alleen mag lezen soms een sleutel van hoogstens 90 dagen maken.
7. Odoo toont de sleutel één keer. Kopieer hem meteen en noteer de vervaldatum. Zet de sleutel niet in een mail of een gedeeld document: vul hem in stap 4 meteen in.

3. Wat je Odoo nodig heeft

• Odoo 19 of nieuwer. Een oudere versie leest Cifer niet.
• Het abonnement Custom bij Odoo Online, of Odoo.sh, of een eigen server. Met het abonnement Standard laat Odoo geen koppeling toe.
• Het Belgisch rekeningschema in elk bedrijf dat Cifer leest. Een bedrijf met een ander rekeningschema slaat Cifer over.

4. Het formulier

Open de link die je van Cifer kreeg, en vul in:

• Adres van je Odoo: het adres waarmee je Odoo opent, zoals https://jouwbedrijf.odoo.com.
• Databank: op Odoo Online het deel voor .odoo.com. Bij https://jouwbedrijf.odoo.com is dat jouwbedrijf. Op Odoo.sh of een eigen server vraag je de naam aan wie je Odoo beheert.
• API-sleutel: de sleutel van stap 2.
• Vervaldatum van de sleutel: de datum die je in stap 2 noteerde. Koos je Never, laat dit veld dan leeg.

Cifer test de sleutel meteen. Lukt dat niet, dan zegt het formulier wat er schort, en bewaart Cifer niets.

Cifer bewaart de sleutel versleuteld en gebruikt hem alleen om je boekhouding te lezen. 30 en 7 dagen voor de vervaldatum krijg je een mail met een link om een nieuwe sleutel in te vullen. Je kan de sleutel altijd intrekken in Odoo, in dezelfde tab Account Security. Dan kan Cifer niets meer ophalen.

Wat Cifer uit Odoo leest en hoe lang Cifer het bijhoudt, staat in het privacybeleid. Een vraag? Mail naar ruben@cifer.be.