Verbinden met Moneybird (bèta)

Voor Moneybird werkt SamenstelFlow met een persoonlijk API-token. Dat maak je aan in je eigen Moneybird-account en plak je één keer in SamenstelFlow. Alle administraties waar jouw Moneybird-gebruiker bij kan, komen daarna als lijst in beeld.

Het token aanmaken

Ga in Moneybird naar Instellingen en dan naar Externe en AI-koppelingen. Daar maak je een persoonlijk token aan. Alleen de eigenaar van het Moneybird-account kan dat doen; ben je dat niet, vraag het dan aan degene die dat wel is.

Bij het aanmaken kies je waar het token toegang toe krijgt. SamenstelFlow heeft deze onderdelen nodig:

Facturen, voor de verkoop- en inkoopfacturen.
Documenten, voor bonnen en memoriaalboekingen.
Bankieren, voor de bankrekeningen en de mutaties.
Instellingen, voor het rekeningschema en de btw-tarieven.

Offertes en uren heeft SamenstelFlow niet nodig; die kun je uit laten.

Twee dingen om vooraf te weten. De rechten van een persoonlijk token liggen vast op het moment dat je het aanmaakt en zijn later niet meer aan te passen: wil je andere rechten, dan maak je een nieuw token aan. En zet je een onderdeel op alleen-lezen, dan kan SamenstelFlow er alleen uit lezen. Voor het samenstellen van het dossier is dat genoeg, maar wil je vanuit de factuurcontrole ook matches in Moneybird laten boeken, dan mogen facturen, documenten en bankieren niet op alleen-lezen staan.

De actuele stappen bij Moneybird staan in hun eigen helpartikel: API-token aanmaken en beheren

Invoeren en administraties selecteren

Ga naar Dashboard en klik op Administratie importeren.
Kies bij Boekhoudpakket de optie Moneybird (Beta).
Plak het token in het veld Moneybird-token en klik op Verbinden.
Vink aan welke administraties je wilt overnemen en klik op Koppelen.

De administraties staan in de lijst met hun naam en hun Moneybird-id eronder. Het verdere verloop van de wizard staat in Administraties importeren.

Veelvoorkomende fouten

Moneybird accepteert het token niet. SamenstelFlow vraagt je de API-token te controleren. Je vindt je persoonlijke tokens terug in Moneybird onder Instellingen > Externe en AI-koppelingen. Controleer of het token nog bestaat en of je het in zijn geheel hebt geplakt.
Moneybird is niet bereikbaar. Je krijgt de melding dat de verbinding mislukte en dat je het later opnieuw kunt proberen. Dat ligt niet aan jouw token.
De lijst blijft leeg of mist administraties. Het token werkt, maar jouw Moneybird-gebruiker heeft geen toegang tot die administraties. Regel die toegang eerst in Moneybird.

Het token weer intrekken

Intrekken gaat in Moneybird in twee stappen. Trek eerst de toegang in via Instellingen > Externe en AI-koppelingen, en verwijder daarna het token zelf via Gebruikersaccount > Ontwikkelaars, met de verwijderknop rechtsboven.

Daarna werkt de koppeling in SamenstelFlow niet meer. Een token voer je alleen in tijdens het importeren, en een administratie die al gekoppeld is wordt daar geweigerd, dus een nieuw token in de plaats zetten kun je niet zelf. Datzelfde geldt als je andere rechten nodig hebt en daarvoor een nieuw token aanmaakt. Neem in beide gevallen contact op via Support vragen.

Wat “bèta” hier betekent

De Moneybird-koppeling draagt in de app het label Beta. De koppeling is nieuwer en op minder administraties beproefd dan die van Yuki. Het is geen uitgeklede versie: de werkstukken die Moneybird ondersteunt staan gewoon in de export, zie Werkstukken per pakket.

Wel goed om te weten bij het beoordelen van de uitvoer: Moneybird geeft geen kolommenbalans of grootboek als zodanig uit. SamenstelFlow bouwt het grootboek op uit de onderliggende boekingen. De cijfers sluiten aan, maar de herkomst is een reconstructie en geen kant-en-klaar overzicht uit het pakket.

Moneybird begrenst hoeveel er per tijdseenheid opgevraagd mag worden. SamenstelFlow houdt daar rekening mee en wacht vanzelf even als die grens in zicht komt. Bij een grote administratie of een eerste export kan dat betekenen dat het langer duurt dan je gewend bent; dat is geen storing.

Kom je iets tegen dat niet klopt in de cijfers of in een werkstuk, meld het dan met de administratie, het boekjaar en het werkstuk erbij. Zie Support vragen.

Volgende stap

Bekijk wat je per administratie kunt instellen: Administratie-instellingen.