> ## 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épanner la connectivité de l'imprimante Star et l'impression des commandes

> Diagnostiquez et corrigez les problèmes d'impression storekit courants avec le diagnostic interactif. Référez-vous aux codes LED des imprimantes Star pour les problèmes de connectivité.

export const PrintingTroubleshooter = () => {
  const [step, setStep] = useState(0);
  const [answers, setAnswers] = useState({});
  const flow = [{
    question: "What's the printer's Power LED showing?",
    options: [{
      label: 'Steady blue (on)',
      value: 'power_on',
      next: 1
    }, {
      label: 'Off',
      value: 'power_off',
      solution: 'power_off'
    }]
  }, {
    question: "What's the Network LED showing?",
    options: [{
      label: 'Steady green (connected)',
      value: 'network_on',
      next: 2
    }, {
      label: 'Flashing green',
      value: 'network_flashing',
      solution: 'network_flashing'
    }, {
      label: 'Off',
      value: 'network_off',
      solution: 'network_off'
    }]
  }, {
    question: "What's the Error LED showing?",
    options: [{
      label: 'Off (no error)',
      value: 'no_error',
      next: 3
    }, {
      label: 'Steady red',
      value: 'error_steady',
      solution: 'cover_open'
    }, {
      label: 'Flashing red',
      value: 'error_flashing',
      solution: 'out_of_paper'
    }]
  }, {
    question: "What's happening with your orders?",
    options: [{
      label: "Orders aren't printing at all",
      value: 'not_printing',
      next: 4
    }, {
      label: 'Some items are missing from prints',
      value: 'missing_items',
      solution: 'split_printing'
    }, {
      label: 'Print quality is poor (faded/light)',
      value: 'quality',
      solution: 'print_quality'
    }, {
      label: 'Orders are printing late/delayed',
      value: 'delayed',
      solution: 'buffer_setting'
    }]
  }, {
    question: 'Are you using auto-print?',
    options: [{
      label: 'Yes, auto-print is enabled',
      value: 'auto_print',
      next: 5
    }, {
      label: 'No, I manually print orders',
      value: 'manual',
      solution: 'power_cycle'
    }]
  }, {
    question: 'Have you accepted the orders in your dashboard?',
    options: [{
      label: 'Yes, orders are accepted',
      value: 'accepted',
      solution: 'power_cycle'
    }, {
      label: 'No / Not sure',
      value: 'not_accepted',
      solution: 'accept_orders'
    }]
  }];
  const solutions = {
    power_off: {
      title: 'Printer Has No Power',
      icon: '🔌',
      steps: ['Check the power cable is connected to both the printer and wall outlet', 'Disconnect and reconnect the power cable firmly', 'Try a different power outlet', 'Press the power button - wait for steady blue light'],
      severity: 'error'
    },
    network_flashing: {
      title: 'Printer Trying to Connect',
      icon: '📶',
      steps: ['Power off the printer', 'Check ethernet cable is firmly connected to router', 'Verify your internet connection is working', 'Power on printer and wait 60 seconds', 'If still flashing, try moving printer closer to router (WiFi) or use ethernet cable'],
      severity: 'warning'
    },
    network_off: {
      title: 'No Network Connection',
      icon: '❌',
      steps: ['Power off the printer', 'Check ethernet cable at both ends (printer and router)', 'Try a different ethernet port on your router', 'Verify your router is online and working', 'Power on printer and wait 60 seconds'],
      note: 'No network = no orders will print. This is critical to fix.',
      severity: 'error'
    },
    cover_open: {
      title: 'Printer Cover Open',
      icon: '📂',
      steps: ['Check the paper cover is fully closed', 'Open and close the cover firmly until it clicks', 'If error persists, check paper is loaded correctly'],
      severity: 'warning'
    },
    out_of_paper: {
      title: 'Out of Paper',
      icon: '📜',
      steps: ['Open the printer cover', 'Insert a new paper roll with thermal side facing out', 'Close the cover until it clicks', 'The error should clear automatically'],
      severity: 'warning'
    },
    split_printing: {
      title: 'Check Split Printing Settings',
      icon: '⚙️',
      steps: ['Go to Menu in your dashboard', 'Select the category with missing items', 'Click the Printing tab', 'Ensure the correct printer is ticked for this category', 'Repeat for any other categories not printing', 'Save changes'],
      note: 'Each category can be assigned to specific printers. Unassigned categories won\'t print to that printer.',
      severity: 'info'
    },
    print_quality: {
      title: 'Improve Print Quality',
      icon: '✨',
      steps: ['Check paper is loaded correctly (thermal side facing out - test by scratching with fingernail)', 'Clean the print head with isopropyl alcohol and a lint-free cloth', 'Replace paper roll if old or stored in humid conditions', 'Try the "Large" text size setting in Settings > Direct Printing'],
      severity: 'info'
    },
    buffer_setting: {
      title: 'Check Print Timing Settings',
      icon: '⏱️',
      steps: ['Go to Settings > Direct Printing', 'Check the buffer/delay setting for pre-orders', 'For ASAP orders, ensure "Print immediately" is enabled', 'Review your pre-order lead time settings', 'If using auto-print, orders only print after acceptance'],
      severity: 'info'
    },
    accept_orders: {
      title: 'Accept Orders First',
      icon: '✅',
      steps: ['With auto-print enabled, orders only print after being accepted', 'Go to your Orders page in the dashboard', 'Look for pending orders waiting to be accepted', 'Accept the order - it should print automatically', 'If it still doesn\'t print, try a power cycle'],
      note: 'Auto-print waits for you to accept orders before printing. This prevents printing orders you might reject.',
      severity: 'info'
    },
    power_cycle: {
      title: 'Power Cycle the Printer',
      icon: '🔄',
      steps: ['Turn the printer off using the power button', 'Unplug the power cord from the wall outlet', 'Wait 30 seconds', 'Plug the power cord back in', 'Turn the printer on', 'Wait for steady blue (power) and green (network) lights', 'Try printing a test order from Settings > Direct Printing'],
      note: 'This resolves most "everything looks fine but won\'t print" issues.',
      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 not working?</h4>
            <p className="text-sm text-zinc-600 dark:text-zinc-400">
              If these steps didn't help, contact support with your store name, printer model, and a photo of the LED lights.
            </p>
          </div>
        </div>}
    </div>;
};

## Outil de diagnostic

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

<PrintingTroubleshooter />

***

## Indicateurs LED

Les imprimantes Star possèdent des LED indiquant l'état de l'imprimante :

| LED         | État             | Signification                                |
| ----------- | ---------------- | -------------------------------------------- |
| **Power**   | Bleu fixe        | L'imprimante est allumée et fonctionne       |
| **Power**   | Éteint           | Pas d'alimentation - vérifiez les connexions |
| **Network** | Vert fixe        | Connectée au réseau                          |
| **Network** | Vert clignotant  | Tentative de connexion au réseau             |
| **Network** | Éteint           | Aucune connexion réseau                      |
| **Error**   | Rouge fixe       | Capot de l'imprimante ouvert                 |
| **Error**   | Rouge clignotant | Plus de papier                               |

<Note>
  La LED Bluetooth n'est pas utilisée avec storekit - les imprimantes se connectent uniquement via WiFi ou Ethernet.
</Note>

## Redémarrage rapide

Si votre imprimante affiche des voyants bleu et vert fixes mais n'imprime pas, essayez un redémarrage :

1. Éteignez l'imprimante
2. Débranchez le cordon d'alimentation de la prise
3. Attendez 30 secondes
4. Rebranchez et allumez

Si les commandes en file d'attente commencent à s'imprimer, l'imprimante est de nouveau en ligne.

## Problèmes de connexion

### La LED Power est éteinte

* Vérifiez que le câble d'alimentation est branché à la fois à l'imprimante et à la prise murale
* Débranchez et rebranchez le câble d'alimentation
* Essayez une autre prise électrique
* Appuyez sur le bouton d'alimentation - il doit afficher un voyant bleu fixe

### La LED Network est éteinte ou clignote

1. Éteignez l'imprimante
2. Vérifiez la connexion du câble Ethernet à votre routeur (ou la force du signal WiFi)
3. Débranchez et rebranchez le câble réseau
4. Allumez l'imprimante
5. Si elle clignote toujours, vérifiez que votre connexion Internet fonctionne

<Warning>
  Pas de connexion réseau = aucune commande imprimée. Assurez-vous toujours que votre routeur est en ligne et que l'imprimante est correctement connectée.
</Warning>

### Routeurs BT

BT (British Telecom) a déployé une politique réseau qui peut bloquer la connexion entre les routeurs BT et le service d'impression cloud de storekit. Cela affecte de nombreux modèles BT Hub et BT Smart Hub.

**Symptômes :**

* L'imprimante s'affiche **online** dans le tableau de bord mais les commandes cessent de s'imprimer par intermittence
* Le redémarrage de l'imprimante résout temporairement le problème, mais celui-ci se reproduit — souvent en quelques heures
* Les impressions de test peuvent fonctionner correctement, puis les commandes réelles échouent à s'imprimer peu après

**Solutions de contournement (par ordre de priorité) :**

<Steps>
  <Step title="Option 1 : Utiliser un routeur mobile séparé (recommandé)">
    Connectez l'imprimante à un **routeur mobile 5G** plutôt qu'au routeur BT. Cela contourne entièrement le filtrage réseau de BT et constitue la solution la plus fiable. Vous aurez besoin d'un routeur 5G et d'une carte SIM avec un forfait de données — l'imprimante consomme très peu de données, un petit forfait suffit.
  </Step>

  <Step title="Option 2 : Utiliser Ethernet plutôt que WiFi">
    Connectez l'imprimante au routeur BT via un **câble Ethernet** plutôt qu'en WiFi. Les connexions filaires sont plus stables et moins affectées par les fonctionnalités de gestion réseau de BT.
  </Step>

  <Step title="Option 3 : Whitelister l'adresse MAC de l'imprimante">
    Connectez-vous à la page d'administration du BT Hub (généralement sur `192.168.1.254`) et ajoutez l'adresse MAC de l'imprimante à la liste blanche. Cela empêche le routeur de déprioriser ou de bloquer la connexion de l'imprimante. Vous pouvez trouver l'adresse MAC de l'imprimante sur l'impression de statut réseau (maintenez le bouton **FEED** lors de la mise sous tension).
  </Step>
</Steps>

**Astuces supplémentaires pour les routeurs BT :**

* **Désactivez Smart Setup / Complete Wi-Fi** — cette fonctionnalité peut interférer avec les connexions d'imprimante en déplaçant automatiquement les appareils entre les bandes ou points d'accès. Désactivez-la dans le panneau d'administration de votre routeur BT sous **Advanced Settings** → **Wireless**
* **Redémarrez l'imprimante** (éteindre, débrancher 30 secondes, rebrancher) pour restaurer temporairement l'impression pendant que vous appliquez l'un des correctifs ci-dessus
* Si aucune des solutions ci-dessus ne résout le problème, envisagez de remplacer le routeur BT par un routeur non-BT pour le réseau auquel l'imprimante se connecte

Pour les étapes générales de configuration de l'imprimante, consultez le [guide de configuration de l'imprimante](/docs/fr/guides/printing/printer-setup).

