Shopify e-Boekhouden handmatig synchroniseren: wanneer de knop wel (en niet) helpt

De testorder is groen, de accountant belt: “order 1842 staat in Shopify, niet in e-Boekhouden.nl.” Je opent de app, zoekt een knop, en vindt er twee bovenaan de mutatiepagina. Shopify e-Boekhouden handmatig synchroniseren klinkt als de snelle fix. Soms is het dat. Vaak is het de verkeerde knop voor het probleem dat je denkt op te lossen.

Dit artikel legt uit wanneer die handmatige sync bedoeld is, wat hij *niet* ophaalt, hoe je de mutatiestatus controleert, en hoe de e-Boekhouden.nl Koppeling daarna weer realtime verdergaat.

We schreven eerder wanneer orders automatisch naar e-Boekhouden gaan (Paid of Fulfilled) en hoe je historische orders via support laat importeren. Hier gaat het om de uitzondering *ná* livegang: één order of refund die de webhook miste.

Waarom de automatische sync soms een gat laat

De FAQ is stellig: synchronisatie is realtime. Zodra een order of refund in Shopify wordt aangemaakt of gewijzigd, gaat die onmiddellijk naar e-Boekhouden.nl. Geen nachtelijke batch, geen extra sync-toeslag.

Toch kan een regel ontbreken. Een webhook die niet aankwam. Een order die op fout bleef staan omdat het factuuradres leeg was. Een refund die je wél in Shopify deed, maar waarvan de negatieve mutatie niet verscheen. Native Shopify roept e-Boekhouden.nl niet aan; de koppeling wel. Als die push faalt, blijft de shopstatus “betaald” en de administratie stil.

De listing van de e-Boekhouden.nl Koppeling belooft naast automatische sync van orders, klanten en mutaties ook: controleer welke gegevens succesvol of met fouten zijn verwerkt. Dat overzicht is het startpunt — niet de knop zelf. Zonder te weten of 1842 op fout staat of nooit is aangeboden, duw je in het wilde weg.

Belangrijke grenzen (FAQ + listing):

• Geen PDF-factuur mee naar e-Boekhouden.nl — alleen gestructureerde orderdata.

• Geen artikelen of voorraad.

• Geannuleerde orders gaan niet mee; gebruik de restitutie-flow voor een negatieve mutatie.

• Listingprijs: $13.95 per maand, 14 dagen trial, facturatie via Shopify in USD. 5.0 uit 1 review. De listing is Nederlandstalig.

Wat shops nu proberen

1. De handmatige knoppen gebruiken voor 2024

De docs Handmatig synchroniseren van orders en refunds zijn expliciet: een handmatige sync haalt uitsluitend mutaties op vanaf het moment van installatie tot nu. Orders van vóór die datum komen er niet uit. Dat is geen bug; dat is de grens. Historie is een supportaanvraag, geen self-service.

2. De app deïnstalleren “dan komt alles mee”

Herinstallatie reset de webhook-start, niet de boekhouding. Je krijgt geen magische backfill. Wat je wél krijgt: verwarring over welke periode al geboekt is.

3. Dezelfde order handmatig in e-Boekhouden.nl zetten én daarna syncen

Dubbele mutatie. De app weet niet dat jij de verkoop al hebt ingetypt. Eerst status in de mutatielijst checken, dan pas duwen of handmatig corrigeren — niet allebei.

4. Alleen annuleren in Shopify

Annuleren is geen creditboeking. De FAQ zegt: geannuleerde orders worden niet doorgestuurd. Wil je crediteren, gebruik dan restitutie. Handmatig synchen van een cancel levert geen min-boeking op.

Geen van die routes vervangt: mutatieoverzicht lezen, oorzaak fixen, daarna de knoppen alleen voor mutaties ná installatie.

Hoe handmatig synchroniseren wél werkt

Op de mutatie-overzichtspagina staan bovenaan twee knoppen voor handmatige synchronisatie — één set voor orders en refunds, bedoeld als uitzondering. Tijdens normale werking zijn ze niet nodig: Shopify-webhooks doen het werk. De docs: gebruik ze als er een probleem is opgetreden bij de automatische synchronisatie.

