🐻 Admin Fidelity

Connessione...

💳 Cards Importate

carte fidelity

⭐ Punti Totali

punti in circolo

📈 Media Punti

per cliente

🕐 Ultima Sync

🔄 Azioni Sync

🔍 Cerca Cliente

Codice Carta

💰 Gestione Punti

Punti

Nota (opzionale)

⚠️ Attenzione Cassa in Cloud

Lo scarico/carico punti aggiorna automaticamente Firestore e PassKit (carta digitale del cliente).
Per Cassa in Cloud devi aggiornare i punti manualmente dal portale, altrimenti alla prossima sincronizzazione verranno sovrascritti con il valore di Cassa in Cloud.

📜 Ultime Transazioni

Sorgente

Dal

Carta (opzionale)

Data	Codice	Cliente	Tipo	Punti	Nota	Cassa
Carica lo storico...

🎁 Premi richiesti

⚠️ I punti in cassa si tolgono a mano

Quando togli i punti su Cassa in Cloud, spunta “Punti tolti in cassa”.
Finché non lo spunti, l'app e il wallet continuano a mostrare il saldo già senza quei punti, anche dopo la consegna. Se togli i punti in cassa e non spunti, verrebbero sottratti due volte.

📝 Premio chiesto in cassa

Il cliente chiede il premio al banco senza app: registralo qui, così finisce nella stessa lista.

Consegnato subito Punti già tolti in cassa

☑️ Lista premi

Data	Cliente	Premio	Punti	Origine / nota	Consegnato	Punti tolti in cassa
Caricamento…

✅ Conferma Ritiro Manuale

📋 Procedura di ritiro:

Cliente mostra il codice ritiro (PR-XXXXXX-XXXX)
Verifica il premio nella lista sopra
Togli i punti su Cassa in Cloud e spunta “Punti tolti in cassa” nella lista
Inserisci il codice qui sotto e clicca "Conferma Ritiro"
Consegna il premio al cliente

📜 Storico Premi Ritirati

Data Ritiro	Codice	Cliente	Premio	Punti	Locale	Operatore
Carica lo storico...

🔥 Promo attive

Sconti e promozioni per chi ha la carta fedeltà: compaiono nell'app (pulsante "Promo attive") e sulla pagina web della fedeltà. Con le date "dal / al" la promo appare e sparisce da sola. Scrivi **testo** per il grassetto.

🎁 Catalogo premi

Questi premi compaiono nell'app clienti e si possono richiedere. Le modifiche sono visibili ai clienti entro un minuto, senza aggiornare l'app. Togli la spunta "Attivo" per nascondere un premio senza cancellarlo (es. premi stagionali).

Foto	Emoji	Nome	Descrizione	Punti	Attivo	Codice
Caricamento…

📋 Regolamento

Sezioni mostrate nell'app (Fidelity → Regolamento). In fondo l'app aggiunge da sola l'elenco dei premi attivi.

🆕 Crea Nuova Carta Fedeltà

Inserisci i dati del cliente per creare una nuova carta fedeltà. Verrà creata su Cassa in Cloud, PassKit e inviata email con link wallet.

Nome *

Cognome

Email *

Telefono

🎯 Circuito

🏷️ Categoria

📋 Risultato Creazione

📋

Compila il form per creare una nuova carta

➕ Aggiungi Nuova Categoria

Crea una nuova categoria con codice promo. Il tier verrà creato automaticamente su PassKit.

ID Categoria (senza spazi, minuscolo)

Nome Visualizzato

Codice Promo (maiuscolo)

Descrizione

Colore (esadecimale)

📋 Categorie Attive

Lista delle categorie configurate. Clicca 🗑️ per eliminare.

Colore	ID Tier	Nome	Codice Promo	PassKit	Azioni
Carica le categorie...

⚠️ Note Importanti

Aggiungere una categoria crea automaticamente il tier su PassKit
Modificare una categoria aggiorna sia Firestore che PassKit (nome tier)
Eliminare una categoria ti chiede se vuoi eliminare anche su PassKit
I clienti già assegnati a una categoria eliminata manterranno il loro tier su PassKit
Il codice promo deve essere univoco e in maiuscolo
Le categorie base/standard non possono essere eliminate

