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

# PointOne

> Collega storekit a PointOne, POS cloud, per sincronizzazione automatica del menu, iniezione degli ordini e pay at table. Istruzioni passo-passo per l'integrazione bidirezionale.

PointOne è un sistema POS per l'ospitalità basato su cloud. Collegalo a storekit per sincronizzare automaticamente il tuo menu, inviare gli ordini online direttamente al tuo POS e permettere ai clienti di pagare i propri conti al tavolo dal loro telefono.

## Cosa ottieni

* **Sincronizzazione automatica del menu** — importa l'intero menu da PointOne con un clic
* **Iniezione degli ordini** — gli ordini online compaiono direttamente in PointOne, senza inserimento manuale
* **Pay at table** — i clienti scansionano un QR code per visualizzare e pagare il conto

## Iniziare

### Cosa serve

Contatta il tuo account manager PointOne per ottenere:

* **API Key** — la tua chiave di accesso univoca
* **Site ID** — identifica la tua specifica sede

### Connessione a PointOne

1. Vai su **Settings > Integrations** nella tua dashboard storekit
2. Seleziona **PointOne**
3. Inserisci la tua API Key e il Site ID
4. Clicca su **Save**

### Importazione del menu

Una volta connesso, clicca su **Sync Menu** per importare tutto da PointOne. La sync porta:

* Categorie e sottocategorie
* Prodotti con descrizioni e immagini
* Gruppi di modificatori e opzioni
* Informazioni sugli allergeni
* Dati nutrizionali (calorie, grassi, carboidrati, ecc.)
* Programmi di disponibilità delle categorie

<Note>
  Le immagini dei prodotti vengono ottimizzate automaticamente durante l'importazione. La sync richiede in genere alcuni minuti a seconda della dimensione del menu.
</Note>

### Mantenere il menu aggiornato

Quando apporti modifiche in PointOne:

1. Torna su **Settings > Integrations > PointOne**
2. Clicca su **Sync Menu** per recuperare le ultime modifiche

<Tip>
  Sincronizza solo quando hai apportato modifiche al menu. Sincronizzare troppo frequentemente non è necessario e non produce risultati diversi.
</Tip>

## Dettagli sulla sincronizzazione del menu

### Prezzi

Se in PointOne hai prezzi diversi per eat-in e takeaway, storekit utilizza il **prezzo takeaway** per gli ordini online.

### Allergeni

Tutti i 14 principali allergeni si sincronizzano automaticamente da PointOne e vengono visualizzati sul tuo menu online, aiutando i clienti a fare scelte informate.

### Orari di categoria

Se alcune categorie sono disponibili solo in orari specifici (come un menu colazione), quei programmi si trasferiscono da PointOne. I clienti vedono solo gli articoli disponibili.

### Articoli con restrizioni d'età

I prodotti marcati come 18+ in PointOne vengono automaticamente segnalati, garantendo che compaiano i prompt di verifica dell'età al checkout.

## Come funzionano gli ordini

### Flusso ordine

1. Il cliente effettua l'ordine sul tuo store storekit
2. L'ordine viene inviato immediatamente a PointOne
3. L'ordine compare sul tuo POS pronto per la preparazione
4. Il cliente riceve la conferma con il suo numero d'ordine

### Cosa è incluso

Gli ordini inviati a PointOne contengono tutto ciò che serve alla tua cucina:

* Tutti gli articoli e i modificatori
* Nome del cliente e dettagli di contatto
* Indirizzo di consegna (per ordini delivery)
* Eventuali sconti o codici promozionali applicati
* Mance e service charge
* Istruzioni speciali

### Tipi di ordine

| Ordine online | Compare in PointOne come |
| ------------- | ------------------------ |
| Pickup        | Collection               |
| Delivery      | Delivery                 |
| Dine-in       | Ordine al tavolo         |

### Pre-ordini

Gli ordini programmati vengono inviati a PointOne con la data e l'ora richieste, così che il tuo team sappia esattamente quando prepararli.

## Pay at Table

Permetti ai clienti dine-in di visualizzare e pagare il conto senza aspettare lo staff.

### Setup

1. Assicurati che i tuoi tavoli siano configurati sia in PointOne che in storekit
2. Genera i QR code per ogni tavolo in storekit
3. Posiziona i QR code sui tavoli

### Esperienza cliente

1. Il cliente scansiona il QR code al proprio tavolo
2. Il suo conto attuale compare con tutti gli articoli
3. Può pagare l'intero importo o dividere con altri
4. Il pagamento viene applicato al conto in PointOne

### Aggiornamenti del conto

Il conto si aggiorna automaticamente, quindi se un cliente ordina un altro giro prima di pagare, i nuovi articoli compaiono sul suo telefono.

### Pagamenti misti

Se alcuni ospiti pagano via QR code e altri pagano alla cassa, tutto resta sincronizzato. PointOne traccia tutti i pagamenti indipendentemente da come vengono effettuati.

## Troubleshooting

### Problemi di sincronizzazione del menu

