POS-Fehlerbehebung

​

Diagnose-Tool

Beantworten Sie ein paar Fragen, um Ihr Problem zu diagnostizieren:

---

Dieser Leitfaden behandelt häufige Probleme mit POS-Integrationen und deren Lösung.

​

Verbindungsprobleme

​

Integration lässt sich nicht verbinden

Symptome:

• Fehler „Verbindung fehlgeschlagen” bei der Einrichtung
• Integrationseinstellungen können nicht gespeichert werden
• Verbindungstest schlägt fehl

Lösungen:

1. Zugangsdaten überprüfen
   • Prüfen Sie API-Schlüssel, Secrets und Site-IDs doppelt
   • Achten Sie darauf, dass keine Leerzeichen in kopierten Zugangsdaten sind
   • Bestätigen Sie, dass die Zugangsdaten nicht abgelaufen sind
2. POS-Status prüfen
   • Überprüfen Sie, ob Ihr POS-System online ist
   • Stellen Sie sicher, dass Cloud-Konnektivität aktiviert ist
   • Prüfen Sie auf POS-System-Ausfälle
3. Netzwerkprobleme
   • Bestätigen Sie, dass Ihr Standort über Internetverbindung verfügt
   • Prüfen Sie, ob Firewall-Einstellungen API-Aufrufe blockieren
   • Versuchen Sie es nach Möglichkeit aus einem anderen Netzwerk
4. POS-Anbieter kontaktieren
   • Überprüfen Sie, ob der API-Zugriff für Ihr Konto aktiviert ist
   • Fordern Sie neue Zugangsdaten an, wenn die bestehenden nicht funktionieren

​

Verbindung bricht zeitweise ab

Symptome:

• Integration funktioniert manchmal, manchmal nicht
• Bestellungen scheitern gelegentlich bei der Injection
• Synchronisation gelingt manchmal, manchmal nicht

Lösungen:

1. Internet-Stabilität prüfen
   • Instabile Verbindungen verursachen sporadische Fehler
   • Erwägen Sie eine Backup-Internetverbindung
2. POS-Uptime prüfen
   • Manche POS-Systeme starten nachts neu
   • Prüfen Sie, ob Fehler mit Wartungsfenstern korrelieren
3. API-Limits überwachen
   • Manche POS-Systeme haben Rate-Limits
   • Reduzieren Sie die Sync-Frequenz, wenn Limits erreicht werden

​

Menü-Sync-Probleme

​

Menü synchronisiert nicht

Symptome:

• Sync-Button reagiert nicht
• Produkte erscheinen nach Sync nicht
• Sync läuft, aber Menü ist leer

Lösungen:

1. Integration ist verbunden prüfen
   • Gehen Sie zu Store-Einstellungen > Integrationen
   • Überprüfen Sie, dass der POS als verbunden angezeigt wird
2. Menü im POS überprüfen
   • Stellen Sie sicher, dass Produkte aktiv/veröffentlicht sind
   • Prüfen Sie, dass Produkte Kategorien zugewiesen sind
   • Bestätigen Sie, dass der Menütyp korrekt ist
3. Manuelle Synchronisation versuchen
   • Verwenden Sie den Sync-Button im Menü-Bereich
   • Warten Sie, bis die Synchronisation vollständig abgeschlossen ist
   • Prüfen Sie auf Fehlermeldungen

​

Produkte fehlen nach Sync

Symptome:

• Einige Produkte werden synchronisiert, andere nicht
• Modifikatoren fehlen
• Kategorien sind unvollständig

Lösungen:

1. Produktstatus im POS prüfen
   • Produkte müssen aktiv/aktiviert sein
   • Produkte müssen einem Menü zugewiesen sein
   • Prüfen Sie die Sichtbarkeitseinstellungen der Produkte
2. Menüstruktur überprüfen
   • Produkte außerhalb von Kategorien werden möglicherweise nicht synchronisiert
   • Manche Integrationen synchronisieren nur bestimmte Menütypen
   • Prüfen Sie, ob das richtige Menü ausgewählt ist