➕ Aggiungi / Modifica Circuito

Il circuito standard (quello attuale, dal .env) resta il predefinito: i link e QR già in giro, senza ?c=, continuano a iscrivere lì. Ogni circuito nuovo ha il suo circuito + programma punti su Cassa in Cloud e un QR dedicato fide.html?c=<slug>. La card Wallet (PassKit) è la stessa per tutti.

Slug (minuscolo, senza spazi — finisce nel QR)

Nome visualizzato

ID Circuito Cassa in Cloud (idFidelityCircuit)

ID Programma Punti Cassa in Cloud (idFidelityPointsProgram)

🎨 Tier PassKit (grafica card Wallet) — opzionale Assegnato alle carte iscritte da questo QR senza codice promo. Un codice promo valido ha la precedenza. Crea prima il tier nel tab Categorie se non esiste.

🎨 Tema pagina iscrizione — opzionale

Principale · usa Accento · usa

Spunta la casella accanto al colore per usarlo; senza spunta la pagina resta con i colori standard.

Attivo (accetta iscrizioni) Circuito predefinito

🎂 Regalo di compleanno per le carte di questo circuito

Valido per giorni:

Il giorno del compleanno (alle 9) arrivano email di auguri e notifica nell'app con un codice da mostrare in cassa (tab 🎁 Regali per ritirarlo). Con i livelli Orso Fidelity accesi l'omaggio dipende dal livello, salvo i circuiti partner con un regalo proprio. Serve la data di nascita sulla carta.

🔒 Tessera riservata: solo le persone autorizzate Con questa opzione dal QR possono iscriversi solo le persone nell'elenco (pulsante 👥 Autorizzati nella lista a destra), riconosciute da nome e cognome (in qualsiasi ordine, maiuscole o minuscole, con o senza accenti). Ognuno può fare una sola tessera.

🎯 Circuiti configurati

URL base per i QR

⏳ Caricamento...

ℹ️ Se nessun circuito è configurato, le carte vengono create sul circuito delle variabili ambiente (FIDELITY_CIRCUIT_ID / FIDELITY_POINTS_PROGRAM_ID). Le carte esistenti vengono associate al circuito alla prossima sync in base al loro idCircuit.

🎁 Ritira un regalo

Il cliente mostra il codice AUG-XXXXXX ricevuto per email o nell'app.

📅 Compleanni dei prossimi 7 giorni

⏳ Caricamento…

🎂 Regali emessi (compleanni e livelli)

Compleanni: ogni mattina alle 9 chi compie gli anni riceve email (e notifica nell'app) con l'omaggio del suo livello Orso Fidelity, o il regalo del suo circuito se è un circuito partner con regalo proprio (🎯 Circuiti / QR → Modifica). Livelli: chi sale di livello riceve il regalo del nuovo livello (titolo "regalo Orsetto", "regalo Orso"…). Si ritirano tutti con lo stesso codice AUG-XXXXXX.

Cliente	Regalo	Codice	Valido fino	Avviso	Stato

🧪 Test Connessione API Cassa in Cloud

Verifica che le API rispondano correttamente

📤 Export punti da Cassa in Cloud

Una riga per ogni cliente × programma punti con saldo. Serve per fare ordine tra programmi vecchi e nuovi. Le righe evidenziate in giallo hanno punti su un programma diverso da quello del circuito della carta.

includi saldi a zero

📋 Risultati Test

🧪

Clicca "Esegui Test" per verificare le API

👥 Lista Clienti

🎯 Circuiti:

📊 Mostrando 0 clienti

⚠️ Eliminazione Carte

L'eliminazione rimuove la carta da Firestore e PassKit (wallet).
Cassa in Cloud non supporta l'eliminazione via API: devi eliminarla manualmente dal portale MyCassa in Cloud, altrimenti al prossimo sync la carta tornerà.

Codice	Nome	Telefono	Email	Data Creazione	Punti	Azioni
Caricamento...

📝 Log Operazioni

📝

Nessun log disponibile