Koppeling met e-Boekhouden.nl

e-Boekhouden.nl heeft twee ingangen naast elkaar, en de keuze daartussen bepaalt hoe lang uw koppeling meegaat.

Twee generaties naast elkaar

e-Boekhouden.nl biedt twee manieren om te koppelen. De oudste is een SOAP-koppeling, een oudere techniek waarbij uw software eerst een sessie opent en daarna berichten uitwisselt. De nieuwere is een REST-API, de techniek die de rest van de markt inmiddels gebruikt.

Het pakket laat zelf zien welke van de twee de oude is. In het menu staat de eerste letterlijk aangeduid als de oude koppeling. Nieuw werk hoort dus op de REST-API te staan, ook als een bestaand koppelstuk nog via SOAP loopt.

Draait er al een koppeling via SOAP, dan is dat geen reden tot haast, maar wel iets om te weten. Wie nu iets nieuws bouwt op de oude ingang, bouwt iets dat een keer over moet.

Hoe u toegang krijgt

Het token voor de REST-API maakt u zelf aan in e-Boekhouden.nl, onder Beheer en dan Koppelingen. Let bij het kiezen op de aanduiding: de regel met de vermelding dat het om de oude koppeling gaat, is de SOAP-variant en niet degene die u nodig hebt.

Zoals bij elk pakket geldt: staat de administratie op het abonnement van uw boekhouder, dan maakt uw boekhouder het token aan of geeft die u het recht om dat te doen. Regel dat voordat het bouwen begint, want zonder token valt er niets te koppelen.

Waar u op let bij het ontwerp

e-Boekhouden.nl publiceert geen hard aantal aanroepen dat u per dag mag doen. Dat betekent niet dat er geen grens is, en het betekent zeker niet dat u er ongelimiteerd tegenaan kunt.

Behandel de koppeling daarom alsof de grens er wel is. Stuur meerdere boekingen in één keer door in plaats van per stuk, spreid een eerste vulling van duizenden regels over de tijd, en laat de koppeling rustig opnieuw proberen als het pakket even niet antwoordt.

Dat is bovendien het gedrag dat u bij elk pakket wilt. Een koppeling die netjes omgaat met de kant waar hij tegenaan praat, blijft werken als uw volume groeit of als de leverancier zijn grenzen aanscherpt.

Wat wij hier bouwen

Wij koppelen e-Boekhouden.nl aan webshops, aan urenregistratie en aan maatwerksoftware, tegen de REST-API. Een bestelling of een afgerond project wordt dan een verkoopfactuur in het pakket, en uw software kan terugzien of die factuur betaald is.

Loopt er al iets via de oude SOAP-koppeling, dan kijken we in de kennismaking wat het kost om dat over te zetten en of dat nu moet. Daarna krijgt u een voorstel met één prijs en één opleverdatum.

Bronnen

Veelgestelde vragen

Moeten we onze bestaande SOAP-koppeling meteen vervangen?

Meteen niet. Werkt hij en doet hij wat hij moet doen, dan kan hij blijven. Zet nieuw werk wel op de REST-API, en plan de overzetting op een moment dat het u uitkomt in plaats van op een moment dat het moet.

Zit API-toegang in ons abonnement?

Bij e-Boekhouden.nl is koppelen breed beschikbaar, maar controleer het voor uw eigen plan in uw account. Dat is één blik in het menu Koppelingen en het scheelt een verrassing halverwege het project.

Hoeveel facturen per dag kan zo'n koppeling aan?

Voor de aantallen van het mkb is dat geen bottleneck, mits de koppeling in batches werkt en opnieuw probeert bij een storing. Noem uw aantallen in de kennismaking, dan rekenen we het na in plaats van het te schatten.

Kunnen jullie ook uit e-Boekhouden.nl lezen in plaats van erin schrijven?

Ja. Een klantportaal dat openstaande facturen toont is een veelvoorkomend voorbeeld. Lezen en schrijven zijn aparte rechten, en wij vragen alleen wat de koppeling echt nodig heeft.