Asperion koppelen aan APIcenter

Asperion gebruikt OAuth 2.0 voor zijn API. Je koppelt Asperion daarom aan APIcenter door in te loggen bij Asperion en toestemming te geven. Je geeft APIcenter geen wachtwoord. Je doet dit één keer. Daarna gebruik je Asperion in al je integraties.

Wat je nodig hebt

• Een Asperion-gebruiker die toegang heeft tot de administratie waarmee je wilt koppelen.
• Een gebruiker die de gegevens mag bekijken en aanmaken die je flows nodig hebben, zoals debiteuren, artikelen en facturen.

Zo koppel je Asperion

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

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

Welke administratie APIcenter gebruikt

Een Asperion-gebruiker kan toegang hebben tot één of meer administraties. Na het ophalen van een toegangssleutel kiest Asperion de standaardadministratie. Log daarom in met een gebruiker voor de administratie waarmee je wilt koppelen.

Hoe lang de toegang geldig is

APIcenter vraagt toegang bij Asperion met een toegangssleutel en een vernieuwingssleutel. Volgens Asperion is de toegangssleutel één uur geldig. De vernieuwingssleutel is standaard iets meer dan een maand geldig en werkt maar één keer: bij elke vernieuwing geeft Asperion een nieuwe. Blijft een koppeling langer ongebruikt dan de geldigheid van de laatste vernieuwingssleutel, of mislukt een vernieuwing, dan moet je opnieuw op Autoriseren klikken. Zie Verbinding of inloggen mislukt.

Als het niet lukt

• Lukt het inloggen niet of staat er na de test een foutmelding? Controleer of de gebruiker in Asperion toegang heeft tot de administratie en klik opnieuw op Autoriseren.
• Zie je later in de activiteit een melding over inloggen? Klik bij de Asperion-verbinding opnieuw op Autoriseren.
• Meer fouten staan in Asperion: veelvoorkomende fouten.

Volgende stappen

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

Meer informatie van Asperion zelf staat op Asperion REST API en API Endpoints.