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

# Dépannage POS

> Diagnostiquez et résolvez les problèmes courants d'intégration POS dans storekit, y compris les commandes manquantes, erreurs de synchronisation de menu, problèmes de mappage et délais de connexion.

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

## Outil de diagnostic

Répondez à quelques questions pour diagnostiquer votre problème :

<PosTroubleshooter />

***

Ce guide couvre les problèmes courants avec les intégrations POS et comment les résoudre.

## Problèmes de connexion

### L'intégration ne se connecte pas

**Symptômes :**

* Erreur « Connection failed » lors de la configuration
* Impossible d'enregistrer les paramètres d'intégration
* Le test de connexion échoue

**Solutions :**

1. **Vérifiez les identifiants**
   * Vérifiez soigneusement les clés API, secrets et IDs de site
   * Assurez-vous qu'il n'y a pas d'espaces superflus dans les identifiants copiés
   * Confirmez que les identifiants n'ont pas expiré

2. **Vérifiez le statut du POS**
   * Vérifiez que votre système POS est en ligne
   * Assurez-vous que la connectivité cloud est activée
   * Vérifiez les pannes du système POS

3. **Problèmes réseau**
   * Confirmez que votre établissement a une connexion Internet
   * Vérifiez que les paramètres du pare-feu ne bloquent pas les appels API
   * Essayez depuis un autre réseau si possible

4. **Contactez votre fournisseur POS**
   * Vérifiez que l'accès API est activé sur votre compte
   * Demandez de nouveaux identifiants si ceux existants ne fonctionnent pas

### La connexion se coupe par intermittence

**Symptômes :**

* L'intégration fonctionne parfois mais pas toujours
* Les commandes échouent occasionnellement à s'injecter
* La synchronisation se termine parfois mais échoue à d'autres moments

**Solutions :**

1. **Vérifiez la stabilité de la connexion Internet**
   * Les connexions instables causent des échecs intermittents
   * Envisagez une connexion Internet de secours

2. **Vérifiez la disponibilité du POS**
   * Certains systèmes POS redémarrent la nuit
   * Vérifiez si les échecs correspondent aux fenêtres de maintenance

3. **Surveillez les limites d'API**
   * Certains systèmes POS ont des limites de débit
   * Réduisez la fréquence de synchronisation si vous atteignez les limites

## Problèmes de synchronisation du menu

### Le menu ne se synchronise pas

**Symptômes :**

* Le bouton de synchronisation ne fait rien
* Les produits n'apparaissent pas après la synchronisation
* La synchronisation s'exécute mais le menu est vide

**Solutions :**

1. **Vérifiez que l'intégration est connectée**
   * Allez dans Paramètres de la boutique > Intégrations
   * Vérifiez que le POS s'affiche comme connecté

2. **Vérifiez le menu dans le POS**
   * Assurez-vous que les produits sont actifs/publiés
   * Vérifiez que les produits sont assignés à des catégories
   * Confirmez que le type de menu est correct

3. **Essayez la synchronisation manuelle**
   * Utilisez le bouton de synchronisation dans la section Menu
   * Attendez que la synchronisation soit complètement terminée
   * Recherchez les messages d'erreur

### Produits manquants après synchronisation

**Symptômes :**

* Certains produits se synchronisent mais d'autres non
* Des modificateurs manquent
* Les catégories sont incomplètes

**Solutions :**

1. **Vérifiez le statut du produit dans le POS**
   * Les produits doivent être actifs/activés
   * Les produits doivent être assignés à un menu
   * Vérifiez les paramètres de visibilité du produit

2. **Vérifiez la structure du menu**
   * Les produits hors catégorie peuvent ne pas se synchroniser
   * Certaines intégrations ne synchronisent que des types de menu spécifiques
   * Vérifiez que le bon menu est sélectionné

3. **Vérifiez les erreurs de synchronisation**
   * Consultez les messages d'erreur après synchronisation
   * Des produits individuels peuvent échouer alors que d'autres réussissent

### Les prix sont incorrects

**Symptômes :**

* Les prix synchronisés ne correspondent pas au POS
* Les prix sont doublés ou divisés par deux
* La taxe apparaît de manière incorrecte

**Solutions :**

1. **Incohérence des paramètres de taxe**
   * Vérifiez si les prix POS incluent la taxe
   * Vérifiez que les paramètres de taxe storekit correspondent
   * Assurez-vous que les taux de taxe sont correctement configurés

2. **Problèmes de devise**
   * Confirmez que les paramètres de devise correspondent
   * Vérifiez les différences de décimales

3. **Resynchronisez après changements**
   * Les prix ne se mettent pas à jour tant que vous n'avez pas synchronisé
   * Déclenchez une synchronisation manuelle après des changements de prix dans le POS

## Problèmes d'injection de commande

### Les commandes n'apparaissent pas dans le POS

**Symptômes :**

