> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# POS-Fehlerbehebung

> Diagnostizieren und beheben Sie häufige POS-Integrationsprobleme in storekit, darunter fehlende Bestellungen, Menü-Sync-Fehler, Mapping-Probleme und Verbindungs-Timeouts.

export const PosTroubleshooter = () => {
  const [step, setStep] = useState(0);
  const [answers, setAnswers] = useState({});
  const flow = [{
    question: "What type of issue are you experiencing?",
    options: [{
      label: "Can't connect to POS",
      value: 'connection',
      next: 1
    }, {
      label: "Menu sync not working",
      value: 'sync',
      next: 4
    }, {
      label: "Orders not appearing in POS",
      value: 'injection',
      next: 7
    }, {
      label: "Connection drops randomly",
      value: 'intermittent',
      solution: 'intermittent_connection'
    }]
  }, {
    question: 'Have you double-checked your credentials?',
    options: [{
      label: 'Yes, credentials are definitely correct',
      value: 'creds_ok',
      next: 2
    }, {
      label: 'No / Not sure',
      value: 'creds_unknown',
      solution: 'verify_credentials'
    }]
  }, {
    question: 'Is your POS system currently online?',
    options: [{
      label: 'Yes, I can use it normally',
      value: 'pos_online',
      next: 3
    }, {
      label: 'No / Having issues with POS itself',
      value: 'pos_offline',
      solution: 'pos_offline'
    }]
  }, {
    question: 'Does your POS provider require any special setup for API access?',
    options: [{
      label: 'Yes, I\'ve enabled API access',
      value: 'api_enabled',
      solution: 'firewall_check'
    }, {
      label: 'Not sure / Haven\'t checked',
      value: 'api_unknown',
      solution: 'enable_api_access'
    }]
  }, {
    question: 'What happens when you try to sync?',
    options: [{
      label: 'Nothing happens / Sync button doesn\'t work',
      value: 'no_sync',
      solution: 'check_connection_first'
    }, {
      label: 'Sync runs but products are missing',
      value: 'missing_products',
      next: 5
    }, {
      label: 'Sync completes but prices are wrong',
      value: 'wrong_prices',
      solution: 'tax_settings'
    }]
  }, {
    question: 'Are the missing products active in your POS?',
    options: [{
      label: 'Yes, they\'re active and visible',
      value: 'products_active',
      next: 6
    }, {
      label: 'No / Some are disabled',
      value: 'products_inactive',
      solution: 'activate_products'
    }, {
      label: 'Not sure how to check',
      value: 'check_unknown',
      solution: 'product_status'
    }]
  }, {
    question: 'Are the products assigned to a menu/category in your POS?',
    options: [{
      label: 'Yes, all assigned correctly',
      value: 'assigned',
      solution: 'menu_type_mismatch'
    }, {
      label: 'No / Some aren\'t assigned',
      value: 'not_assigned',
      solution: 'assign_products'
    }, {
      label: 'Not sure',
      value: 'assigned_unknown',
      solution: 'product_status'
    }]
  }, {
    question: 'Do orders appear in your storekit dashboard?',
    options: [{
      label: 'Yes, orders are in the dashboard',
      value: 'in_dashboard',
      next: 8
    }, {
      label: 'No, orders are missing everywhere',
      value: 'no_orders',
      solution: 'order_not_placed'
    }]
  }, {
    question: 'Do you see any error messages on the order in the dashboard?',
    options: [{
      label: 'Yes, there\'s an error shown',
      value: 'has_error',
      next: 9
    }, {
      label: 'No error, just not in POS',
      value: 'no_error',
      solution: 'check_pos_terminal'
    }]
  }, {
    question: 'What type of error do you see?',
    options: [{
      label: 'PLU/product code error',
      value: 'plu_error',
      solution: 'fix_plu_codes'
    }, {
      label: 'Connection/timeout error',
      value: 'connection_error',
      solution: 'injection_connection'
    }, {
      label: 'Validation error',
      value: 'validation_error',
      solution: 'validation_error'
    }, {
      label: 'Other / Not sure',
      value: 'other_error',
      solution: 'contact_support'
    }]
  }];
  const solutions = {
    verify_credentials: {
      title: 'Verify Your Credentials',
      icon: '🔑',
      steps: ['Go to your POS provider\'s admin panel', 'Locate your API credentials (API key, secret, site ID)', 'Copy them fresh - don\'t retype manually', 'Check for extra spaces at the start or end when pasting', 'Ensure credentials haven\'t expired or been regenerated', 'Try the connection again with fresh credentials'],
      severity: 'warning'
    },
    pos_offline: {
      title: 'POS System Offline',
      icon: '📴',
      steps: ['Check your POS terminal is powered on', 'Verify the POS has internet connectivity', 'Check your POS provider\'s status page for outages', 'Restart your POS terminal if needed', 'Try connecting once your POS is working normally'],
      note: 'storekit can\'t connect if your POS system itself is offline.',
      severity: 'error'
    },
    enable_api_access: {
      title: 'Enable API Access',
      icon: '🔓',
      steps: ['Log into your POS provider\'s admin portal', 'Look for "API Access", "Integrations", or "Third-party apps" settings', 'Enable API access for your account', 'Generate new API credentials if required', 'Some providers require you to contact them to enable API access'],
      note: 'Many POS systems require API access to be explicitly enabled before integrations work.',
      severity: 'warning'
    },
    firewall_check: {
      title: 'Check Network/Firewall',
      icon: '🔥',
      steps: ['Ensure your network allows outbound HTTPS connections', 'Check if a firewall is blocking API calls', 'Whitelist storekit\'s servers if required', 'Try from a different network (e.g., mobile hotspot) to test', 'Contact your IT team if on a corporate network'],
      severity: 'warning'
    },
    intermittent_connection: {
      title: 'Fix Intermittent Connection',
      icon: '📡',
      steps: ['Check your internet stability - run a speed test', 'Look for patterns - do failures happen at specific times?', 'Some POS systems restart overnight for maintenance', 'Check if you\'re hitting API rate limits (too many requests)', 'Consider a backup internet connection for reliability', 'Check your POS provider\'s status page for known issues'],
      severity: 'warning'
    },
    check_connection_first: {
      title: 'Check Connection Status',
      icon: '🔌',
      steps: ['Go to Store Settings > Integrations', 'Check if your POS shows as "Connected"', 'If disconnected, click to reconnect', 'Re-enter your credentials if prompted', 'Test the connection before attempting sync', 'Once connected, try the menu sync again'],
      severity: 'warning'
    },
    tax_settings: {
      title: 'Fix Tax/Price Mismatch',
      icon: '💰',
      steps: ['Check if your POS prices include or exclude VAT/tax', 'Go to storekit Settings and verify tax settings match', 'Ensure tax rates are the same in both systems', 'Check for currency or decimal place differences', 'Re-sync the menu after correcting settings'],
      note: 'Price mismatches are almost always caused by tax-inclusive vs tax-exclusive settings.',
      severity: 'info'
    },
    activate_products: {
      title: 'Activate Products in POS',
      icon: '✅',
      steps: ['Log into your POS system', 'Find the products that aren\'t syncing', 'Enable/activate them (look for "Active" or "Published" toggle)', 'Ensure they\'re visible for online ordering if that\'s an option', 'Save changes in your POS', 'Run menu sync again in storekit'],
      severity: 'info'
    },
    product_status: {
      title: 'Check Product Configuration',
      icon: '📋',
      steps: ['In your POS, products need to be: active/enabled, assigned to a category/menu, and visible for the correct channel', 'Check each missing product meets these criteria', 'Some POS systems have separate "online" vs "in-store" visibility', 'Verify the correct menu/price list is selected in storekit settings', 'Run menu sync after making changes'],
      severity: 'info'
    },
    assign_products: {
      title: 'Assign Products to Menu',
      icon: '📁',
      steps: ['In your POS, find the unassigned products', 'Add them to a category or menu group', 'Products outside of categories often won\'t sync', 'Save changes in your POS', 'Run menu sync again in storekit'],
      severity: 'info'
    },
    menu_type_mismatch: {
      title: 'Check Menu Type Settings',
      icon: '📑',
      steps: ['Some POS systems have multiple menu types (dine-in, takeaway, delivery)', 'Verify storekit is syncing from the correct menu type', 'Check your integration settings for menu selection', 'Ensure products are on the menu type being synced', 'Contact support if you\'re unsure which menu to use'],
      severity: 'info'
    },
    order_not_placed: {
      title: 'Order May Not Have Completed',
      icon: '❓',
      steps: ['Ask the customer if they received a confirmation email', 'Check your storekit dashboard Orders page', 'Search by time, customer name, or email', 'If not found, the order likely wasn\'t completed', 'Customer may have abandoned at payment', 'Check for any payment failures in your payment provider'],
      severity: 'info'
    },
    check_pos_terminal: {
      title: 'Check POS Terminal',
      icon: '🖥️',
      steps: ['Verify your POS terminal is powered on', 'Check the terminal has network connectivity', 'Some POS systems queue orders - check for a pending queue', 'Try placing a test order directly in the POS', 'Restart the POS terminal if it seems unresponsive', 'Check if the correct location/terminal is selected in storekit'],
      severity: 'warning'
    },
    fix_plu_codes: {
      title: 'Fix PLU/Product Codes',
      icon: '🏷️',
      steps: ['PLU errors mean storekit can\'t find the product in your POS', 'Go to Menu in your storekit dashboard', 'Find the product(s) mentioned in the error', 'Check the PLU/product code matches exactly what\'s in your POS', 'Update any incorrect codes', 'Don\'t forget to check modifier PLUs too'],
      note: 'Even a small typo in a PLU code will cause the item to fail.',
      severity: 'warning'
    },
    injection_connection: {
      title: 'Order Injection Connection Issue',
      icon: '🔗',
      steps: ['Check your POS integration is still connected', 'Verify your POS terminal is online and accessible', 'Connection errors often mean the POS was temporarily unavailable', 'Try re-sending the order from the order details page', 'If persistent, check your network stability'],
      severity: 'warning'
    },
    validation_error: {
      title: 'Fix Validation Error',
      icon: '⚠️',
      steps: ['Validation errors mean the POS rejected the order data', 'Common causes: missing required fields, invalid modifiers, price mismatches', 'Check if the products in the order still exist in your POS', 'Verify modifier configurations match between systems', 'Re-sync your menu to update product data', 'Contact support with the order ID for specific help'],
      severity: 'warning'
    },
    contact_support: {
      title: 'Contact Support',
      icon: '💬',
      steps: ['Note down the order ID from your dashboard', 'Take a screenshot of the error message', 'Check which products/items are affected', 'Contact storekit support with these details', 'Also check with your POS provider if it\'s a POS-side error'],
      severity: 'info'
    }
  };
  const reset = () => {
    setStep(0);
    setAnswers({});
  };
  const handleAnswer = option => {
    const newAnswers = {
      ...answers,
      [step]: option.value
    };
    setAnswers(newAnswers);
    if (option.solution) {
      setStep(-1);
      setAnswers({
        ...newAnswers,
        solution: option.solution
      });
    } else if (option.next !== undefined) {
      setStep(option.next);
    }
  };
  const currentSolution = answers.solution ? solutions[answers.solution] : null;
  return <div className="not-prose">
      {}
      {step >= 0 && !currentSolution && <div className="space-y-4">
          {step > 0 && <button onClick={reset} className="text-sm text-blue-600 dark:text-blue-400 hover:underline flex items-center gap-1">
              ← Start over
            </button>}
          
          <div className="p-4 rounded-xl border border-zinc-200 dark:border-zinc-700 bg-zinc-50 dark:bg-zinc-800/50">
            <h3 className="text-lg font-semibold text-zinc-900 dark:text-white mb-4">
              {flow[step].question}
            </h3>
            <div className="space-y-2">
              {flow[step].options.map((option, idx) => <button key={idx} onClick={() => handleAnswer(option)} className="w-full p-3 rounded-lg border border-zinc-200 dark:border-zinc-600 hover:border-blue-500 dark:hover:border-blue-500 hover:bg-blue-50 dark:hover:bg-blue-900/20 transition-all text-left text-zinc-900 dark:text-white">
                  {option.label}
                </button>)}
            </div>
          </div>
        </div>}

      {}
      {currentSolution && <div className="space-y-4">
          <button onClick={reset} className="text-sm text-blue-600 dark:text-blue-400 hover:underline flex items-center gap-1">
            ← Start over
          </button>

          <div className={`p-4 rounded-xl border-2 ${currentSolution.severity === 'error' ? 'border-red-300 dark:border-red-800 bg-red-50 dark:bg-red-900/20' : currentSolution.severity === 'warning' ? 'border-yellow-300 dark:border-yellow-800 bg-yellow-50 dark:bg-yellow-900/20' : 'border-blue-300 dark:border-blue-800 bg-blue-50 dark:bg-blue-900/20'}`}>
            <div className="flex items-start gap-3">
              <span className="text-3xl">{currentSolution.icon}</span>
              <div className="flex-1">
                <h3 className="text-lg font-semibold text-zinc-900 dark:text-white">
                  {currentSolution.title}
                </h3>
                
                <ol className="mt-4 space-y-2">
                  {currentSolution.steps.map((s, idx) => <li key={idx} className="flex gap-3">
                      <span className="flex-shrink-0 w-6 h-6 rounded-full bg-zinc-200 dark:bg-zinc-700 flex items-center justify-center text-sm font-medium text-zinc-700 dark:text-zinc-300">
                        {idx + 1}
                      </span>
                      <span className="text-zinc-700 dark:text-zinc-300">{s}</span>
                    </li>)}
                </ol>

                {currentSolution.note && <div className="mt-4 p-3 rounded-lg bg-white/50 dark:bg-black/20 text-sm text-zinc-600 dark:text-zinc-400">
                    💡 {currentSolution.note}
                  </div>}
              </div>
            </div>
          </div>

          <div className="p-4 rounded-xl border border-zinc-200 dark:border-zinc-700 bg-white dark:bg-zinc-800">
            <h4 className="font-medium text-zinc-900 dark:text-white mb-2">Still having issues?</h4>
            <p className="text-sm text-zinc-600 dark:text-zinc-400">
              Contact support with your store name, the order ID (if applicable), and screenshots of any error messages.
            </p>
          </div>
        </div>}
    </div>;
};