Praktische volgorde:

1. Open de mutatiepagina in de app. Zoek de Shopify-order of refund. Staat hij op fout, of ontbreekt hij helemaal?

2. Lees de fout. De pagina Mutaties foutmeldingen behandelt onder meer `billing_address`: leeg `address1`, ontbrekende `billing_address`, ontbrekende `contact_email`. Dat zie je vaak bij handmatig aangemaakte orders of POS. Oplossing uit die docs: stel een standaarddebiteurcode in via Settings, zodat de order alsnog naar e-Boekhouden.nl kan.

3. Fix de oorzaak in Shopify (adres, e-mail) of in de app (standaarddebiteur, grootboek, trigger Paid vs Fulfilled). Opnieuw pushen zonder fix geeft dezelfde fout.

4. Gebruik daarna de handmatige sync-knoppen bovenaan de mutatiepagina. Ze halen mutaties op vanaf installatie tot nu, niet daarvoor.

5. Controleer de regel: succesvol of opnieuw fout. In e-Boekhouden.nl: debiteur, bedrag, btw, verzendkosten. Bij een refund: een aparte negatieve mutatie, geen overschrijving van de oorspronkelijke verkoop.

De koppeling boekt mutaties, geen Shopify-PDF. Als de accountant “de factuur” mist, is dat geen mislukte sync — dat is een verwachting die de FAQ al ontkracht.

Wat de knoppen niet zijn

Geen import van Q1 terwijl je in maart installeerde. Daarvoor: historische orders en refunds, via info@onlineorigins.nl (073 234 0612). Support beoordeelt of de periode technisch kan, om dubbele boekingen te voorkomen.

Geen artikelsync, geen voorraad. Als SKU’s in e-Boekhouden.nl ontbreken, hoort dat zo.

Geen tweede realtime-kanaal. Na een geslaagde handmatige push gaan nieuwe Paid- of Fulfilled-events weer via webhooks. Blijf je elke ochtend op de knop drukken, dan is de trigger of de mapping het echte probleem.

Voorbeeld: order 1842, POS, leeg factuuradres

Een winkel verkoopt online én aan de kassa. Weborders landen keurig. POS-order 1842 (betaald, afgehaald) staat niet in e-Boekhouden.nl. Op de mutatiepagina: validatie `billing_address` ontbreekt. De docs zeggen: dat is typisch POS of een handmatig aangemaakte order.

Je zet in Settings een standaarddebiteur voor dit soort regels. Daarna handmatig synchroniseren. De mutatie gaat erdoor op die debiteurcode. De volgende POS-order met leeg adres volgt dezelfde mapping — zonder dat je elke keer de knop nodig hebt.

Tweede scenario: de webhook miste een online refund. De oorspronkelijke order is al geboekt. In Shopify staat de restitutie. Handmatige sync vanaf installatiedatum pakt die refund mee als negatieve mutatie. Annuleren van de order had niets gedaan.

Wat je nodig hebt om te starten

1. Installeer de e-Boekhouden.nl Koppeling ($13.95/maand, 14 dagen trial).

2. API-key, grootboekmapping en trigger (Paid of Fulfilled) staan. Zonder mapping is een herpush zinloos.

3. Open het mutatieoverzicht. Filter op fouten voordat je bulk duwt.

4. Fix adressen of standaarddebiteur als de foutmelding dat vraagt.

5. Gebruik de twee knoppen bovenaan alleen voor mutaties ná installatie.

6. Historie vóór die datum: mail support, niet de knop.

Installatie liever uitbesteden? Eenmalige installatieservice via info@onlineorigins.nl; bij afzien van de koppeling wordt die vergoeding teruggestort (FAQ).

Tot slot

Shopify e-Boekhouden handmatig synchroniseren is een vangnet voor webhooks en validatiefouten ná livegang. Het is geen importknop voor het verleden, geen PDF-doorvoer en geen credit voor een geannuleerde order. Lees de mutatiestatus, los de oorzaak op, duw daarna bewust.

Zet de koppeling live via de e-Boekhouden.nl Koppeling-listing en gebruik de handmatige knoppen alleen als de realtime sync een gat liet.