3. Auf Sync-Fehler prüfen
   • Überprüfen Sie Fehlermeldungen nach dem Sync
   • Einzelne Produkte können scheitern, während andere gelingen

​

Preise sind falsch

Symptome:

• Synchronisierte Preise stimmen nicht mit POS überein
• Preise sind verdoppelt oder halbiert
• Steuer erscheint falsch

Lösungen:

1. Nicht übereinstimmende Steuereinstellungen
   • Prüfen Sie, ob POS-Preise die Steuer enthalten
   • Vergewissern Sie sich, dass storekit-Steuereinstellungen übereinstimmen
   • Stellen Sie sicher, dass Steuersätze korrekt konfiguriert sind
2. Währungsprobleme
   • Bestätigen Sie, dass Währungseinstellungen übereinstimmen
   • Prüfen Sie auf Unterschiede bei Dezimalstellen
3. Nach Änderungen erneut synchronisieren
   • Preise werden erst nach dem Sync aktualisiert
   • Lösen Sie einen manuellen Sync nach Preisänderungen im POS aus

​

Probleme mit Order Injection

​

Bestellungen erscheinen nicht im POS

Symptome:

• Kunde erhält Bestätigung
• Bestellung erscheint im storekit-Dashboard
• Bestellung erscheint nie im POS

Lösungen:

1. Integrationsstatus prüfen
   • Überprüfen Sie, dass die Integration aktiviert ist
   • Prüfen Sie auf Trennungswarnungen
2. Bestellung im Dashboard überprüfen
   • Sehen Sie sich die Bestelldetails auf Fehler an
   • Prüfen Sie das Feld POS-Injection-Status
3. POS online prüfen
   • Überprüfen Sie, dass das Terminal eingeschaltet ist
   • Bestätigen Sie die Netzwerkverbindung
   • Versuchen Sie, eine Bestellung direkt im POS aufzugeben
4. PLU-Codes prüfen (manuelle Verknüpfung)
   • Stellen Sie sicher, dass alle Artikel gültige PLUs haben
   • Überprüfen Sie, dass PLUs im POS-System existieren
5. E-Mail-Benachrichtigungen prüfen
   • Wenn die Order Injection fehlschlägt, erhalten Sie eine E-Mail-Benachrichtigung
   • Die E-Mail enthält den spezifischen Fehlergrund und die Bestelldetails
   • Prüfen Sie, ob Ihre Venue-E-Mail-Adresse korrekt konfiguriert ist

​

Bestellungen erscheinen verspätet

Symptome:

• Bestellungen erscheinen minuten-/stundenlang verspätet im POS
• Vorbestellungen kommen zur falschen Zeit an
• ASAP-Bestellungen sind verzögert

Lösungen:

1. Injection-Einstellungen prüfen
   • Überprüfen Sie das Timing für Vorbestellungs-Injection
   • Vergewissern Sie sich, dass ASAP-Bestellungen auf sofort eingestellt sind
2. Netzwerklatenz
   • Langsame Verbindungen verzögern die Injection
   • Prüfen Sie die allgemeine Netzwerkleistung
3. POS-Warteschlangen-Probleme
   • Manche POS-Systeme stellen eingehende Bestellungen in Warteschlangen
   • Prüfen Sie die POS-Einstellungen für die Bestellverarbeitung

​

Fehlende Artikel in Bestellungen

Symptome:

• Bestellung erscheint, aber Artikel fehlen
• Modifikatoren werden nicht angezeigt
• Teilbestellung im POS

Lösungen:

1. PLU-Mapping-Probleme
   • Fehlende PLUs führen zum Ausfall von Artikeln
   • Prüfen Sie, ob alle Produkte und Modifikatoren PLUs haben
