POS-troubleshooting

​

Diagnostische tool

Beantwoord een paar vragen om je probleem te diagnosticeren:

---

Deze gids behandelt veelvoorkomende problemen met POS-integraties en hoe ze op te lossen.

​

Verbindingsproblemen

​

Integratie wil niet verbinden

Symptomen:

• “Connection failed”-fout bij setup
• Kan integratie-instellingen niet opslaan
• Test connection mislukt

Oplossingen:

1. Verifieer gegevens
   • Controleer API-keys, secrets en site-ID’s dubbel
   • Zorg dat er geen extra spaties in gekopieerde gegevens zitten
   • Bevestig dat gegevens niet zijn verlopen
2. Controleer POS-status
   • Verifieer dat je POS-systeem online is
   • Zorg dat cloudconnectiviteit is ingeschakeld
   • Controleer op POS-systeemstoringen
3. Netwerkproblemen
   • Bevestig dat je vestiging internetconnectiviteit heeft
   • Controleer of firewallinstellingen geen API-calls blokkeren
   • Probeer indien mogelijk vanaf een ander netwerk
4. Neem contact op met je POS-provider
   • Verifieer dat API-toegang is ingeschakeld op je account
   • Vraag nieuwe gegevens aan als bestaande niet werken

​

Verbinding valt intermitterend weg

Symptomen:

• Integratie werkt soms wel en soms niet
• Bestellingen worden af en toe niet geïnjecteerd
• Sync voltooit soms en mislukt andere keren

Oplossingen:

1. Controleer internetstabiliteit
   • Onstabiele verbindingen veroorzaken intermitterende fouten
   • Overweeg een backup-internetverbinding
2. Bekijk POS-uptime
   • Sommige POS-systemen starten ‘s nachts opnieuw op
   • Controleer of fouten correleren met onderhoudsvensters
3. Monitor API-limieten
   • Sommige POS-systemen hebben rate limits
   • Verminder syncfrequentie als limieten worden bereikt

​

Menu-sync-problemen

​

Menu synchroniseert niet

Symptomen:

• Sync-knop doet niets
• Producten verschijnen niet na sync
• Sync draait maar menu is leeg

Oplossingen:

1. Controleer dat integratie verbonden is
   • Ga naar Store Settings > Integrations
   • Verifieer dat de POS als verbonden wordt getoond
2. Verifieer menu in POS
   • Zorg dat producten actief/gepubliceerd zijn
   • Controleer dat producten aan categorieën zijn toegewezen
   • Bevestig dat het menutype correct is
3. Probeer handmatige sync
   • Gebruik de sync-knop in de Menu-sectie
   • Wacht tot sync volledig is voltooid
   • Controleer op foutmeldingen

​

Producten ontbreken na sync

Symptomen:

• Sommige producten synchroniseren maar andere niet
• Modifiers ontbreken
• Categorieën zijn incompleet

Oplossingen:

1. Controleer productstatus in POS
   • Producten moeten actief/ingeschakeld zijn
   • Producten moeten aan een menu zijn toegewezen
   • Controleer productzichtbaarheidsinstellingen
2. Bekijk menustructuur
   • Producten buiten categorieën synchroniseren mogelijk niet
   • Sommige integraties synchroniseren alleen specifieke menutypes
   • Verifieer dat het juiste menu is geselecteerd
3. Controleer op syncfouten
   • Bekijk foutmeldingen na sync
   • Individuele producten kunnen mislukken terwijl andere slagen

​

Prijzen zijn verkeerd

Symptomen:

• Gesynchroniseerde prijzen komen niet overeen met POS
• Prijzen zijn verdubbeld of gehalveerd
• Belasting verschijnt onjuist

Oplossingen:

1. Btw-instellingen komen niet overeen
   • Controleer of POS-prijzen inclusief btw zijn
   • Verifieer dat storekit-btw-instellingen overeenkomen
   • Zorg dat btw-tarieven correct zijn geconfigureerd
2. Valuta-problemen
   • Bevestig dat valuta-instellingen overeenkomen
   • Controleer op verschillen in decimalen
3. Sync opnieuw na wijzigingen
   • Prijzen worden pas bijgewerkt als je synchroniseert
   • Trigger een handmatige sync na prijswijzigingen in POS

