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

# Configura una stampante cloud Star Micronics

> Configura le stampanti per ricevute Star Micronics CloudPRNT con storekit tramite WiFi o ethernet per stampare automaticamente gli scontrini di cucina e degli ordini.

storekit si integra con le stampanti cloud Star Micronics per stampare automaticamente o su richiesta gli scontrini degli ordini. Le stampanti si connettono alla tua rete tramite WiFi o ethernet (il cavo è consigliato per l'affidabilità) e ricevono i lavori dal cloud - nessun cavo verso il tuo computer richiesto.

## Quando usare la Direct Printing

Collega una stampante se:

* **Non sei integrato con il POS** - Gli ordini devono raggiungere in qualche modo la tua cucina
* **Vuoi affidabilità di fallback** - Stampa automaticamente gli ordini quando l'integrazione POS fallisce (vedi [Stampa di fallback](/docs/it/guides/printing/fallback-printing))

<Note>
  Se sei integrato con il POS, il tuo POS gestisce solitamente la stampa. Ma collegare una stampante storekit come fallback garantisce di non perdere mai un ordine se la connessione POS si interrompe.
</Note>

## Utilizzo di stampanti da un POS o EPOS di terze parti

Se utilizzi già un sistema POS o EPOS di terze parti fornito con le proprie stampanti per ricevute o cucina (ad esempio, hardware fornito insieme a un'integrazione con un aggregatore di ordini), non colleghi quelle stampanti direttamente a storekit.

Quando sei [integrato con il POS](/docs/it/guides/integrations/pos/overview), storekit inietta ogni ordine direttamente nel tuo POS, e il tuo POS gestisce le proprie stampanti e display di cucina. Le stampanti non-Star rimangono dal lato POS e continuano a stampare esattamente come per gli altri tuoi canali — non c'è nulla da configurare in **Settings → Printers** di storekit per loro.

<Note>
  Solo le stampanti **Star Micronics CloudPRNT** possono connettersi direttamente a storekit (vedi [Stampanti supportate](#supported-printers) di seguito). Le stampanti di altri marchi, come Epson, devono essere gestite dal tuo POS/EPOS. Puoi comunque aggiungere una stampante Star CloudPRNT a storekit come [fallback](/docs/it/guides/printing/fallback-printing) se desideri un backup per quando la connessione POS si interrompe.
</Note>

## Stampanti supportate

storekit supporta solo le stampanti **Star Micronics CloudPRNT** per la stampa automatica diretta. I modelli elencati sotto sono quelli che puoi selezionare in **Settings → Printers**. Epson e altri marchi di stampanti non possono connettersi direttamente a storekit — se usi un marchio diverso, deve essere gestito da un sistema POS/EPOS (vedi [Utilizzo di stampanti da un POS o EPOS di terze parti](#using-printers-from-a-third-party-pos-or-epos) sopra).

| Modello             | Tipo               | Note                                                                        |
| ------------------- | ------------------ | --------------------------------------------------------------------------- |
| **Star TSP100IV**   | Termica            | Consigliata - veloce, affidabile, facile da configurare                     |
| **Star MC Print 3** | Termica            | Design compatto, caricamento carta frontale                                 |
| **Star MC Print 2** | Termica            | Opzione economica                                                           |
| **Star SP742**      | A matrice di punti | Stampante da cucina - resistente al calore/spruzzi (solo modello CloudPRNT) |

<Tip>
  Puoi acquistare stampanti preconfigurate pronte per storekit da [Commandear](https://commandear.com/products/storekit-configures-star-tsp143iv-receipt-printer).
</Tip>

## Cosa ti servirà

Prima di iniziare, assicurati di avere quanto segue:

1. **Una stampante Star Micronics** — uno dei modelli supportati elencati sopra
2. **Un cavo ethernet (LAN)** — per collegare la stampante al tuo router
3. **Un router con accesso a internet** — la stampante si connette a storekit tramite il cloud
4. **L'app Star Quick Setup Utility** sul tuo telefono o tablet:
   * [iOS (iPhone/iPad)](https://apps.apple.com/us/app/star-quick-setup-utility/id1549088652)
   * [Android](https://play.google.com/store/apps/details?id=com.starmicronics.starquicksetuputility)

## Prima di iniziare

Segui questa checklist per evitare problemi comuni di configurazione:

<Steps>
  <Step title="La stampante è collegata al router">
    Collega un'estremità del cavo ethernet alla porta LAN della stampante e l'altra estremità a una porta libera sul tuo router (o switch di rete).
  </Step>

  <Step title="La stampante è accesa">
    Collega il cavo di alimentazione e accendi la stampante. Dovresti vedere una luce blu o verde sul pannello frontale.
  </Step>

  <Step title="Il tuo telefono/tablet è sulla stessa rete">
    Assicurati che il dispositivo che esegue Star Quick Setup Utility sia connesso alla stessa rete WiFi fornita dal tuo router — non una rete ospite o dati mobili.
  </Step>
</Steps>

<Tip>
  Se il tuo router è lontano da dove vuoi posizionare la stampante, usa un cavo ethernet lungo, uno switch di rete o un router 4G con una porta LAN posizionato vicino alla stampante.
</Tip>

## Passaggi di configurazione

<Warning>
  La tua stampante Star deve essere collegata al router tramite un cavo ethernet (LAN) per una stampa cloud affidabile. Le configurazioni solo WiFi non sono consigliate e potrebbero non riuscire a connettersi. Assicurati di avere un cavo LAN disponibile prima di iniziare la configurazione. Se il tuo router non è vicino alla stampante, usa un cavo LAN lungo, uno switch di rete o un router 4G con una porta LAN.
</Warning>

### Passaggio 1: Collega la stampante tramite Ethernet (cavo LAN)

1. Collega un'estremità del cavo ethernet alla **porta LAN** sul retro della tua stampante
2. Collega l'altra estremità a una porta libera sul tuo router
3. Accendi la stampante — aspetta che la luce diventi blu o verde
4. Apri l'app **Star Quick Setup Utility** sul tuo telefono o tablet
5. Seleziona il modello della tua stampante dall'elenco
6. Segui le istruzioni sullo schermo per completare la connessione di rete

<Warning>
  La stampante deve essere sulla stessa rete WiFi della connessione internet del tuo locale. Le reti per ospiti o le reti con isolamento client potrebbero non funzionare.
</Warning>

### Passaggio 2: Ottieni l'indirizzo MAC

L'indirizzo MAC è un identificatore univoco per la tua stampante. Ti servirà per registrare la stampante con storekit.

**Per eseguire un test di autostampa:**

1. Spegni la stampante
2. Tieni premuto il pulsante **FEED**
3. Mentre tieni premuto FEED, riaccendi la stampante
4. Rilascia il pulsante quando inizia la stampa della pagina di test

L'indirizzo MAC è stampato sulla pagina di test nel formato `00:11:62:XX:XX:XX`.

<Note>
  Per istruzioni dettagliate sull'autostampa per il tuo modello specifico, consulta la [documentazione Star Micronics](https://www.star-m.jp/products/s_print/mcprint3/manual/en/basicOperations/testPrint.htm).
</Note>

### Passaggio 3: Aggiungi la stampante in storekit

1. Apri la tua [dashboard storekit](https://dashboard.storekit.com)
2. Seleziona il tuo negozio dall'elenco
3. Vai a **Settings** → **Printers**
4. Clicca su **Connect new printer**
5. Seleziona il modello della tua stampante
6. Inserisci un nome (es. "Kitchen Printer", "Bar Printer")
7. Inserisci l'indirizzo MAC dalla stampa di test
8. Configura le impostazioni di stampa (vedi sotto)
9. Clicca su **Add printer**

La stampante apparirà come "Pending confirmation" fino a quando non si connette con successo al servizio di stampa cloud di storekit.

### Passaggio 4: Conferma la connessione

Una volta che la stampante si connette:

1. Clicca su **Connect printer** accanto alla stampante in sospeso
2. La stampante stamperà una ricevuta di conferma
3. Lo stato cambierà in **Online**

Puoi cliccare sull'icona della stampante in qualsiasi momento per inviare una stampa di prova.

## Impostazioni della stampante

| Impostazione             | Opzioni        | Descrizione                                       |
| ------------------------ | -------------- | ------------------------------------------------- |
| **Name**                 | Testo          | Nome visualizzato mostrato nella dashboard        |
| **Text size**            | Medium / Large | Dimensione del carattere sugli scontrini stampati |
| **Print item prices**    | On / Off       | Mostra i prezzi per ciascun articolo              |
| **Print admin comments** | On / Off       | Include note interne sugli scontrini              |
| **Auto / Manual print**  | Auto / Manual  | Quando stampare (vedi sotto)                      |
| **Copies**               | 1-4            | Numero di copie per ordine                        |
| **Buffer**               | 0-720 minuti   | Ritardo per i pre-ordini                          |

## Stampa automatica vs manuale

### Stampa automatica

Gli ordini vengono stampati automaticamente non appena vengono accettati. Ideale per:

* Locali ad alto volume
* Cucine che lavorano con scontrini stampati
* Ridurre i passaggi manuali nel flusso degli ordini

### Stampa manuale

Gli ordini vengono stampati solo quando clicchi il pulsante di stampa nella dashboard. Ideale per:

* Locali a basso volume
* Quando preferisci rivedere prima gli ordini sullo schermo
* Locali che usano tablet come display principale degli ordini

## Buffer per pre-ordini

L'impostazione del buffer ritarda la stampa dei pre-ordini fino a quando non si avvicina l'orario di ritiro/consegna.

**Esempio:** Un cliente effettua un ordine alle 10:00 per il ritiro alle 14:00.

* **Buffer = 0**: Stampa immediatamente alle 10:00
* **Buffer = 30**: Stampa alle 13:30 (30 minuti prima del ritiro)
* **Buffer = 60**: Stampa alle 13:00 (60 minuti prima del ritiro)

<Tip>
  Un buffer di 30-60 minuti funziona bene per la maggior parte delle cucine - abbastanza lungo per preparare l'ordine, abbastanza breve da evitare che gli scontrini si accumulino.
</Tip>

<Note>
  Se i pre-ordini non vengono stampati come previsto, consulta la [guida alla risoluzione dei problemi di stampa dei pre-ordini](/docs/it/guides/printing/troubleshooting#pre-order-printing) per problemi comuni e soluzioni.
</Note>

## Stato della stampante

La dashboard mostra lo stato della stampante in tempo reale:

* 🟢 **Online** - Stampante connessa e pronta
* 🔴 **Offline** - Stampante non raggiungibile

Se una stampante appare offline:

1. Controlla che la stampante sia accesa
2. Verifica che sia connessa al WiFi (controlla la spia di rete della stampante)
3. Assicurati che la stampante sia sulla stessa rete di quando è stata configurata
4. Prova a spegnere e riaccendere la stampante

## Problemi comuni

| Problema                                              | Cosa controllare                                                                                                                                                                                                                                                                        |
| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Stampante non trovata nell'app**                    | Assicurati che il cavo ethernet sia saldamente collegato ad entrambe le estremità (stampante e router). Conferma che il tuo router abbia connessione internet — prova a caricare una pagina web sul tuo telefono. Assicurati che il tuo telefono sia sulla stessa rete del router.      |
| **La ricevuta di test non viene stampata**            | Controlla che la carta sia caricata correttamente e che il coperchio della carta sia completamente chiuso. Apri il coperchio, riposiziona il rotolo e chiudilo fino allo scatto.                                                                                                        |
| **La stampante mostra una luce rossa**                | Una luce rossa fissa significa che il coperchio è aperto; una luce rossa lampeggiante significa carta esaurita. Anche gli inceppamenti carta possono causare una luce rossa. Apri il coperchio, rimuovi eventuale carta inceppata, ricarica il rotolo e chiudi saldamente il coperchio. |
| **La stampante è bloccata su "Pending confirmation"** | La stampante non ha ancora raggiunto il cloud di storekit. Verifica la connessione del cavo ethernet e che il tuo router abbia accesso a internet. Spegni e riaccendi la stampante e aspetta 2 minuti.                                                                                  |

<Note>
  Per una risoluzione dei problemi più avanzata — inclusi codici di stato LED, diagnostica di rete e problemi di stampa dei pre-ordini — consulta la [Guida completa alla risoluzione dei problemi della stampante](/docs/it/guides/printing/troubleshooting).
</Note>

## Hai bisogno di aiuto?

Se hai provato i passaggi sopra e la tua stampante ancora non funziona, il nostro team di supporto può guidarti telefonicamente.

<Card title="Supporto telefonico" icon="phone">
  Chiama **020 3318 9890** — disponibile dalle 8:00 all'1:00 GMT, 7 giorni su 7.
</Card>


## Related topics

- [Guida rapida](/docs/it/getting-started/quick-start-guide.md)
- [6. Collegare una stampante di ricevute cloud](/docs/it/getting-started/launch/connect-printing.md)
- [Risolvi i problemi di connettività della stampante Star e di stampa degli ordini](/docs/it/guides/printing/troubleshooting.md)
- [5. Configura i pagamenti](/docs/it/getting-started/launch/set-up-payments.md)
- [Stampa di fallback](/docs/it/guides/printing/fallback-printing.md)