2. Produkt-Mismatch
   • Artikel wurde möglicherweise aus POS gelöscht
   • Menü erneut synchronisieren, um Zuordnungen zu aktualisieren
3. Modifikator-Konfiguration
   • Überprüfen Sie, dass Modifikatoren korrekt verknüpft sind
   • Prüfen Sie die Einstellungen der Modifikatorgruppen

​

Falsche Artikel in Bestellungen

Symptome:

• POS zeigt andere Artikel als bestellt
• Mengen sind falsch
• Modifikatoren werden falschen Artikeln zugeordnet

Lösungen:

1. PLU-Codes falsch
   • Falsche PLU verweist auf falsches Produkt
   • Auditieren Sie die PLU-Zuordnungen gegen den POS
2. Doppelte PLUs
   • Gleiche PLU wird für mehrere Produkte verwendet
   • Stellen Sie sicher, dass PLUs eindeutig sind
3. Kürzliche Menüänderungen
   • Produkte wurden möglicherweise neu zugeordnet
   • Erneut synchronisieren und Zuordnungen überprüfen

​

Probleme mit Rabatten & Treueprogrammen

​

Rabatte werden nicht angewendet

Symptome:

• Treuerabatte erscheinen nicht
• Aktionspreise funktionieren nicht
• Kundenguthaben wird nicht berücksichtigt

Lösungen:

1. Rabatt ist aktiv prüfen
   • Überprüfen Sie, dass die Promotion im POS aktiviert ist
   • Bestätigen Sie, dass der Datumsbereich aktuell ist
   • Prüfen Sie, dass die Bedingungen erfüllt sind
2. Kundenqualifikation
   • Prüfen Sie, ob der Kunde im Treueprogramm eingeschrieben ist
   • Überprüfen Sie, dass der Kunde die Rabattkriterien erfüllt
   • Bestätigen Sie, dass Online-Bestellungen berechtigt sind
3. Integrationseinstellungen
   • Einige Rabatte müssen explizit aktiviert werden
   • Prüfen Sie die Rabatt-Sync-Einstellungen

​

Falsche Rabattbeträge

Symptome:

• Rabatt wird angewendet, aber Betrag ist falsch
• Prozentsatz wird falsch berechnet
• Rabatt erscheint doppelt

Lösungen:

1. Rabattregeln prüfen
   • Überprüfen Sie die Berechnungsmethode des Rabatts
   • Prüfen Sie Stacking-Regeln
2. Steuerinteraktion
   • Bestätigen Sie, ob Rabatt vor/nach Steuer angewendet wird
   • Prüfen Sie, dass beide Systeme die gleiche Methode verwenden

​

E-Mail-Benachrichtigungen für fehlgeschlagene Synchronisationen

storekit sendet automatisch E-Mail-Benachrichtigungen, wenn Bestellungen oder Zahlungen nicht mit Ihrem POS synchronisiert werden können, damit Sie keine wichtigen Informationen verpassen.

​

Benachrichtigungen zu fehlgeschlagenen Bestellungen

Wenn eine Bestellung nicht mit Ihrem POS synchronisiert werden kann, erhalten Sie eine E-Mail mit folgenden Informationen:

• Bestelldetails – Kundenname, Bestell-ID und Zahlungsmethode
• Fehlergrund – Spezifische technische Details darüber, warum die Synchronisation fehlgeschlagen ist
• Bestellpositionen – Eine Zusammenfassung des Bestellten (wenn verfügbar mit Bildern)
• Schnellaktionen – Direkter Link zur Ansicht der Bestellung in Ihrem Dashboard

​

Was zu tun ist, wenn Sie eine E-Mail über eine fehlgeschlagene Bestellung erhalten

