Wat je nodig hebt
- De rol Admin of Member in je organisatie. Viewers hebben geen toegang tot Koppelen. Zie Wie mag koppelen?.
- Tweestapsverificatie (2FA) op je APIboard-account.
- Een vrije plek in je pakket: Proefperiode en Basis 3 koppelingen, Team 7, Pro 10 (plus eventueel een gekochte extra koppeling).
- Een Moneybird-account met toegang tot de administratie die je wilt koppelen.
Verbinden
- Ga in APIboard naar Koppelen > Koppelingen.
- Zoek Moneybird bij Beschikbare koppelingen (of typ de naam in het zoekveld) en klik op de kaart. Er opent een venster dat je stap voor stap begeleidt.
- Klik op Verbind met Moneybird. Je gaat naar de inlogpagina van Moneybird.
- Log in met je Moneybird-account en geef APIboard toestemming.
- Kies de administratie die je wilt koppelen, als je er meerdere hebt (zie hieronder).
- APIboard haalt direct de eerste gegevens op (Data wordt opgehaald…). Daarna zie je Verbonden met Moneybird, met de dashboards die klaarstaan. Op Koppelen > Koppelingen staat de pil Bezig met ophalen… tot de eerste volledige ronde klaar is; daarna staat er Actief.
Account of administratie kiezen
Heeft je login meerdere administraties, dan zie je Kies je administratie met de tekst “We vonden meerdere administraties bij je Moneybird-account. Kies welke je aan APIboard wilt koppelen.” Al gekoppelde administraties staan niet in de lijst; zijn ze allemaal gekoppeld, dan zie je “Alle beschikbare accounts zijn al gekoppeld.” Is er precies één administratie, dan zie je Koppeling bevestigen. Je kunt daar een Naam voor deze koppeling invullen en klikt op Koppelen of Bevestigen. Kies je niets, dan meldt APIboard “Kies een account.”
Meer administraties koppelen? Open de kaart van de koppeling en klik op + Account toevoegen (of kies Meer opties > Account toevoegen). In het venster kies je een administratie van een login die al gekoppeld is, zonder opnieuw in te loggen (onder het kopje Via Moneybird), of je kiest Ander account koppelen om met een andere login in te loggen. Elke administratie telt mee als account in je pakket. Gebruik je Ander account koppelen terwijl je in je browser nog bij Moneybird bent ingelogd met een ander account, log daar dan eerst uit.
Welke gegevens je krijgt
| Onderwerp | Tabellen |
|---|---|
| Verkoop | Verkoopfacturen, Regels van verkoopfacturen, Betalingen van verkoopfacturen, Offertes, Regels van offertes, Terugkerende facturen, Regels van terugkerende facturen |
| Inkoop | Inkoopfacturen, Regels van inkoopfacturen, Betalingen van inkoopfacturen |
| Bank en betalingen | Bankmutaties, Regels van bankmutaties, Uitgaande betalingen, Bankrekeningen |
| Boekhouding | Grootboekrekeningen, Grootboeksaldi per maand, Btw-tarieven, Vaste activa |
| Relaties en producten | Contacten, Producten, Projecten |
| Tijd | Uren |
| Beheer | Identiteiten, Gebruikers |
Je vraagt de gegevens op via de API en ziet ze in de Datawerkbank. Alle tabellen en velden staan in de API-documentatie van Moneybird.
Hoe vaak vernieuwd
Na de eerste vulling haalt APIboard alleen op wat in Moneybird is gewijzigd; daarnaast loopt er periodiek een controle. De eerste vulling van facturen, bankmutaties en offertes gaat per maand, de nieuwste maand eerst. Contacten en stamgegevens (zoals rekeningen, producten en btw-tarieven) worden elke ronde volledig opgehaald. De grootboeksaldi van de lopende en vorige maand worden elke ronde opnieuw berekend.
De eerste vulling van gegevens met een datum (zoals facturen, uren of mutaties) begint op 1 januari van het jaar dat bij je pakket hoort: Proefperiode en Basis dit kalenderjaar, Team ook vorig jaar, Pro ook twee jaar terug. Stamgegevens (zoals relaties of rekeningen) worden altijd volledig opgehaald. Wat al is opgehaald, verwijdert APIboard niet als je pakket kleiner wordt.
Hoe vaak dat gebeurt, hangt af van je pakket (Proefperiode, Basis, Team of Pro): zie Hoe vaak worden gegevens vernieuwd?.
Goed om te weten
- Per administratie loopt er één synchronisatie tegelijk. Moneybird beperkt het aantal aanroepen; APIboard pauzeert vanzelf als de limiet dichtbij komt en gaat daarna door.
- Contacten die je in Moneybird archiveert, blijven in APIboard staan als gearchiveerd. Records die uit Moneybird verdwijnen, worden als verwijderd gemarkeerd.
- Een factuur met een factuurdatum die meer dan een kalendermaand in de toekomst ligt, komt pas binnen zodra die maand in het ophaalvenster valt.
- Moneybird-factuurstatussen worden in het Nederlands getoond, zoals Concept, Open, Te laat, Betaald en Oninbaar.
- Opnieuw verbinden vervangt alleen je inloggegevens. De koppeling, alle opgehaalde gegevens en de syncstand blijven staan, de status gaat terug naar Actief en de volgende synchronisatie haalt alleen wijzigingen op. Het verbindscherm opent direct, zonder bevestigingsvraag. Je logt opnieuw in bij Moneybird en geeft toestemming. Log je in met een ander account, dan weigert APIboard dat met de melding “Dit is een ander account dan de koppeling die je opnieuw verbindt. Log in met hetzelfde account.” Dan is het een nieuwe koppeling. Tijdens een lopende synchronisatie kan de melding “Moneybird wordt op dit moment gesynchroniseerd. Probeer het over een minuut opnieuw.” verschijnen; probeer het dan zo opnieuw.
- Je vindt Opnieuw verbinden (pijlicoon) in het zijpaneel dat opent als je op de kaart van de koppeling klikt.
- Een koppeling of account verwijderen (Koppeling verwijderen of het verwijderpictogram bij een account) wist ook alle opgehaalde gegevens. Dat kan niet ongedaan worden gemaakt.
Problemen oplossen
- Koppelen mislukt. Controleer je gegevens en probeer het opnieuw. Dit is de standaardmelding. Probeer het opnieuw en controleer of je met een Moneybird-account inlogt dat de administratie kan zien. Lukt het niet, neem dan contact op met support.
- Je hebt geen toestemming gegeven. Probeer opnieuw en accepteer de gevraagde rechten. Je hebt in het venster van Moneybird de toestemming geweigerd. Start de koppeling opnieuw en geef APIboard toestemming.
- OAuth-sessie verlopen, probeer opnieuw te verbinden. Je deed er langer dan 10 minuten over. Start de koppeling opnieuw en rond hem in één keer af, in dezelfde browser.
- Zoeken is niet gelukt. Probeer het later opnieuw. Of Toevoegen is niet gelukt. Probeer het later opnieuw. Dit komt bij Account toevoegen voor, bijvoorbeeld als er op dat moment een synchronisatie van Moneybird loopt. Wacht een minuut en probeer het opnieuw.
- Kon geen popup-venster openen. Sta pop-ups toe voor deze site. Sta pop-ups toe voor APIboard in je browser en klik opnieuw op Verbind met Moneybird.
- Viewers kunnen geen koppelingen beheren. Je hebt de rol Viewer. Vraag een Admin van je organisatie om je de rol Member te geven, of om de koppeling te maken.
- Dit account is al gekoppeld. Wat je probeert te koppelen, staat al in je organisatie. Zoek het op onder Koppelen > Koppelingen.
- Je hebt je koppelingen-limiet bereikt voor je pakket. (of Je hebt je accounts-limiet bereikt voor je pakket.) Kies Bekijk abonnementen om te upgraden, of koop een extra koppeling of extra account.
- De pil Fout bij de koppeling. Een synchronisatie is mislukt of de toegang is verlopen of ingetrokken. APIboard probeert het bij een tijdelijke fout later zelf opnieuw; bij een verlopen toegang gebruik je Opnieuw verbinden.
Was dit artikel behulpzaam?