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

# Risolvi i problemi di connettività della stampante Star e di stampa degli ordini

> Diagnostica e risolvi i problemi comuni di stampa storekit con il troubleshooter interattivo. Riferimento ai codici di stato LED della stampante Star per i problemi di connettività.

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

## Strumento diagnostico

Rispondi ad alcune domande per diagnosticare il tuo problema:

<PrintingTroubleshooter />

***

## Indicatori LED

Le stampanti Star hanno indicatori LED che mostrano lo stato della stampante:

| LED         | Stato              | Significato                                      |
| ----------- | ------------------ | ------------------------------------------------ |
| **Power**   | Blu fisso          | La stampante è accesa e funzionante              |
| **Power**   | Spento             | Nessuna alimentazione - controlla le connessioni |
| **Network** | Verde fisso        | Connesso alla rete                               |
| **Network** | Verde lampeggiante | Sta tentando di connettersi alla rete            |
| **Network** | Spento             | Nessuna connessione di rete                      |
| **Error**   | Rosso fisso        | Il coperchio della stampante è aperto            |
| **Error**   | Rosso lampeggiante | Carta esaurita                                   |

<Note>
  Il LED Bluetooth non viene utilizzato con storekit - le stampanti si connettono solo tramite WiFi o ethernet.
</Note>

## Ciclo di alimentazione rapido

Se la tua stampante ha luci blu e verdi fisse ma non stampa, prova un ciclo di alimentazione:

1. Spegni la stampante
2. Scollega il cavo di alimentazione dalla presa
3. Aspetta 30 secondi
4. Ricollega e accendi

Se gli ordini in coda iniziano a stampare, la stampante è tornata online.

## Problemi di connessione

### Il LED Power è spento

* Controlla che il cavo di alimentazione sia collegato sia alla stampante che alla presa a muro
* Scollega e ricollega il cavo di alimentazione
* Prova una presa di corrente diversa
* Premi il pulsante di accensione - dovrebbe mostrare una luce blu fissa

### Il LED Network è spento o lampeggiante

