Shopify e-Boekhouden sync fouten: groen of rood in het overzicht

De webshop is groen. De boekhouder belt: order 1842 staat nergens in e-Boekhouden.nl. Of erger: de refund ontbreekt, de verkoop staat er wél. Shopify e-Boekhouden sync fouten zie je niet in Shopify Admin. Je ziet ze in het mutatie-overzicht van de koppeling: succesvol of fout. Zonder dat scherm duw je blind, of je typt de mutatie met de hand én synct daarna alsnog dubbel.

De e-Boekhouden.nl Koppeling belooft realtime sync van orders, klanten en financiële mutaties — en dat je controleert welke gegevens succesvol of met fouten zijn verwerkt. Dat overzicht is het onderwerp. De drie billing_address-teksten staan in mutaties foutmeldingen. Hier: hoe je het scherm leest, en drie oorzaken die géén adresregel zijn: API-key, grootboekmapping, refund-flow.

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

Shopify synct zelf niets naar e-Boekhouden.nl

Native Shopify heeft geen e-Boekhouden-dagboek. De koppeling wel: realtime, via webhooks, als mutatieboeking. De FAQ is stellig: zodra een order of refund in Shopify wordt aangemaakt of gewijzigd, gaat die onmiddellijk door. Geen nachtelijke batch, geen extra sync-toeslag.

Toch kan een regel op fout blijven staan, of helemaal niet verschijnen. Drie lagen:

1. De app is niet verbonden (API-key, Connecten).

2. De app is verbonden, maar mapping of trigger klopt niet.

3. De app weigert de mutatie (validatie) of jij verwacht iets dat de FAQ uitsluit.

Shopify blijft in alle drie gevallen groen. Alleen het mutatie-overzicht vertelt of de boekhouding meeliep.

Grenzen die bij “fouten” vaak verward worden (FAQ + listing):

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

• Geen artikelen of voorraad.

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

• BTW komt uit Shopify; de koppeling gokt geen tarief.

Een “fout” omdat de accountant de PDF mist, is geen syncfout. Dat is een verwachting die de FAQ al ontkracht.

Wat merchants nu proberen tot de administratie scheef loopt

Het overzicht niet openen tot de btw-aangifte

Tientallen regels op fout, of helemaal geen mutaties omdat de key verlopen is. Liever één oorzaak nu.

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

Dubbele mutatie. De app weet niet dat jij de verkoop al hebt ingetypt.

De app herinstalleren

Herinstallatie reset de webhook-start, niet de boekhouding. Wat al geboekt is, blijft. Wat op fout stond, komt terug als de data hetzelfde is.

Alleen de handmatige knoppen duwen

De docs Handmatig synchroniseren zeggen: die knoppen zijn voor uitzonderingen ná installatie. Ze halen mutaties op vanaf het moment van installatie tot nu. Ze repareren geen verlopen API-key en geen verkeerde omzetrekening.

Geen van die routes vervangt: overzicht openen, status lezen, oorzaak fixen, pas daarna opnieuw aanbieden.

Het overzicht: succesvol versus fout

Open de mutatie-overzichtspagina in de app. Filter op fouten. Zoek het Shopify-ordernummer. Lees de tekst, niet alleen de kleur.

Groen: de mutatie is geaccepteerd. Controleer in e-Boekhouden.nl debiteur, bedrag, btw, verzendkosten. Eén check per inrichting is genoeg; daarna is het overzicht je uitzonderingslijst.

Rood: de push is gestopt. Niet opnieuw duwen in de hoop dat e-Boekhouden.nl soepeler wordt. Eerst de oorzaak.

Geen regel: de webhook heeft de order niet aangeboden, of de trigger is nog niet bereikt. Paid versus Fulfilled is één setting voor de hele koppeling — Koppeling configureren. Staat de trigger op Fulfilled, dan blijft een betaalde maar onverzonden order stil. Dat is geen foutregel. Dat is wachten.

De listing van de e-Boekhouden.nl Koppeling noemt die controle expliciet. Het is hetzelfde scherm als de twee handmatige sync-knoppen bovenaan.

Oorzaak 1: API-key

Zonder verbinding synct er niets. We zetten de stappen in e-Boekhouden API key: token in e-Boekhouden.nl onder Beheer → Koppelingen → API → e-Boekhouden API, kopiëren vóór opslaan, plakken in de app, Connecten. Tokens hebben een einddatum; e-Boekhouden laat doorgaans maximaal ongeveer één jaar toe.

