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

# Cosa puoi chiedere

> Prompt che funzionano bene con l'assistente AI di storekit, raggruppati per attività: vendite, rimborsi, conti, snooze, menu, codici sconto e payment link.

Il tuo assistente capisce quali strumenti di storekit chiamare da ciò che chiedi. Questi prompt sono un punto di partenza; adatta negozi, date e importi ai tuoi.

> [!TIP]
>
> Tre abitudini rendono le risposte più affidabili:
>
> * **Nomina il negozio** quando ne hai più di uno ("da Soho", "per il kiosk di Brighton"). Senza, le cifre di vendita vengono sommate sull'account, il che viene rifiutato quando i tuoi negozi usano valute diverse.
> * **Indica il periodo** ("ieri", "la scorsa settimana", "dal 1 al 15 marzo"). Il default è gli ultimi 7 giorni, o 30 giorni per le statistiche di vendita e i top product. Il periodo singolo più lungo è di 90 giorni.
> * **Chiedi una cosa alla volta** per le prime domande, poi concatena ("ora confrontalo con la settimana precedente").

## Numeri di ieri

```text theme={null}
Quanti ordini abbiamo preso ieri a Soho, e qual è stato il totale?
```

```text theme={null}
Confronta le vendite di questa settimana a Soho con gli stessi giorni della scorsa settimana.
```

```text theme={null}
Qual è stato il nostro valore medio dell'ordine per gli ordini di delivery ad agosto?
```

I totali escludono gli ordini rifiutati e cancellati (gli ordini in contanti e pay-later sono inclusi). Sono al lordo dei rimborsi: chiedi i rimborsi separatamente (sotto) se vuoi una cifra netta. Le cifre per un singolo negozio usano l'orario locale di quel negozio; le cifre a livello di account usano UTC a meno che tu non specifichi un fuso orario.

## Cosa è stato venduto

```text theme={null}
Quali sono stati i dieci prodotti più venduti a Soho il mese scorso?
```

```text theme={null}
Quali articoli hanno venduto meno di 5 unità negli ultimi 30 giorni?
```

I prezzi mostrati a fianco sono i prezzi correnti del menu, non quello a cui ogni unità è stata venduta all'epoca.

## Ordini

```text theme={null}
Mostrami gli ordini di ieri che sono stati rifiutati.
```

```text theme={null}
Cosa è successo all'ordine KX7D2? Dammi la timeline completa.
```

```text theme={null}
Elenca gli ordini di delivery programmati per domani.
```

