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

# Esportazione al data warehouse

> Sincronizza ordini, clienti, prodotti del menu e pagamenti storekit nel tuo data warehouse: Snowflake, BigQuery, Databricks, Redshift, Postgres.

> [!NOTE]
>
> **Beta feature** - This feature is currently in beta. If you'd like to use it, please ask us on live chat.

L'esportazione al data warehouse mantiene una copia continuamente aggiornata dei tuoi dati storekit in un warehouse di tua proprietà. Ordini, clienti, prodotti del menu e pagamenti arrivano come tabelle pronte per essere interrogate, così i tuoi analisti e i tuoi strumenti di BI lavorano sugli stessi dati usati da storekit, senza esportare CSV o interrogare l'API.

## Come funziona

storekit invia i dati alla tua destinazione con una pianificazione ricorrente. Ogni sincronizzazione scrive le righe nuove e modificate rispetto alla sincronizzazione precedente, così le tabelle restano aggiornate senza ricaricare tutto.

* **La destinazione è tua.** I dati vengono scritti in un database o in un bucket del tuo account cloud. storekit non ha bisogno di accedere in lettura a nient'altro nel tuo warehouse.
* **Incrementale per impostazione predefinita.** Dopo il backfill iniziale della cronologia, ogni sincronizzazione trasferisce solo le righe create o aggiornate dall'ultima esecuzione.
* **Schema gestito per te.** Tabelle e colonne vengono create e mantenute aggiornate automaticamente. I nuovi campi appaiono come colonne; le colonne esistenti non vengono mai rinominate o rimosse senza preavviso.
* **Gli account con più store si sincronizzano come un unico dataset.** Se il tuo account ha più store, ogni tabella include un identificativo dello store, così puoi generare report per singolo store o per l'intero gruppo.

## Cosa viene esportato

| Dataset | Descrizione |
| - | - |
| Ordini | Ogni ordine con il metodo di evasione, lo stato, i tempi, i totali, gli sconti, le mance e le commissioni |
| Righe d'ordine | Le voci di ogni ordine, inclusi modificatori, quantità e prezzi unitari |
| Pagamenti e rimborsi | Tentativi di pagamento, importi incassati, rimborsi e metodo di pagamento utilizzato |
| Clienti | Anagrafiche cliente con dati di contatto, consensi marketing e riferimenti alla cronologia degli ordini |
| Prodotti del menu | Prodotti, categorie, gruppi di modificatori e opzioni con prezzi e disponibilità aggiornati |
| Store | Dettagli dello store, orari di apertura e impostazioni di evasione |

Gli importi vengono esportati nelle unità minori (centesimi) con la valuta a fianco, in linea con l'API storekit e con i [payload dei webhook](/docs/it/developers/webhooks/payload-format).

> [!NOTE]
>
> I dati personali sono inclusi dove necessari a riconciliare gli ordini con i clienti. Tratta le tabelle esportate con gli stessi controlli di accesso che applichi a storekit; consulta la [Policy di sicurezza](/docs/it/privacy-security/security-policy) per sapere come storekit gestisce questi dati dalla propria parte.

## Destinazioni supportate

I dati possono essere consegnati ai principali data warehouse cloud, database relazionali e object store, tra cui:

* Snowflake
* Google BigQuery
* Databricks
* Amazon Redshift
* PostgreSQL
* MySQL
* ClickHouse
* Amazon S3, Google Cloud Storage e Azure Blob Storage

Se il tuo warehouse non è in elenco, [contatta il nostro team](/docs/it/getting-started/contact-support): aggiungiamo destinazioni nuove regolarmente.

## Come attivarla

L'esportazione al data warehouse viene attualmente abilitata dal team storekit e non dalla dashboard. Per iniziare:

**1. Indicaci la tua destinazione**

[Contatta il nostro team](/docs/it/getting-started/contact-support) indicando il warehouse o il database che usi e la regione in cui è in esecuzione.

**2. Crea le credenziali per storekit**

Ti inviamo una breve guida specifica per la tua destinazione. Copre la creazione di un utente o service account dedicato con accesso in scrittura a un singolo schema o bucket e l'inserimento in allow-list degli indirizzi IP di storekit se il tuo warehouse limita le connessioni in ingresso.

**3. Condividi i dati di connessione**

Ti forniamo un canale sicuro per inserire i dati di connessione; non inviare mai credenziali via email o chat.

**4. Attendi il backfill iniziale**

Una volta connesso, storekit carica l'intera cronologia degli ordini. A seconda del volume ci vogliono da pochi minuti a qualche ora. Dopodiché le sincronizzazioni partono in automatico.

> [!TIP]
>
> Al termine della prima sincronizzazione vedrai le tabelle sopra elencate nello schema che hai fornito; ogni sincronizzazione successiva le aggiorna in place. Per le destinazioni di tipo object store (S3, Google Cloud Storage, Azure Blob Storage) ogni dataset viene scritto invece come una cartella di file nel bucket, e ogni sincronizzazione aggiunge nuovi file.

## Domande frequenti

> **Quanto sono aggiornati i dati?**
>
> Le sincronizzazioni avvengono a intervalli ricorrenti nel corso della giornata, non in tempo reale. Se devi reagire a un ordine nell'istante in cui viene creato — ad esempio per avviare un flusso in cucina — usa i [webhook](/docs/it/developers/webhooks/overview) e riserva il warehouse alla reportistica.

> **Sostituisce i report della dashboard?**
>
> No. I [report della dashboard](/docs/it/guides/reports/overview) restano invariati. L'esportazione è pensata per i team che vogliono unire i dati storekit ad altre fonti, costruire dashboard proprie o conservare un archivio a lungo termine sotto il proprio controllo.

> **Dove si trovano i dati durante la sincronizzazione?**
>
> I dati vengono letti dalla regione in cui risiede il tuo account (vedi [Residenza dei dati](/docs/it/privacy-security/data-residency)) e scritti direttamente sulla tua destinazione. storekit non conserva una copia aggiuntiva dei dati esportati.

> **Posso sincronizzare i dati dal mio warehouse verso storekit?**
>
> No. L'esportazione al data warehouse è unidirezionale, da storekit verso il tuo warehouse. Per modificare menu, stock o impostazioni dello store usa la dashboard o l'[API](/docs/it/developers/api/overview).

> **Cosa succede se una sincronizzazione fallisce?**
>
> Le sincronizzazioni fallite vengono ritentate automaticamente e la successiva esecuzione riuscita riparte da dove si era interrotta l'ultima, quindi nessun dato viene saltato. Se le credenziali vengono revocate o il tuo warehouse resta irraggiungibile per un periodo prolungato, ti contattiamo.

> **C'è un costo aggiuntivo?**
>
> Sì. Il prezzo dipende dal tuo piano e dal volume di dati sincronizzati. [Contatta il nostro team](/docs/it/getting-started/contact-support) per un preventivo per il tuo account.


## Related topics

- [Dati dei clienti](/docs/it/guides/marketing/customer-data.md)
- [Tracciamento eventi](/docs/it/privacy-security/event-tracking.md)
- [Audit log](/docs/it/privacy-security/audit-log.md)
- [Report di vendita e contabilità in storekit](/docs/it/guides/reports/overview.md)
- [Guida al mapping PLU](/docs/it/guides/integrations/pos/advanced/plu-mapping.md)


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