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

# Centegra

> Collega Centegra POS a storekit per l'iniezione degli ordini. Collega i prodotti con i PLU per inviare gli ordini online alle tue casse esistenti, con i tavoli mappati per POS ID.

Centegra è un sistema POS enterprise ampiamente utilizzato nell'ospitalità. L'integrazione storekit abilita l'iniezione automatica degli ordini. La gestione del menu utilizza un linking manuale dei prodotti: costruisci il menu in storekit e colleghi i prodotti ai loro ID Centegra.

## Cosa ottieni

* **Iniezione degli ordini** — gli ordini online vengono inviati direttamente a Centegra
* **Mapping tavoli** — instrada gli ordini dine-in a una Location Centegra e a un tavolo per POS ID
* **Linking manuale dei prodotti** — controllo completo sulla presentazione del tuo menu online

## Iniziare

### Cosa serve

Contatta il tuo account manager Centegra per ottenere:

* **Secure Key** — la tua API key a livello aziendale
* **Site ID** — identifica la tua specifica sede

Dovrai inoltre configurare le impostazioni specifiche del locale nella dashboard storekit dopo aver effettuato la connessione.

### Connessione a Centegra

1. Vai su **Settings > Integrations** nella tua dashboard storekit
2. Seleziona **Centegra**
3. Inserisci la tua **Secure Key**
4. Clicca su **Connect**

### Selezione del tuo site

Dopo la connessione a livello di account:

1. Vai su **Stores** → il tuo store → **Settings** → **Integrations** → **Centegra**
2. Seleziona il tuo **Site** Centegra tra le opzioni disponibili
3. Il Site ID viene salvato per l'instradamento degli ordini

### Configurazione delle impostazioni del locale

Ogni locale richiede specifiche impostazioni Centegra:

| Impostazione        | Descrizione                                             |
| ------------------- | ------------------------------------------------------- |
| **Location**        | L'area/location all'interno del tuo site per gli ordini |
| **Till**            | Quale cassa riceve gli ordini online                    |
| **Till Secure Key** | Chiave di autenticazione per la cassa selezionata       |
| **Clerk**           | L'ID del clerk usato per gli ordini online              |
| **Media**           | Tipo di media di pagamento per i pagamenti online       |
| **Source**          | Identificatore di origine per gli ordini online         |
| **Price Level**     | Quale price level usare per gli articoli dell'ordine    |

<Warning>
  Tutte le impostazioni devono corrispondere a valori validi nel tuo sistema Centegra. Una configurazione errata farà fallire gli ordini.
</Warning>

## Collegare i prodotti

Centegra utilizza il **linking manuale dei prodotti** — i prodotti non vengono sincronizzati automaticamente dal tuo POS.

### Come funziona

1. Crea il tuo menu in storekit con categorie, prodotti e modificatori
2. Per ogni prodotto, inserisci il suo **Centegra Product ID** nel campo POS ID
3. Per ogni modificatore, inserisci il suo **Centegra Product ID**
4. Quando vengono effettuati ordini, storekit invia i Product ID a Centegra

### Trovare i Product ID

Puoi trovare i tuoi Centegra Product ID in:

* Il back office Centegra alla voce Products
* Report di export prodotti
* Contattando il tuo team di supporto Centegra

### Collegare i modificatori

Anche i modificatori necessitano dei Product ID da Centegra:

1. Vai ai tuoi gruppi di modificatori in storekit
2. Per ogni opzione di modificatore, inserisci il suo Centegra Product ID
3. I modificatori vengono inviati come articoli figli collegati al loro prodotto genitore

## Come funzionano gli ordini

### Flusso ordine

1. Il cliente effettua l'ordine sul tuo store storekit
2. L'ordine viene validato con Centegra (`TransactionValidate`)
3. Se valido, l'ordine viene inviato (`Transaction`)
4. L'ordine compare in Centegra sulla cassa configurata
5. Il cliente riceve la conferma con l'ID della transazione

<Info>
  Se un ordine non riesce a sincronizzarsi con Centegra, riceverai una notifica email con i dettagli dell'errore e un link diretto all'ordine nella tua dashboard.
</Info>

### Tipi di ordine

| Ordine online | Tipo di transazione Centegra |
| ------------- | ---------------------------- |
| Pickup        | Type 2                       |
| Delivery      | Type 3                       |

### Cosa riceve Centegra

Ogni ordine include:

* ID transazione esterno (basato su timestamp)
* ID di location, cassa e clerk
* Tutti gli articoli con Product ID, quantità e prezzi
* Modificatori come articoli figli collegati ai genitori
* Sconti calcolati distribuiti tra gli articoli
* Dettagli pagamento con media ID
* Nome, email e telefono del cliente
* Numero di riferimento dell'ordine
* Ora di inizio preparazione (per la pianificazione)
* Note dell'ordine