1. Fehlergrund prüfen – Die E-Mail enthält spezifische Details darüber, warum die Synchronisation fehlgeschlagen ist
2. Bestellung im Dashboard anzeigen – Klicken Sie auf den Link in der E-Mail, um alle Bestelldetails zu sehen
3. Ursache beheben – Zum Beispiel POS-Terminal oder iPad-App wieder einschalten oder einen erforderlichen Modifikator, der in der Bestellung fehlt, wieder aktivieren
4. Bestellung selbst erneut an den POS senden – Öffnen Sie die Bestellung, klicken Sie auf Weitere Aktionen und dann auf Bestellung erneut an POS senden. Das Dashboard bestätigt mit POS-Order-Injection-Wiederholung in Warteschlange und die Bestellung wird erneut an Ihren POS gesendet
5. Bestellung manuell eingeben – Wenn die Wiederholung erneut fehlschlägt, geben Sie die Bestellung direkt in Ihren POS als Rückfalloption ein
6. Support kontaktieren – Wenn das Problem weiterhin besteht, wurde unser Support-Team bereits benachrichtigt und kann bei der Lösung helfen

​

Benachrichtigungen zu fehlgeschlagenen Rechnungszahlungen

Wenn eine Pay-at-Table-Zahlung erfolgreich ist, aber nicht mit Ihrem POS synchronisiert werden kann, erhalten Sie eine E-Mail-Benachrichtigung. Dies ist kritisch, weil der Kunde bereits bezahlt hat, Ihr POS dies jedoch möglicherweise nicht widerspiegelt. Die Benachrichtigung enthält:

• Rechnungsdetails – Rechnungs-ID und Venue-Name
• Zahlungsinformationen – Zahlungs-ID und Transaktionsdetails
• Fehlergrund – Spezifische technische Details darüber, warum die Synchronisation fehlgeschlagen ist
• Referenz-IDs – Sowohl storekit- als auch POS-Rechnungs-IDs zur Abstimmung
• Schnellaktionen – Direkter Link zur Ansicht der Rechnung in Ihrem Dashboard

​

Was zu tun ist, wenn Sie eine E-Mail über eine fehlgeschlagene Rechnungszahlung erhalten

1. Fehlerdetails prüfen – Die E-Mail enthält spezifische Informationen darüber, warum die Synchronisation fehlgeschlagen ist
2. Rechnung im Dashboard anzeigen – Klicken Sie auf den Link, um alle Zahlungsdetails zu sehen
3. Manuell im POS abgleichen – Markieren Sie die Rechnung bei Bedarf im POS als bezahlt
4. Support kontaktieren – Unser Team wird automatisch benachrichtigt und kann bei wiederkehrenden Problemen helfen

​

Sicherstellen, dass Sie Benachrichtigungen erhalten

Stellen Sie sicher, dass Ihre Venue-E-Mail-Adresse korrekt konfiguriert ist:

1. Gehen Sie in Ihrem Dashboard zu Store-Einstellungen
2. Navigieren Sie zu Store-Details
3. Überprüfen Sie, dass Ihre E-Mail-Adresse korrekt ist
4. Fügen Sie bei Bedarf mehrere E-Mail-Adressen hinzu (die erste Adresse erhält Benachrichtigungen)

​

Hilfe erhalten

Wenn Sie diese Lösungen ausprobiert haben und weiterhin Probleme bestehen:

1. Informationen sammeln
   • Notieren Sie die spezifischen Fehlermeldungen
   • Erfassen Sie die betroffenen Bestell-IDs
   • Machen Sie nach Möglichkeit Screenshots
   • Prüfen Sie auf E-Mail-Benachrichtigungen zu fehlgeschlagenen Bestellungen
2. POS-Anbieterstatus prüfen
   • Suchen Sie nach systemweiten Problemen
   • Wenden Sie sich für die POS-Seite an den POS-Support
3. storekit-Support kontaktieren
   • Geben Sie Bestell-IDs und Fehlerdetails an
   • Teilen Sie Integrationseinstellungen (keine Zugangsdaten) mit
   • Leiten Sie E-Mail-Benachrichtigungen zu fehlgeschlagenen Bestellungen weiter

Kontaktieren Sie den Support für weitere Unterstützung.