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

# Guida al mapping PLU

> Best practice per mappare i prodotti tra storekit e il tuo POS utilizzando i codici PLU. Evita le insidie comuni e assicurati che gli ordini arrivino accuratamente in cucina.

I codici PLU (Price Look-Up) sono identificatori univoci che collegano i prodotti tra storekit e il tuo sistema POS. Un mapping PLU corretto assicura che gli ordini arrivino accuratamente in cucina.

## Comprendere i codici PLU

Un codice PLU è un numero o un codice alfanumerico che identifica in modo univoco un prodotto nel tuo POS. Quando storekit invia un ordine al tuo POS, include il codice PLU così che il POS sappia esattamente quale articolo è stato ordinato.

### Esempio di mapping PLU

| Prodotto storekit                 | PLU POS | Nome POS   |
| --------------------------------- | ------- | ---------- |
| Pizza Margherita                  | 1001    | MARG-12    |
| Pizza Pepperoni                   | 1002    | PEPP-12    |
| Extra formaggio (modificatore)    | 2001    | MOD-CHEESE |
| Base senza glutine (modificatore) | 2002    | MOD-GF     |

## Quando è richiesto il mapping PLU

Il mapping PLU è richiesto per le **integrazioni con linking manuale** in cui i menu non vengono sincronizzati automaticamente:

* TISSL
* Comtrex
* Centegra
* Altre integrazioni basate su PLU

Per le **integrazioni con sync automatica** (Zonal, Lightspeed), il mapping PLU avviene automaticamente durante la sincronizzazione del menu.

## Configurare il mapping PLU

### Passo 1: esportare la lista PLU dal POS

Ottieni un elenco completo dei codici PLU dal tuo POS:

1. Accedi al back office del tuo POS
2. Esporta o stampa l'elenco prodotti con i codici PLU
3. Includi modificatori e varianti

<Tip>
  Crea un foglio di calcolo con le colonne: PLU POS, nome POS, nome prodotto storekit, categoria. Diventa il tuo documento di riferimento.
</Tip>

### Passo 2: aggiungere i PLU ai prodotti storekit

Per ogni prodotto:

1. Vai su **Menu** nella tua dashboard storekit
2. Clicca su un prodotto per modificarlo
3. Trova il campo **PLU** o **POS Settings**
4. Inserisci il codice PLU esatto
5. Salva il prodotto

### Passo 3: mappare i modificatori

Anche i modificatori necessitano di PLU:

1. Vai ai tuoi gruppi di modificatori
2. Modifica ogni opzione di modificatore
3. Inserisci il codice PLU per ciascuna opzione
4. Salva le modifiche

### Passo 4: verificare i mapping

Prima di andare live:

1. Rivedi il tuo foglio PLU
2. Controlla che ogni prodotto storekit abbia un PLU
3. Verifica che i PLU corrispondano esattamente (case-sensitive per alcuni sistemi)
4. Testa con ordini di esempio

## Best practice per il mapping PLU

### Mantieni un riferimento master

Mantieni un foglio di calcolo che mappi:

* ID/nome prodotto storekit
* Codice PLU POS
* Nome prodotto POS
* Data ultimo aggiornamento
* Note

Aggiorna questo documento ogni volta che apporti modifiche.

### Usa una nomenclatura coerente

Quando crei i prodotti in storekit, usa nomi che rendono più facile il matching dei PLU:

| Invece di            | Usa                     |
| -------------------- | ----------------------- |
| "The Classic Burger" | "Classic Burger (1001)" |
| "Large Fries"        | "Fries - Large (2050)"  |

Includere il PLU nel nome interno aiuta durante gli audit.

### Gestisci correttamente le varianti

I prodotti con opzioni di taglia o variante hanno spesso PLU diversi:

| Prodotto | Variante | PLU  |
| -------- | -------- | ---- |
| Latte    | Small    | 3001 |
| Latte    | Medium   | 3002 |
| Latte    | Large    | 3003 |

In storekit puoi:

* Creare prodotti separati per ogni taglia
* Usare modificatori con PLU individuali

### Pianifica per i modificatori

I modificatori rientrano tipicamente in categorie:

| Tipo                                     | Strategia PLU                                                         |
| ---------------------------------------- | --------------------------------------------------------------------- |
| **Add-on** (extra formaggio)             | PLU univoco per ogni add-on                                           |
| **Rimozioni** (senza cipolle)            | Potrebbe non servire un PLU, oppure usa un PLU di rimozione specifico |
| **Sostituzioni** (patatine con insalata) | PLU per l'articolo di sostituzione                                    |

