Lightspeed Exact Online koppeling

Wat je tussen Lightspeed en Exact Online koppelt

Exact Online is de bron voor artikelen, prijzen en voorraad, Lightspeed eCom voor orders en webklanten. Welke API de koppeling aan de Lightspeed-kant gebruikt, hangt af van één vraag: hangt je webshop omnichannel aan de Lightspeed-kassa (R-Series)? Dan zijn producten en varianten in de eCom API alleen-lezen en schrijft de koppeling artikelen en voorraad naar de kassa.

Verkooporders, leveringen en voorraadposities zitten in de API van Exact alleen in Handel en Productie. Met Boekhouden wordt een Lightspeed-order een verkoopfactuur of verkoopboeking en gaat er geen voorraad terug. De kassakant zelf staat op Lightspeed kassa koppeling.

Welk systeem is leidend, per gegeven

Bij een omnichannel shop komt er een derde systeem bij voor de voorraad: de kassa telt per winkel. Daar moet vastliggen welke winkel in de kassa het webshopmagazijn is en dus de voorraad uit Exact krijgt. De winkels zelf houden hun eigen kassavoorraad.

Wat Lightspeed en Exact Online anders bewaren

Adressen: losse velden naar vrije regels

Bij de meeste platforms moet een koppeling een adres splitsen. Hier gaat het andersom. Een Lightspeed-order heeft addressShippingStreet, addressShippingNumber en addressShippingExtension als losse velden. Exact Online heeft in crm/Addresses drie vrije regels, AddressLine1 tot AddressLine3, en geen huisnummerveld. De koppeling voegt samen:

Lightspeed:  addressShippingStreet     "Dorpsstraat"
             addressShippingNumber     "12"
             addressShippingExtension  "A"
             addressShippingCountry    code "nl"
Exact:       AddressLine1              "Dorpsstraat 12 A"
             Country                   "NL"

Lightspeed's eigen voorbeeldorder laat zien dat het huisnummer soms in de straat staat en het nummerveld leeg is. Samenvoegen gaat dan vanzelf goed, omdat de koppeling een leeg nummer weglaat. Het land komt als code en code3; de koppeling gebruikt de tweeletterige code. Meer in adresvelden mappen.

Korting zit al op de regel

Een orderregel in Lightspeed (orderProduct) heeft basePriceExcl op 4 decimalen, priceExcl en priceIncl als regeltotaal op 2 decimalen, en discountExcl en discountIncl. Het regeltotaal is het bedrag na korting. Een kortingscode die over drie regels valt is dus al per regel verdeeld, en daarmee per btw-tarief. De koppeling rekent de prijs per stuk voor Exact uit het regeltotaal: 3 stuks met priceExcl 53,70 is 17,90 per stuk in NetPrice. De code uit discountCouponCode gaat naar Remarks op de verkooporder.

Verzend- en betaalkosten

De order heeft shipmentPriceExcl en shipmentPriceIncl voor verzending en paymentPriceExcl en paymentPriceIncl voor betaalkosten. In Exact Handel en Productie horen die in SalesOrderOrderChargeLines, toeslagregels die los staan van de artikelen. In Boekhouden bestaan die niet, en worden het factuurregels met een eigen artikel voor verzendkosten en een voor betaalkosten. Elk krijgt de btw-code die bij het tarief op de order hoort.

Zakelijke klanten

Lightspeed zet isCompany, companyName, companyCoCNumber en companyVatNumber op de order. Exact heeft op de debiteur Name, ChamberOfCommerce en VATNumber, en alleen Name is verplicht. De koppeling zoekt eerst op btw-nummer, dan op e-mail, en vult KvK- en btw-nummer bij een nieuwe debiteur. Een particuliere order (isCompany false) gaat naar een eigen debiteur of naar een verzameldebiteur.

De technische werkelijkheid van deze combinatie

De getallen staan in de documentatie van Lightspeed eCom, de Lightspeed-kassa en Exact Online, nagelezen op 3 oktober 2026.

Een dag, doorgerekend. Een shop met 6.000 artikelen en 250 orders per dag, zonder kassa:

Aan de Lightspeed-kant is dat 1.062 van de 12.000, aan de Exact-kant 918 van de 5.000. De voorraadronde gaat uit van hooguit 100 gewijzigde artikelen per uur; de eerste volledige ronde is 6.000 / 100 = 60 aanroepen.

Met de kassa erbij verandert de rekensom. In de kassa-API gaat voorraad per artikel: één verzoek op de ItemShop van het artikel in die winkel. De eerste ronde van 6.000 artikelen bij 1 verzoek per seconde duurt 6.000 seconden, 1 uur en 40 minuten. Met drie kassa's in het abonnement is de snelheid 1 + 2 x 0,5 = 2 per seconde en duurt het 50 minuten. Daarna gaan alleen wijzigingen: 900 per dag is 15 minuten. De koppeling leest de headers X-LS-Api-Bucket-Level en X-LS-Api-Drip-Rate en past zijn tempo daarop aan. De rekenmethode staat in doorvoer berekenen.

Wat een standaardkoppeling hier niet doet

Standaardkoppelingen en koppelplatformen voor Lightspeed en Exact Online documenteren hun eigen grenzen:

• Geen B2B-variant. Staffels en klantprijzen uit Exact gaan niet naar Lightspeed.
• Alleen orders naar de boekhouding. De order wordt een boeking; voorraad en trackingcodes komen niet terug.
• Eén magazijn per koppeling, vast ingesteld bij de installatie.
• Debiteur alleen op e-mailadres, en een bestaande debiteur wordt niet bijgewerkt. Een nieuw btw-nummer op de order komt niet in Exact.

Een gebouwde koppeling kent de route via de kassa, voegt het adres samen zoals Exact het verwacht en zet verzend- en betaalkosten op de plek die bij jouw pakket hoort. De platformkant staat op Lightspeed koppeling, de systeemkant op Exact Online koppeling.

Als het misgaat

Exact staat per endpoint 10 fouten per uur toe en blokkeert de sleutel daarboven. De koppeling controleert daarom vooraf of elk artikel en elke btw-code bestaat, zodat één foute order de rest niet stillegt. Een order die blijft falen bewaart hij met de oorspronkelijke inhoud en biedt hij opnieuw aan zodra de oorzaak is opgelost. Elke poging zoekt eerst op YourRef, zodat een herhaling geen tweede verkooporder maakt. Voor livegang draait de koppeling als dry run.

Wij hosten en bewaken de koppeling en passen hem aan als Lightspeed of Exact een interface wijzigt. Alle stromen staan op koppelingen. Verwante combinaties: CCV Shop Exact Online koppeling, Shopware Exact Online koppeling en WooCommerce Exact Online koppeling. Vertel of je shop aan de kassa hangt en welk Exact-pakket je hebt.