Typische syncfouten vanuit de key, geen validatietekst:

• Nooit Connecten na installatie: het overzicht blijft leeg.

• Token verlopen: mutaties stoppen op de einddatum, Shopify blijft orders maken.

• Key van de verkeerde administratie: boekingen landen waar je ze niet zoekt, of de API weigert.

Fix: nieuwe key, opnieuw Connecten, daarna een testorder. Historische gaten vallen niet vanzelf bij. Terugwerkende kracht vraag je via support, niet via de handmatige knoppen — die docs zeggen dat nadrukkelijk.

Oorzaak 2: mapping

De koppeling boekt als mutatie. Daarvoor heeft ze rekeningen nodig. Koppeling configureren vraagt minimaal:

• Debiteuren: voorbeeld 1300, balans.

• Tegenrekening omzet: voorbeeld 8000, géén balans.

• Verzendkosten: voorbeeld 4590.

• Betaalkosten: voorbeeld 4550, kostenrekening.

Verkeerde mapping is geen “de sync is kapot”. Het is een mutatie op de verkeerde rekening, of een weigering als het nummer in e-Boekhouden.nl niet bestaat. OSS-landrekeningen horen in de 1600-reeks op de balans, één per land — dat staat in OSS-grootboek per land. De app maakt die rekeningen niet aan.

Eén tegenrekening omzet. Er is geen apart veld “hoog/laag”. 21% en 9% komen uit Shopify tax lines plus btw-codes (FAQ vraag 7). Dat hebben we in btw hoog/laag uitgelegd; hier telt het als mapping-oorzaak, niet als extra dropdown.

Oorzaak 3: refund-flow

De FAQ: restituties gaan mee als negatieve mutatie. Geannuleerde orders niet. Wie in Shopify op Annuleren drukt in plaats van Restitutie, krijgt geen credit in e-Boekhouden.nl. Het overzicht toont dan geen fout — er is niets aangeboden. Dat voelt als een syncfout. Het is de verkeerde knop.

Gedeeltelijke restitutie: wel een negatieve mutatie voor het teruggestorte bedrag. We zetten de boeking in refunds boeken en creditorder. Hier: kijk in het overzicht of de refundregel bestaat. Ontbreekt hij, check of Shopify een refund heeft of alleen een cancel.

Handmatig synchen ná een refund die de webhook miste: dezelfde docs, knoppen bovenaan het overzicht. Eerst bevestigen dat er een restitutie in Shopify staat. Anders duw je lucht.

Validatiefouten op adres en e-mail blijven bestaan. Die drie teksten en de standaard-/POS-debiteur staan in het foutmeldingen-artikel. Lees die als de regel rood is met `billing_address` of `contact_email`. Mail info@onlineorigins.nl als de tekst niet in die docs staat. Verzin geen tweede mapping.

Aan de slag met één rode of ontbrekende regel

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

2. Open het mutatie-overzicht. Zoek het ordernummer. Groen, rood, of afwezig?

3. Afwezig: API-key + Connecten, daarna trigger Paid of Fulfilled. Testorder.

4. Rood met adres/e-mail: standaarddebiteur of `address1` — zie foutmeldingen-artikel. Daarna bewust opnieuw aanbieden.

5. Rood of scheef bedrag: grootboeknummers in e-Boekhouden.nl en in Settings naast elkaar.

6. Refund zoek: restitutie in Shopify, niet annuleren. Dan de refundregel in het overzicht.

7. Pas daarna de handmatige knoppen. Tab open laten tot het klaar is. Check in e-Boekhouden.nl: één mutatie, geen dubbele.

Optioneel: installatieservice via info@onlineorigins.nl (eenmalige vergoeding). De hoofdroute blijft zelf het overzicht lezen.

Tot slot

Shopify e-Boekhouden sync fouten zijn zelden “de koppeling is stuk”. Het overzicht vertelt of de key leeft, of de mapping klopt, en of een refund überhaupt is aangeboden. Fix de oorzaak. Duw daarna. Niet andersom.

Gebruik de e-Boekhouden.nl Koppeling als dat scherm: succesvol versus fout, op dezelfde plek als de handmatige sync.