​

Order injection-problemen

​

Bestellingen verschijnen niet in POS

Symptomen:

• Klant ontvangt bevestiging
• Bestelling verschijnt in storekit-dashboard
• Bestelling verschijnt nooit in POS

Oplossingen:

1. Controleer integratiestatus
   • Verifieer dat integratie is ingeschakeld
   • Controleer op verbroken verbindingswaarschuwingen
2. Bekijk bestelling in dashboard
   • Kijk naar orderdetails voor fouten
   • Controleer POS-injectiestatusveld
3. Verifieer dat POS online is
   • Controleer of terminal aan staat
   • Bevestig netwerkconnectiviteit
   • Probeer een bestelling direct in POS te plaatsen
4. Controleer PLU-codes (handmatige koppeling)
   • Zorg dat alle items geldige PLU’s hebben
   • Verifieer dat PLU’s bestaan in POS-systeem
5. Controleer op e-mailmeldingen
   • Als order injection mislukt, ontvang je een e-mailmelding
   • De e-mail bevat de specifieke foutreden en orderdetails
   • Controleer of je vestiging-e-mailadres correct is geconfigureerd

​

Bestellingen komen te laat aan

Symptomen:

• Bestellingen komen minuten/uren te laat in POS aan
• Pre-orders komen op verkeerde tijden aan
• ASAP-orders zijn vertraagd

Oplossingen:

1. Controleer injectie-instellingen
   • Bekijk pre-order-injectietiming
   • Verifieer dat ASAP-orders op onmiddellijk zijn ingesteld
2. Netwerklatentie
   • Trage verbindingen vertragen injectie
   • Controleer algehele netwerkprestaties
3. POS-wachtrij-problemen
   • Sommige POS-systemen zetten inkomende bestellingen in de wachtrij
   • Controleer POS-instellingen voor orderverwerking

​

Items ontbreken op bestellingen

Symptomen:

• Bestelling verschijnt maar items ontbreken
• Modifiers worden niet getoond
• Gedeeltelijke bestelling in POS

Oplossingen:

1. PLU-mapping-problemen
   • Ontbrekende PLU’s zorgen dat items mislukken
   • Controleer dat alle producten en modifiers PLU’s hebben
2. Product-mismatch
   • Item kan zijn verwijderd uit POS
   • Sync menu opnieuw om mappings bij te werken
3. Modifier-configuratie
   • Verifieer dat modifiers correct zijn gekoppeld
   • Controleer modifier-groep-instellingen

​

Verkeerde items op bestellingen

Symptomen:

• POS toont andere items dan besteld
• Hoeveelheden zijn verkeerd
• Modifiers toegepast op verkeerde items

Oplossingen:

1. Onjuiste PLU-codes
   • Verkeerde PLU mapt aan verkeerd product
   • Audit PLU-mappings tegen POS
2. Dubbele PLU’s
   • Dezelfde PLU gebruikt voor meerdere producten
   • Zorg dat PLU’s uniek zijn
3. Recente menuwijzigingen
   • Producten kunnen opnieuw gemapt zijn
   • Sync opnieuw en verifieer mappings

​

Kortings- & loyalty-problemen

​

Kortingen worden niet toegepast

Symptomen:

• Loyalty-kortingen verschijnen niet
• Promotionele prijzen werken niet
• Klantsaldo niet weerspiegeld

Oplossingen:

1. Verifieer dat korting actief is
   • Controleer of promotie is ingeschakeld in POS
   • Bevestig dat datumbereik actueel is
   • Verifieer dat aan voorwaarden is voldaan
2. Klantkwalificatie
   • Controleer of klant is aangemeld voor loyalty
   • Verifieer dat klant voldoet aan kortingscriteria
   • Bevestig dat online bestellingen in aanmerking komen
3. Integratie-instellingen
   • Sommige kortingen hebben expliciete inschakeling nodig
   • Controleer korting-syncinstellingen

​

Verkeerde kortingsbedragen

Symptomen:

• Korting toegepast maar bedrag is verkeerd
• Percentage onjuist berekend
• Korting verschijnt twee keer

Oplossingen:

1. Controleer kortingsregels
   • Verifieer kortingsberekeningsmethode
   • Controleer op stacking-regels