1. Spegni la stampante
2. Controlla la connessione del cavo ethernet al tuo router (o l'intensità del segnale WiFi)
3. Scollega e ricollega il cavo di rete
4. Accendi la stampante
5. Se lampeggia ancora, controlla che la tua connessione internet funzioni

<Warning>
  Nessuna connessione di rete = nessun ordine stampato. Assicurati sempre che il tuo router sia online e che la stampante sia correttamente connessa.
</Warning>

### Router BT

BT (British Telecom) ha implementato una politica di rete che può bloccare la connessione tra i router BT e il servizio di stampa cloud storekit. Questo influisce su molti modelli BT Hub e BT Smart Hub.

**Sintomi:**

* La stampante è mostrata come **online** nella dashboard, ma gli ordini smettono di stampare in modo intermittente
* Il ciclo di alimentazione della stampante risolve temporaneamente il problema, ma si ripresenta — spesso entro poche ore
* Le stampe di test possono funzionare correttamente, poi gli ordini reali non riescono a stampare poco dopo

**Soluzioni alternative (in ordine di priorità):**

<Steps>
  <Step title="Opzione 1: Usa un router mobile separato (consigliato)">
    Collega la stampante a un **router mobile 5G** invece che al router BT. Questo bypassa completamente il filtraggio di rete di BT ed è la correzione più affidabile. Avrai bisogno di un router 5G e di una SIM con un piano dati — la stampante usa pochissimi dati, quindi un piccolo piano è sufficiente.
  </Step>

  <Step title="Opzione 2: Usa ethernet invece del WiFi">
    Collega la stampante al router BT tramite un **cavo ethernet** invece che via WiFi. Le connessioni cablate sono più stabili e meno colpite dalle funzionalità di gestione di rete di BT.
  </Step>

  <Step title="Opzione 3: Metti nella whitelist l'indirizzo MAC della stampante">
    Accedi alla pagina di amministrazione BT Hub (di solito su `192.168.1.254`) e metti nella whitelist l'indirizzo MAC della stampante. Questo impedisce al router di deprioritizzare o bloccare la connessione della stampante. Puoi trovare l'indirizzo MAC della stampante sulla stampa di stato della rete (tieni premuto il pulsante **FEED** durante l'accensione).
  </Step>
</Steps>

**Suggerimenti aggiuntivi per il router BT:**

* **Disabilita Smart Setup / Complete Wi-Fi** — questa funzione può interferire con le connessioni della stampante spostando automaticamente i dispositivi tra bande o access point. Disattivala nel pannello di amministrazione del tuo router BT sotto **Advanced Settings** → **Wireless**
* **Cicla l'alimentazione della stampante** (spegni, scollega per 30 secondi, ricollega) per ripristinare temporaneamente la stampa mentre applichi una delle correzioni sopra
* Se nessuna delle soluzioni sopra risolve il problema, considera di sostituire il router BT con un router non-BT per la rete a cui si connette la stampante

Per i passaggi generali di configurazione della stampante, consulta la [guida alla configurazione della stampante](/docs/it/guides/printing/printer-setup).

## Gli ordini non vengono stampati

### La stampante è online ma gli ordini non vengono stampati

* Se usi la **stampa automatica**, gli ordini vengono stampati solo dopo essere stati accettati
* Controlla che l'**impostazione del buffer** non stia ritardando i pre-ordini
* Verifica che la stampante sia assegnata alle categorie pertinenti (per lo split printing)
* Prova a inviare una stampa di prova dalla dashboard

### Alcuni articoli non vengono stampati

* Per lo split printing: controlla che la categoria sia assegnata a una stampante online
* Assicurati che la stampante abbia carta
* Effettua un ordine di prova per confermare l'instradamento

### Le note del cliente sono assenti dagli scontrini

L'ordine viene stampato, ma la nota del cliente (allergia, richiesta di preparazione, istruzioni di consegna) non è presente sullo scontrino della cucina o del bar:

1. Controlla che le note d'ordine siano attivate — vai a **Stores** → \[il tuo negozio] → **Settings** → **Operations** → **Order Notes** e impostale su **Optional** o **Mandatory**. **Hidden** rimuove completamente il campo delle note dal checkout.
2. Se usi il batching degli ordini, attiva **Include order notes** — sotto **Order batching** → **Merged ticket contents** nella stessa pagina. Quando il batching è attivo e questo interruttore è disattivato, le note vengono rimosse dallo scontrino unificato anche se continuano a essere mostrate sull'ordine nella dashboard. Consulta [Note del cliente sugli scontrini in batch](/docs/it/guides/orders/advanced/order-batching#customer-notes-on-batched-tickets).
3. Per Zonal (Aztec), imposta un **Order Note Product ID** — Zonal accetta le note solo come voce d'ordine, quindi senza di esso la nota non raggiunge mai il POS o i suoi scontrini. Consulta [Note d'ordine Zonal](/docs/it/guides/integrations/pos/zonal#order-notes).
4. Nota che l'interruttore **Print admin comments** nelle impostazioni della stampante controlla i commenti di amministrazione aggiunti nella dashboard, non le note d'ordine del cliente.

Una nota d'ordine generale non è legata a un articolo, quindi viene stampata su ogni scontrino di stazione generato per quell'ordine — una stampante che non riceve nessuno degli articoli dell'ordine non stampa alcuno scontrino.

### Stampa ritardata

Se gli ordini vengono stampati ma arrivano più tardi del previsto, segui questa checklist:

1. Controlla se il batching degli ordini è abilitato — vai a **Stores** → \[il tuo negozio] → **Settings** → **Operations** → **Order batching** e controlla il valore **Batch timeout** (1-5 minuti). Disattiva **Enable order batching** per inviare ogni ordine direttamente alla cucina. Consulta la [guida al batching degli ordini](/docs/it/guides/orders/advanced/order-batching) per ulteriori dettagli.
2. **Controlla il buffer dei pre-ordini** nelle impostazioni della tua stampante — un buffer diverso da zero ritarda la stampa per i pre-ordini.
3. **Controlla Auto Accept** — se disabilitato, gli ordini attendono l'accettazione manuale prima di essere stampati.
4. **Controlla il tuo provider internet** — connessioni lente o inaffidabili possono ritardare la consegna degli ordini alla stampante (consulta [Router BT](#bt-routers) sopra).

## Stampa intermittente (funziona a volte, poi si ferma)

Se la tua stampante funziona per un po' poi smette casualmente di stampare — e riprende dopo un ciclo di alimentazione — questo è solitamente un **problema di stabilità della rete**, non un problema hardware della stampante. Il tuo router potrebbe far cadere periodicamente la connessione della stampante.

### Diagnostica il problema

1. **Controlla il tempo di lease DHCP del tuo router** — tempi di lease brevi possono causare la perdita dell'indirizzo IP della stampante. Imposta il tempo di lease a **24 ore** o più nel pannello di amministrazione del tuo router
2. **Assegna un IP statico alla stampante** — questo impedisce al router di riassegnare l'indirizzo della stampante:
   * Trova l'indirizzo IP attuale della stampante sulla stampa di stato della rete (tieni premuto il pulsante **FEED** durante l'accensione)
   * Apri il pannello di amministrazione del tuo router e prenota quell'IP per l'indirizzo MAC della stampante
3. **Metti nella whitelist l'indirizzo MAC della stampante** nelle impostazioni del tuo router per impedire al router di deprioritizzarla o disconnetterla
4. **Controlla le interferenze WiFi** — sposta la stampante più vicino al router o passa a una connessione ethernet

<Tip>
  Usa l'app gratuita **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)) per verificare lo stato della connessione di rete della tua stampante e vedere il suo indirizzo IP attuale, l'intensità del segnale e il tipo di connessione.
</Tip>

<Note>
  Se stai usando un router BT, consulta la sezione [Router BT](#bt-routers) — BT ha una politica di rete che causa comunemente errori di stampa intermittenti.
</Note>

## Reti multiple / cambio router

Se la tua stampante funziona su un router ma smette di funzionare quando passi a un router o rete diversa, il problema è quasi sempre una **mancata corrispondenza della configurazione di rete** tra i due router. Anche se entrambe le reti hanno accesso a internet, differenze nel modo in cui gestiscono il traffico locale possono interrompere la comunicazione della stampante.

### Perché succede

| Causa                                               | Spiegazione                                                                                                                                                                                            |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Subnet diverse**                                  | Se la stampante è su `192.168.1.x` ma il tuo dispositivo è su `192.168.0.x`, non possono vedersi — anche se entrambi sono connessi allo stesso router fisico                                           |
| **AP isolation (client isolation)**                 | Molti router abilitano AP isolation per impostazione predefinita, che impedisce ai dispositivi sulla stessa rete WiFi di comunicare tra loro. Questo blocca la connessione tra dispositivo e stampante |
| **Regole firewall che bloccano le porte di stampa** | Alcuni router bloccano il traffico sulla porta **9100** (RAW printing) o sulla porta **515** (LPR/LPD) per impostazione predefinita, impedendo ai lavori di stampa di raggiungere la stampante         |

### Correzione passo-passo

<Steps>
  <Step title="Conferma che stampante e dispositivo siano sulla stessa subnet">
    Controlla l'indirizzo IP della stampante tenendo premuto il pulsante **FEED** durante l'accensione per stampare un foglio di stato della rete. Poi controlla l'indirizzo IP del tuo dispositivo nelle sue impostazioni WiFi/rete. Entrambi dovrebbero condividere gli stessi primi tre ottetti (es. entrambi su `192.168.1.x`). Se differiscono, connetti entrambi allo stesso router o VLAN.
  </Step>

  <Step title="Disabilita AP isolation / client isolation">
    Accedi al pannello di amministrazione del tuo router e cerca **AP Isolation**, **Client Isolation** o **Wireless Isolation** (di solito sotto **Wireless** → **Advanced Settings**). Disattivalo in modo che i dispositivi sulla stessa rete possano comunicare tra loro. Salva e riavvia il router.
  </Step>

  <Step title="Controlla che il firewall del router non stia bloccando la stampante">
    Nel pannello di amministrazione del tuo router, controlla le impostazioni firewall o di controllo accessi per eventuali regole che bloccano l'indirizzo IP della stampante o le porte **9100** e **515**. Aggiungi un'eccezione per l'IP della stampante se necessario. Alcuni router lo etichettano sotto **Port Filtering** o **Access Control**.
  </Step>

  <Step title="Assegna un IP statico alla stampante sulla nuova rete">
    Dopo aver cambiato router, la stampante potrebbe ricevere un nuovo indirizzo IP tramite DHCP. Prenota l'IP della stampante nelle impostazioni DHCP del nuovo router per impedire che cambi. Consulta [Stampa intermittente](#intermittent-printing-works-sometimes-then-stops) per i passaggi dettagliati.
  </Step>
</Steps>

### Stampanti cloud Star Micronics

Le stampanti cloud Star Micronics (utilizzate con il servizio di stampa cloud di storekit) richiedono una connessione internet in uscita per ricevere gli ordini — non si basano solo sulla stampa di rete locale. Quando ci si sposta su una nuova rete, la stampante deve essere in grado di raggiungere i server cloud di Star.

<Warning>
  Se il LED Network della stampante è verde fisso ma gli ordini non vengono stampati sulla nuova rete, il router potrebbe bloccare il traffico in uscita verso i server di Star.
</Warning>

Conferma che la stampante possa raggiungere **`*.starmicronics.com`** sulla **porta 443** (HTTPS) dalla nuova rete:

1. Controlla che il router non stia utilizzando un firewall in uscita restrittivo o un filtro dei contenuti che blocca i domini sconosciuti
2. Se il tuo router ha una modalità whitelist/allowlist, aggiungi `*.starmicronics.com` sulla porta 443
3. Assicurati che la risoluzione DNS funzioni — la stampante deve risolvere i nomi host di Star. Prova a usare un server DNS pubblico (es. `8.8.8.8`) nelle impostazioni WAN del router se il DNS predefinito è inaffidabile

<Tip>
  Usa l'app **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)) per verificare lo stato della connessione della stampante dopo averla spostata su una nuova rete. Se l'app può vedere la stampante ma gli ordini non fluiscono, il problema è probabilmente una regola firewall in uscita.
</Tip>

### Utenti di router BT

Se il nuovo router è un BT Hub o BT Smart Hub, potresti essere colpito anche dalla politica di rete di BT che blocca le connessioni di stampa cloud. Consulta la sezione [Router BT](#bt-routers) sopra per soluzioni specifiche tra cui l'uso di un router mobile separato, il passaggio a ethernet e la whitelist dell'indirizzo MAC della stampante.

## Problemi di split printing

### Gli articoli vengono stampati su tutte le stampanti

La categoria non è stata assegnata a stampanti specifiche. Vai a **Menu** → seleziona la categoria → scheda **Printing** e seleziona solo la/e stampante/i che desideri.

### Gli articoli vengono stampati sulla stampante sbagliata

* Rivedi le impostazioni Printing della categoria
* Deseleziona le stampanti che non vuoi che ricevano quella categoria

## Problemi di qualità di stampa

### Stampa sbiadita o chiara

* Controlla che la carta sia caricata correttamente (lato termico rivolto verso l'esterno)
* Pulisci la testina di stampa con alcol isopropilico
* Sostituisci il rotolo di carta se vecchio o conservato in condizioni umide

### Testo troppo piccolo

Prova l'impostazione dimensione testo **Large** nelle impostazioni della tua stampante.

## Reset di fabbrica

<Warning>
  Ripristina alle impostazioni di fabbrica solo come ultima risorsa. La stampante dovrà essere configurata da zero.
</Warning>

Se nient'altro funziona:

**Passaggio 1: Elimina la stampante da storekit**

1. Vai alla tua [dashboard storekit](https://dashboard.storekit.com)
2. Naviga su **Settings** → **Direct Printing**
3. Clicca sull'icona del cestino accanto alla stampante per eliminarla

**Passaggio 2: Ripristina la stampante**

1. Spegni la stampante
2. Inserisci una penna nel foro **RESET** sul retro della stampante
3. Mentre tieni premuto il pulsante RESET, premi e rilascia il pulsante **POWER**
4. Continua a tenere premuto RESET fino a quando il LED Network verde non lampeggia
5. Rilascia il pulsante RESET
6. Premi il pulsante **FEED** per selezionare l'interfaccia LAN
7. Tieni premuto FEED per confermare
8. La stampante viene ripristinata alle impostazioni di fabbrica

**Passaggio 3: Configura nuovamente**

[Configura di nuovo la stampante](/docs/it/guides/printing/printer-setup) dall'inizio.

## Notifiche email

storekit invia automaticamente notifiche email quando le tue stampanti vanno offline o tornano online, aiutandoti a rimanere informato sullo stato delle stampanti.

### Notifiche di stampante offline

Quando una stampante non riesce a inviare un check-in per 5 minuti, riceverai un'email che include:

* **Dettagli della stampante** - Nome della stampante, modello e indirizzo MAC
* **Timestamp offline** - Quando la stampante è andata offline
* **Azioni rapide** - Link diretto per visualizzare lo stato della stampante nella tua dashboard

### Notifiche di stampante online

Quando una stampante si riconnette dopo essere stata offline per almeno 5 minuti, riceverai un'email di conferma con:

* **Dettagli della stampante** - Nome della stampante e modello
* **Timestamp online** - Quando la stampante si è riconnessa
* **Conferma dello stato** - Verifica che la stampante sia pronta a ricevere ordini

### Assicurarsi di ricevere le notifiche

Assicurati che l'indirizzo email del tuo locale sia configurato correttamente:

1. Vai a **Store Settings** nella tua dashboard
2. Naviga su **Store Details**
3. Verifica che il tuo indirizzo email sia corretto
4. Aggiungi più indirizzi email se necessario (il primo indirizzo riceverà le notifiche)

<Tip>
  Le notifiche di stato della stampante ti aiutano a rilevare problemi di connettività prima che influiscano sull'evasione degli ordini. Se ricevi una notifica offline, controlla immediatamente l'alimentazione e la connessione di rete della tua stampante.
</Tip>

## Stampa dei pre-ordini

Gli scontrini dei pre-ordini differiscono dagli scontrini degli ordini in tempo reale — vengono stampati a un **orario programmato** basato sull'impostazione del tuo buffer, non immediatamente quando viene effettuato l'ordine. Ad esempio, un pre-ordine effettuato alle 10:00 per il ritiro alle 14:00 con un buffer di 30 minuti verrà stampato alle 13:30.

Consulta [Buffer per pre-ordini](/docs/it/guides/printing/printer-setup#pre-order-buffer) per come configurare questa tempistica.

### I pre-ordini non vengono stampati

<Steps>
  <Step title="Controlla l'impostazione del buffer">
    Vai a **Dashboard** → **Store Settings** → **Printers** → seleziona la tua stampante → controlla il valore **Buffer**. Un buffer diverso da zero ritarda la stampa fino a quando non si avvicina l'orario di evasione. Imposta a `0` se vuoi che i pre-ordini vengano stampati immediatamente.
  </Step>

  <Step title="Conferma che la stampante sia online all'orario di stampa programmato">
    I pre-ordini vengono stampati quando viene raggiunta la finestra del buffer — se la stampante è offline in quel momento, lo scontrino non verrà stampato. Controlla le tue [notifiche di stato della stampante](#email-notifications) per eventuali avvisi offline intorno all'orario di stampa previsto.
  </Step>
</Steps>

### Lo scontrino del pre-ordine mostra data/ora errate

* **Controlla le impostazioni del fuso orario** — vai a **Dashboard** → **Store Settings** → **Store Details** e verifica che il fuso orario corrisponda alla posizione fisica del tuo locale. Un fuso orario errato sfaserà tutti gli orari stampati.

## Problemi con la stampa di prova

### La stampa di prova funziona ma gli ordini reali non vengono stampati

<Steps>
  <Step title="Controlla l'assegnazione della categoria">
    Per lo split printing, vai a **Menu** → seleziona la categoria → scheda **Printing** e verifica che la categoria sia assegnata alla stampante corretta. Una stampa di prova bypassa l'assegnazione delle categorie, quindi può avere successo anche quando le categorie non sono collegate alla stampante.
  </Step>

  <Step title="Controlla stampa automatica vs manuale">
    Se la stampante è impostata su **Manual**, gli ordini non verranno stampati fino a quando non clicchi il pulsante di stampa nella dashboard. Passa a **Auto** se vuoi che gli ordini vengano stampati automaticamente all'accettazione.
  </Step>
</Steps>

### La stampa di prova fallisce

<Steps>
  <Step title="Cicla l'alimentazione della stampante">
    Spegni la stampante, scollega il cavo di alimentazione, aspetta 30 secondi, poi ricollega e accendi. Consulta [Ciclo di alimentazione rapido](#quick-power-cycle).
  </Step>

  <Step title="Controlla la connessione">
    Verifica che il cavo USB o ethernet sia saldamente collegato. Per le stampanti di rete, conferma che il LED Network mostri una luce verde fissa. Consulta [Problemi di connessione](#connection-issues).
  </Step>

  <Step title="Verifica che la stampante sia assegnata nella dashboard">
    Vai a **Dashboard** → **Store Settings** → **Printers** e conferma che la stampante appaia e sia mostrata come **Online**. Se manca, [aggiungila di nuovo](/docs/it/guides/printing/printer-setup#step-3-add-printer-in-storekit).
  </Step>
</Steps>

## Continui ad avere problemi?

1. Invia una stampa di prova dalla dashboard per confermare la connettività
2. Nota eventuali luci o messaggi di errore
3. Controlla le notifiche email dello stato della stampante
4. [Contatta il supporto storekit](/docs/it/getting-started/contact-support) con il nome del tuo negozio e la descrizione del problema


## Related topics

- [Configura una stampante cloud Star Micronics](/docs/it/guides/printing/printer-setup.md)
- [6. Collegare una stampante di ricevute cloud](/docs/it/getting-started/launch/connect-printing.md)
- [Stati degli ordini](/docs/it/guides/orders/order-statuses.md)
- [Stampa di fallback](/docs/it/guides/printing/fallback-printing.md)
- [Iniezione degli ordini](/docs/it/guides/integrations/pos/order-injection.md)
