Koppeling met Moneybird
Moneybird heeft sandbox-administraties en tokens die u zelf aanmaakt.
Hoe u toegang krijgt
Voor uw eigen administratie maakt u zelf een persoonlijk token aan. Daarmee kan uw software verbinding maken zonder aanvraag of wachttijd.
Bouwt u software die ook bij andere Moneybird-gebruikers moet werken, dan registreert u een app en loopt de aanmelding via OAuth. De gebruiker geeft dan zelf toestemming en u ziet zijn wachtwoord nooit.
Elk verzoek gaat naar een adres waarin het nummer van de administratie staat. Werkt u met meerdere administraties, dan moet uw software weten welke het betreft. De API staat op versie 2 en geeft antwoord in JSON of XML.
Testen zonder uw echte administratie te raken
Moneybird biedt sandbox-administraties aan. Die hebben alle functies van een gewone administratie, en facturen die u er maakt krijgen een watermerk zodat ze niet per ongeluk voor echte facturen worden aangezien.
De limieten
Moneybird staat 150 verzoeken per vijf minuten toe per IP-adres. Voor rapportages ligt de grens lager, op 50 per vijf minuten. Wordt de grens overschreden, dan antwoordt de API met statuscode 429 en geeft hij aan hoe lang u moet wachten.
Voor de meeste koppelingen is dat ruim voldoende. De grens wordt merkbaar bij een eerste import, wanneer u in één keer een paar duizend klanten of facturen wilt overzetten. Een koppeling die de opgegeven wachttijd uitleest en zich daaraan houdt, zet de gegevens dan in delen over.
Bronnen
Veelgestelde vragen
Kunnen we het token zelf aanmaken en beheren?
Dat heeft onze voorkeur. Het token blijft dan van u en u kunt de toegang op elk moment intrekken, ook als u ooit met iemand anders verder werkt.
Onze boekhouder werkt in onze Moneybird-administratie. Merkt die iets van de koppeling?
De boekingen die de koppeling maakt, verschijnen in de administratie op dezelfde manier als andere boekingen. Spreek vooraf af hoe een factuur uit de koppeling herkenbaar is, bijvoorbeeld aan een eigen nummerreeks, zodat uw boekhouder ziet welke facturen uit de koppeling komen.
Wat gebeurt er met een factuur die Moneybird weigert?
In een goed gebouwde koppeling komt die factuur, met de reden van de weigering, op een overzicht dat iemand controleert.
Kunnen we later overstappen naar een ander pakket?
Dat kan. Het deel van uw software dat met Moneybird communiceert, wordt dan vervangen. Wij houden dat deel daarom apart, zodat de rest van uw software er niet van afhankelijk is.