Yuki koppeling met je webshop: verkoopfacturen in Yuki, nu Nmbrs Accounting

Wat is Yuki en wie gebruikt het?

Yuki is een Nederlands online boekhoudpakket, sterk bij accountants- en administratiekantoren die voor hun klanten boekhouden. Sinds 1 september 2026 gaat Yuki samen met WeFact, Nmbrs en Visionplanner verder onder de naam Nmbrs, onderdeel van Visma. Het boekhoudpakket heet nu Nmbrs Accounting. Op deze pagina noemen we het Yuki, omdat de webservices, de API-adressen en de meeste klanten die naam nog gebruiken.

Yuki werkt met domeinen en administraties. Een domein is de omgeving van een klant, vaak beheerd vanuit het portaal van een accountant; een domein kan meerdere administraties bevatten. Een webshopkoppeling schrijft naar één administratie en rekent af op het dagbudget van het domein.

Wat je met Yuki koppelt

Yuki kent geen orders, geen voorraad en geen magazijn. Een Yuki koppeling is een stroom van verkoopfacturen naar de boekhouding. De klant reist mee in het factuurbericht: Yuki zoekt hem op of maakt hem aan. Welke velden bij een order horen staat op orders, klanten en verzending.

Hoe Yuki data vrijgeeft

SOAP-webservices met een API-sleutel

Yuki heeft twaalf SOAP-webservices op api.yukiworks.nl/ws/, waaronder Sales, Accounting, AccountingInfo, Contact en Purchase. Toegang loopt met een webservice-API-sleutel en een administratie-ID, die je in Yuki genereert. De sleutel geeft toegang op portaal-, domein- of administratieniveau; de rechten op domein- of administratieniveau gaan voor. Authenticate wisselt de sleutel in voor een sessie-ID, en elke volgende aanroep draagt dat sessie-ID en het administratie-ID. Verbindingen moeten TLS 1.2 of hoger gebruiken. De Purchase-webservice vraagt daarnaast een client-ID en secret, die je per e-mail bij Nmbrs aanvraagt.

Een factuur gaat als XML-document naar ProcessSalesInvoices, volgens het schema SalesInvoices.xsd van Yuki:

<SalesInvoices xmlns="urn:xmlns:http://www.theyukicompany.com:salesinvoices">
  <SalesInvoice>
    <Reference>10482</Reference>
    <PaymentMethod>iDeal</PaymentMethod>
    <PaymentID>tr_7Hx2kQ</PaymentID>
    <Process>true</Process>
    <Date>2026-10-01</Date>
    <Contact><ContactCode>WEB311</ContactCode>
      <FullName>Bakker Installatie B.V.</FullName>
      <ContactType>Company</ContactType></Contact>
    <InvoiceLines><InvoiceLine><ProductQuantity>2</ProductQuantity>
      <Product><Description>Snoeischaar</Description><SalesPrice>24.20</SalesPrice>
        <VATPercentage>21</VATPercentage><VATIncluded>true</VATIncluded>
        <VATType>1</VATType><GLAccountCode>8000</GLAccountCode></Product>
    </InvoiceLine></InvoiceLines>
  </SalesInvoice>
</SalesInvoices>

Limiet per dag, en waarom bundelen helpt

De bron is het artikel Nmbrs Accounting API koppeling van Yuki en het schema SalesInvoices.xsd, nagelezen op 3 oktober 2026.

Een limiet per dag in plaats van per minuut maakt de vorm van de koppeling belangrijk. Stuurt de koppeling elke order apart, met een Authenticate en een ProcessSalesInvoices, dan kost een order 2 aanroepen, als Authenticate meetelt, en is het budget op bij 500 orders per dag, nog voordat er openstaande posten zijn opgevraagd. Omdat één aanroep tot 9.999 facturen mag bevatten, bundelt de koppeling: elke 15 minuten één sessie en één bericht met alle orders van dat kwartier. Dat is 96 x 2 = 192 aanroepen per dag, of de webshop nu 50 of 1.500 orders verwerkt. Hoe je zo'n som maakt staat in doorvoer berekenen.

Waar het bij Yuki op vastloopt

Klanten die op naam worden samengevoegd

Yuki koppelt de klant in een factuurbericht eerst op ContactCode. Is die leeg of onbekend, dan zoekt Yuki op naam, en een bestaand contact met dezelfde naam wordt automatisch gekoppeld. Twee particuliere klanten die allebei J. de Vries heten, komen zo op één debiteur, met de openstaande posten van beiden. De koppeling stuurt daarom altijd een ContactCode mee: het klantnummer uit de webshop met een voorvoegsel, bijvoorbeeld WEB311, en voor gastbestellingen een code op basis van het e-mailadres. ContactType staat standaard op Person; voor een zakelijke klant zet de koppeling Company en het btw-nummer. Zie dubbele klanten en debiteuren.

Btw: percentage plus type

Yuki heeft geen veld voor een btw-code. Het leidt de code af uit VATPercentage samen met VATType, een nummer uit Instellingen, Btw-tarieven in het domein. Bestaat er geen btw-code bij die combinatie, dan wordt de factuur geannuleerd. Bij een verlegde of buitenlandse levering moet het type dus kloppen, niet alleen het percentage. VATIncluded staat standaard op false: een prijs van € 24,20 inclusief btw zonder die vlag wordt € 24,20 x 1,21 = € 29,28. Meer in bedragen en btw mappen.

Stille standaardwaarden

Drie velden geven geen fout als ze leeg of onbekend zijn, maar vallen terug op een standaard:

De koppeling vult ze daarom altijd en controleert grootboekcodes vooraf tegen GetGLAccountScheme. Een order met een code die niet in het schema staat gaat naar de controlelijst.

Openstaande posten op factuurnummer

CheckOutstandingItem geeft het openstaande bedrag van een factuur, op factuurnummer of op de GUID van de transactie. Volgens Yuki kan een zoekactie op factuurnummer meerdere posten opleveren; op GUID is hij uniek. De koppeling vraagt op GUID waar die bekend is, en vergelijkt bij meerdere treffers op factuurnummer het bedrag en de klant voordat hij een betaling aan een post toewijst. Zie wat is afletteren.

Platformen die we aan Yuki koppelen

De koppeling wordt gebouwd op jouw domein en administratie: je btw-typen, je grootboekschema, je betaalwijzen en je projecten. Per platform:

• WooCommerce koppeling met je boekhoudpakket, met Yuki naast Exact Online, Twinfield en e-Boekhouden
• WooCommerce koppeling en Shopify koppeling voor de platformkant

Andere boekhoudpakketten: Twinfield koppeling, Exact Online koppeling en e-Boekhouden koppeling. Het overzicht van alle stromen staat op koppelingen.

Wij bouwen de koppeling voor een vaste prijs en hosten, draaien en bewaken hem daarna voor een vast bedrag per maand. Voor de livegang draait hij als dry run: je ziet per order welk contact, welke btw-code en welke grootboekrekening er in Yuki zouden ontstaan. Vertel welke webshop je hebt en wie je Yuki-domein beheert.