e-Boekhouden mutaties foutmeldingen Shopify: mislukte syncs oplossen

De testorder was groen. Vandaag belt de boekhouder: order 2104 staat in Shopify als Paid, in e-Boekhouden.nl nergens. In de app zie je een rode regel. e-Boekhouden mutaties foutmeldingen Shopify zijn geen “de koppeling is kapot”. Het is een validatie of mapping die de realtime push tegenhoudt — en als je die negeert, duw je dezelfde fout opnieuw, of je typt de verkoop handmatig in én synct daarna alsnog.

Dit artikel volgt de docs-pagina Mutaties Foutmeldingen: welke meldingen het vaakst voorkomen, wat ze betekenen, en hoe je ze oplost zonder dubbele boekingen. De e-Boekhouden.nl Koppeling belooft naast automatische sync ook dat je controleert welke gegevens succesvol of met fouten zijn verwerkt. Dat overzicht is het startpunt.

We schreven eerder hoe je handmatig synchroniseert als een webhook miste, en hoe je grootboekrekeningen mapt. Hier gaat het om de foutregel zelf: lezen, oorzaak fixen, pas daarna opnieuw aanbieden.

Het Shopify-probleem: Paid in de shop, stil in de administratie

Shopify toont de order als betaald. Native Shopify belt e-Boekhouden.nl niet. 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.

Toch kan een regel op fout blijven staan. De app valideert orderdata voordat e-Boekhouden.nl een mutatie accepteert. Ontbreekt `billing_address`, is `address1` leeg, of mist `contact_email`, dan stopt de push. Shopify blijft groen. De administratie blijft stil. Jij ziet alleen de mutatielijst — als je daar kijkt.

De listing van de e-Boekhouden.nl Koppeling noemt die controle expliciet. Listing 5.0 uit 1 review, $13.95/maand, 14 dagen trial, facturatie via Shopify in USD. De listing is Nederlandstalig. Dat overzicht is geen extra rapportage-app; het is hetzelfde scherm als de twee handmatige sync-knoppen.

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 mutatiefout. Dat is een verwachting die de FAQ al ontkracht.

Wat merchants nu proberen

1. De rode regel negeren tot de kwartaalaangifte

Tientallen orders blijven op fout staan. Daarna is de fix hetzelfde — adres of standaarddebiteur — plus een inhaalronde. Liever één oorzaak nu dan een stapel in april.

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

Dubbele mutatie. De app weet niet dat jij de verkoop al hebt ingetypt. Eerst de fouttekst lezen. Als de sync daarna slaagt, heb je twee boekingen voor één Shopify-order.

3. De app herinstalleren “dan komt alles opnieuw”

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

4. Alleen de handmatige knoppen duwen zonder de oorzaak te fixen

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 leeg `address1`. Opnieuw pushen zonder fix geeft dezelfde fout.

Geen van die routes vervangt: mutatielijst openen, foutmelding lezen, Shopify of Settings aanpassen, daarna bewust opnieuw aanbieden.

Hoe je mutatiefouten wél oplost

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

Billing_address: de drie meldingen uit de docs

De pagina Mutaties Foutmeldingen behandelt drie validaties:

1. Veld `address1` ontbreekt of is leeg in `billing_address`.

2. Veld `billing_address` ontbreekt of is leeg in `order_data`. Stel een standaarddebiteur in bij de instellingen om deze order te verwerken.

3. Veld `contact_email` ontbreekt of is leeg in `order_data`. Ook hier: standaarddebiteur.

Uitleg uit die docs: er is geen factuuradres gekoppeld aan de order. Dat gebeurt vaak bij een handmatig aangemaakte order of bij Shopify POS.

Oplossing volgens dezelfde pagina: wil je de order toch doorsturen, stel dan een standaard debiteurcode in via Settings. Koppeling configureren noemt dat veld Standaard debiteurcode — voorbeeld `0012JOOSTJANSEN` — voor shops die bestellingen op één vaste debiteur boeken in plaats van per klant. Voor kassaverkopen is er een apart veld: POS debiteurcode, zodat fysieke verkopen gescheiden blijven van weborders.

Praktische volgorde:

1. Is het een online checkout met een ontbrekend huisnummer? Vul `address1` in Shopify bij en bied de mutatie opnieuw aan.

