Probleemoplossing Herroepingsknop

Symptomen:

• Geen "Withdraw from this order" knop op de orderdetailpagina
• Geen "Withdraw" link bij My Orders
• Klanten melden dat ze de herroepingsoptie niet kunnen vinden

Oplossing:

1. Bevestig dat de module is ingeschakeld voor de juiste store view
2. Controleer of de bestelling in aanmerking komt:
   • Orderstatus moet pending, processing of complete zijn
   • Bestelling moet binnen de geconfigureerde herroepingsperiode vallen
   • Er mag geen bestaande pending/confirmed/processed herroeping zijn voor deze bestelling
   • Bestelling mag niet volledig bestaan uit uitgesloten producttypen, categorieën of SKU's
3. Leeg de full page cache en block HTML cache
4. Als je een custom theme gebruikt, controleer of sales_order_view.xml en sales_order_history.xml layout updates niet worden overschreven

Preventie:

• Leeg altijd de cache na het wijzigen van herroepingsinstellingen
• Controleer uitgesloten producttypen/categorieën/SKU's als knoppen onverwacht verdwijnen

Symptomen:

• Klant klikt op de herroepingslink in de ordermail en krijgt een foutmelding
• Link leidt naar een 404-pagina
• Melding "Invalid or expired token"

Oplossing:

1. Controleer of Include Magic Link in Order Email op Yes staat
2. Controleer of de token niet is verlopen — tokens verlopen wanneer de herroepingsperiode eindigt
3. Controleer of de bestelling niet al een actieve herroeping heeft (slechts één per bestelling)
4. Als de link nooit in de e-mail stond, controleer dan of je orderbevestigingstemplate de variabele `` bevat — de module injecteert deze automatisch, maar custom templates kunnen deze verwijderen

Preventie:

• Zorg ervoor dat je e-mailtemplates gebaseerd zijn op de standaard Magento templates of de herroepingsvariabele bevatten
• Verlopen tokens worden dagelijks om 03:00 UTC opgeruimd door cron

Symptomen:

• Herroeping is succesvol ingediend (referentiecode getoond)
• Klant ontvangt geen bevestigingsmail
• Herroepingsrecord bestaat in de admin grid

Oplossing:

1. Controleer Magento's e-mail queue: System → Email Queue (bij gebruik van async e-mail)
2. Controleer of de e-mailtemplate is geconfigureerd: Stores → Configuration → Magmodules → Withdrawal Button → Email → Customer Confirmation Template
3. Controleer of Magento überhaupt e-mails kan versturen — test met een andere transactionele e-mail
4. Bekijk fouten in var/log/magmodules_withdrawal_button_error.log
5. Controleer of het e-mailadres van de klant geldig is in het herroepingsrecord

Preventie:

• Test het versturen van e-mails tijdens de initiële setup
• Monitor je e-mail delivery-infrastructuur

Symptomen:

• Semi-automatic of Full Automatic modus in gebruik
• Geen meldingsmails ontvangen wanneer herroepingen worden ingediend
• Herroepingen verschijnen wel in de admin grid maar het team werd niet geïnformeerd

Oplossing:

1. Controleer of Admin Notification Recipients minimaal één geldig e-mailadres bevat
2. Controleer of je Semi-automatic of Full Automatic modus gebruikt — Registration Only stuurt geen admin-meldingen
3. Controleer spammappen
4. Bekijk foutlogs voor e-mailverzendfouten

Preventie:

• Gebruik een gedeelde mailbox die actief wordt gemonitord
• Test met een echte herroeping na het wijzigen van e-mailinstellingen

Symptomen:

• After-action Mode staat op Full Automatic
• Herroeping is bevestigd maar orderstatus verandert niet
• action_taken toont none in de admin grid

Oplossing:

1. Controleer of de bestelling kan worden geannuleerd — Magento staat annulering alleen toe in bepaalde statussen (pending, processing). Reeds verzonden of voltooide bestellingen kunnen niet worden geannuleerd.
2. Voor verzonden bestellingen, controleer of een credit memo kan worden aangemaakt — de bestelling heeft facturen nodig en items beschikbaar voor restitutie
3. Bekijk het action_taken veld van het herroepingsrecord:
   • canceled — bestelling is succesvol geannuleerd
   • credit_memo — offline credit memo is aangemaakt
   • none — geen van beide acties was mogelijk; vereist handmatige afhandeling
4. Controleer foutlogs voor specifieke foutredenen

Preventie:

• Begrijp dat Full Automatic bewust fallback-gedrag heeft — complexe gevallen vereisen handmatige interventie
• Monitor de admin grid op herroepingen met action_taken = none

Symptomen:

• Klant voert bestelnummer en e-mail in op de /withdrawal pagina
• Krijgt foutmelding dat de bestelling niet kan worden gevonden
• Bestelling bestaat wel in het systeem

Oplossing:

1. Controleer of de klant het increment ID invoert (bijv. 100000042), niet het entity ID
2. Controleer of het e-mailadres exact overeenkomt — het is niet hoofdlettergevoelig maar moet overeenkomen met het e-mailadres van de bestelling
3. Controleer of de bestelling behoort tot de store view waar de klant browst
4. Controleer of de bestelling aan de geschiktheidsvereisten voldoet

Preventie:

• Overweeg een opmerking toe te voegen aan het opzoekformulier die verduidelijkt welk bestelnummer moet worden gebruikt (het nummer uit de bevestigingsmail)

Symptomen:

• Footerlink is geconfigureerd maar wordt niet getoond in de webshop

Oplossing:

1. Controleer of Enable Footer Link op Yes staat
2. Leeg de full page cache
3. Als je een custom theme gebruikt, controleer of het thema default.xml niet overschrijft op een manier die het herroepingslinkblok verwijdert
4. Controleer of de module is ingeschakeld voor de huidige store view

Preventie:

• Controleer na theme-updates of module layout handles nog steeds worden verwerkt