eKonomi koppelen aan APIcenter

Je koppelt eKonomi aan APIcenter door in te loggen bij eKonomi en APIcenter toestemming te geven om met jouw bedrijf te werken. eKonomi gebruikt hiervoor OAuth 2.0: je geeft toestemming in eKonomi zelf en vult nergens je wachtwoord in bij APIcenter. Je doet dit één keer. Daarna gebruik je eKonomi in al je integraties.

Wat je nodig hebt

• Een eKonomi-account met toegang tot het bedrijf dat je wilt koppelen. Heeft de gebruiker geen toegang tot eKonomi voor dat bedrijf, dan weigert eKonomi de verbinding.
• Een bedrijf dat actief is en de startgids in eKonomi heeft afgerond. Anders weigert eKonomi alle aanvragen voor dat bedrijf.
• Een gebruiker die de licentieovereenkomst van eKonomi heeft geaccepteerd. Log hiervoor één keer met dezelfde gebruiker en hetzelfde bedrijf in bij eKonomi.
• Voor sommige onderdelen heb je extra modules in eKonomi nodig. Heeft je abonnement een onderdeel niet, dan geeft eKonomi een foutmelding bij het ophalen of versturen van die gegevens.

Zo koppel je eKonomi

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies eKonomi.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je bedrijf, en klik op Opslaan.
3. Klik op Autoriseren, log in bij eKonomi in het venster dat opent, kies het bedrijf dat je wilt koppelen en geef toestemming.
4. Klik op Testverbinding. Zie je "Verbinding is goed!", dan is eKonomi klaar voor gebruik.

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

Hoe lang de verbinding werkt

eKonomi geeft APIcenter een toegangstoken dat 60 minuten geldig is. Met een vernieuwingstoken vraagt APIcenter daarna een nieuw toegangstoken aan. Het vernieuwingstoken is twee jaar geldig. Verandert de gebruiker waarmee je hebt ingelogd zijn wachtwoord in eKonomi, dan wordt het vernieuwingstoken ongeldig. Klik dan opnieuw op Autoriseren.

Als het niet lukt

eKonomi geeft bij een fout een foutcode en een foutnummer (Error ID) terug. Je ziet ze in de activiteit. Zie eKonomi: veelvoorkomende fouten voor de betekenis van de codes. Algemene hulp bij inloggen staat in Verbinding of inloggen mislukt.

Volgende stappen

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

Meer informatie van eKonomi zelf staat in de documentatie voor ontwikkelaars van Visma eAccounting.