Waarom koppelen aan Yuki?
Kort antwoord
Yuki is een online boekhoud- en administratieplatform dat veel wordt gebruikt door boekhoudkantoren en het MKB. Een koppeling met de SOAP-webservices van Yuki automatiseert je administratie: verkoopfacturen, relaties en journaalposten stromen automatisch tussen je webshop of maatwerksysteem en je boekhouding. Geen dubbel overtypen, minder fouten, altijd actuele cijfers.
Yuki is een van de bekendste online boekhoudplatformen in Nederland en België, vooral populair bij accountants- en boekhoudkantoren die de administratie van hun klanten centraal willen beheren. Veel ondernemers laten hun boekhouding volledig in Yuki draaien: verkoopfacturen, inkoopfacturen, het grootboek en de btw-aangifte.
Draai je daarnaast een eigen webshop, ordersysteem of maatwerkapplicatie, dan wil je die gegevens niet elke dag met de hand overtypen. Een koppeling met Yuki lost dat op. Een nieuwe bestelling in je webshop wordt automatisch een verkoopfactuur in Yuki. Een nieuwe klant verschijnt als relatie. Het resultaat: geen dubbel werk, minder invoerfouten en een administratie die altijd bij is.
Wat kun je koppelen?
De Yuki-webservices geven toegang tot de kern van je administratie. De meest voorkomende datastromen die wij koppelen:
- Verkoopfacturen — Orders uit je webshop of maatwerksysteem automatisch als verkoopfactuur in Yuki wegschrijven, inclusief regels, relatie en btw-codes.
- Relaties en contacten — Klanten en leveranciers synchroniseren, zodat je debiteuren en crediteuren op één plek kloppen.
- Journaalposten — Boekingen op de juiste grootboekrekening en het juiste dagboek plaatsen voor correcte rapportages.
- Documenten — Inkoopfacturen en bonnen als document in de administratie aanleveren, zodat ze in de verwerkingsstroom van Yuki belanden.
- Financiële gegevens — Rapportages en saldi uitlezen om ze in je eigen dashboard of applicatie te tonen.
- Btw-codes — Bedragen koppelen aan het juiste btw-tarief, zodat de aangifte automatisch klopt.
Yuki werkt met meerdere webservices, elk met een eigen aandachtsgebied. De Accounting-webservice biedt bijvoorbeeld methodes om financiële rapportages op te halen en journaalposten aan te maken, terwijl de Sales-webservice draait om het verwerken van verkoopfacturen. Welke webservices je nodig hebt, bepaal je op basis van de datastromen die je wilt automatiseren.
Authenticatie: WebserviceAccessKey en sessionID
Hier wijkt Yuki bewust af van pakketten die met OAuth2 werken, zoals Teamleader of Exact Online. Yuki gebruikt een eigen mechanisme dat draait om een toegangssleutel en een tijdelijke sessie. Dat is belangrijk om vooraf te weten, want het bepaalt hoe je de koppeling inricht.
- WebserviceAccessKey — De web service API key die toegang geeft op portaal-, domein- of administratieniveau. Deze sleutel bepaalt tot welke administraties je koppeling toegang heeft.
- SessionID — De toegangssleutel wissel je met de Authenticate-methode in voor een sessionID. Dat sessionID is 24 uur geldig en stuur je bij de volgende aanroepen mee.
- AdministrationID — De meeste methodes werken op één specifieke administratie. Met de AdministrationID geef je aan om welke administratie het gaat; een aparte methode geeft alle administraties terug die met jouw sleutel bereikbaar zijn.
De praktische consequentie: een Yuki-koppeling is niet zomaar "één keer inloggen". Je moet het sessiebeheer waterdicht bouwen — een verlopen sessionID op tijd vernieuwen, de toegangssleutel veilig opslaan en per klant de juiste administratie administreren. Doe je dat slordig, dan valt de koppeling na een dag onaangekondigd stil.
De helft van de betrouwbaarheid van een koppeling zit niet in de happy flow, maar in wat er gebeurt als een sessie verloopt of een verzoek mislukt.
Synchroniseren zonder webhooks
Een tweede belangrijk verschil: Yuki 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 belast zowel jouw systeem als de Yuki-webservices onnodig. Slim pollen doe je op basis van wat er sinds je laatste synchronisatie is veranderd: je haalt alleen de records op die nieuw of gewijzigd zijn. 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 Yuki toe — Je webshop of maatwerksysteem is leidend en zet orders, verkoopfacturen en nieuwe klanten door naar de boekhouding.
- Uit Yuki terug — Yuki is leidend voor bijvoorbeeld betaalstatussen 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 Yuki-koppelingen
Op basis van de boekhoudkoppelingen die we bouwen, zijn dit de valkuilen die we het vaakst tegenkomen:
- Sessiebeheer onderschatten — Een sessionID verloopt na 24 uur. Zonder automatische vernieuwing valt de verbinding weg. Bouw dit vanaf het begin robuust in.
- Verkeerde administratie — Werk je voor meerdere klanten, dan is de juiste AdministrationID cruciaal. Een boeking in de verkeerde administratie is lastig terug te draaien.
- Btw verkeerd mappen — Een factuur 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 verkoopfactuur wegschrijven voor een relatie die nog niet in Yuki bestaat. Eerst de relatie, dan de factuur.
- Geen foutafhandeling — Zonder retry en een duidelijk statusoverzicht merk je pas dat er iets misgaat als de cijfers achterlopen. Idempotente verwerking voorkomt dubbele facturen bij een herhaald verzoek.
Mijn kijk op Yuki-koppelingen
Een boekhoudkoppeling voelt aan de buitenkant simpel: "zet mijn orders in Yuki". Maar juist financiële data is onverbiddelijk. Een CRM-veld dat een keer niet synchroniseert, is vervelend. Een factuur die dubbel of met het verkeerde btw-tarief landt, kost je een correctie in de aangifte en het vertrouwen van je boekhouder.
Bij Yuki komt daar de context van het boekhoudkantoor bij. De administratie is vaak niet van jou alleen, maar wordt gedeeld met een accountant die erop vertrouwt dat de cijfers kloppen. 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 Yuki-koppelingen op maat: van een eenvoudige stroom die je webshoporders als verkoopfactuur wegschrijft, tot een bidirectionele synchronisatie tussen je maatwerksysteem en de administratie. We regelen het sessiebeheer, de administratie- en btw-mapping en een slimme synchronisatie op wijzigingen, met foutafhandeling die je vertrouwt. Bekijk ook hoe we een webshop aan een boekhoudpakket koppelen of een SnelStart-koppeling opzetten.
Benieuwd wat een Yuki-koppeling voor jouw situatie kan betekenen? Neem contact op voor een vrijblijvend gesprek.
Bron: Yuki Support — Accounting web service (support.yuki.nl).