<Info>
  Alcuni sistemi POS gestiscono le rimozioni in modo diverso. Verifica con il tuo provider POS come configurare i modificatori "senza X".
</Info>

### Documenta i casi speciali

Annota eventuali mapping insoliti:

* Prodotti con più PLU (combo)
* PLU basati sull'orario (prezzi pranzo vs cena)
* PLU specifici per sede (setup multi-locale)

## Problemi comuni di mapping PLU

### PLU non corrispondenti

**Problema:** l'ordine mostra un articolo sbagliato nel POS

**Causa:** il PLU in storekit non corrisponde a quello del POS

**Soluzione:**

1. Controlla il PLU sul prodotto storekit
2. Verifica rispetto all'elenco prodotti del POS
3. Correggi eventuali disallineamenti
4. Testa con un nuovo ordine

### PLU mancanti

**Problema:** l'ordine fallisce o gli articoli mancano

**Causa:** il prodotto in storekit non ha un PLU assegnato

**Soluzione:**

1. Identifica i prodotti senza PLU
2. Cerca il PLU corretto nel POS
3. Aggiungi il PLU al prodotto storekit
4. Salva e testa

### PLU non trovato nel POS

**Problema:** l'errore indica che il PLU non esiste

**Causa:**

* Il PLU è stato eliminato dal POS
* Errore di battitura nel codice PLU
* Il PLU esiste in una sede/menu differente

**Soluzione:**

1. Verifica che il PLU esista nel POS
2. Controlla eventuali errori di battitura (spazi extra, caratteri sbagliati)
3. Conferma che il PLU sia attivo e visibile
4. Aggiorna storekit se il PLU è cambiato

### PLU dei modificatori che falliscono

**Problema:** il prodotto base funziona ma i modificatori falliscono

**Causa:** PLU dei modificatori mancanti o errati

**Soluzione:**

1. Controlla che tutte le opzioni di modificatore abbiano PLU
2. Verifica che i PLU dei modificatori esistano nel POS
3. Testa ogni modificatore individualmente

## Gestione PLU multi-sede

Se hai più sedi:

### Stesso POS, stesso menu

* I PLU sono in genere coerenti
* Usa lo stesso mapping PLU su tutte le sedi

### Stesso POS, menu differenti

* I PLU possono variare per sede
* Mantieni mapping PLU separati per sede
* Documenta i codici specifici per sede

### Sistemi POS differenti

* Ogni sede necessita del proprio setup PLU
* Mantieni documenti di riferimento separati
* Considera di standardizzare dove possibile

## Checklist di audit PLU

Esegui questo audit prima del go-live e periodicamente in seguito:

* [ ] Tutti i prodotti hanno un PLU assegnato
* [ ] Tutti i modificatori hanno un PLU assegnato
* [ ] I PLU corrispondono esattamente al POS (senza errori di battitura)
* [ ] Il documento di riferimento PLU è aggiornato
* [ ] Gli ordini di test funzionano correttamente
* [ ] I prezzi sono accurati
* [ ] I modificatori compaiono correttamente sugli scontrini
* [ ] I nuovi articoli aggiunti dall'ultimo audit sono mappati

## Manutenzione dei mapping PLU

### Quando aggiungi nuovi articoli

1. Crea prima il prodotto nel POS
2. Annota il PLU assegnato
3. Crea il prodotto in storekit con il PLU
4. Aggiorna il tuo documento di riferimento
5. Testa il nuovo articolo

### Quando rimuovi articoli

1. Rimuovi da storekit (o marca come non disponibile)
2. Aggiorna il tuo documento di riferimento
3. Facoltativamente rimuovi dal POS

### Quando i PLU cambiano

1. Aggiorna il prodotto storekit con il nuovo PLU
2. Aggiorna il documento di riferimento
3. Testa i prodotti interessati
4. Annota la data della modifica per il troubleshooting

Per ulteriore assistenza, [contatta il supporto](/docs/it/getting-started/contact-support).


## Related topics

- [Centegra](/docs/it/guides/integrations/pos/centegra.md)
- [Troubleshooting POS](/docs/it/guides/integrations/pos/advanced/troubleshooting.md)
- [Guida rapida](/docs/it/getting-started/quick-start-guide.md)
- [3. Costruisci il tuo menu](/docs/it/getting-started/launch/build-your-menu.md)
- [Store connesso al POS](/docs/it/getting-started/store-types/pos-connected-store.md)