**Alcuni prodotti sono mancanti**

* I prodotti devono avere un nome e un prezzo superiore a zero per sincronizzarsi
* Verifica che gli articoli mancanti soddisfino questi requisiti in PointOne

**Le categorie vuote non compaiono**

* Le categorie devono contenere almeno un prodotto per essere visualizzate
* Aggiungi prodotti alla categoria in PointOne e ri-sincronizza

**Le immagini non sono state importate**

* Assicurati che le immagini siano caricate in PointOne
* Prova a sincronizzare di nuovo — le immagini grandi possono richiedere più tempo per essere elaborate

### Problemi con gli ordini

**Ordini non compaiono in PointOne**

* Controlla la tua connessione internet
* Verifica che PointOne sia online e accetti ordini
* Contatta il supporto se gli ordini falliscono costantemente

**Articoli sbagliati negli ordini**

* Il tuo menu potrebbe essere non sincronizzato
* Esegui una sync del menu per assicurarti che i prodotti corrispondano tra i sistemi

### Problemi con Pay at Table

**Messaggio "No open bill"**

* Il tavolo potrebbe non avere ancora un conto attivo
* Lo staff deve aprire un conto in PointOne prima che i clienti possano visualizzarlo

**Il pagamento non compare in PointOne**

* I pagamenti compaiono in genere in pochi secondi
* Se ritardato, controlla che il conto sia ancora aperto
* Il sistema riprova automaticamente i pagamenti falliti

## Checklist di go-live

Prima del lancio, testa l'intero flusso:

* [ ] La sync del menu si completa senza errori
* [ ] Prodotti, modificatori e prezzi sono corretti
* [ ] Effettua un ordine di test pickup — verifica che compaia in PointOne
* [ ] Effettua un ordine di test delivery con indirizzo completo
* [ ] Testa un pre-ordine per domani
* [ ] Scansiona un QR code al tavolo e verifica che il conto si carichi
* [ ] Completa un pagamento di test via QR code
* [ ] Conferma che il pagamento compaia in PointOne

## Funzionalità supportate

<AccordionGroup>
  <Accordion title="Sincronizzazione del menu">
    | Funzionalità                            | Supportata |
    | --------------------------------------- | :--------: |
    | Sincronizzazione automatica del menu    |      ✓     |
    | Sync leggera (solo prezzi)              |      ✗     |
    | Immagini prodotto                       |      ✓     |
    | Allergeni                               |      ✓     |
    | Info nutrizionali                       |      ✓     |
    | Modificatori nidificati                 |      ✓     |
    | Sottocategorie                          |      ✓     |
    | Fasce orarie di disponibilità categoria |      ✓     |
    | Porzioni / taglie                       |      ✗     |
    | Portate                                 |      ✗     |
    | Stato di stock                          |      ✓     |
  </Accordion>

  <Accordion title="Ordini">
    | Funzionalità                  | Supportata |
    | ----------------------------- | :--------: |
    | Iniezione ordini              |      ✓     |
    | Pre-ordini                    |      ✓     |
    | Buffering ordini              |      ✗     |
    | Validazione carrello          |      ✗     |
    | Auto-snooze articoli esauriti |      ✗     |
    | Sconti                        |      ✓     |
    | Mance                         |      ✓     |
    | Service charge                |      ✓     |
    | Note d'ordine personalizzate  |      ✓     |
    | Dettagli consegna             |      ✓     |
  </Accordion>

  <Accordion title="Pay at Table">
    | Funzionalità                            | Supportata |
    | --------------------------------------- | :--------: |
    | Sync conto in tempo reale               |      ✓     |
    | Applicare pagamenti al conto            |      ✓     |
    | Pagamenti divisi                        |      ✓     |
    | Tracciamento pagamenti da terminale POS |      ✓     |
    | Aggiungere a conto esistente            |      ✗     |
  </Accordion>

  <Accordion title="Configurazione locale">
    | Funzionalità                       | Supportata |
    | ---------------------------------- | :--------: |
    | Sync della planimetria             |      ✗     |
    | Aggiornamenti stock in tempo reale |      ✗     |
    | Supporto multi-sede                |      ✓     |
  </Accordion>
</AccordionGroup>

## Correlati

* [Panoramica integrazioni POS](/docs/it/guides/integrations/pos/overview)
* [Iniezione ordini](/docs/it/guides/integrations/pos/order-injection)
* [Pay at Table](/docs/it/guides/pay-at-table/overview)
* [Troubleshooting problemi POS](/docs/it/guides/integrations/pos/advanced/troubleshooting)


## Related topics

- [Gestire gli ordini live](/docs/it/guides/orders/managing-live-orders.md)
- [Panoramica integrazioni POS](/docs/it/guides/integrations/pos/overview.md)
- [Depositi](/docs/it/guides/menu/deposits.md)
- [Batching degli ordini](/docs/it/guides/orders/advanced/order-batching.md)
- [Store connesso al POS](/docs/it/getting-started/store-types/pos-connected-store.md)