Met de API van Moneybird automatiseer je alle handelingen die je ook in de webapplicatie kunt uitvoeren.
Je kunt de toegang tot je administratie beheren via Instellingen > Koppelingen > Externe applicaties. Zo kun je de toegang van een applicatie ontzeggen.
Sandbox administratie
Met een sandbox administratie kun je je integratie met de Moneybird API testen zonder je echte administratie te gebruiken. Je maakt een sandbox aan via Gebruikersaccount > Ontwikkelaars > Sandbox administratie. Op dezelfde pagina kun je aangeven of je een nieuwsbrief over API-updates wilt ontvangen.
Een sandbox administratie is gratis en valt buiten de betaalde pakketten. Je kunt de sandbox blijven gebruiken, maar er gelden wel maandelijkse limieten voor verschillende functies. De maandelijkse limieten worden berekend vanaf de startdatum van je sandbox en niet vanaf de eerste dag van de kalendermaand.
De belangrijkste limieten zijn:
Functie | Limiet per maand |
Facturen, inclusief facturen uit externe bronnen | 50 |
Periodieke facturen en abonnementen | 10 |
Inkoopdocumenten en bonnetjes | 50 |
Bankmutaties | 100 |
Urenregistraties | 50 |
Documentanalyses (automatisch uitlezen) | 10 |
Budget voor de AI-assistent | 5 |
E-mails naar contacten | 10 |
Wanneer je een limiet bereikt, kan de betreffende functie beperkt of niet meer beschikbaar zijn totdat een nieuwe maandelijkse periode begint. Een sandbox administratie die de factuurlimiet heeft bereikt, kan niet worden geüpgraded.
Een sandbox is bedoeld om API-integraties te testen en is niet geschikt voor je echte boekhouding. Je kunt er facturen mee versturen, maar op iedere factuur verschijnt een watermerk, zoals ‘example’. Houd er rekening mee dat e-mails die je vanuit de sandbox verstuurt daadwerkelijk bij de ontvanger aankomen.
Beperkingen bij het versturen van e-mails
Vanuit een sandbox administratie kun je maximaal 10 e-mails per maand naar je eigen contacten versturen. Zodra je deze limiet bereikt, houdt Moneybird verdere e-mails tegen. Je ziet dan een melding op de betreffende factuur of offerte.
E-mails met meldingen van Moneybird aan jou als ontwikkelaar vallen niet onder deze limiet en worden wel verstuurd.
Andere beperkingen
Niet alle functies van Moneybird zijn beschikbaar in een sandboxadministratie. Zo kun je de volgende functies niet testen:
Peppol: het versturen van elektronische facturen via Peppol.
Moneybird Online Betaalmethoden: de verificatie van deze betaalmethoden.
Moneybird Betaalrekening: de verificatie van deze functie.
Moneybird Online Verkopen: de verificatie van deze functie.
Voor gebruikers, bankkoppelingen en Moneybird Zakelijke Rekeningen gelden de beperkingen van het proefpakket.
Ben je op zoek naar een testomgeving met bestaande dummygegevens? Neem dan contact op met ons supportteam via de helpwidget rechtsonderin je scherm en vraag een demo-administratie aan.
OpenAPI en Swagger
Moneybird biedt een OpenAPI-specificatie, die ook wel een Swagger-specificatie wordt genoemd. Hiermee kun je inzicht krijgen in de beschikbare API-endpoints en de structuur van de API.
Je vindt de specificatie en de bijbehorende documentatie op de Moneybird API-documentatie.
Callback URL
Een callback URL is het webadres waarnaar een gekoppelde applicatie informatie terugstuurt, bijvoorbeeld na een autorisatie. De ontwikkelaar van de koppeling vertelt je welke callback URL je moet gebruiken.
Zorg ervoor dat je de juiste URL instelt wanneer je een applicatie aan Moneybird koppelt.