## Diagnose-Tool

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

<PosTroubleshooter />

***

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

<Info>
  E-Mails über fehlgeschlagene Bestellungen werden auch dann gesendet, wenn der Kunde bereits online bezahlt hat, damit Sie keine Bestellung verpassen, die manuell bearbeitet werden muss.
</Info>

#### 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

<Note>
  **Bestellung erneut an POS senden** erscheint nur bei Bestellungen, die den POS noch nicht erreicht haben, in Stores mit einer verbundenen POS-Integration. Sobald die Bestellung den POS erreicht hat, verschwindet die Aktion. Beheben Sie immer zuerst die Ursache – ein erneutes Senden ohne Behebung schlägt aus demselben Grund fehl.
</Note>

### 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

<Warning>
  E-Mails zu fehlgeschlagenen Rechnungszahlungen weisen darauf hin, dass der Kunde bereits erfolgreich bezahlt hat. Sie müssen diese Zahlung möglicherweise manuell in Ihrem POS abgleichen, um Unstimmigkeiten zu vermeiden.
</Warning>

#### 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](/docs/de/getting-started/contact-support) für weitere Unterstützung.


## Related topics

- [Centegra](/docs/de/guides/integrations/pos/centegra.md)
- [PointOne](/docs/de/guides/integrations/pos/pointone.md)
- [Bestellstatus](/docs/de/guides/orders/order-statuses.md)
- [Live-Bestellungen verwalten](/docs/de/guides/orders/managing-live-orders.md)
- [Fehlerbehebung bei Webhooks](/docs/de/developers/webhooks/troubleshooting.md)