Koppelingene-Boekhouden.nl
e-Boekhouden.nl koppelen aan je webshop.
e-Boekhouden.nl is het boekhoudpakket van tienduizenden Nederlandse ondernemers, verenigingen en stichtingen. De REST API is openbaar beschreven, dus je bestellingen, relaties en facturen kunnen zonder overtypen de administratie in.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met e-Boekhouden.nl je oplevert.
Orders zonder overtypen. Een bestelling wordt een factuur of mutatie in de administratie, met de relatie erbij.
Eén artikelbestand. Artikelen en prijzen komen uit e-Boekhouden, dus je onderhoudt ze op één plek.
Ook voor verenigingen. Leden zijn een eigen onderdeel in de API, dus een ledenadministratie op je site kan meelopen.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- De REST API v1 op api.e-boekhouden.nl, met onderdelen voor relaties, artikelen, facturen, mutaties, grootboek, kostenplaatsen en leden. De oudere SOAP-koppeling bestaat nog
- Authenticatie
- Een API-token uit de instellingen van je account. Daarmee vraag je een kortlevend sessietoken op, en dat gaat mee in de Authorization-header
- Richting
- Beide kanten op
- Verversing
- Per aanroep; het sessietoken is kortlevend en wordt telkens opnieuw opgehaald
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- Het API-token zie je één keer. Bij het aanmaken toont e-Boekhouden hem, en daarna niet meer. Zet hem meteen in een wachtwoordkluis; kwijt is opnieuw aanmaken, en dat betekent dat elke koppeling die erop draait tegelijk stilvalt. Stuur hem ook niet per mail naar je bouwer, wat helaas de gewoonte is.
- Er zijn twee generaties naast elkaar. De oudere koppeling is SOAP met XML en een gebruikersnaam met twee beveiligingscodes; de nieuwe is REST met JSON en een API-token. Bouw op de nieuwe. Kom je bij een bestaande site een koppeling tegen die met beveiligingscodes werkt, dan is dat de vorige generatie: die werkt nog, maar er komt niets meer bij.
- Het token is niet hetzelfde als de sessie. Met het API-token vraag je een sessietoken op, en dat sessietoken gaat mee bij elke volgende aanroep. Het is kortlevend, dus de koppeling moet er zelf een nieuwe halen als hij verloopt. Een koppeling die dat niet doet, werkt de eerste keer prima en daarna niet meer.
- Spreek af wat een bestelling in de boekhouding is. Een factuur per bestelling, of een dagtotaal per verkoopkanaal? Voor een webshop met tientallen kleine orders per dag is dat tweede meestal netter, en het scheelt je boekhouder werk. Het is een administratieve keuze en die hoort aan het begin, niet nadat er drieduizend facturen in staan.
e-Boekhouden.nl koppelen
Wat je moet weten voor je begint.
Wat is e-Boekhouden.nl?
e-Boekhouden.nl is online boekhoudsoftware uit Purmerend, veel gebruikt door zzp’ers, kleine bedrijven, verenigingen en stichtingen. Facturen, bankmutaties, btw-aangifte, relaties en artikelen zitten erin, en voor verenigingen ook een ledenadministratie.
Dat laatste is een verschil met de meeste pakketten en het is voor een website soms precies de reden om te koppelen: een vereniging die haar leden in e-Boekhouden bijhoudt, wil dat een inschrijving op de site daar terechtkomt en niet in een los formulier.
Hoe de koppeling werkt
De REST API is openbaar beschreven. Je maakt in de instellingen van je account een API-token aan, en daarmee vraag je een kortlevend sessietoken op. Dat sessietoken gaat mee in de Authorization-header bij elke aanroep.
Wat er te benaderen valt: relaties, artikelen en artikelgroepen, facturen en factuursjablonen, mutaties, het grootboek met saldi, kostenplaatsen, eenheden en leden. Genoeg voor een webshopkoppeling en ruim genoeg voor een ledenadministratie.
De oudere SOAP-koppeling bestaat nog en werkt met een gebruikersnaam en twee beveiligingscodes. Voor nieuw werk gebruiken wij de REST-variant.
Wat je heen en weer stuurt
Naar e-Boekhouden gaat de omzet: per bestelling een factuur, of per dag een verzamelboeking per kanaal. Welke van de twee hangt af van je aantallen en van wat je boekhouder wil zien.
De klant wordt een relatie. Ook hier hoort de afspraak hoe je een bestaande relatie herkent, anders staat dezelfde persoon er na een maand vijf keer in.
Naar je site komen de artikelen en prijzen. Voor een webshop die zijn assortiment daar bijhoudt scheelt dat een tweede lijst; voor een vereniging is de interessantere kant juist de andere, namelijk een inschrijving die als lid wordt aangemaakt.
Voor verenigingen en stichtingen
Dit is de toepassing die het vaakst wordt vergeten. Een vereniging heeft een site met een inschrijfformulier, en een penningmeester die de leden in e-Boekhouden bijhoudt. Zonder koppeling typt die penningmeester elke inschrijving over, en gaat het mis op het moment dat iemand verhuist of opzegt.
Met de koppeling wordt een inschrijving op de site meteen een lid in de administratie, en kan de contributiefactuur daaruit volgen.
Wat wij daarbij aanraden: houd de site dom en de administratie slim. De site verzamelt en toont, de administratie bepaalt wie lid is en wat er betaald moet worden. Dat scheelt discussies over welk systeem gelijk heeft.
Bijgewerkt op
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Kan ik mijn webshoporders automatisch in e-Boekhouden krijgen?
Ja, als factuur per bestelling of als dagtotaal per kanaal. Bij tientallen kleine orders per dag is dat tweede meestal netter voor je boekhouder. We spreken het vooraf af, want achteraf draaien is lastig.
Hoe kom ik aan een API-token?
Die maak je aan in de instellingen van je eigen account. Let op: je ziet hem één keer. Zet hem meteen in een wachtwoordkluis en stuur hem niet per mail.
Wat is het verschil met de SOAP-koppeling?
De SOAP-variant is de oudere generatie, met een gebruikersnaam en twee beveiligingscodes. De REST API is de nieuwe, met een API-token en JSON. Voor nieuw werk gebruiken wij de REST-variant.
Kunnen leden van onze vereniging vanaf de site worden aangemaakt?
Ja. Leden zijn een eigen onderdeel in de API, dus een inschrijving op je site kan als lid in de administratie landen, met de contributiefactuur die daaruit volgt.
Werkt een e-Boekhouden-koppeling ook op WooCommerce?
Ja. De koppeling draait vanaf de server op een vast ritme, dus het token staat niet in de paginabron en een bezoeker wacht nooit op de boekhouding.
Let’s work together.
Je omzet in de boekhouding, zonder overtypen.