Probleemoplossing

Oplossingen voor veelvoorkomende problemen met de e-Boekhouden koppelingsmodule.

---

Verbindingsproblemen

Verbindingstest Mislukt

Symptomen:

• "Invalid credentials" fout
• "Authentication failed" melding
• Verbindingstest knop toont fout

Oplossingen:

1. Verifieer gegevens:

   • Log in op e-Boekhouden.nl
   • Ga naar Beheer → Instellingen → Koppelingen tab → API/SOAP
   • Kopieer gegevens exact (inclusief speciale tekens)
   • Let op: Beveiligingscodes zijn hoofdlettergevoelig

2. Controleer scope:

   • Zorg dat u de juiste store view configureert
   • Gegevens kunnen verschillen per store view

3. Wis versleutelde waarden:

   • Verwijder Security Code 1 en 2 velden volledig
   • Sla config op
   • Voer de codes opnieuw in
   • Opslaan en opnieuw testen

4. Controleer API status:

   • Verifieer dat e-Boekhouden API operationeel is
   • Neem contact op met e-Boekhouden support bij aanhoudende problemen

Timeout Fouten

Symptomen:

• "Connection timed out" fouten
• Sync duurt erg lang en mislukt dan

Oplossingen:

1. Controleer server connectiviteit:

   • Verifieer dat uitgaande HTTPS verbindingen zijn toegestaan
   • Controleer firewall regels voor e-Boekhouden API endpoints

2. Verklein batch grootte:

   • Verwerk minder facturen per cron run
   • Overweeg frequentere, kleinere syncs

---

Synchronisatieproblemen

Facturen Synchroniseren Niet

Symptomen:

• Facturen verschijnen in grid maar syncen niet
• Geen entries in Invoice Log
• Success blijft leeg

Oplossingen:

1. Controleer module status:

   • Verifieer dat Module Status op "Yes" staat
   • Verifieer dat Connection op "Enabled" staat

2. Controleer cron:

   bin/magento cron:run
   

   • Verifieer dat Magento cron draait
   • Controleer cron_schedule tabel voor accounting jobs

3. Controleer automatisering:

   • Ga naar Accounting → General
   • Zorg dat "Auto add invoices and creditmemos" op Yes staat

4. Controleer startdatum:

   • Factuurdatum moet na geconfigureerde Start Date zijn
   • Pas Start Date aan indien nodig

5. Handmatige push:

   • Ga naar Accounting → Data → Invoices
   • Klik Actions → Push to e-Boekhouden

Factuur Synct maar Toont Fout

Symptomen:

• Invoice Log toont Success = No
• Foutmelding in Message kolom

Veelvoorkomende fouten en oplossingen:

"Invalid tax code"

• Ga naar Accounting → Configuration → Tax Rate Mapping
• Map de ontbrekende belastingregel naar een e-Boekhouden code
• BTW codes zijn hoofdlettergevoelig (gebruik HOOG_VERK niet hoog_verk)

"Customer email required"

• Order heeft ontbrekend of ongeldig factuur email
• Update klantrecord met geldig email
• Synchroniseer de factuur opnieuw

"Ledger account not found"

• Klik "Sync Ledger & Costs from e-Boekhouden" in instellingen
• Configureer grootboekrekening mappings opnieuw
• Verifieer dat grootboekrekening bestaat in e-Boekhouden

"Invoice number already exists"

• Factuur was eerder gesynchroniseerd naar e-Boekhouden
• Controleer e-Boekhouden direct voor de factuur
• Dit is niet per se een fout

"Factuursjabloon not found"

• Het geconfigureerde sjabloon bestaat niet in e-Boekhouden
• Ga naar e-Boekhouden: Beheer → Sjablonen → Factuursjablonen
• Gebruik de exacte sjabloonnaam in configuratie

Creditnota's Synchroniseren Niet

Symptomen:

• Creditnota's blijven in wachtrij
• Fout: "Invoice not found"

Oplossingen:

1. Synchroniseer originele factuur eerst:

   • Creditnota's vereisen dat de gerelateerde factuur is gesynchroniseerd
   • Vind en sync de originele factuur
   • Synchroniseer daarna de creditnota opnieuw

2. Controleer creditnota datum:

   • Moet na geconfigureerde Start Date zijn

---

BTW Problemen

Verkeerd BTW Tarief in e-Boekhouden

Symptomen:

• Factuur in e-Boekhouden toont verkeerd BTW percentage
• BTW bedragen komen niet overeen met Magento

Oplossingen:

1. Controleer Tax Rate Mapping:

   • Ga naar Accounting → Configuration → Tax Rate Mapping
   • Vind de belastingregel gebruikt op de factuur
   • Verifieer dat correcte e-Boekhouden code is gekoppeld

2. Controleer fallback BTW codes:

   • Ga naar e-Boekhouden.nl → Advanced Settings
   • Verifieer dat Default Tax Classes correct zijn ingesteld

