Moneybird API-token aanmaken

Met een persoonlijk API-token geef je een koppeling toegang tot je Moneybird-administratie, zonder je wachtwoord te delen. Zo maak je er een aan, met precies de rechten die nodig zijn.

Bijgewerkt op

Kort antwoord

  • Ga in Moneybird naar moneybird.com/user/applications/new en kies voor een persoonlijk API-token.
  • Geef het token een herkenbare naam, bijvoorbeeld ‘BolBird’, en vink alleen de rechten aan die de koppeling nodig heeft.
  • Kopieer het token en plak het in de koppeling. Bewaar het nergens anders.
  • Intrekken kan altijd op dezelfde pagina in Moneybird; de koppeling werkt dan meteen niet meer.

Stap voor stap

  1. Log in op Moneybird en ga naar moneybird.com/user/applications/new.
  2. Kies voor een persoonlijk API-token, niet voor een externe applicatie.
  3. Geef het token een naam, bijvoorbeeld BolBird.
  4. Vink de rechten aan die de koppeling nodig heeft. Voor BolBird: Verkoopfacturen, Documenten en Instellingen.
  5. Kopieer het token en plak het in de koppeling. In BolBird doe je dat op het overzicht, bij ‘Koppel je Moneybird-administratie’.

Welke rechten heeft BolBird nodig?

Recht in MoneybirdWaarvoor BolBird het gebruikt
VerkoopfacturenVerkopen en retouren boeken als (credit)factuur, en klanten als contact aanmaken
DocumentenBol-facturen boeken als inkoopfactuur, met de PDF als bijlage
InstellingenBtw-tarieven en grootboekrekeningen lezen en de bol.com-rekeningen aanmaken

Niet nodig: Bank, Offertes en Uren. Hoe minder rechten een token heeft, hoe kleiner het risico als het ooit uitlekt.

Is een API-token veilig?

  • Een token is een sleutel tot je administratie. Deel het nooit via e-mail of chat.
  • BolBird slaat je token versleuteld op (AES-256) en gebruikt het alleen om je bol.com-gegevens te boeken.
  • Maak per koppeling een eigen token aan. Dan kun je er één intrekken zonder de andere te raken.
  • Stop je met een koppeling? Trek het token dan in via dezelfde pagina in Moneybird.

Meerdere administraties

Heb je in Moneybird meerdere administraties, bijvoorbeeld voor twee bedrijven? Dan vraagt BolBird na het plakken van het token welke administratie je wilt koppelen. Elke administratie heeft een eigen BolBird-account.

Heb je twee bol.com-accounts binnen hetzelfde bedrijf? Dan heb je geen tweede administratie nodig. Lees twee bol.com-accounts in Moneybird.

Dit allemaal automatisch?

BolBird boekt je bol.com-verkopen, retouren en bol-kosten automatisch in Moneybird, gesplitst naar Nederland en België, met de juiste btw. 14 dagen gratis, daarna vanaf € 69 per jaar (excl. btw).

Veelgestelde vragen

Verloopt een Moneybird API-token?

Moneybird noemt geen vaste vervaldatum voor persoonlijke tokens. Trek een token in zodra je het niet meer gebruikt.

Wat is het verschil tussen een API-token en ‘Koppelen met Moneybird’?

Bij een koppeling via Moneybird (OAuth) log je in en geef je toestemming in Moneybird zelf. Met een persoonlijk token maak je zelf een sleutel aan en plak je die in de koppeling. Allebei geven ze toegang tot je administratie zonder dat je je wachtwoord deelt.

Ik heb mijn token niet goed gekopieerd. Wat nu?

Maak op dezelfde pagina een nieuw token aan en trek het oude in. BolBird test het token direct en meldt het als Moneybird het niet accepteert.

Verder lezen