Je Bunni API-sleutel aanmaken

In Bunni maak je eenmalig een API-sleutel aan en plak je die in Schakel, samen met de link van je administratie. De sleutel hoort bij die ene administratie, dus je hoeft daarna niets meer te kiezen. Kost een paar minuten.

Wat je overhoudtEen API-sleutel uit je eigen Bunni-administratie (begint met bu_live_) en de link van die administratie, allebei ingevuld in Schakel.

  1. 01

    Ga naar API in het hoofdmenu

    Log in op mijn.bunni.nl en open de administratie die je wilt koppelen. Klik in het hoofdmenu op API. Je komt op het tabblad API Keys; daarnaast staat API Reference, dat heb je hiervoor niet nodig.

  2. 02

    Maak een nieuwe API key aan

    Maak een nieuwe API key aan. Bunni noemt hem uit zichzelf API Key 1. Geef hem de naam Schakel, zodat je later weet waar hij bij hoort.

  3. 03

    Vink aan wat Schakel mag

    Bij een API key vink je per onderdeel aan welke calls hij mag doen. Vink aan: Categories (ophalen), Contacts (ophalen en aanmaken), Invoice Designs (ophalen), Invoices (ophalen en aanmaken) en Tax Rates (ophalen). Meer is niet nodig: Schakel leest je categorieën, btw-tarieven en factuurontwerpen en maakt facturen aan.

  4. 04

    Kopieer de sleutel

    Kopieer de sleutel die Bunni laat zien. Hij begint met bu_live_. Doe dat meteen: kun je hem later niet meer terugvinden, maak dan gewoon een nieuwe aan.

  5. 05

    Kopieer de link van je administratie

    Kijk in de adresbalk van je browser terwijl je in Bunni bent ingelogd. Daar staat iets als https://mijn.bunni.nl/administratie/jouwbedrijf/.... Kopieer die link. Het stuk na /administratie/ vertelt Schakel welke administratie het is, want de sleutel zelf zegt dat niet.

  6. 06

    Plak beide in Schakel

    Ga in Schakel naar Connecties, klik bij Bunni op Account koppelen en plak de link en de sleutel. Klik op Koppelen en testen. Schakel test de sleutel meteen tegen je administratie en zegt het als er een vinkje ontbreekt.

Goed om te weten

  • De sleutel hoort bij één administratie. Voer je meer administraties, maak dan per administratie een eigen sleutel aan en koppel ze apart.
  • Na het koppelen kies je in de instellingen van de koppeling je factuurontwerp, je omzetcategorie en welk Bunni-btw-tarief bij welke situatie hoort. Schakel stelt alvast voor wat bij je tarieven past; controleer het even.
  • Betalingen koppel je in Bunni zelf aan de factuur, zoals je dat bij je andere facturen doet. Schakel boekt de verkoop en de klant, niet de betaling.

Als er iets misgaat

Schakel zegt dat de sleutel een recht mist.
Open de sleutel op de pagina API in Bunni en vink aan wat Schakel noemt. Je hoeft geen nieuwe sleutel te maken: plak dezelfde daarna opnieuw.
Schakel zegt dat de sleutel niet werkt.
Controleer of de link bij dezelfde administratie hoort als waar je de sleutel maakte: een sleutel werkt alleen voor zijn eigen administratie. Is de sleutel half gekopieerd, maak dan een nieuwe aan.
Er worden geen facturen geboekt.
Kijk eerst in de instellingen van de koppeling of je factuurontwerp, omzetcategorie en het hoge btw-tarief gekozen zijn. Staat dat goed, open dan het logboek: mist een bestelling een btw-tarief, bijvoorbeeld voor 9% of voor buiten de EU, dan staat daar welk tarief je nog moet kiezen.

Koppelingen die je Bunni-toegang gebruiken

Heb je de sleutels binnen, dan gaan ze hierheen. Elke koppeling hieronder praat met Bunni.

Shopify → Bunni

Loop je vast op een stap?

Schermen verschuiven weleens. Ziet het er bij jou anders uit dan op de schermafbeeldingen, stuur ons dan een bericht. Dan kijken we mee en passen we de pagina aan.

Contact Alle handleidingen