Odoo koppelen aan APIcenter

Je koppelt Odoo aan APIcenter met een Odoo-gebruiker en een API-sleutel. APIcenter logt met die gegevens in bij Odoo. Je doet dit één keer. Daarna gebruik je Odoo in al je integraties.

Wat je nodig hebt

• Een Odoo-omgeving waarvoor de externe API beschikbaar is. Volgens Odoo geldt dit alleen voor de Custom-abonnementen, niet voor One App Free en Standard.
• Een Odoo-gebruiker voor APIcenter. APIcenter voert alle acties in Odoo uit als deze gebruiker. De gebruiker moet de gegevens van je flows mogen bekijken en aanmaken.
• De naam van de database van je Odoo-omgeving.
• Het ID van de Odoo-gebruiker.
• Een API-sleutel van die gebruiker.

Stap 1: Maak een API-sleutel

1. Log in bij Odoo met de gebruiker die APIcenter gaat gebruiken.
2. Open Preferences (of My Profile) en ga naar het tabblad Account Security.
3. Klik op New API Key en vul een duidelijke omschrijving in, bijvoorbeeld APIcenter. Met de omschrijving herken je de sleutel later.
4. Klik op Generate Key en kopieer de sleutel meteen. Odoo toont de sleutel maar één keer. Bewaar hem op een veilige plek, zoals een wachtwoordmanager, en behandel hem als een wachtwoord.

Gebruik je liever het wachtwoord van de gebruiker? Dat kan ook: vul dan dat wachtwoord in bij API Password. Bij Odoo Online heeft een gebruiker standaard geen lokaal wachtwoord. Een beheerder kan er een instellen via Settings > Users & Companies > Users, door de gebruiker te openen en bij Action te kiezen voor Change Password.

Let op: een API-sleutel kan verlopen. In de documentatie van Odoo 19 geeft elke sleutel een geldigheidsduur van maximaal drie maanden. Verloopt de sleutel, dan stopt de koppeling. Maak dan een nieuwe sleutel en vul die in APIcenter in. Lees de actuele regels voor jouw Odoo-versie in de documentatie van Odoo.

Stap 2: Zoek de database en het gebruikers-ID op

• Database: de naam van de database van je Odoo-omgeving. Bij Odoo Online is dat de naam van je omgeving. Voor https://mycompany.odoo.com is de database mycompany.
• Gebruikers-ID: het nummer van de gebruiker (in de documentatie van Odoo uid genoemd). Odoo geeft dit nummer terug als je via de API inlogt.

Meer uitleg staat in de documentatie van Odoo over de externe API.

Stap 3: Vul de gegevens in APIcenter in

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Odoo.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je Odoo-omgeving.
3. Vul de verbindingsgegevens in:
   • Database name: de naam van de database uit stap 2.
   • Account ID: het gebruikers-ID uit stap 2.
   • API Password: de API-sleutel uit stap 1.
   • Het adres van je Odoo-omgeving, in het veld dat APIcenter daarvoor toont.
4. Klik op Opslaan en daarna op Testverbinding.

De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

Als het niet lukt

• De test mislukt. Controleer de database, het gebruikers-ID en de API-sleutel. Een tikfout in één van de drie is de meest voorkomende oorzaak. Zie ook Verbinding of inloggen mislukt.
• De koppeling werkte en stopt ineens. Controleer of de API-sleutel niet is verlopen of in Odoo is verwijderd. Maak zo nodig een nieuwe sleutel.
• Een flow meldt een fout van Odoo. Zie Odoo: veelvoorkomende fouten.

Volgende stappen

Maak een integratie met Odoo en controleer de instellingen. Zie Odoo verbindings- en integratie-instellingen.

Meer informatie van Odoo

• Externe API van Odoo 18 (XML-RPC)
• Externe JSON-2 API van Odoo 19