* Le client reçoit une confirmation
* La commande apparaît dans le tableau de bord storekit
* La commande n'apparaît jamais dans le POS

**Solutions :**

1. **Vérifiez le statut de l'intégration**
   * Vérifiez que l'intégration est activée
   * Recherchez les avertissements de déconnexion

2. **Consultez la commande dans le tableau de bord**
   * Consultez les détails de la commande pour les erreurs
   * Vérifiez le champ de statut d'injection POS

3. **Vérifiez que le POS est en ligne**
   * Vérifiez que le terminal est sous tension
   * Confirmez la connectivité réseau
   * Essayez de passer une commande directement dans le POS

4. **Vérifiez les codes PLU (liaison manuelle)**
   * Assurez-vous que tous les articles ont des PLU valides
   * Vérifiez que les PLU existent dans le système POS

5. **Vérifiez les notifications par email**
   * Si l'injection de commande échoue, vous recevrez une notification par email
   * L'email inclut la raison spécifique de l'erreur et les détails de la commande
   * Vérifiez que l'adresse email de votre établissement est correctement configurée

### Commandes arrivant en retard

**Symptômes :**

* Les commandes arrivent au POS avec plusieurs minutes/heures de retard
* Les précommandes arrivent aux mauvaises heures
* Les commandes ASAP sont retardées

**Solutions :**

1. **Vérifiez les paramètres d'injection**
   * Consultez le timing d'injection des précommandes
   * Vérifiez que les commandes ASAP sont configurées sur immédiat

2. **Latence réseau**
   * Les connexions lentes retardent l'injection
   * Vérifiez la performance globale du réseau

3. **Problèmes de file d'attente POS**
   * Certains systèmes POS mettent en file d'attente les commandes entrantes
   * Vérifiez les paramètres du POS pour le traitement des commandes

### Articles manquants dans les commandes

**Symptômes :**

* La commande apparaît mais des articles manquent
* Les modificateurs ne s'affichent pas
* Commande partielle dans le POS

**Solutions :**

1. **Problèmes de mappage PLU**
   * Les PLU manquants font échouer les articles
   * Vérifiez que tous les produits et modificateurs ont des PLU

2. **Incohérence de produit**
   * L'article peut avoir été supprimé du POS
   * Resynchronisez le menu pour mettre à jour les mappages

3. **Configuration des modificateurs**
   * Vérifiez que les modificateurs sont correctement liés
   * Vérifiez les paramètres des groupes de modificateurs

### Articles erronés dans les commandes

**Symptômes :**

* Le POS affiche des articles différents de ceux commandés
* Les quantités sont incorrectes
* Modificateurs appliqués aux mauvais articles

**Solutions :**

1. **Codes PLU incorrects**
   * Un PLU erroné mappe au mauvais produit
   * Auditez les mappages PLU par rapport au POS

2. **PLU en double**
   * Le même PLU utilisé pour plusieurs produits
   * Assurez-vous que les PLU sont uniques

3. **Modifications récentes du menu**
   * Les produits peuvent avoir été remappés
   * Resynchronisez et vérifiez les mappages

## Problèmes de remises et fidélité

### Les remises ne s'appliquent pas

**Symptômes :**

* Les remises de fidélité n'apparaissent pas
* La tarification promotionnelle ne fonctionne pas
* Le solde client n'est pas reflété

**Solutions :**

1. **Vérifiez que la remise est active**
   * Vérifiez que la promotion est activée dans le POS
   * Confirmez que la plage de dates est actuelle
   * Vérifiez que les conditions sont remplies

2. **Qualification du client**
   * Vérifiez que le client est inscrit à la fidélité
   * Vérifiez que le client remplit les critères de la remise
   * Confirmez que les commandes en ligne sont éligibles

3. **Paramètres d'intégration**
   * Certaines remises nécessitent une activation explicite
   * Vérifiez les paramètres de synchronisation des remises

### Montants de remise incorrects

**Symptômes :**

* La remise s'applique mais le montant est incorrect
* Pourcentage mal calculé
* La remise apparaît deux fois

**Solutions :**

1. **Vérifiez les règles de remise**
   * Vérifiez la méthode de calcul de la remise
   * Vérifiez les règles de cumul

2. **Interaction avec la taxe**
   * Confirmez si la remise s'applique avant/après taxe
   * Vérifiez que les deux systèmes utilisent la même méthode

## Notifications par email pour les synchronisations échouées

storekit envoie automatiquement des notifications par email lorsque les commandes ou paiements échouent à se synchroniser avec votre POS, garantissant que vous ne manquiez jamais d'informations critiques.

### Notifications de commandes échouées

Lorsqu'une commande échoue à se synchroniser avec votre POS, vous recevrez un email qui inclut :