### Sconti

Quando viene applicato uno sconto:

* L'importo dello sconto viene distribuito proporzionalmente su tutti gli articoli
* Ogni articolo mostra il prezzo unitario, il totale lordo e l'importo dello sconto
* Centegra riceve la scomposizione completa dello sconto

### Mance

Le mance vengono gestite come una voce di pagamento negativa, mantenendo il totale dell'ordine accurato pur tracciando separatamente la gratifica.

## Tavoli e instradamento dine-in

La pagina impostazioni Centegra non ha una planimetria né un pulsante di sync dei tavoli. Crea le tue aree e i tavoli in storekit (vedi [tavoli dine-in](/docs/it/guides/fulfillment/dine-in-tables)) e assegna a ciascun tavolo il POS ID Centegra corrispondente, così che gli ordini dine-in vengano instradati al tavolo corretto all'interno della **Location** configurata.

## Troubleshooting

### Problemi di connessione

**"Secure Key not found"**

* Verifica che la tua Secure Key sia inserita correttamente a livello di account
* Contatta il supporto Centegra per confermare l'accesso API

**"Site not found"**

* Controlla che il Site ID corrisponda alla tua sede in Centegra
* Assicurati che la tua Secure Key abbia accesso a questo site

### Problemi con gli ordini

**Ordini falliscono la validazione**

* Controlla che tutte le impostazioni del locale siano configurate (location, cassa, clerk, ecc.)
* Verifica che la Till Secure Key sia corretta
* Assicurati che tutti i prodotti abbiano Centegra Product ID validi

**"Product doesn't have posId"**

* L'articolo in questione manca del suo Centegra Product ID
* Modifica il prodotto in storekit e aggiungi il POS ID

**"Modifier doesn't have posId"**

* Un'opzione di modificatore manca del Product ID
* Modifica il modificatore e aggiungi il Centegra Product ID

### Articoli o prezzi sbagliati

* Verifica che i Product ID corrispondano tra storekit e Centegra
* Controlla che l'impostazione Price Level sia corretta per il tuo menu online
* Assicurati che le aliquote fiscali siano configurate sui prodotti

### Gli ordini dine-in non arrivano al tavolo corretto

* Conferma che il tuo locale abbia un Site ID valido (posId)
* Controlla che la **Location** selezionata nelle impostazioni Centegra di storekit esista in Centegra
* Verifica che ogni tavolo storekit abbia il POS ID del tavolo Centegra corrispondente

## Checklist di go-live

Prima del lancio:

* [ ] Secure Key inserita a livello di account
* [ ] Impostazioni del locale configurate (location, cassa, clerk, media, source, price level)
* [ ] Tutti i prodotti hanno Centegra Product ID
* [ ] Tutti i modificatori hanno Centegra Product ID
* [ ] Effettua un ordine di test pickup
* [ ] Verifica che l'ordine compaia sulla cassa corretta in Centegra
* [ ] Controlla che articoli, modificatori e prezzi siano corretti
* [ ] Testa un ordine di delivery con indirizzo completo
* [ ] Crea i tavoli in storekit con i loro POS ID Centegra (se usi il dine-in)

## Funzionalità supportate

<AccordionGroup>
  <Accordion title="Sincronizzazione del menu">
    | Funzionalità                         | Supportata |
    | ------------------------------------ | :--------: |
    | Sincronizzazione automatica del menu |      ✗     |
    | Linking manuale dei prodotti         |      ✓     |
    | Immagini prodotto                    |      ✗     |
    | Allergeni                            |      ✗     |
    | Info nutrizionali                    |      ✗     |
    | Modificatori nidificati              |      ✗     |
    | Sottocategorie                       |      ✗     |
    | Stato di stock                       |      ✗     |

    Centegra utilizza il linking manuale dei prodotti. Crea il tuo menu in storekit e inserisci il Centegra Product ID per ogni articolo.
  </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)
* [Guida al mapping PLU](/docs/it/guides/integrations/pos/advanced/plu-mapping)
* [Troubleshooting problemi POS](/docs/it/guides/integrations/pos/advanced/troubleshooting)


## Related topics

- [Sincronizzazione del menu POS](/docs/it/guides/menu/pos-menu-sync.md)
- [Aggiungi e configura prodotti, modificatori e tag del menu](/docs/it/guides/menu/products.md)
- [Panoramica integrazioni POS](/docs/it/guides/integrations/pos/overview.md)
- [Guida al mapping PLU](/docs/it/guides/integrations/pos/advanced/plu-mapping.md)
- [Store connesso al POS](/docs/it/getting-started/store-types/pos-connected-store.md)