Pennylane koppelen aan APIcenter

Je koppelt Pennylane aan APIcenter met gegevens uit je eigen Pennylane-omgeving. Je doet dit één keer. Daarna gebruik je Pennylane in al je integraties.

Wat je nodig hebt

• Een Pennylane-account met minimaal het abonnement Essential. Dit eist Pennylane voor het aanmaken van API-tokens.
• Beheerrechten voor het bedrijf in Pennylane. Dit zijn de rollen Executive, Internal Accountant en External Accountant.

Welke toegang APIcenter nodig heeft

Pennylane werkt met rechten per onderdeel (scopes). Welke rechten je nodig hebt, hangt af van de flows die je gebruikt:

• Klanten naar Pennylane sturen: customers:all.
• Producten ophalen uit Pennylane: products:readonly. Verkooporders versturen als factuur gebruikt ook products:readonly, om de producten van de orderregels op te zoeken.
• Verkooporders versturen als factuur: customer_invoices:all, en customers:all om de klant op te zoeken of aan te maken.
• Verkooporders versturen als boeking: ledger_entries:all, plus journals:readonly en ledger_accounts:readonly voor de lijsten met journaals en grootboekrekeningen.

Geeft Pennylane een fout over een ontbrekend recht, dan mist het token of de toestemming een van deze rechten. Zie Pennylane: veelvoorkomende fouten.

Zo maak je een API-token in Pennylane

1. Log in bij Pennylane.
2. Ga in het onderdeel Management naar Settings > Connectivity > Developers.
3. Klik op Generate an API Token.
4. Geef het token een naam, bijvoorbeeld APIcenter.
5. Kies onder API V2 de rechten. Kies Read and write als APIcenter gegevens moet aanmaken of bijwerken.
6. Kies een einddatum. Pennylane biedt 1 maand, 6 maanden, 12 maanden of onbeperkt.
7. Klik op Generate Token en kopieer het token direct. Pennylane toont het maar één keer en kan het later niet meer laten zien. Is het kwijt, dan maak je een nieuw token aan.

Pennylane legt de stappen uit in Create a Company API Token. De volledige lijst met rechten staat in Understand Scopes.

Zo koppel je Pennylane in APIcenter

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Pennylane.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je bedrijf in Pennylane.
3. Vul de verbindingsgegevens in die APIcenter vraagt. Gebruik hiervoor het token uit Pennylane. Klik op Opslaan.
4. Klik op Testverbinding. Zie je "Verbinding is goed!", dan is Pennylane klaar voor gebruik.

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

Als het niet lukt

• Pennylane geeft de fout 401 als het token ontbreekt of ongeldig is. Controleer of je het volledige token hebt gekopieerd en of het niet is verlopen.
• Pennylane geeft de fout 403 als het token het benodigde recht niet heeft. Maak een nieuw token aan met de juiste rechten.
• Pennylane staat 25 verzoeken per 5 seconden per token toe. Ga je daarboven, dan geeft Pennylane de fout 429. Zie Pennylane: veelvoorkomende fouten.

Zie ook Verbinding of inloggen mislukt.

Volgende stappen

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