Probleemoplossing SnelStart Integratie

Symptomen:

• Klikken op "Connect to SnelStart" doet niets
• Geen redirect naar SnelStart login

Oplossing:

1. Controleer browser popups:

   • Browser kan popup blokkeren
   • Sta popups toe voor uw Magento admin domein

2. Controleer JavaScript fouten:

   • Open browser console (F12)
   • Zoek naar JavaScript fouten

3. Leeg cache:

   bin/magento cache:flush
   

4. Probeer andere browser:

   • Sommige browser extensies kunnen interfereren

Symptomen:

• Redirect naar SnelStart werkt
• Fout na login of autorisatie

Oplossing:

1. Controleer SnelStart account:

   • Verifieer dat u admin rechten heeft in SnelStart
   • Zorg dat account actief is en niet vergrendeld

2. Intrekken en opnieuw verbinden:

   • In SnelStart, ga naar account instellingen
   • Trek Magmodules autorisatie in
   • Probeer opnieuw te verbinden in Magento

3. Controleer SSL certificaat:

   • SnelStart vereist HTTPS
   • Verifieer dat uw SSL certificaat geldig is

Symptomen:

• Werkte, plotseling gestopt
• "Not connected" of lege account velden

Oplossing:

1. Opnieuw verbinden:

   • Klik nogmaals op "Connect to SnelStart"
   • Autoriseer de applicatie opnieuw

2. Controleer token verloop:

   • OAuth tokens kunnen verlopen
   • Opnieuw verbinden vernieuwt het token

Symptomen:

• Facturen verschijnen in grid maar status blijft "Pending"
• Geen entries in SnelStart

Oplossing:

1. Controleer cron:

   bin/magento cron:run
   

2. Verifieer automatisering:

   • Winkels → Configuratie → Accounting → General
   • "Auto add invoices" = Yes
   • Module "Enabled" = Yes

3. Controleer sync logs:

   • Accounting → Synchronisation Logs → Invoice
   • Zoek naar foutmeldingen

4. Handmatige sync:

   • Ga naar Accounting → Data → Invoices
   • Selecteer factuur, gebruik "Push to SnelStart" actie

Symptomen:

• Fout: "Tax rate not found" of vergelijkbaar
• Factuur blijft in error status

Oplossing:

1. Controleer Tax Rate Mapping:

   • Ga naar Accounting → Configuration → Tax Rate Mapping
   • Zorg dat alle Magento belastingregels een SnelStart BTW code hebben

2. Controleer fallback tax classes:

   • Configuratie → Accounting → SnelStart → Advanced Settings
   • Stel default tax classes in voor edge cases

3. Opnieuw syncen na fix:

   • Ga naar factuur in grid
   • Reset status en push opnieuw

Symptomen:

• Factuur synchroniseert maar naar verkeerde grootboekrekening
• Omzet verschijnt in verkeerde rekening

Oplossing:

1. Verifieer grootboekrekening configuratie:

   • Controleer Product Hoog/Laag/etc. instellingen
   • Match grootboekrekeningen correct aan BTW tarieven

2. Controleer Tax Rate Mapping:

   • Elke belastingregel moet naar correct SnelStart BTW type mappen
   • 21% → Hoog, 9% → Laag, etc.

3. Controleer advanced ledger mapping:

   • Indien ingeschakeld, kan attribuut-gebaseerde mapping overriden

Symptomen:

• Grootboekrekening dropdowns zijn leeg
• Kan product/verzending grootboekrekeningen niet configureren

Oplossing:

1. Importeer grootboekrekeningen:

   • Ga naar Ledger Accounts & Cost Centers
   • Klik op "Sync Ledger & Costs from SnelStart"
   • Wacht tot import voltooid is

2. Controleer verbinding:

   • Zorg dat verbinding actief is
   • Account veld moet uw accountnaam tonen

3. Controleer SnelStart setup:

   • Verifieer dat grootboekrekeningen bestaan in SnelStart
   • Sommige accounttypes hebben mogelijk niet alle grootboekrekeningen

Symptomen:

• Klikken op sync knop toont fout
• Grootboekrekeningen verschijnen niet na sync

Oplossing:

1. Controleer verbinding:

   • Verbinding moet actief zijn
   • Probeer opnieuw te verbinden via OAuth

2. Controleer rechten:

   • Uw SnelStart account heeft grootboekrekening toegang nodig
   • Neem contact op met uw SnelStart administrator

3. Controleer logs:

   tail -100 var/log/snelstart/error.log
   

Symptomen:

• Dezelfde klant verschijnt meerdere keren in SnelStart
• Nieuwe debiteur aangemaakt voor elke order

Oplossing:

1. Controleer Customer Sync Logic:

   • Configuratie → Accounting → General → Advanced
   • "Customer Sync Logic" instelling

2. Begrijp de logica:

   • Customer: Eén debiteur per customer_id + land + BTW nummer
   • Address: Eén debiteur per factuuradres

3. Waarom duplicaten gebeuren:

   • Klant wijzigt land → nieuwe debiteur
   • Klant voegt BTW nummer toe → nieuwe debiteur
   • Dit is correct gedrag voor BTW doeleinden

Symptomen:

• EU orders gebruiken geen OSS grootboekrekeningen
• Verkeerde BTW wordt toegepast

Oplossing:

1. Schakel OSS eerst in SnelStart in:

   • Configureer in SnelStart applicatie
   • Zie: kennisplein.snelstart.nl

2. Schakel in Magento in:

   • Configuratie → SnelStart → One Stop Shop
   • Zet "Enabled" op Yes

3. Configureer OSS grootboekrekeningen:

   • Ledger: Standaard (meestal 8080)
   • VAT Ledger (meestal 1700)

4. Controleer EU landenlijst:

   • Winkels → Configuratie → Algemeen → Land Opties
   • Verifieer European Union Countries lijst

Symptomen:

• Grote wachtrij bouwt op
• Cron heeft time-out

Oplossing:

1. Verhoog cron frequentie:

   • Vaker = kleinere batches
   • Overweeg "Every 5 minutes" voor hoog volume

2. Controleer batch grootte:

   • Default verwerkt items per cron run
   • Grote achterstanden hebben tijd nodig om weg te werken

3. Monitor server resources:

   • Controleer geheugen en CPU tijdens sync
   • Verhoog PHP memory_limit indien nodig