## Les commandes ne s'impriment pas

### L'imprimante est en ligne mais les commandes ne s'impriment pas

* Si vous utilisez l'**impression automatique**, les commandes ne s'impriment qu'après acceptation
* Vérifiez que le paramètre **buffer** ne diffère pas les précommandes
* Vérifiez que l'imprimante est attribuée aux catégories concernées (pour l'impression séparée)
* Essayez d'envoyer une impression de test depuis le tableau de bord

### Certains articles ne s'impriment pas

* Pour l'impression séparée : vérifiez que la catégorie est attribuée à une imprimante en ligne
* Assurez-vous que l'imprimante a du papier
* Passez une commande de test pour confirmer le routage

### Les notes de commande du client manquent sur les tickets

La commande s'imprime, mais la note du client (allergie, demande de préparation, instruction de livraison) n'apparaît pas sur le ticket cuisine ou bar :

1. Vérifiez que les notes de commande sont activées — allez dans **Stores** → \[votre magasin] → **Settings** → **Operations** → **Order Notes** et réglez sur **Optional** ou **Mandatory**. **Hidden** supprime entièrement le champ de note au moment du paiement.
2. Si vous utilisez le regroupement de commandes, activez **Include order notes** — sous **Order batching** → **Merged ticket contents** sur la même page. Lorsque le regroupement est activé et que cette bascule est désactivée, les notes sont supprimées du ticket regroupé même si elles restent visibles sur la commande dans le tableau de bord. Consultez [Notes client sur les tickets regroupés](/docs/fr/guides/orders/advanced/order-batching#customer-notes-on-batched-tickets).
3. Pour Zonal (Aztec), définissez un **Order Note Product ID** — Zonal n'accepte les notes que sous forme de ligne d'article, donc sans cela la note n'atteint jamais le POS ni ses tickets. Consultez [Notes de commande Zonal](/docs/fr/guides/integrations/pos/zonal#order-notes).
4. Notez que la bascule **Print admin comments** dans les paramètres de l'imprimante contrôle les commentaires administrateurs ajoutés dans le tableau de bord, pas les notes de commande client.

Une note de commande générale n'est pas liée à un article, elle s'imprime donc sur chaque ticket de poste généré pour cette commande — une imprimante qui ne reçoit aucun des articles de la commande n'imprime aucun ticket.

### Impression retardée

Si les commandes s'impriment mais arrivent plus tard que prévu, parcourez cette liste :

1. Vérifiez si le regroupement de commandes est activé — allez dans **Stores** → \[votre magasin] → **Settings** → **Operations** → **Order batching** et vérifiez la valeur **Batch timeout** (1–5 minutes). Désactivez **Enable order batching** pour envoyer chaque commande directement à la cuisine. Consultez le [guide Order Batching](/docs/fr/guides/orders/advanced/order-batching) pour plus de détails.
2. **Vérifiez le buffer précommande** dans les paramètres de votre imprimante — un buffer différent de zéro retarde l'impression pour les précommandes.
3. **Vérifiez Auto Accept** — si désactivé, les commandes attendent une acceptation manuelle avant l'impression.
4. **Vérifiez votre fournisseur d'accès Internet** — des connexions lentes ou peu fiables peuvent retarder la livraison des commandes à l'imprimante (voir [Routeurs BT](#bt-routers) ci-dessus).

## Impression intermittente (fonctionne parfois, puis s'arrête)

Si votre imprimante fonctionne pendant un certain temps puis cesse soudainement d'imprimer — et reprend après un redémarrage — il s'agit généralement d'un **problème de stabilité réseau**, pas d'un problème matériel d'imprimante. Votre routeur peut perdre la connexion de l'imprimante périodiquement.

### Diagnostiquer le problème

1. **Vérifiez la durée du bail DHCP de votre routeur** — des durées courtes peuvent faire perdre à l'imprimante son adresse IP. Réglez la durée du bail sur **24 heures** ou plus dans le panneau d'administration de votre routeur
2. **Attribuez une IP statique à l'imprimante** — cela empêche le routeur de réattribuer l'adresse de l'imprimante :
   * Trouvez l'adresse IP actuelle de l'imprimante sur l'impression de statut réseau (maintenez le bouton **FEED** lors de la mise sous tension)
   * Ouvrez le panneau d'administration de votre routeur et réservez cette IP pour l'adresse MAC de l'imprimante
3. **Ajoutez l'adresse MAC de l'imprimante à la liste blanche** dans les paramètres de votre routeur pour éviter qu'il ne la dépriorise ou ne la déconnecte
4. **Vérifiez les interférences WiFi** — rapprochez l'imprimante du routeur ou passez à une connexion Ethernet

<Tip>
  Utilisez l'application gratuite **Star Quick Setup Utility** ([iOS](https://apps.apple.com/app/star-quick-setup-utility/id1549088652) / [Android](https://play.google.com/store/apps/details?id=com.starmicronics.starquicksetup)) pour vérifier l'état de la connexion réseau de votre imprimante et consulter son adresse IP actuelle, la force du signal et le type de connexion.
</Tip>

<Note>
  Si vous utilisez un routeur BT, consultez la section [Routeurs BT](#bt-routers) — BT applique une politique réseau qui provoque fréquemment des échecs d'impression intermittents.
</Note>

## Plusieurs réseaux / changement de routeur

Si votre imprimante fonctionne sur un routeur mais cesse de fonctionner lorsque vous passez à un autre routeur ou réseau, le problème provient presque toujours d'une **incompatibilité de configuration réseau** entre les deux routeurs. Même si les deux réseaux ont accès à Internet, des différences dans la gestion du trafic local peuvent rompre la communication avec l'imprimante.

### Pourquoi cela se produit

| Cause                                                  | Explication                                                                                                                                                                      |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sous-réseaux différents**                            | Si l'imprimante est sur `192.168.1.x` mais que votre appareil est sur `192.168.0.x`, ils ne peuvent pas se voir — même s'ils sont connectés au même routeur physique             |
| **AP isolation (isolation client)**                    | De nombreux routeurs activent l'isolation AP par défaut, ce qui empêche les appareils du même réseau WiFi de communiquer entre eux. Cela bloque la connexion appareil-imprimante |
| **Règles de pare-feu bloquant les ports d'impression** | Certains routeurs bloquent par défaut le trafic sur le port **9100** (impression RAW) ou le port **515** (LPR/LPD), empêchant les tâches d'impression d'atteindre l'imprimante   |

### Correctif étape par étape

<Steps>
  <Step title="Confirmez que l'imprimante et l'appareil sont sur le même sous-réseau">
    Vérifiez l'adresse IP de l'imprimante en maintenant le bouton **FEED** lors de la mise sous tension pour imprimer une feuille de statut réseau. Vérifiez ensuite l'adresse IP de votre appareil dans ses paramètres WiFi/réseau. Les deux doivent partager les trois premiers octets (par exemple, tous deux sur `192.168.1.x`). S'ils diffèrent, connectez les deux au même routeur ou VLAN.
  </Step>

  <Step title="Désactivez l'isolation AP / isolation client">
    Connectez-vous au panneau d'administration de votre routeur et cherchez **AP Isolation**, **Client Isolation** ou **Wireless Isolation** (généralement sous **Wireless** → **Advanced Settings**). Désactivez-la afin que les appareils du même réseau puissent communiquer entre eux. Enregistrez et redémarrez le routeur.
  </Step>

  <Step title="Vérifiez que le pare-feu du routeur ne bloque pas l'imprimante">
    Dans le panneau d'administration de votre routeur, vérifiez les paramètres de pare-feu ou de contrôle d'accès à la recherche de règles bloquant l'adresse IP de l'imprimante ou les ports **9100** et **515**. Ajoutez une exception pour l'IP de l'imprimante si nécessaire. Certains routeurs appellent cela **Port Filtering** ou **Access Control**.
  </Step>

  <Step title="Attribuez une IP statique à l'imprimante sur le nouveau réseau">
    Après avoir changé de routeur, l'imprimante peut recevoir une nouvelle adresse IP via DHCP. Réservez l'IP de l'imprimante dans les paramètres DHCP du nouveau routeur pour éviter qu'elle ne change. Consultez [Impression intermittente](#intermittent-printing-works-sometimes-then-stops) pour les étapes détaillées.
  </Step>
</Steps>

### Imprimantes cloud Star Micronics

Les imprimantes cloud Star Micronics (utilisées avec le service d'impression cloud de storekit) nécessitent une connexion Internet sortante pour recevoir les commandes — elles ne dépendent pas uniquement de l'impression réseau locale. Lors d'un changement de réseau, l'imprimante doit pouvoir atteindre les serveurs cloud de Star.

<Warning>
  Si la LED Network de l'imprimante affiche un vert fixe mais que les commandes ne s'impriment pas sur le nouveau réseau, le routeur peut bloquer le trafic sortant vers les serveurs de Star.
</Warning>

Confirmez que l'imprimante peut atteindre **`*.starmicronics.com`** sur le **port 443** (HTTPS) depuis le nouveau réseau :

1. Vérifiez que le routeur n'utilise pas un pare-feu sortant restrictif ou un filtre de contenu qui bloque les domaines inconnus
2. Si votre routeur dispose d'un mode liste blanche/allowlist, ajoutez `*.starmicronics.com` sur le port 443
3. Assurez-vous que la résolution DNS fonctionne — l'imprimante doit résoudre les noms d'hôtes de Star. Essayez d'utiliser un serveur DNS public (par exemple `8.8.8.8`) dans les paramètres WAN du routeur si le DNS par défaut n'est pas fiable

<Tip>
  Utilisez l'application **Star Quick Setup Utility** ([iOS](https://apps.apple.com/app/star-quick-setup-utility/id1549088652) / [Android](https://play.google.com/store/apps/details?id=com.starmicronics.starquicksetup)) pour vérifier l'état de la connexion de l'imprimante après l'avoir déplacée vers un nouveau réseau. Si l'application voit l'imprimante mais que les commandes ne circulent pas, le problème est probablement une règle de pare-feu sortant.
</Tip>

### Utilisateurs de routeurs BT

Si le nouveau routeur est un BT Hub ou BT Smart Hub, vous pouvez également être affecté par la politique réseau de BT qui bloque les connexions d'impression cloud. Consultez la section [Routeurs BT](#bt-routers) ci-dessus pour des solutions spécifiques, notamment l'utilisation d'un routeur mobile séparé, le passage à l'Ethernet et l'ajout de l'adresse MAC de l'imprimante à la liste blanche.

## Problèmes d'impression séparée

### Les articles s'impriment sur toutes les imprimantes

La catégorie n'a pas été attribuée à des imprimantes spécifiques. Allez dans **Menu** → sélectionnez la catégorie → onglet **Printing** et cochez uniquement la ou les imprimantes souhaitées.

### Les articles s'impriment sur la mauvaise imprimante

* Passez en revue les paramètres Printing de la catégorie
* Décochez les imprimantes qui ne doivent pas recevoir cette catégorie

## Problèmes de qualité d'impression

### Impression pâle ou claire

* Vérifiez que le papier est correctement chargé (face thermique vers l'extérieur)
* Nettoyez la tête d'impression avec de l'alcool isopropylique
* Remplacez le rouleau de papier s'il est vieux ou stocké dans un environnement humide

### Texte trop petit

Essayez le paramètre de taille de texte **Large** dans les paramètres de votre imprimante.

## Réinitialisation d'usine

<Warning>
  N'effectuez une réinitialisation d'usine qu'en dernier recours. L'imprimante devra être configurée depuis le début.
</Warning>

Si rien d'autre ne fonctionne :

**Étape 1 : Supprimer l'imprimante de storekit**

1. Allez sur votre [tableau de bord storekit](https://dashboard.storekit.com)
2. Accédez à **Settings** → **Direct Printing**
3. Cliquez sur l'icône de la corbeille à côté de l'imprimante pour la supprimer

**Étape 2 : Réinitialiser l'imprimante**

1. Éteignez l'imprimante
2. Insérez un stylo dans le trou **RESET** à l'arrière de l'imprimante
3. Tout en maintenant le bouton RESET, appuyez et relâchez le bouton **POWER**
4. Continuez à maintenir RESET jusqu'à ce que la LED Network verte clignote
5. Relâchez le bouton RESET
6. Appuyez sur le bouton **FEED** pour sélectionner l'interface LAN
7. Maintenez FEED enfoncé pour confirmer
8. L'imprimante est réinitialisée aux paramètres d'usine

**Étape 3 : Configurer à nouveau**

[Configurez à nouveau l'imprimante](/docs/fr/guides/printing/printer-setup) depuis le début.

## Notifications par e-mail

storekit envoie automatiquement des notifications par e-mail lorsque vos imprimantes passent hors ligne ou reviennent en ligne, ce qui vous aide à rester informé de l'état des imprimantes.

### Notifications d'imprimante hors ligne

Lorsqu'une imprimante ne parvient pas à se signaler pendant 5 minutes, vous recevrez un e-mail qui inclut :

* **Détails de l'imprimante** - Nom, modèle et adresse MAC de l'imprimante
* **Horodatage hors ligne** - Quand l'imprimante est passée hors ligne
* **Actions rapides** - Lien direct pour consulter l'état de l'imprimante dans votre tableau de bord

### Notifications d'imprimante en ligne

Lorsqu'une imprimante se reconnecte après être restée hors ligne pendant au moins 5 minutes, vous recevrez un e-mail de confirmation avec :

* **Détails de l'imprimante** - Nom et modèle de l'imprimante
* **Horodatage en ligne** - Quand l'imprimante s'est reconnectée
* **Confirmation de statut** - Vérification que l'imprimante est prête à recevoir des commandes

### Vous assurer que vous recevez les notifications

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

1. Allez dans **Store Settings** dans votre tableau de bord
2. Accédez à **Store Details**
3. Vérifiez que votre adresse e-mail est correcte
4. Ajoutez plusieurs adresses e-mail si nécessaire (la première adresse recevra les notifications)

<Tip>
  Les notifications de statut d'imprimante vous aident à détecter les problèmes de connectivité avant qu'ils n'affectent l'exécution des commandes. Si vous recevez une notification hors ligne, vérifiez immédiatement l'alimentation et la connexion réseau de votre imprimante.
</Tip>

## Impression des précommandes

Les tickets de précommande diffèrent des tickets de commande en direct — ils s'impriment à un **horaire planifié** en fonction de votre paramètre de buffer, et non immédiatement lors de la commande. Par exemple, une précommande passée à 10 h pour une collecte à 14 h avec un buffer de 30 minutes s'imprimera à 13 h 30.

Consultez [Buffer précommande](/docs/fr/guides/printing/printer-setup#pre-order-buffer) pour savoir comment configurer ce délai.

### Les précommandes ne s'impriment pas

<Steps>
  <Step title="Vérifiez le paramètre buffer">
    Allez dans **Dashboard** → **Store Settings** → **Printers** → sélectionnez votre imprimante → vérifiez la valeur **Buffer**. Un buffer différent de zéro diffère l'impression jusqu'à un moment proche de l'heure de fulfillment. Réglez sur `0` si vous voulez que les précommandes s'impriment immédiatement.
  </Step>

  <Step title="Confirmez que l'imprimante est en ligne à l'heure d'impression prévue">
    Les précommandes s'impriment lorsque la fenêtre de buffer est atteinte — si l'imprimante est hors ligne à ce moment, le ticket ne s'imprimera pas. Consultez vos [notifications de statut d'imprimante](#email-notifications) pour toute alerte hors ligne autour de l'heure d'impression prévue.
  </Step>
</Steps>

### Le ticket de précommande affiche une mauvaise date/heure

* **Vérifiez les paramètres de fuseau horaire** — allez dans **Dashboard** → **Store Settings** → **Store Details** et vérifiez que le fuseau horaire correspond à l'emplacement physique de votre établissement. Un fuseau horaire incorrect décalera toutes les heures imprimées.

## Problèmes d'impression de test

### L'impression de test fonctionne mais les vraies commandes ne s'impriment pas

<Steps>
  <Step title="Vérifiez l'attribution des catégories">
    Pour l'impression séparée, allez dans **Menu** → sélectionnez la catégorie → onglet **Printing** et vérifiez que la catégorie est attribuée à la bonne imprimante. Une impression de test contourne l'attribution des catégories, elle peut donc réussir même si les catégories ne sont pas liées à l'imprimante.
  </Step>

  <Step title="Vérifiez impression automatique vs manuelle">
    Si l'imprimante est réglée sur **Manual**, les commandes ne s'imprimeront pas tant que vous n'aurez pas cliqué sur le bouton d'impression dans le tableau de bord. Passez à **Auto** si vous voulez que les commandes s'impriment automatiquement à l'acceptation.
  </Step>
</Steps>

### L'impression de test échoue

<Steps>
  <Step title="Redémarrez l'imprimante">
    Éteignez l'imprimante, débranchez le cordon d'alimentation, attendez 30 secondes, puis rebranchez et allumez. Consultez [Redémarrage rapide](#quick-power-cycle).
  </Step>

  <Step title="Vérifiez la connexion">
    Vérifiez que le câble USB ou Ethernet est fermement connecté. Pour les imprimantes réseau, confirmez que la LED Network affiche un vert fixe. Consultez [Problèmes de connexion](#connection-issues).
  </Step>

  <Step title="Vérifiez que l'imprimante est attribuée dans le tableau de bord">
    Allez dans **Dashboard** → **Store Settings** → **Printers** et confirmez que l'imprimante apparaît et est affichée comme **Online**. Si elle est absente, [ajoutez-la à nouveau](/docs/fr/guides/printing/printer-setup#step-3-add-printer-in-storekit).
  </Step>
</Steps>

## Toujours des problèmes ?

1. Envoyez une impression de test depuis le tableau de bord pour confirmer la connectivité
2. Notez tout voyant ou message d'erreur
3. Vérifiez les notifications par e-mail de statut d'imprimante
4. [Contactez le support storekit](/docs/fr/getting-started/contact-support) avec le nom de votre magasin et une description du problème


## Related topics

- [Impression séparée](/docs/fr/guides/printing/split-printing.md)
- [6. Connecter une imprimante à tickets cloud](/docs/fr/getting-started/launch/connect-printing.md)
- [Configurer une imprimante cloud Star Micronics](/docs/fr/guides/printing/printer-setup.md)
- [Impression de secours](/docs/fr/guides/printing/fallback-printing.md)
- [Créer et planifier les catégories de menu](/docs/fr/guides/menu/categories.md)