2. Is het POS of een handmatige order zonder factuuradres? Vul Standaard debiteurcode of POS debiteurcode in Settings. Dan kan de koppeling de order toch als mutatie sturen.

3. Controleer daarna de regel: succesvol of opnieuw fout. In e-Boekhouden.nl: debiteur, bedrag, btw, verzendkosten.

4. Blijft de tekst hetzelfde, dan is de oorzaak niet gefixt. Niet nog eens duwen in de hoop dat e-Boekhouden.nl soepeler wordt.

Staat jouw melding niet in die drie? De docs zeggen: mail info@onlineorigins.nl. Verzin geen tweede mapping.

Wat je niet “fixt” via de foutlijst

• Historie vóór installatie. Handmatige sync haalt dat niet op. Dat is een supportaanvraag, om dubbele boekingen te voorkomen. Zie historische orders.

• Een geannuleerde order. Die gaat niet mee. Wil je crediteren: restitutie in Shopify, dan een aparte negatieve mutatie. We behandelden dat bij refunds.

• Verkeerde grootboekrekening. Dat is meestal geen rode validatiefout maar een mutatie op de verkeerde rekening. Mapping: debiteuren 1300 (balans), omzet 8000 (geen balans), verzend 4590, betaalkosten 4550 — voorbeelden uit de instellingendocs.

Dubbele boekingen voorkomen

De gevaarlijkste workflow: rode regel zien → order intypen in e-Boekhouden.nl “voor de zekerheid” → later de fout fixen → sync slaagt → twee mutaties. Doe één van beide, niet allebei. Of je lost de validatie op en laat de app boeken, of je boekt handmatig en laat die Shopify-regel met rust — en documenteert waarom.

Na een geslaagde herpush gaan nieuwe Paid- of Fulfilled-events weer via webhooks. Blijf je elke ochtend fouten wegklikken, dan is Settings (debiteur, trigger, mapping) het echte probleem, niet de mutatielijst.

Voorbeeld: POS-bon 2104, leeg factuuradres

Een winkel verkoopt online én aan de kassa. Weborders landen. POS-order 2104 (betaald, afgehaald) staat niet in e-Boekhouden.nl. Mutatielijst: validatie `billing_address` ontbreekt. De docs wijzen naar handmatige of POS-orders.

Je vult in Settings de POS debiteurcode in — dezelfde soort code als de standaarddebiteur, maar bedoeld om kassaverkopen apart te houden. Daarna bied je 2104 opnieuw aan, of je gebruikt de handmatige knoppen bovenaan voor mutaties ná installatie. De mutatie gaat erdoor op die POS-debiteur. De volgende afhaalbon zonder factuuradres volgt dezelfde mapping.

Tweede scenario: online order met leeg `address1` (klant of staff heeft het veld overgeslagen). Vul het adres in Shopify, niet een willekeurige debiteur “om erdoor te komen”, tenzij je bewust alles op één standaarddebiteur boekt. Daarna opnieuw aanbieden. Eén mutatie, juiste adresgegevens, geen dubbele boeking.

Wat je nodig hebt om te starten

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

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

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

4. Lees de tekst: `address1`, `billing_address`, `contact_email` — of iets dat niet in de docs staat (dan support).

5. Fix Shopify-data of Standaard/POS-debiteurcode. Duw daarna, niet ervoor.

6. Check e-Boekhouden.nl: één mutatie, juiste debiteur, geen tweede handmatige verkoop ernaast.

Installatie of een hardnekkige melding uitbesteden? Eenmalige installatieservice via info@onlineorigins.nl; bij afzien van de koppeling wordt die vergoeding teruggestort (FAQ). Telefoon: 073 234 0612.

Tot slot

e-Boekhouden mutaties foutmeldingen Shopify zijn bijna altijd validatie: geen factuuradres, geen e-mail, of een POS-bon zonder klantdetail. De listing geeft je het overzicht succesvol versus fout. De docs geven de drie billing_address-teksten en de standaarddebiteur als uitweg. Handmatig synchen is het vangnet ná de fix, geen vervanging ervan.

Open de e-Boekhouden.nl Koppeling-listing, installeer de app, en los de rode regels op voordat je dezelfde order een tweede keer intypt.