Moneybird koppelen aan APIcenter

Je koppelt Moneybird aan APIcenter door Moneybird als applicatie toe te voegen. Je doet dit één keer. Daarna gebruik je Moneybird in al je integraties.

Wat je nodig hebt

• Een Moneybird-account met toegang tot de administratie waarmee je wilt koppelen. Moneybird zegt dat bij het geven van toestemming de gebruiker eigenaar van de administratie moet zijn.
• De gegevens die APIcenter vraagt als je Moneybird koppelt.

Moneybird kent twee manieren om toegang te geven: OAuth2 (inloggen en toestemming geven) en een persoonlijk API-token. Een persoonlijk API-token geeft toegang tot je hele Moneybird-account. Bewaar zo'n token daarom veilig en deel het nergens anders. Bij een persoonlijk API-token kies je in Moneybird zelf de rechten (scopes), bijvoorbeeld sales_invoices voor facturen. Je maakt een token of een OAuth-applicatie aan op de pagina van Moneybird voor applicaties. Meer uitleg staat in de authenticatie-documentatie van Moneybird.

Zo koppel je Moneybird

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Moneybird.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je administratie, en vul de velden in die APIcenter voor Moneybird toont.
3. Klik op Opslaan.
4. Klik op Testverbinding. Zie je dat de verbinding goed is, dan is Moneybird klaar voor gebruik.

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

De administratie

Een Moneybird-account kan meerdere administraties hebben. APIcenter werkt met één administratie per verbinding. Het administratie-ID vul je niet zelf in: APIcenter zet het automatisch in Administration ID (filled automatically) als je de verbinding test. Haalt APIcenter dit ID op, dan gebruikt het de eerste administratie in het antwoord van Moneybird. Je ziet de waarde nadat je de pagina hebt ververst. Heb je meer administraties? Controleer dan na de test of het ID bij de juiste administratie hoort. Zie Moneybird verbindings- en integratie-instellingen.

Als het niet lukt

• Moneybird geeft een fout 401 als de toegang ontbreekt of niet geldig is. Controleer de gegevens van de verbinding en test opnieuw. Zie Verbinding of inloggen mislukt.
• Moneybird geeft een fout 403 als je IP-adres voor de API is geblokkeerd, en een fout 429 als je te veel verzoeken doet. Zie Moneybird: veelvoorkomende fouten.

Volgende stappen

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

Meer informatie van Moneybird zelf staat in de Moneybird API-documentatie.