3. Hersync na correctie:

   • Na corrigeren van mapping moet factuur mogelijk handmatig worden aangepast in e-Boekhouden
   • Of maak een correctie-entry

BTW Code Niet in Dropdown

Oplossingen:

1. Importeer BTW codes:

   • Ga naar Ledger Accounts & Cost Centers
   • Klik "Sync Ledger & Costs from e-Boekhouden"
   • BTW codes worden samen met grootboekrekeningen geïmporteerd

2. Controleer e-Boekhouden account:

   • Verifieer dat de BTW code bestaat in uw e-Boekhouden account
   • Verschillende accounttypes kunnen verschillende codes beschikbaar hebben

---

Klantproblemen

Dubbele Klanten in e-Boekhouden

Symptomen:

• Zelfde klant verschijnt meerdere keren als debiteur
• Elke order maakt nieuwe klant aan

Uitleg: Dit kan opzettelijk gebeuren wanneer:

• Klant wijzigt land
• Klant wijzigt BTW-nummer
• "Address" sync logica wordt gebruikt

Oplossingen:

1. Controleer sync logica:

   • Ga naar Accounting → General → Advanced
   • Bekijk Customer Sync Logic instelling
   • "Customer" creëert minder duplicaten dan "Address"

2. Verwacht gedrag:

   • Wijzigingen aan country_id of vat_number maken nieuwe debiteur aan
   • Dit is opzettelijk omdat deze invloed hebben op belastingtarieven

Klant Synchroniseert Niet

Oplossingen:

1. Controleer automatisering:

   • Zorg dat "Auto add customers" op Yes staat

2. Controleer verplichte velden:

   • Klant moet geldig email hebben
   • Voor B2B: Bedrijfsnaam en BTW-nummer aanbevolen

3. Handmatige sync:

   • Ga naar Accounting → Data → Customers
   • Klik Actions → Push to e-Boekhouden

---

Prestatieproblemen

Sync Is Erg Traag

Oplossingen:

1. Optimaliseer cron frequentie:

   • Vaker = kleinere batches = sneller per run
   • Minder vaak = grotere batches = langer per run

2. Controleer op fouten:

   • Mislukte syncs proberen herhaaldelijk opnieuw
   • Los onderliggende fouten eerst op

3. Schakel Force Recalculate alleen in wanneer nodig:

   • Deze instelling verhoogt verwerkingstijd
   • Alleen tijdelijk inschakelen voor migraties

Veel Items in Wachtrij

Oplossingen:

1. Laat cron bijwerken:

   • Initiële sync van historische data kost tijd
   • Overweeg Start Date op recente datum te zetten

2. Voer cron handmatig uit:

   bin/magento cron:run --group=accounting
   

---

Debug Mode

Debug Logging Inschakelen

1. Ga naar e-Boekhouden.nl → Debug & Logging
2. Zet Debug Mode op Yes
3. Sla Config op
4. Reproduceer het probleem
5. Controleer logs:
   • var/log/eboekhouden/debug.log
   • var/log/eboekhouden/error.log

Self Test

1. Ga naar e-Boekhouden.nl → Debug & Logging
2. Klik "Run Self Test"
3. Bekijk resultaten voor configuratieproblemen

Log Bestandslocaties

Log	Pad	Inhoud
Debug	var/log/eboekhouden/debug.log	Gedetailleerde API calls en responses
Error	var/log/eboekhouden/error.log	Alle fouten (altijd gelogd)

---

Veelvoorkomende Foutmeldingen

Fout	Oorzaak	Oplossing
Invalid credentials	Verkeerde API gegevens	Voer gegevens opnieuw in vanuit e-Boekhouden
Authentication failed	Verlopen of ongeldige codes	Genereer nieuwe codes in e-Boekhouden
Invalid tax code	Niet-gekoppelde of verkeerde BTW code	Controleer Tax Rate Mapping
Ledger not found	Ontbrekende grootboekrekening	Sync grootboekrekeningen vanuit e-Boekhouden
Customer email required	Ontbrekend factuur email	Voeg email toe aan order/klant
Invoice already exists	Dubbele sync	Controleer e-Boekhouden, geen actie nodig
Connection timeout	Netwerk/server probleem	Controleer connectiviteit, probeer later opnieuw

---

Hulp Krijgen

Voordat u Contact Opneemt

1. Schakel Debug Mode in en reproduceer het probleem
2. Download debug.log en error.log
3. Noteer de specifieke factuur/klant/creditnota IDs
4. Voer Self Test uit en leg resultaten vast

Support Bronnen

Documentatie:

• Alle Help Artikelen

Support:

• Contact Opnemen

Bij contact met support, geef:

• Magento versie
• Module versie (via Version knop)
• Foutmeldingen uit logs
• Stappen om te reproduceren
• Store view/scope waar probleem optreedt