SYNC131: Serverfout in de winkel

Wat dit betekent

Je winkel heeft een fout teruggegeven, waardoor deze actie niet is voltooid.

De winkel is wel bereikt, maar de server kon het verzoek niet verwerken. Dit is een probleem op de website en niet in de POS, dus alleen opnieuw proberen helpt mogelijk niet: controleer het foutlog van de site of vraag de host dat te doen en probeer het daarna opnieuw. Er is niets verloren gegaan op dit apparaat.

Wat je moet doen

Probeer de actie opnieuw. WCPOS probeert dit niet uit zichzelf opnieuw — probeer het opnieuw wanneer je er klaar voor bent.

Je gegevens

De wijziging is op dit apparaat opgeslagen, maar heeft je winkel niet bereikt. Als dit aanhoudt, exporteer dan diagnostische gegevens en neem contact op met WCPOS-support.

Probleemoplossing

1. Vouw de logvermelding uit en noteer de status, het endpoint en de serverCode — die vertellen wat de server aan het doen was toen het misging.
2. Open WooCommerce → Status → Logs op de site en controleer het nieuwste fatal-errors-log rond het tijdstip van de fout; een respons uit de 500-reeks laat daar vrijwel altijd een PHP-fout achter.
3. Als de fout begon na een plugin-, thema- of PHP-update op de site, verdenk die wijziging dan eerst en draai deze terug of schakel deze uit.
4. Als de logs van WooCommerce niets tonen, vraag de hostingprovider dan om het PHP-foutlog van de server voor hetzelfde tijdvenster.
5. Probeer het opnieuw vanuit de POS zodra de oorzaak aan de serverkant is opgelost — de wijziging staat nog steeds opgeslagen op dit apparaat.

Waar je moet kijken

Als WCPOS deze fout kan opslaan, wordt deze vastgelegd op het apparaat waarop de fout is opgetreden. Open Winkelstatus → Logs (het hartslagpictogram onderaan het navigatiepaneel), zoek de vermelding met deze code op en vouw deze uit: de uitgevouwen regel toont de reden in begrijpelijke taal en de context die op het moment van de fout is vastgelegd. Bij een verzoek aan de winkel kan die context de eigen foutcode van de server (serverCode), de HTTP-status of het endpoint bevatten; welke velden worden getoond, hangt af van waar de fout is opgetreden. Gebruik bij het melden van een probleem Debug-info kopiëren boven aan het Logs-scherm (Debug-info delen op telefoons en tablets) in plaats van schermafbeeldingen: dit bundelt de app-versie, de verbindingsstatus en de meest recente fouten. Logs worden maximaal 30 dagen bewaard, dus verzamel ze zolang het probleem vers is. Kopieer ook eventuele fouten uit de browserconsole die verschenen voordat de POS zijn eigen logvermelding kon schrijven.

Naast het log in de app kan deze fout ook sporen achterlaten in:

• Netwerkinspector (web en desktop): open de ontwikkelaarstools — druk op F12 in de browser of kies Geavanceerd → Ontwikkelaarstools in-/uitschakelen in het menu van de desktop-app — en ga naar het tabblad Netwerk. Volg eerst de instructies voor opnieuw proberen op deze pagina; herhaal de actie alleen wanneer die stappen aangeven dat het veilig is. Een mislukt verzoek toont de HTTP-status en de onbewerkte responsinhoud, inclusief foutpagina's die het POS-log nooit bereiken.
• Server-side POS-logs: open in WP Admin POS → Instellingen → Gereedschap → Logs. Deze pagina registreert POS-gerelateerde waarschuwingen en fouten die op de server zelf optreden en die mogelijk nooit in de app verschijnen. Een rode markering bij het menu betekent dat er ongelezen server-side fouten zijn.
• WooCommerce → Status → Logs: controleer op de WordPress-site het nieuwste fatal-errors-*.log op PHP-crashes, plus elke logbron die is genoemd naar een plugin die bij de fout betrokken is. Een fout uit de 500-reeks vanuit de winkel laat de oorzaak hier vrijwel altijd achter.
• Het PHP-foutlog van de site: als de logpagina van WooCommerce niets toont voor het tijdstip van de fout, vraag de hostingprovider dan om het PHP-foutlog — sommige fatale fouten worden alleen op serverniveau vastgelegd.

Details

• Code: SYNC131 (STORE_SERVER_ERROR)
• Ernst: error
• Geïntroduceerd in: WCPOS 1.10.0