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

> Diagnosticeer en los veelvoorkomende POS-integratieproblemen op in storekit, waaronder ontbrekende bestellingen, menu-syncfouten, mappingproblemen en connectietime-outs.

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>;
};

## Diagnostische tool

Beantwoord een paar vragen om je probleem te diagnosticeren:

<PosTroubleshooter />

***

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

<Info>
  E-mails over mislukte bestellingen worden verstuurd zelfs als de klant al online heeft betaald, zodat je nooit een bestelling mist die handmatige aandacht nodig heeft.
</Info>

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

<Note>
  **Resend order to POS** verschijnt alleen op bestellingen die nog niet de POS hebben bereikt, bij vestigingen met een verbonden POS-integratie. Zodra de bestelling de POS heeft bereikt, verdwijnt de actie. Los altijd eerst de oorzaak op — opnieuw versturen daarvoor mislukt om dezelfde reden.
</Note>

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

<Warning>
  E-mails over mislukte rekeningbetalingen geven aan dat de klant al succesvol heeft betaald. Je moet deze betaling mogelijk handmatig afstemmen in je POS om afwijkingen te voorkomen.
</Warning>

#### 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](/docs/nl/getting-started/contact-support) voor verdere hulp.


## Related topics

- [Bestelstatussen](/docs/nl/guides/orders/order-statuses.md)
- [Live bestellingen beheren](/docs/nl/guides/orders/managing-live-orders.md)
- [Centegra](/docs/nl/guides/integrations/pos/centegra.md)
- [PointOne](/docs/nl/guides/integrations/pos/pointone.md)
- [PLU-mapping-gids](/docs/nl/guides/integrations/pos/advanced/plu-mapping.md)