* **Détails de la commande** — Nom du client, ID de commande et mode de paiement
* **Raison de l'erreur** — Détails techniques spécifiques sur la raison de l'échec de synchronisation
* **Articles de la commande** — Un résumé de ce qui a été commandé (avec images lorsque disponibles)
* **Actions rapides** — Lien direct pour consulter la commande dans votre tableau de bord

<Info>
  Les emails de commandes échouées sont envoyés même si le client a déjà payé en ligne, garantissant que vous ne manquez jamais une commande nécessitant une attention manuelle.
</Info>

#### Que faire lorsque vous recevez un email de commande échouée

1. **Vérifiez la raison de l'erreur** — L'email inclut des détails spécifiques sur la raison de l'échec de synchronisation
2. **Consultez la commande dans le tableau de bord** — Cliquez sur le lien dans l'email pour voir tous les détails de la commande
3. **Corrigez la cause sous-jacente** — Par exemple, remettez le terminal POS ou l'iPad en marche, ou réactivez un modificateur requis manquant dans la commande
4. **Renvoyez vous-même la commande à votre POS** — Ouvrez la commande, cliquez sur **Plus d'actions**, puis **Renvoyer la commande au POS**. Le tableau de bord confirme avec **Nouvelle tentative d'injection POS mise en file d'attente** et la commande est renvoyée à votre POS
5. **Saisissez manuellement la commande** — Si la nouvelle tentative échoue toujours, saisissez la commande directement dans votre POS en solution de repli
6. **Contactez le support** — Si le problème persiste, notre équipe de support a déjà été notifiée et peut aider à le résoudre

<Note>
  **Renvoyer la commande au POS** n'apparaît que sur les commandes qui n'ont pas encore atteint le POS, dans les établissements avec une intégration POS connectée. Une fois que la commande a atteint le POS, l'action disparaît. Corrigez toujours la cause d'abord — un renvoi avant cela échouera pour la même raison.
</Note>

### Notifications d'échec de paiement d'addition

Lorsqu'un paiement Pay at Table réussit mais échoue à se synchroniser avec votre POS, vous recevrez une notification par email. C'est critique car le client a déjà payé, mais votre POS peut ne pas le refléter.

La notification inclut :

* **Détails de l'addition** — ID de l'addition et nom de l'établissement
* **Informations de paiement** — ID de paiement et détails de la transaction
* **Raison de l'erreur** — Détails techniques spécifiques sur la raison de l'échec de synchronisation
* **IDs de référence** — IDs d'addition storekit et POS pour la réconciliation
* **Actions rapides** — Lien direct pour consulter l'addition dans votre tableau de bord

<Warning>
  Les emails d'échec de paiement d'addition indiquent que le client a déjà payé avec succès. Vous devrez peut-être réconcilier manuellement ce paiement dans votre POS pour éviter les divergences.
</Warning>

#### Que faire lorsque vous recevez un email d'échec de paiement d'addition

1. **Vérifiez les détails de l'erreur** — L'email inclut des informations spécifiques sur la raison de l'échec de synchronisation
2. **Consultez l'addition dans le tableau de bord** — Cliquez sur le lien pour voir tous les détails du paiement
3. **Réconciliez manuellement dans le POS** — Marquez l'addition comme payée dans votre POS si nécessaire
4. **Contactez le support** — Notre équipe est notifiée automatiquement et peut aider avec les problèmes récurrents

### Vous assurer de recevoir les notifications

Assurez-vous que l'adresse email de votre établissement est correctement configurée :

1. Allez dans **Paramètres de la boutique** dans votre tableau de bord
2. Naviguez vers **Détails de la boutique**
3. Vérifiez que votre adresse email est correcte
4. Ajoutez plusieurs adresses email si nécessaire (la première adresse recevra les notifications)

## Obtenir de l'aide

Si vous avez essayé ces solutions et que vous rencontrez toujours des problèmes :

1. **Rassemblez les informations**
   * Notez les messages d'erreur spécifiques
   * Enregistrez les IDs de commande concernés
   * Prenez des captures d'écran si possible
   * Vérifiez les notifications par email de commandes échouées

2. **Vérifiez le statut du fournisseur POS**
   * Recherchez les problèmes à l'échelle du système
   * Contactez le support POS pour leur côté

3. **Contactez le support storekit**
   * Fournissez les IDs de commande et les détails d'erreur
   * Partagez les paramètres d'intégration (pas les identifiants)
   * Transférez toutes les notifications par email de commandes échouées

[Contactez le support](/docs/fr/getting-started/contact-support) pour toute assistance supplémentaire.


## Related topics

- [Dépannage des webhooks](/docs/fr/developers/webhooks/troubleshooting.md)
- [Centegra](/docs/fr/guides/integrations/pos/centegra.md)
- [PointOne](/docs/fr/guides/integrations/pos/pointone.md)
- [Statuts de commande](/docs/fr/guides/orders/order-statuses.md)
- [Affectation aux services](/docs/fr/guides/menu/course-assignments.md)