Importazione Punti Vendita da Cassa in Cloud

Situazione Attuale

Il sistema di gestione punti vendita è già implementato e funzionante. Ora devi importare i punti vendita mancanti da Cassa in Cloud.

Passaggi da Seguire

1. Verifica configurazione API Key

Prima di tutto, assicurati che l’API Key di Cassa in Cloud sia configurata:

1. Accedi all’applicazione
2. Vai su Impostazioni > Generali
3. Verifica che il campo “API Key Cassa in Cloud” sia compilato
4. Se non lo è, inserisci la tua API Key e salva

2. Accedi alla pagina Punti Vendita

1. Vai su Impostazioni > Punti Vendita
2. Vedrai la lista dei punti vendita attualmente configurati

3. Sincronizza i punti vendita

Nella pagina Punti Vendita troverai una card chiamata “Sincronizzazione Punti Vendita”:

1. La card mostrerà quanti punti vendita sono disponibili su Cassa in Cloud
2. Clicca sul pulsante “Sincronizza Punti Vendita”
3. Attendi il completamento dell’operazione
4. Riceverai un messaggio con:
   • Numero di punti vendita creati (nuovi)
   • Numero di punti vendita aggiornati (già esistenti)

4. Verifica i risultati

Dopo la sincronizzazione:

1. Ricarica la pagina
2. Dovresti vedere tutti i punti vendita da Cassa in Cloud nella lista
3. Ogni punto vendita mostrerà:
   • Nome
   • Indirizzo
   • Stato (attivo/inattivo)
   • ID Cassa in Cloud (collegamento)

5. Personalizza i punti vendita

Per ogni punto vendita puoi:

1. Cliccare sull’icona matita per modificarlo
2. Aggiungere:
   • Logo e immagine di copertina
   • Icona personalizzata
   • Orari di apertura dettagliati
   • Informazioni di contatto (email, telefono, sito web)
   • Social media
   • Note
3. Impostare come punto vendita primario (⭐)
4. Abilitare/disabilitare consegna a domicilio e ritiro

Script di Verifica (Opzionale)

Se preferisci verificare prima dalla command line quali punti vendita verranno importati:

node scripts/check-missing-outlets.js

⚠️ Nota: Questo script richiede che l’API Key sia configurata nel database (tramite l’interfaccia web).

Cosa Succede Durante la Sincronizzazione

1. L’applicazione si connette a Cassa in Cloud con la tua API Key
2. Recupera la lista di tutti i punti vendita con licenza attiva
3. Per ogni punto vendita:
   • Se non esiste nel database → viene creato
   • Se esiste già (stesso cassaincloud_id) → viene aggiornato con i dati più recenti
4. Previene automaticamente i duplicati usando il campo cassaincloud_id

Utilizzo dei Punti Vendita

Una volta importati, potrai usare i punti vendita in:

Report Finanziari

• Vai su Report > Report Finanziari
• Seleziona un punto vendita dal menu a tendina
• Visualizza i dati filtrati solo per quel punto vendita

Vendite e Incassi

• I dati da Cassa in Cloud verranno automaticamente filtrati per punto vendita
• Potrai analizzare le performance di ogni outlet separatamente

Dashboard

• Le metriche verranno calcolate considerando tutti i punti vendita o un singolo outlet selezionato

Troubleshooting

”API Key di Cassa in Cloud non configurata”

Soluzione: Vai su Impostazioni > Generali e inserisci l’API Key

”Nessun punto vendita disponibile”

Possibili cause:

• Non ci sono punti vendita con licenza attiva su Cassa in Cloud
• Problemi di connessione con Cassa in Cloud
• API Key non valida

Soluzione: Verifica su Cassa in Cloud che ci siano punti vendita attivi

Vedo duplicati

Soluzione:

1. Identifica quale ha il campo “ID Cassa in Cloud”
2. Elimina quello senza ID
3. Risincronizza

Documentazione Aggiuntiva

• GESTIONE_PUNTI_VENDITA.md - Guida utente completa
• OUTLETS_INTEGRATION.md - Documentazione tecnica

Prossimi Passi

Dopo aver importato i punti vendita:

1. ✅ Personalizza ogni outlet con logo e informazioni
2. ✅ Imposta il punto vendita primario
3. ✅ Configura gli orari di apertura
4. ✅ Usa i filtri nei report per analizzare le performance per outlet
5. ✅ Configura eventuali integrazioni aggiuntive (WooCommerce, ecc.)

Supporto

Per qualsiasi problema, verifica:

1. Che l’API Key sia configurata correttamente
2. Che ci sia connessione a Internet
3. I log dell’applicazione (Console del browser)