Di default gli ordini vengono elencati per quando sono dovuti (il loro tempo programmato, o il tempo di creazione se non c'è slot). Di' "effettuato il" o "creato" se intendi quando il cliente ha ordinato. Gli ordini rifiutati e cancellati appaiono solo quando li chiedi.

## Rimborsi

```text theme={null}
Quanto abbiamo rimborsato a Soho la scorsa settimana, e su quali ordini?
```

```text theme={null}
Elenca i rimborsi per ordini effettuati a luglio.
```

I rimborsi vengono mostrati per la data in cui è stato emesso il rimborso a meno che tu non chieda per la data dell'ordine.

## Pay at Table

```text theme={null}
Quali conti sono ancora aperti a Brighton in questo momento?
```

```text theme={null}
Quanti coperti abbiamo fatto sui conti ieri?
```

## Snooze

```text theme={null}
Quali articoli sono stati messi in snooze a Soho questa settimana, e per quanto tempo in totale?
```

```text theme={null}
Ci sono stati articoli messi in snooze dal POS piuttosto che dallo staff negli ultimi 7 giorni?
```

I report di snooze coprono l'intero periodo che chiedi. Se vuoi i singoli eventi on/off per un articolo, chiedili e mantieni il periodo breve: una settimana affollata può superare il limite di 100 eventi per articolo.

## Menu e negozi

```text theme={null}
Quali menu ha Brighton, e quali sono live?
```

```text theme={null}
Elenca ogni prodotto del menu Brunch con il suo prezzo e se è disponibile.
```

```text theme={null}
Quali sono gli orari di consegna e le commissioni di consegna di Soho?
```

## Codici sconto

> [!WARNING]
>
> Questa sezione include una **scrittura**. La maggior parte dei client chiede prima di creare il codice, ma solo se non hai auto-consentito lo strumento, consulta [autorizzazioni](/docs/it/guides/ai/permissions-and-privacy). Verifica codice, importo, negozi e date prima di approvare, poi conferma sotto **Marketing** → **Discounts**.

```text theme={null}
Quali codici sconto sono attivi, e quante volte è stato usato ciascuno?
```

```text theme={null}
Crea un codice sconto WELCOME10 per il 10% di sconto a Soho e Brighton, un uso per cliente, valido fino alla fine del mese prossimo.
```

I tipi che l'assistente può creare sono: un importo fisso di sconto, una percentuale di sconto, buy one get one free e delivery gratuito. Può impostare una spesa minima, un limite di utilizzo totale o per cliente, una data di inizio e fine, e limitare il codice a delivery, pickup o in-store. Non può modificare o archiviare un codice una volta creato: fallo nella dashboard.

## Payment link

> [!WARNING]
>
> Questa sezione include una **scrittura**. La maggior parte dei client chiede prima di creare il link, ma solo se non hai auto-consentito lo strumento. Verifica negozio, importo e scadenza prima di approvare. Un link creato è live immediatamente e può prendere denaro.

```text theme={null}
Crea un payment link one-off da £150 a Soho intitolato "Deposito private dining — Patel, 14 ott", con scadenza in 7 giorni.
```

```text theme={null}
Crea un payment link riutilizzabile a Brighton in cui il cliente sceglie l'importo, tra £5 e £500, intitolato "Buono regalo".
```

```text theme={null}
Mostrami il codice QR per il payment link plink_… così posso stamparlo.
```

```text theme={null}
Quali payment link hanno preso pagamenti questo mese, e per quanto?
```

Un link **one-off** diventa **Completed** dopo un pagamento; un link **reusable** rimane attivo (opzionalmente fino a un numero massimo di pagamenti). Un link **fixed** ha un importo impostato; un link **variable** consente al pagante di scegliere entro limiti opzionali. L'assistente può anche impostare una descrizione, un reference interno, un'immagine, un messaggio di ringraziamento o un redirect dopo il pagamento, e se raccogliere il nome, l'email, il telefono o la ragione sociale del pagante. Consulta [Payment Links](/docs/it/payment-links/overview) per come si comportano una volta creati.

## Quando l'assistente dice di no

Alcune risposte sono rifiuti per design:

| L'assistente dice | Perché |
| - | - |
| Ha bisogno che tu scelga un negozio | I tuoi negozi usano più di una valuta, quindi un totale a livello di account non avrebbe senso |
| Il periodo è troppo lungo | Il limite è 90 giorni in una domanda: dividi |
| Non riesce a trovare un ordine, un negozio o un link | Appartiene a un altro account, o l'ID è sbagliato. Gli ID degli ordini sono codici brevi come `KX7D2`; gli ID dei payment link iniziano con `plink_` |
| Non può modificare un menu, un ordine o un'impostazione | Non c'è alcuno strumento per farlo. Consulta [Cosa non può fare](/docs/it/guides/ai/overview#cosa-non-può-fare) |

Qualsiasi altra cosa che sembri sbagliata è trattata in [Risoluzione dei problemi](/docs/it/guides/ai/troubleshooting).


## Related topics

- [Collega il tuo agente AI](/docs/it/guides/ai/overview.md)
- [Collega ChatGPT](/docs/it/guides/ai/connect/chatgpt.md)
- [Collega Claude](/docs/it/guides/ai/connect/claude.md)
- [Collega Claude Code](/docs/it/guides/ai/connect/claude-code.md)
- [Collega Cursor o VS Code](/docs/it/guides/ai/connect/cursor-vscode.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.