CCV Shop Exact Online koppeling

Wat je tussen CCV Shop en Exact Online koppelt

Exact Online is de bron voor artikelen, prijzen en voorraad, CCV Shop voor orders en webklanten. De REST API van CCV Shop werkt met JSON en een API-sleutel en geheim die je in de winkel aanmaakt. Elk verzoek draagt een HMAC-SHA512-hash in de header x-hash en een tijdstip in x-date dat niet meer dan 5 minuten van de servertijd mag afwijken.

Verkooporders, leveringen en voorraadposities bestaan in de API alleen voor Exact Online Handel en Productie. Met Boekhouden landt een CCV Shop-order als verkoopfactuur of verkoopboeking en gaat er geen voorraad terug. De keuze per pakket staat op Exact Online koppeling.

Welk systeem is leidend, per gegeven

Wat CCV Shop en Exact Online anders bewaren

Varianten: eigen artikelen tegenover combinaties met meerprijs

Exact Online heeft geen hoofdartikel met varianten: elke maat is een eigen artikel met een eigen code, prijs en voorraad. CCV Shop slaat een variant op als attribuutcombinatie onder één product. Een combinatie heeft een eigen product_number (64 tekens), ean_number (50) en stock, maar geen eigen prijs: alleen netto_extra_price, het verschil met het hoofdproduct, dat ook negatief mag zijn.

De koppeling groepeert de artikelen uit Exact op een afgesproken deel van de code, hier 10482. De laagste prijs gaat naar het product en elke combinatie krijgt het verschil: 26,50 min 24,50 is 2,00 voor maat XL. stocktype op het product bepaalt of de voorraad op het product staat (Product) of per combinatie (Attribute). Bij varianten staat hij op Attribute. Meer in varianten koppelen.

Prijs en korting als twee velden

Een product in CCV Shop heeft price en discount, en de verkoopprijs is price min discount. In CCV's eigen voorbeeld is dat 11,95 min 1,95. Een tijdelijke actieprijs uit Exact (een SalesItemPrices-regel met StartDate en EndDate) zet de koppeling in discount, zodat de oorspronkelijke prijs zichtbaar blijft. Op de einddatum zet hij discount terug op 0. Of de prijzen inclusief btw zijn staat in de winkelinstelling prices_include_vat; de koppeling leest die bij de start en rekent de prijs uit Exact daarop om.

Btw: een tarief op naam tegenover een code

CCV Shop geeft een product een taxtariff: normal, low A, low B, extra low of zero. Het oude veld vatrate met een percentage is verouderd. Een orderregel heeft wel een percentage in tax. Exact Online vraagt per regel een btw-code uit vat/VATCodes. De koppeling houdt twee tabellen bij: van de Exact-code naar het CCV-tarief voor artikelen, en van percentage, land en type order naar de Exact-code voor orders.

Orders die via een extern platform zijn geplaatst hebben is_platform_sale op true. Volgens CCV is de btw op alle regels dan 0%. Die order krijgt in Exact een eigen code met 0%, en vaak een eigen dagboek. Een regel van het type statiegeld (product_type deposit) heeft ook altijd 0%. Meer in bedragen en btw mappen.

Adressen in twee vormen

Een CCV Shop-adres komt in een van twee vormen: address_line_1 en address_line_2, of street, housenumber en housenumber_suffix. housenumber is een geheel getal, dus een toevoeging staat altijd apart. Exact heeft in crm/Addresses drie vrije regels zonder huisnummerveld. De koppeling neemt address_line_1 over als die gevuld is, en voegt anders samen: Dorpsstraat, 12 en A wordt Dorpsstraat 12 A. Het land komt als country_code (ISO 3166-1, twee letters) en als volledige naam; de koppeling gebruikt de code. Zie adresvelden mappen.

Zakelijke klanten

De klant op de order heeft customertype (b2c of b2b), btw en kvk. In Exact zijn dat VATNumber en ChamberOfCommerce op de debiteur, en alleen Name is verplicht. De koppeling zoekt eerst op btw-nummer, dan op e-mail. Een particuliere klant gaat naar een eigen debiteur of naar een verzameldebiteur.

De technische werkelijkheid van deze combinatie

De CCV-getallen staan per methode in de API-documentatie van CCV Shop, die van Exact in de documentatie over API-limieten. Nagelezen op 3 oktober 2026.

De eerste voorraadronde, doorgerekend. Een winkel met 3.000 producten zonder varianten en 1.000 producten met elk 4 combinaties heeft 3.000 + 4.000 = 7.000 voorraadplekken. Uit Exact is dat 7 verzoeken op de sync-endpoint. Naar CCV Shop is het één PATCH per plek, bij 100 per minuut:

products:              3.000 / 100 per minuut = 30 minuten
attributecombinations: 4.000 / 100 per minuut = 40 minuten
na elkaar                                      = 70 minuten

De twee resources hebben elk hun eigen limiet, maar CCV hanteert ook een totaal over de hele API, zonder dat getal te publiceren. De koppeling loopt ze daarom na elkaar af en verlaagt het tempo bij de eerste 429. Na de eerste ronde gaan alleen gewijzigde plekken mee.

Orders hebben geen filter op wijzigingsdatum. Je kunt orders opvragen vanaf een aanmaakdatum, niet vanaf een laatste wijziging. Een order die gisteren is geplaatst en vandaag wordt betaald, mist een ronde die alleen naar nieuwe orders kijkt. De koppeling luistert daarom naar de webhooks orders.created en orders.updated.ispaid, en haalt elke ronde ook de onbetaalde orders van de laatste dagen op met is_paid. Meer over limieten in wat is een rate limit.

Wat een standaardkoppeling hier niet doet

Standaardkoppelingen en koppelplatformen voor CCV Shop en Exact Online documenteren hun eigen grenzen. Niet elke aanbieder van Exact-koppelingen heeft er een voor CCV Shop. Waar ze er wel zijn:

• Alleen orders naar de boekhouding. De order wordt een boeking of factuur; voorraad en status komen niet terug in de winkel.
• Debiteur alleen op e-mailadres, en een bestaande debiteur wordt niet bijgewerkt.
• Alleen volledige terugbetalingen, binnen 30 dagen en alleen voor orders die de koppeling zelf heeft doorgezet.

Een gebouwde koppeling leest is_platform_sale en general_ledger per order, rekent meerprijzen voor combinaties uit en schrijft voorraad en track-and-trace terug. De platformkant staat op CCV Shop koppeling.

Als het misgaat

CCV Shop stuurt bij een webhook niet mee voor welke winkel hij is. De koppeling zet daarom een eigen kenmerk in het webhookadres en controleert de x-hash over adres en inhoud. Exact staat per endpoint 10 fouten per uur toe en blokkeert de sleutel daarboven, dus elke order wordt vooraf gecontroleerd op artikel, btw-code en grootboekrekening. Een order die blijft falen bewaart de koppeling met de oorspronkelijke inhoud en biedt hij opnieuw aan zodra de oorzaak is opgelost. Voor livegang draait hij als dry run.

Wij hosten en bewaken de koppeling en passen hem aan als CCV of Exact een interface wijzigt. Alle stromen staan op koppelingen. Verwante combinaties: Lightspeed Exact Online koppeling, WooCommerce Exact Online koppeling en Shopware Exact Online koppeling. Vertel hoeveel producten en combinaties je winkel heeft.