Waarom koppelen aan SnelStart?
Kort antwoord
SnelStart is een populair boekhoudpakket bij het Nederlandse MKB. Een koppeling met de SnelStart B2B-API automatiseert je administratie: relaties, artikelen, verkoop- en inkoopboekingen stromen automatisch tussen je webshop of maatwerksysteem en je boekhouding. Geen dubbel overtypen, minder fouten, altijd actuele cijfers.
SnelStart is al jaren een van de bekendste boekhoudpakketten voor zzp'ers en het MKB in Nederland. Veel bedrijven voeren er hun complete financiële administratie in: facturen, relaties, btw-aangifte en het grootboek. Draai je daarnaast een eigen webshop, ordersysteem of maatwerkapplicatie, dan wil je die gegevens niet elke dag met de hand overtypen.
Een koppeling met SnelStart lost dat op. Een nieuwe bestelling in je webshop wordt automatisch een verkoopboeking in SnelStart. Een nieuwe klant verschijnt als relatie. Een betaalde factuur wordt teruggekoppeld naar je eigen systeem. Het resultaat: geen dubbel werk, minder invoerfouten en een boekhouding die altijd bij is.
Wat kun je koppelen?
De SnelStart B2B-API geeft toegang tot de kern van je administratie. De meest voorkomende datastromen die wij koppelen:
- Relaties — Klanten en leveranciers synchroniseren tussen je applicatie en SnelStart, zodat je debiteuren en crediteuren op één plek kloppen.
- Artikelen — Je productcatalogus koppelen aan de artikelen in SnelStart, inclusief prijzen en btw-tarieven.
- Verkoopboekingen en facturen — Orders uit je webshop of maatwerksysteem automatisch als verkoopboeking of factuur in SnelStart wegschrijven.
- Inkoopboekingen — Inkoopfacturen en kosten doorzetten naar de administratie, bijvoorbeeld vanuit een inkoop- of voorraadsysteem.
- Grootboekmutaties — Boekingen op de juiste grootboekrekening en dagboek plaatsen voor correcte rapportages.
- Btw-codes — Bedragen koppelen aan het juiste btw-tarief, zodat je aangifte automatisch klopt.
Authenticatie: subscription key en clientkey
Hier wijkt SnelStart bewust af van pakketten als Teamleader of Exact Online. Waar die met OAuth2 werken, gebruikt de SnelStart B2B-API een eigen mechanisme met twee sleutels. Dat is belangrijk om vooraf te weten, want het bepaalt hoe je de koppeling inricht.
- Subscription key — Die haal je uit je profiel op het SnelStart Developer Portal. De API draait op Microsoft Azure API Management; de subscription key identificeert jouw integratie.
- Clientkey — Die genereert de ondernemer zelf in SnelStart, onder de maatwerk-instellingen. De clientkey bepaalt tot wélke administratie je koppeling toegang krijgt.
- Access token — Subscription key en clientkey wissel je in voor een kortlevend access token. Dat token stuur je bij elk verzoek mee en vernieuw je automatisch zodra het verloopt.
De praktische consequentie: een SnelStart-koppeling is niet zomaar "één keer inloggen". Je moet het tokenbeheer waterdicht bouwen — verlopen tokens automatisch verversen, sleutels veilig opslaan en per klant de juiste clientkey administreren. Doe je dat slordig, dan valt de koppeling onaangekondigd stil.
De helft van de betrouwbaarheid van een koppeling zit niet in de happy flow, maar in wat er gebeurt als een token verloopt of een verzoek mislukt.
Synchroniseren zonder webhooks
Een tweede belangrijk verschil: de SnelStart B2B-API stuurt geen webhooks. Je krijgt dus geen automatisch signaal wanneer er iets verandert. Dat betekent dat je zelf periodiek moet controleren of er nieuwe of gewijzigde gegevens zijn — pollen.
Dom pollen — elke keer álles ophalen — is traag en loopt tegen de limieten van de API aan. Slim pollen doe je op basis van de wijzigingsdatum: je vraagt alleen de records op die sinds je laatste synchronisatie zijn aangemaakt of aangepast. Zo houd je het verkeer laag en blijft de koppeling snel.
Richting bepalen
Voordat je bouwt, bepaal je welk systeem leidend is. Enkele veelvoorkomende scenario's:
- Naar SnelStart toe — Je webshop of maatwerksysteem is leidend en zet orders, facturen en nieuwe klanten door naar de boekhouding.
- Uit SnelStart terug — SnelStart is leidend voor bijvoorbeeld betalingsstatussen of relatiegegevens, die je terugleest in je eigen applicatie.
- Bidirectioneel — Beide kanten wijzigen data. Dit is het krachtigst maar vraagt heldere conflictafspraken, zodat een wijziging aan de ene kant er niet per ongeluk één aan de andere kant overschrijft.
Veelgemaakte fouten bij SnelStart-koppelingen
Op basis van de boekhoudkoppelingen die we bouwen, zijn dit de valkuilen die we het vaakst tegenkomen:
- Tokenbeheer onderschatten — Zonder automatische tokenvernieuwing valt de verbinding na verloop van tijd weg. Bouw dit vanaf het begin robuust in.
- Btw verkeerd mappen — Een order met een afwijkend btw-tarief dat op de verkeerde code landt, geeft een sluitende maar foute administratie. Test dit expliciet.
- Volgorde negeren — Je kunt geen verkoopboeking wegschrijven voor een relatie die nog niet in SnelStart bestaat. Eerst de relatie, dan de boeking.
- Geen foutafhandeling — Zonder retry en een duidelijk statusoverzicht merk je pas dat er iets misgaat als de cijfers achterlopen. Idempotente verwerking voorkomt dubbele boekingen bij een herhaald verzoek.
- Alles tegelijk willen — Begin met de datastroom die de meeste tijd bespaart (vaak: orders naar verkoopboekingen) en breid daarna uit.
Mijn kijk op boekhoudkoppelingen
Een boekhoudkoppeling voelt aan de buitenkant simpel: "zet mijn orders in SnelStart". Maar juist financiële data is onverbiddelijk. Een CRM-veld dat een keer niet synchroniseert, is vervelend. Een boeking die dubbel of met het verkeerde btw-tarief landt, kost je een correctie in de aangifte en het vertrouwen van je boekhouder.
Daarom bouw ik dit soort koppelingen liever conservatief. Liever een koppeling die bij twijfel stopt en een melding geeft, dan één die stilletjes iets fout wegschrijft. En liever eerst één datastroom die aantoonbaar klopt, dan in één keer de hele administratie automatiseren en hopen dat het goed gaat. Boekhouden is precisiewerk; de koppeling hoort dat te respecteren.
— Jasper
Zo helpt Coding Agency hierbij
Wij bouwen SnelStart-koppelingen op maat: van een eenvoudige stroom die je webshoporders als verkoopboeking wegschrijft, tot een bidirectionele synchronisatie tussen je maatwerksysteem en de administratie. We regelen het tokenbeheer, de btw-mapping en een slimme synchronisatie op wijzigingsdatum, met foutafhandeling die je vertrouwt. Bekijk ook hoe we een webshop aan een boekhoudpakket koppelen of twee pakketten zoals Exact Online en Moneybird in sync houden.
Benieuwd wat een SnelStart-koppeling voor jouw situatie kan betekenen? Neem contact op voor een vrijblijvend gesprek.
Bron: SnelStart B2B-API Developer Portal (b2bapi-developer.snelstart.nl).
