Exact Online Pipedrive Koppeling voor een Nederlandse Groothandel

De Klant

Een Nederlandse groothandel in decoratief huisraad, leverancier van tuincentra en retail in Nederland en Duitsland. Het bedrijf draait op Exact Online voor ERP en boekhouding, App4Sales voor ordervastlegging door de buitendienst en de B2B-webshop, en was bezig met de uitrol van Pipedrive als nieuw CRM voor bezoekplanning, accountmanagement en omzetanalyse.

Het project kwam binnen via een onafhankelijke Pipedrive-consultant die de CRM-uitrol leidde. Hij had de Pipedrive-kant tot in detail uitgetekend. Hij had iemand nodig die de brug kon bouwen — zonder het als een enterprise-integrator te beprijzen.

Het Probleem

Exact bevatte alles wat ertoe deed: orders, de volledige productcatalogus over meerdere collecties, verkopers, accountmanagers, factuur- en betaalstatussen. App4Sales duwde orders betrouwbaar naar Exact. Maar Pipedrive — het systeem dat de buitendienst daadwerkelijk dagelijks zou gebruiken — wist nergens van.

Verkopers liepen klantgesprekken in zonder te weten of de laatste order was verzonden of betaald. Accountmanagers konden hun eigen pipeline niet zien. Er was geen manier om slapende klanten te spotten, geen overzicht van omzet per productcategorie, helemaal geen native analytics-laag. Elk rapport betekende weer een Excel-export uit Exact.

De briefing was ongebruikelijk helder: bouw een éénrichtings-synchronisatie van Exact naar Pipedrive, in near real-time, zonder ooit de App4Sales-naar-Exact orderstroom aan te raken. Exact blijft leidend. Pipedrive wordt de analyse- en buitendienstlaag erbovenop.

Onze Aanpak

Fase 0 — Alles Verifiëren Tegen de Live API

Voordat we een definitieve scope verstuurden, raakten we de live Exact API: echte orders opgehaald, elke statuscodecombinatie in kaart gebracht, salesperson-GUID's geëxtraheerd, het bulk-endpoint met uitgevouwen orderregels gevalideerd en de productcategoriestructuur bevestigd. Het resultaat was een volledig geverifieerde statusmap — geen giswerk in de bouw.

Fase 1 — Core Ordersynchronisatie

Het hart van de koppeling: elke Exact SalesOrder wordt een Pipedrive Deal in de "Bestellingen"-pipeline, gekoppeld aan de juiste Organisatie (gematcht op debiteurnummer), eigendom van de juiste verkoper (gemapt vanuit Exact GUID), geprijsd op het ordertotaal exclusief BTW, met elke orderregel gespiegeld als Deal Product. Webhooks op het SalesOrders-topic triggeren de sync binnen seconden; een 5-minuten-poll draait als terugvaloptie.

Het lastigste stuk was de statusmapping. Exact volgt de orderstatus over drie onafhankelijke velden — Status, DeliveryStatus en InvoiceStatus. We comprimeerden de geverifieerde combinaties in een prioriteitsgeordende logica die stage-transities schoon aanstuurt: annuleringen worden verloren deals, volledig gefactureerde orders worden gewonnen deals, deelleveringen landen in "Wacht op backorder", complete leveringen in afwachting van facturering landen in "Verzonden".

Fase 2 — Historische Migratie

Pipedrive heeft geen bulk-create endpoint voor deals en het aanmaaktijdstip is niet schrijfbaar via de API. We konden historische orders dus niet op de voor de hand liggende manier antedateren. Opgelost met een custom "Orderdatum"-datumveld op de deal en een getempode migratierun, afgestemd op Pipedrive's dagelijkse tokenbudget. Aan de Exact-kant dekte een handvol calls naar het bulk SalesOrders-endpoint met uitgevouwen orderregels (1.000 records per pagina) de volledige 12 maanden.

Fase 3 — Productcatalogus en Categoriesynchronisatie

Producten spiegelen van Exact naar Pipedrive op een 15-minutenschema, delta-gesynchroniseerd op wijzigingsdatum om API-gebruik vlak te houden. Elke orderregel draagt de itemgroep van het product mee in een Pipedrive custom field, zodat het team native Insights-rapporten kan draaien over omzet per productcategorie.

Fase 4 — Infrastructuur en Compliance

De hele stack draait op een Hetzner VPS in Neurenberg — specifiek gekozen vanwege AVG/GDPR-jurisdictie. Docker Compose orkestreert N8N, PostgreSQL en Traefik met automatisch vernieuwende Let's Encrypt SSL. Dagelijkse PostgreSQL-dumps en wekelijkse VPS-snapshots. We leverden het juridische pakket naast het technische werk: NDA, sub-verwerkersovereenkomst en TBL — getekend voordat één API-call productiedata raakte.

Wat We Hebben Gebouwd

• 11 productie N8N-workflows voor organisatiesynchronisatie, order-naar-deal aanmaak, regelitems, pipeline stage-logica, productcatalogussynchronisatie, productcategoriemapping, verkopertoewijzing, historische import, klantmigratie, conditionele contactsync en webhook-ontvangst
• 12 maanden orderhistorie gemigreerd met originele orderdatums bewaard in een custom field
• Volledige Exact-productcatalogus gespiegeld in Pipedrive op een 15-minutenschema
• Statusgestuurde pipeline-logica over alle geverifieerde Exact-statuscombinaties
• Verkoper-GUID-naar-Pipedrive-gebruiker mapping met null-terugval
• Webhook-abonnement op Exact SalesOrders-topic met 5-minuten scheduled poll als terugval
• Self-hosted N8N-stack op een Duitse VPS met dagelijkse geautomatiseerde backups
• Volledig AVG/GDPR juridisch pakket meegeleverd met de technische bouw

Het Resultaat

Nul handmatige data-invoer tussen Exact en Pipedrive. Nieuwe Exact-orders verschijnen binnen minuten als Pipedrive-deals. De volledige 12 maanden orderhistorie stond op dag één in het systeem — geen leeg CRM. Verkopers zien factuur- en betaalstatus zonder hun pipeline te verlaten. Accountmanagers draaien omzetrapporten per klant, per categorie, per verkoper native in Pipedrive Insights.

Het Exact API-budget zit comfortabel onder het dagelijkse limiet. OAuth-tokens vernieuwen automatisch bij elke workflowrun, dus het 14-dagenvenster loopt nooit gevaar. Er zijn nul sync-loop incidenten geweest op het conditionele Pipedrive-naar-Exact contactpad.

De integratie draait op een kleine Duitse VPS — en de klant bezit elk workflowbestand als ze het ooit ergens anders willen onderbrengen.

Technologie

• N8N (self-hosted) — workflow-automatiseringsengine, onbeperkte uitvoeringen op eigen infrastructuur
• Exact Online API met community node voor OAuth 2.0 lifecycle
• Pipedrive API v2 — direct aangestuurd via HTTP Request nodes voor endpoints die de native node niet dekt
• Hetzner VPS (Neurenberg, Duitsland) — AVG/GDPR-jurisdictie standaard
• Docker Compose — orkestratie voor N8N + PostgreSQL + Traefik
• PostgreSQL — productie-database backend voor N8N
• Traefik — reverse proxy met automatisch vernieuwende Let's Encrypt SSL-certificaten
• Exact Online webhooks — SalesOrders topic-abonnement voor near-real-time triggers