2. Btw-interactie
   • Bevestig of korting voor/na btw wordt toegepast
   • Controleer of beide systemen dezelfde methode gebruiken

​

E-mailmeldingen voor mislukte syncs

storekit stuurt automatisch e-mailmeldingen wanneer bestellingen of betalingen niet naar je POS kunnen worden gesynchroniseerd, zodat je nooit kritieke informatie mist.

​

Meldingen mislukte bestellingen

Wanneer een bestelling niet naar je POS kan worden gesynchroniseerd, ontvang je een e-mail met:

• Orderdetails - Klantnaam, order-ID en betaalmethode
• Foutreden - Specifieke technische details over waarom de sync is mislukt
• Orderitems - Een samenvatting van wat is besteld (met afbeeldingen indien beschikbaar)
• Snelle acties - Directe link om de bestelling in je dashboard te bekijken

​

Wat te doen wanneer je een e-mail over een mislukte bestelling ontvangt

1. Controleer de foutreden - De e-mail bevat specifieke details over waarom de sync is mislukt
2. Bekijk de bestelling in dashboard - Klik op de link in de e-mail om volledige orderdetails te zien
3. Los de onderliggende oorzaak op - Zet bijvoorbeeld de POS-terminal of iPad-app weer aan, of unsnooze een vereiste modifier die ontbreekt in de bestelling
4. Stuur de bestelling zelf opnieuw naar je POS - Open de bestelling, klik op More actions en vervolgens Resend order to POS. Het dashboard bevestigt met Queued POS order injection retry en de bestelling wordt opnieuw naar je POS gestuurd
5. Voer de bestelling handmatig in - Als de retry nog steeds mislukt, voer de bestelling dan direct in je POS in als fallback
6. Neem contact op met support - Als het probleem aanhoudt, is ons supportteam al op de hoogte gebracht en kan helpen om het op te lossen

​

Meldingen mislukte rekeningbetalingen

Wanneer een Pay at Table-betaling slaagt maar niet kan worden gesynchroniseerd naar je POS, ontvang je een e-mailmelding. Dit is cruciaal omdat de klant al heeft betaald, maar je POS dit mogelijk niet weerspiegelt. De melding bevat:

• Rekeningdetails - Bill-ID en vestigingsnaam
• Betalingsinformatie - Payment-ID en transactiedetails
• Foutreden - Specifieke technische details over waarom de sync is mislukt
• Referentie-ID’s - Zowel storekit- als POS-bill-ID’s voor reconciliatie
• Snelle acties - Directe link om de rekening in je dashboard te bekijken

​

Wat te doen wanneer je een e-mail over een mislukte rekeningbetaling ontvangt

1. Controleer de foutdetails - De e-mail bevat specifieke informatie over waarom de sync is mislukt
2. Bekijk de rekening in dashboard - Klik op de link om volledige betaaldetails te zien
3. Reconciliseer handmatig in POS - Markeer de rekening indien nodig als betaald in je POS
4. Neem contact op met support - Ons team is automatisch op de hoogte gebracht en kan helpen bij terugkerende problemen

​

Zorgen dat je meldingen ontvangt

Zorg dat je vestiging-e-mailadres correct is geconfigureerd:

1. Ga naar Store Settings in je dashboard
2. Navigeer naar Store Details
3. Verifieer dat je e-mailadres correct is
4. Voeg indien nodig meerdere e-mailadressen toe (het eerste adres ontvangt meldingen)

​

Hulp krijgen

Als je deze oplossingen hebt geprobeerd en nog steeds problemen ondervindt:

1. Verzamel informatie
   • Noteer de specifieke foutmeldingen
   • Registreer de betreffende order-ID(‘s)
   • Maak screenshots indien mogelijk
   • Controleer op e-mailmeldingen over mislukte bestellingen
2. Controleer status POS-provider
   • Kijk voor systeembrede problemen
   • Neem contact op met POS-support voor hun kant
3. Neem contact op met storekit-support
   • Verstrek order-ID’s en foutdetails
   • Deel integratie-instellingen (geen gegevens)
   • Stuur eventuele e-mailmeldingen over mislukte bestellingen door

Neem contact op met support voor verdere hulp.