Supporto Tecnico e Manuali

Centro di Supporto Key to Retail

Modulo KFE — Key Front End (cassa / POS)

Apertura della Cassa e Accesso (Login)

Questo modulo descrive le procedure per avviare la sessione di lavoro sulla cassa, effettuare l'accesso ed eseguire la dichiarazione del fondo cassa iniziale (Apertura Cassa).

---

1. Accesso alla Cassa (Login)

L'operatore deve identificarsi per iniziare a lavorare.

Procedura di Accesso:

1. Accendere lo schermo di cassa. La schermata di login sarà visualizzata a tutto schermo.

2. Identificarsi tramite uno dei metodi configurati:

  • Badge Operatore: Scansionare il codice a barre del proprio badge personale con il lettore ottico. Questo effettua l'accesso immediato (Login automatico).
  • Codice e Password: Digitare a schermo il proprio codice operatore, inserire la password sul tastierino e premere Accedi.

---

2. Dichiarazione del Fondo Cassa (Apertura Giornaliera)

Se la cassa è stata chiusa regolarmente la sera precedente, al primo accesso operatore della giornata il sistema richiede obbligatoriamente l'inserimento dell'importo iniziale presente nel cassetto portamonete.

Procedura di Apertura:

1. All'apparire della schermata Apertura Cassa, contare fisicamente le monete e le banconote presenti nel cassetto cassa.

2. Inserire il totale contato (es: 100,00) nel campo dell'importo di apertura.

3. Premere il pulsante Conferma Apertura per sbloccare la cassa e accedere alla schermata principale di vendita.

Regole Operative del Sistema:
  • Visualizzazione Ultimo Saldo: Se configurato, la schermata di apertura mostra l'importo contanti registrato all'ultima chiusura per facilitare il controllo di quadratura.
  • Apertura Forzata: Se configurato in modalità blindata, l'importo viene impostato automaticamente pari all'ultimo valore di chiusura e non è modificabile dall'operatore.

---

3. Gestione dei Blocchi all'Avvio

La cassa effettua un controllo sullo stato del periodo di lavoro precedente prima di consentire l'apertura.

Blocco: "Chiusura Fiscale Obbligatoria"
  • Condizione: Il sistema rileva che l'ultima operazione registrata è un'apertura risalente a un giorno precedente e che non è stata eseguita la chiusura fiscale Z ieri sera.
  • Comportamento della Cassa: Il sistema impedisce la vendita e indirizza automaticamente l'operatore alla schermata di chiusura.
  • Risoluzione: L'operatore deve eseguire la Chiusura Fiscale Giornaliera per azzerare la stampante, dopodiché potrà procedere ad effettuare la normale apertura inserendo il fondo cassa di oggi.

---

Chiusura di Fine Giornata e Operazioni di Cassetto

Questo modulo descrive le procedure di cassetto (prelievi e versamenti di contante intermedi), la chiusura del POS bancario e la procedura di Chiusura Fiscale Giornaliera (Chiusura Z) al termine del turno o della giornata lavorativa.

---

1. Movimenti di Cassa (Prelievi e Versamenti)

Durante la giornata, l'operatore può registrare entrate o uscite di contanti per motivi diversi dalle vendite.

A. Registrare un Prelievo (Uscita Cassa)

Questa operazione serve per rimuovere denaro dal cassetto (ad esempio, per versarlo nella cassaforte principale del negozio o per acquisti urgenti).

1. Premere il tasto Prelievo / Versamento e selezionare Prelievo.

2. Digitare l'importo che si sta prelevando dal cassetto portamonete.

3. Selezionare la Causale corretta (es: "Verso Cassaforte").

4. Premere Conferma. La cassa stamperà due copie della distinta cartacea dell'operazione. Firmarle e riporle nel cassetto.

⚠ Attenzione

Blocco per Cassa Insufficiente: Se la cassa è configurata per controllare i saldi reali del cassetto e si digita un importo superiore ai contanti registrati in quel momento, il sistema bloccherà il prelievo mostrando il messaggio: Attenzione ... non è possibile prelevare più del contenuto del cassetto..

B. Registrare un Versamento (Entrata Cassa)

Questa operazione serve per inserire denaro nella cassa (ad esempio, fondo cassa aggiuntivo per i resti).

1. Premere il tasto Prelievo / Versamento e selezionare Versamento.

2. Digitare l'importo inserito nel cassetto.

3. Selezionare la causale e confermare.

---

2. Chiusura del Terminale POS (Carte)

Prima di chiudere la cassa fiscale, occorre effettuare l'azzeramento delle transazioni elettroniche:

1. Premere il pulsante Chiusura POS sullo schermo di cassa.

2. La cassa invia il comando di chiusura al lettore carte di credito collegato.

3. Il lettore eseguirà la chiusura contabile giornaliera ed emetterà uno scontrino cartaceo di riepilogo delle transazioni elettroniche. Controllare che l'operazione sia andata a buon fine.

---

3. Chiusura Fiscale Giornaliera (Chiusura Z)

La chiusura Z azzera i totalizzatori giornalieri della stampante fiscale e trasmette telematicamente i corrispettivi all'Agenzia delle Entrate.

Procedura operativa:

1. Premere il pulsante Chiusura Cassa e selezionare Chiusura Fiscale (Z).

2. Si aprirà la schermata per il conteggio dei contanti (Distinta Monete):

  • Contare fisicamente il denaro presente all'interno del cassetto portamonete suddiviso per tagli (es. quante banconote da 20€, monete da 2€, ecc.).
  • Digitare le quantità contate nelle rispettive caselle a schermo. Il sistema calcola automaticamente il totale contanti dichiarato.

3. Premere Conferma Chiusura.

4. Azioni Automatiche del Sistema:

  • La stampante fiscale esegue l'azzeramento Z e stampa lo scontrino di chiusura fiscale telematico.
  • La cassa stampa due copie non fiscali della distinta finanziaria di quadratura (mostrando venduto totale, pagamenti elettronici dichiarati e riscontrati, versamenti/prelievi e delta).
  • La sessione di cassa viene chiusa e l'applicazione torna alla schermata di login.

---

4. Gestione di Messaggi e Avvisi di Stampa

  • Avviso: "Carta in Esaurimento" o "Carta Esaurita":
  • La stampante rileva la fine o la prossimità della fine del rotolo di carta termica.
  • In caso di carta esaurita, la stampante si arresta e la cassa blocca l'operatività.
  • Soluzione: Sostituire il rotolo termico nella stampante e premere Ripristina Stampa. La stampante riprenderà l'emissione del documento interrotto.
  • Avviso: "Il cassetto elettronico non ha risposto":
  • Se si utilizza un cassetto elettronico blindato per il contante e questo non risponde entro il tempo limite (timeout) o risponde con un errore, la cassa mostra una notifica per avvisare il cassiere, ma consente comunque di proseguire e chiudere la vendita per non bloccare il servizio al cliente.

---

Consegna E-commerce Click & Collect in Cassa

Questo modulo descrive la procedura che il cassiere deve seguire quando un cliente si presenta al punto cassa per ritirare un ordine acquistato online (servizio Click & Collect).

---

1. Ritiro dell'Ordine Click & Collect

Gli ordini Click & Collect gestibili in cassa sono già stati pagati online dal cliente (importo dovuto in cassa pari a 0,00€). La cassa funge da punto di verifica e sblocco della consegna.

Procedura Operativa:

1. Nella schermata principale di cassa, premere il pulsante Click & Collect (o Servizi E-commerce).

2. Ricerca Ordine: Ricercare l'ordine del cliente inserendo il Numero Ordine o digitando parte del Nome Cliente nel campo di ricerca.

3. Il sistema mostrerà a video i dettagli dell'ordine e il numero di pacchi che lo compongono.

4. Lettura Barcode Pacco: Prelevare fisicamente i pacchi dall'area di stoccaggio del negozio e scansionare il codice a barre stampato su ciascun pacco (Parcel Code).


flowchart TD
    Start([Cliente chiede ritiro Click & Collect]) --> OpenMenu[Apri Menù Click & Collect in cassa]
    OpenMenu --> SearchOrder[Ricerca ordine per Numero o Nome]
    SearchOrder --> ScanParcel[Scansiona codice a barre del pacco]
    ScanParcel --> VerifyParcel{Verifica pacco in cassa}
    VerifyParcel -- Già consegnato --> ErrorAlreadyDelivered[Errore: Pacco già consegnato. Consegna bloccata.]
    VerifyParcel -- Store errato o inesistente --> ErrorStore[Errore: Il pacco non appartiene a questo negozio.]
    VerifyParcel -- Validato --> AddReceipt[Aggiunge pacco allo scontrino attivo]
    AddReceipt --> CheckAllParcels{Tutti i pacchi dell'ordine sono stati letti?}
    CheckAllParcels -- No --> ScanParcel
    CheckAllParcels -- Sì --> AutoAddVirtual[KFE inserisce l'articolo virtuale non fiscale con importo zero]
    AutoAddVirtual --> PrintSlip[Chiudi lo scontrino e stampa la ricevuta non fiscale di consegna]
    PrintSlip --> Done([Consegna Consolidata ed inviata a KBE/Cloud])
Regole Operative del Sistema:
  • Controllo Duplicati: Se il codice a barre di un pacco scansionato è già presente nello scontrino corrente, la cassa mostra l'avviso: Attenzione ... il pacco rilevato è già presente sullo scontrino..
  • Controllo Stato Consegna: Se il pacco risulta già consegnato, il sistema blocca l'operazione visualizzando l'avviso: Attenzione ... il pacco che hai selezionato risulta già consegnato al cliente!!!.
  • Scontrino di Consegna (Firma Ritiro): Una volta scansionati tutti i pacchi che compongono l'ordine, KFE inserisce in automatico nel carrello un articolo virtuale non fiscale (es: "ORDINE: 12345") con valore pari a 0,00€. Il cassiere chiude lo scontrino premendo il tasto Contanti / Chiudi (senza incassare denaro). La stampante emetterà uno scontrino non fiscale che serve come ricevuta di avvenuta consegna, e KFE invierà lo stato di "Consegnato" al database cloud per aggiornare la scheda d'ordine.

---

2. Notifiche Pick From Store (Ordini da Preparare)

La cassa funge anche da centro di allerta per lo staff del negozio in merito agli ordini che devono essere preparati prelevando le merci direttamente dagli scaffali (Pick from Store).

  • Indicatore a Schermo: Sullo schermo di cassa è presente un badge grafico con l'icona e-commerce e un contatore numerico (es: un bollino rosso con il numero 3).
  • Significato: Il contatore indica il numero di ordini Pick from Store pendenti assegnati a quel negozio che sono ancora in attesa di essere prelevati dagli scaffali e che si stanno avvicinando alla scadenza del ritiro.
  • Azione del Cassiere: All'apparire della notifica, il personale deve avvisare gli addetti al prelievo o utilizzare il palmare per avviare la preparazione dell'ordine, evitando ritardi nella spedizione.

---

Gestione dello Scontrino (Composizione del Carrello)

Questo modulo descrive le procedure per inserire i prodotti nello scontrino, gestire le quantità, applicare sconti, variazioni di prezzo e omaggi, ed eseguire storni o annullamenti durante la fase di vendita.

---

1. Aggiunta Prodotti

I prodotti possono essere inseriti nello scontrino in cassa attraverso diverse modalità operative:

A. Scansione Barcode (Laser)
  • Passare il codice a barre dell'articolo davanti al lettore laser di cassa. L'articolo viene aggiunto a schermo con quantità 1.
  • Codici a barre confezione: Se si scansiona un codice a barre associato a un imballo multiplo (es. confezione intera da 6 bottiglie), la cassa converte la lettura aggiungendo l'articolo singolo moltiplicato per la quantità indicata nella confezione (es. 6 articoli singoli).
B. Inserimento Manuale Codice
  • Digitare il codice a barre o il codice articolo gestionale tramite il tastierino numerico della cassa e premere Invio o il pulsante di inserimento a schermo.
C. Ricerca Prodotto a Video
  • Premere il pulsante Cerca Prodotto a schermo, digitare una parola contenuta nella descrizione e selezionare l'articolo corretto dall'elenco dei risultati.
D. Articoli a Peso (Ortofrutta / Macelleria)
  • Scansionando il barcode stampato dall'etichettatrice della bilancia, la cassa riconosce la natura pesata del prodotto ed estrae dal codice sia l'identificativo dell'articolo che il prezzo finale calcolato in base al peso. L'articolo viene aggiunto con la quantità decimale corretta.

---

2. Variazione della Quantità (Moltiplicatore)

  • Per vendere più pezzi dello stesso prodotto: digitare la quantità desiderata sul tastierino (es: 5), premere il tasto Quantità (X) e scansionare il prodotto. Il sistema calcolerà il prezzo totale riga moltiplicato per 5.

---

3. Applicazione degli Sconti di Riga

Il cassiere può applicare uno sconto personalizzato (sconto di riga) in percentuale (%) o in euro (€):

Modalità A (Sconto preventivo):

1. Digitare il valore dello sconto (es. 10 per il 10% o 3 per 3,00€).

2. Premere il tasto Sconto % o Sconto €. Il modificatore a schermo si attiva.

3. Scansionare o inserire l'articolo. Lo sconto viene calcolato e applicato immediatamente a quella riga.

Modalità B (Sconto su riga esistente):

1. Selezionare l'articolo già presente a schermo toccando la riga corrispondente.

2. Premere il tasto Modifica Riga / Sconto.

3. Inserire il valore dello sconto e confermare.

⚠ Attenzione

Articoli bloccati (Non Scontabili): Se un articolo è impostato nel database come non scontabile, qualsiasi tentativo di applicarvi uno sconto mostrerà l'avviso: Attenzione ... l'articolo [Nome] non può essere scontato. e l'articolo verrà inserito a prezzo pieno.

---

4. Prezzo Manuale e Articoli in Omaggio

  • Prezzo Manuale: Permette di digitare manualmente il prezzo di vendita per un articolo specifico (es. per articoli senza prezzo o danneggiati). Selezionare la riga, premere Prezzo Manuale, inserire il prezzo concordato e confermare. Questa operazione può richiedere l'autorizzazione di un responsabile.
  • Articolo in Omaggio: Selezionare la riga e premere il tasto Omaggio (Free Item). Il prezzo finale della riga verrà impostato a 0,00€ con l'indicazione di omaggio fiscale.

---

5. Correzione di Errori (Storno e Annullamento)

Se si commette un errore durante la composizione dello scontrino (prima del pagamento):

  • Storno di una Riga (Cancella Riga): Se si desidera rimuovere un singolo articolo inserito per errore, selezionare la riga del prodotto a schermo e premere il pulsante Cancella Riga. L'articolo verrà rimosso e il totale ricalcolato.
  • Annullamento Scontrino: Per svuotare completamente il carrello e ricominciare da capo, premere il pulsante rosso ANNULLA SCONTRINO. Tutti gli articoli verranno cancellati a video e la cassa tornerà allo stato iniziale.

---

6. Assegnazione Venditore

Se richiesto per scopi di provvigione o tracciamento interno:

  • Premere il pulsante Seleziona Venditore prima di registrare gli articoli per associare l'intera vendita a un operatore specifico del negozio, oppure selezionare una singola riga per assegnare solo quell'articolo a un venditore dedicato.

---

Chiusura Scontrino, Pagamenti e Stampa

Questo modulo descrive come visualizzare il totale, applicare i pagamenti (inclusi i pagamenti misti), gestire il resto e procedere alla stampa dello scontrino fiscale o di cortesia.

---

1. Subtotale e Calcolo Promozioni

Prima di procedere al pagamento, sono disponibili due opzioni per verificare l'importo dello scontrino:

  • Subtotale: Premendo il tasto Subtotale, la cassa visualizza l'importo parziale calcolato fino a quel momento senza bloccare lo scontrino (puoi continuare ad aggiungere articoli).
  • Totale (Fine Vendita): Premendo il tasto Totale, la cassa blocca la modifica degli articoli e richiama il motore promozionale. In questa fase il sistema calcola automaticamente tutti gli sconti speciali di fine scontrino (es. sconti a paniere, offerte 3x2, sconti speciali fedeltà). A schermo viene mostrato il Totale Netto da Pagare.

---

2. Metodi di Pagamento

La cassa supporta pagamenti singoli o frazionati (pagamenti misti). È possibile inserire più metodi di pagamento fino a coprire l'intero importo dello scontrino.

A. Pagamento in Contanti (Cassetto Standard)

1. Digitare l'importo consegnato fisicamente dal cliente (es: scontrino di 18,00€, il cliente consegna 20,00€, digiti 20,00).

2. Premere il tasto Contanti.

3. Il sistema calcolerà il resto da consegnare, lo mostra a schermo (es: Resto: 2,00€) e apre automaticamente il cassetto portamonete fisico.

A.1 Pagamento con Cassetto Automatico / Cassetto Elettronico (KED)

Se il punto vendita è dotato di una cassa con cassetto automatico/intelligente per contanti (gestito dal servizio KED):

1. Premere il tasto Contanti. Il sistema abilita la cassa automatica e blocca la tastiera.

2. Il cliente inserisce le banconote o le monete direttamente nelle fessure della macchina, che effettua il conteggio automatico del denaro in tempo reale.

3. Calcolo e Dispense Resto: Una volta coperto l'importo totale dello scontrino, la macchina eroga automaticamente il resto esatto in monete e banconote. La cassa chiude lo scontrino contabile e avvia la stampa fiscale.

4. Annullamento Transazione: Se il cliente cambia metodo di pagamento durante l'inserimento del contante, il cassiere può premere Annulla Transazione Cassetto. La cassa comanda al cassetto automatico di restituire l'intero importo inserito fino a quel momento e riabilita la scelta dei pagamenti in cassa.

5. Gestione del Cassetto Elettronico (Menù Manager): I responsabili possono accedere al pannello Gestione Cassetto per effettuare operazioni di versamento contante iniziale (fondo cassa), prelievo per svuotamento parziale/totale (scatola di scarto) o verifica dello stato dei sensori e capacità dei cassetti.

B. Pagamento con Carte di Credito e Debito (POS)

1. Premere il tasto Carta / POS.

2. La cassa invia l'importo esatto direttamente al lettore POS collegato sul banco cassa.

3. Chiedere al cliente di avvicinare o inserire la carta.

4. Attesa Esito:

  • Approvato: La cassa riceve il segnale di transazione eseguita, registra i dettagli dell'autorizzazione elettronica e procede a stampare automaticamente lo scontrino fiscale.
  • Rifiutato: Il lettore segnala l'errore (fondi insufficienti, PIN errato, ecc.). La cassa torna alla schermata dei pagamenti consentendo di selezionare un'altra modalità di pagamento.
C. Pagamento con Buoni Pasto e Coupon

1. Premere il tasto Buono / Coupon.

2. Scansionare con il lettore barcode il codice stampato sul buono sconto o sul buono pasto (cartaceo o digitale).

3. Il sistema verifica la validità del codice in tempo reale e detrae l'importo dal totale da pagare.

D. Utilizzo di Gift Card (Carta Regalo)

1. Premere il tasto Gift Card.

2. Scansionare il codice a barre della carta regalo.

3. Il sistema rileva il saldo della carta:

  • Se il saldo copre interamente la spesa, lo scontrino viene finalizzato.
  • Se il saldo è inferiore, la cassa consuma l'intero importo della carta regalo e lascia lo scontrino aperto per la riscossione della quota rimanente con un altro metodo.

---

3. Rimozione di una Forma di Pagamento Errata

Se si seleziona per errore un metodo di pagamento (es. si preme contanti anziché bancomat) e lo scontrino non è ancora stampato:

1. Premere il tasto Annulla Pagamento o Reset Pagamento.

2. Selezionare dall'elenco a video il pagamento inserito erroneamente e confermare la rimozione. Il totale da pagare verrà ripristinato.

---

4. Stampa dello Scontrino di Cortesia (Regalo)

Se il cliente deve fare un regalo e richiede uno scontrino senza i prezzi per permettere al destinatario un eventuale cambio merce:

1. Subito prima della chiusura dello scontrino o dopo la stampa del fiscale (in base alle impostazioni del negozio), premere il pulsante Scontrino di Cortesia (o Scontrino Regalo).

2. La stampante emetterà un documento non fiscale con la lista degli articoli e un codice a barre per il reso, privo di qualsiasi importo in euro.

---

Manuale Operativo di Cassa - KFE (Key Front End)

Benvenuto nel Manuale Operativo di Cassa per la suite KFE (Key Front End).

Questo manuale è progettato per gli operatori di cassa (cassieri) e i responsabili di negozio. Descrive le procedure quotidiane, le regole del sistema e i comportamenti a schermo per assistere il lavoro quotidiano sul punto vendita.

---

Indice dei Contenuti

1. [Apertura e Login](file:///c:/KSolution/KFE/Manuale/Apertura_e_Login.md): Come accedere al sistema e dichiarare il fondo cassa iniziale.

2. [Gestione dello Scontrino](file:///c:/KSolution/KFE/Manuale/Gestione_Scontrino.md): Aggiunta di prodotti, variazione di quantità, sconti di riga, articoli in omaggio e storno di articoli o scontrini.

3. [Pagamenti e Stampa](file:///c:/KSolution/KFE/Manuale/Pagamenti_e_Stampa.md): Passaggio a totale, calcolo sconti, pagamenti misti (contanti, pos, buoni), gestione del resto e scontrino di cortesia.

4. [Sospensione e Ripristino](file:///c:/KSolution/KFE/Manuale/Sospensione_e_Ripristino.md): Come sospendere uno scontrino temporaneamente per servire un altro cliente e riprenderlo in seguito.

5. [Resi e Storni Fiscali](file:///c:/KSolution/KFE/Manuale/Resi_e_Storni_Fiscali.md): Annullamento di scontrini errati emessi in giornata, reso di articoli con scontrino originale e resi liberi senza scontrino.

6. [Consegna E-commerce Click & Collect](file:///c:/KSolution/KFE/Manuale/Consegna_Ecommerce_Click_and_Collect.md): Consegna in cassa di ordini acquistati online, lettura dei colli e notifica per la preparazione degli ordini (Pick from Store).

7. [Chiusura di Fine Giornata](file:///c:/KSolution/KFE/Manuale/Chiusura_e_Fine_Giornata.md): Movimenti di cassa (prelievi/versamenti), azzeramento pos e procedura di Chiusura Fiscale Z con quadratura contante.

---

Resi, Rimborsi e Annullamento Scontrini (Storni Fiscali)

Se viene rilevato un errore dopo che lo scontrino fiscale è già stato stampato, o se un cliente richiede la restituzione di un prodotto acquistato, la cassa KFE dispone di procedure guidate per gestire lo storno (annullamento fiscale) o il reso merce.

---

1. Annullamento Scontrino Emesso (Storno Fiscale)

Questa procedura serve per annullare completamente uno scontrino errato stampato per sbaglio.

Procedura operativa:

1. Premere il tasto Annulla Scontrino Emesso (o Storno Fiscale).

2. Scansionare il codice a barre stampato in fondo allo scontrino fiscale che si desidera annullare, oppure digitare a schermo il numero dello scontrino.

3. Il sistema recupera i dettagli dello scontrino e li mostra a schermo.

4. Premere Conferma Annullamento (Void Confirm).

5. La stampante emetterà un documento di Annullamento Fiscale dello Scontrino. Graffettare lo scontrino originale errato insieme allo scontrino di storno e riporli nella cassa.

⚠ Attenzione

Regole di Controllo del Sistema:

  • Controllo Data: Il sistema consente di annullare fiscalmente uno scontrino solo se è stato emesso nella giornata odierna. In caso contrario, il sistema blocca l'operazione mostrando l'errore: Impossibile annullare uno scontrino fatto in una giornata differente da quella odierna. (in questo caso andrà eseguito un Reso Merce).
  • Fattura Fiscale: Se lo scontrino è già stato trasformato in fattura o fattura diretta, il sistema impedisce l'annullamento mostrando l'avviso: Attenzione ... lo scontrino è stato trasformato in fattura e non è possibile effettuare l'annullo..

---

2. Reso Articolo con Scontrino Originale

Da utilizzare quando il cliente restituisce un prodotto acquistato nei giorni precedenti ed è in possesso dello scontrino fiscale originale.

Procedura operativa:

1. Premere il tasto Reso da Scontrino.

2. Scansionare il codice a barre stampato sullo scontrino originale (o digitarlo).

3. Sullo schermo appare l'elenco dei prodotti acquistati in quello scontrino.

4. Selezionare i prodotti che il cliente sta restituendo e indicare la quantità resa.

5. Premere Conferma Reso.

6. I prodotti selezionati verranno inseriti a schermo nello scontrino corrente con quantità e prezzo negativi (es: -1 pezzo, -15,00€).

7. Procedere in uno dei seguenti modi:

  • Compensazione: Scansionare i nuovi prodotti che il cliente intende acquistare in sostituzione. La cassa calcolerà la differenza da riscuotere (o da rimborsare).
  • Rimborso: Se il totale rimane negativo, procedere alla chiusura per emettere un rimborso contanti o un buono spesa.

---

3. Reso Libero (Senza Scontrino)

Da utilizzare solo se autorizzati, quando il cliente non possiede lo scontrino fiscale originale.

Procedura operativa:

1. Premere il tasto Reso Libero (o Reso Senza Scontrino).

2. Scansionare o cercare il prodotto restituito dal cliente.

3. L'articolo viene aggiunto nel carrello corrente con quantità negativa (-1).

4. Procedere al pagamento o alla compensazione della transazione.

---

Sospensione e Ripristino dello Scontrino

Durante il lavoro in cassa, può presentarsi la necessità di interrompere temporaneamente una vendita (ad esempio, se il cliente ha dimenticato la borsa in auto o desidera recuperare un prodotto dimenticato sullo scaffale).

Per evitare di bloccare il punto cassa e far attendere gli altri clienti, è possibile sospendere lo scontrino in corso per poi ripristinarlo e completarlo in un secondo momento.

---

1. Come Sospendere lo Scontrino (Congelamento)

Se si ha uno scontrino avviato con uno o più prodotti inseriti a schermo:

1. Premere il pulsante Sospendi Scontrino (o Sospendi).

2. Lo scontrino sparisce dallo schermo di cassa.

3. La cassa torna immediatamente libera (carrello vuoto) ed è pronta per registrare le spese dei clienti successivi.

Nota

Il sistema salva internamente tutti gli articoli dello scontrino sospeso, compresi sconti di riga già calcolati e l'eventuale tessera fedeltà del cliente associata, senza stampare alcun documento fiscale.

---

2. Come Ripristinare lo Scontrino (Richiamo)

Quando il cliente ritorna alla cassa per pagare la sua spesa sospesa:

1. Premere il pulsante Richiama Scontrino (o Ripristina).

2. Sullo schermo apparirà un elenco di tutti gli scontrini sospesi sulla cassa corrente, identificabili da:

  • Ora di creazione / sospensione.
  • Numero di prodotti inseriti.
  • Importo totale provvisorio.
  • Nome del cliente (se era stata scansionata la carta fedeltà).

3. Selezionare lo scontrino corretto dall'elenco toccandolo a schermo.

4. Premere Conferma Ripristino.

5. Lo scontrino viene ricaricato a video esattamente nello stato in cui era stato congelato.

6. A questo punto è possibile aggiungere altri articoli, rimuoverne di esistenti o procedere direttamente alla chiusura del pagamento.

---

Nessun risultato per la ricerca.

Modulo KBE — Key Back End (back-office gestionale)

Gestione Anagrafiche Clienti e Campagne Fedeltà (Fidelity)

Questo modulo descrive le procedure per inserire e modificare le schede anagrafiche dei clienti, gestire le tessere fedeltà (Fidelity Card), monitorare i saldi punti/bollini e impostare le regole per la conversione dei punti in buoni sconto (Cashback).

---

1. Registrazione Nuovi Clienti (Anagrafica)

Per associare gli acquisti a un cliente specifico ed emettere tessere promozionali, occorre registrarlo nel sistema:

Procedura di Inserimento Cliente:

1. Accedere a Anagrafiche -> Clienti.

2. Premere Nuovo Cliente.

3. Compilare le informazioni richieste:

  • Dati Personali: Cognome, Nome, Data di Nascita.
  • Contatti: Telefono, Email (fondamentali per invio promozioni).
  • Dati di Fatturazione: Codice Fiscale (o Partita IVA e Ragione Sociale se si tratta di un'azienda).

4. Consenso Privacy: Spuntare le caselle relative al consenso per la privacy e la profilazione commerciale (fondamentali per le normative vigenti).

5. Selezionare la Categoria Cliente (es: "Standard", "Dipendente", "Rivenditore"). Questo assegna automaticamente al cliente listini prezzi o sconti dedicati in cassa.

6. Premere Salva.

---

2. Associazione Tessera Fedeltà (Fidelity Card)

  • Nuova Tessera: Nella scheda del cliente creato, posizionarsi sul campo Codice Card / Codice Fidelity.
  • Scansionare il codice a barre di una tessera plastica vuota con il lettore ottico oppure digitare il codice manualmente.
  • Salvare la scheda. Da questo momento, quando il cassiere scansiona quella tessera al punto vendita, la cassa riconoscerà automaticamente il cliente.

---

3. Gestione Saldo Punti e Campagna Bollini

Il sistema aggiorna in tempo reale i saldi accumulati dai clienti durante gli acquisti:

  • Consulta Saldo Punti: Ricercare il cliente per nome o codice tessera per visualizzare il saldo punti attivo e lo storico dei punti accumulati e spesi.
  • Rettifica Saldo (Operazioni di Ufficio): In caso di errore (es. scontrino battuto per errore senza tessera fedeltà), il manager può inserire una Rettifica Punti o Rettifica Bollini, inserendo il numero di punti da aggiungere o sottrarre e inserendo una nota giustificativa.
  • Campagne a Bollini: Utilizzate per raccolte premi specifiche. KBE permette di verificare quanti bollini elettronici il cliente ha accumulato e quanti ne ha riscossi per ritirare i premi fisici nel punto vendita.

---

4. Cashback e Rimborso Punti

Il sistema permette al cliente di convertire i punti accumulati in sconti immediati sulla spesa (Cashback).


flowchart TD
    Start([Cliente chiede di usare i punti]) --> CheckPoints[Il cassiere verifica il saldo punti del cliente]
    CheckPoints --> MinPoints{Ha raggiunto la soglia minima es: 1000 punti?}
    MinPoints -- No --> Reject[Soglia non raggiunta. Continua accumulo]
    MinPoints -- Sì --> SelectRedeem[Seleziona quantità punti da convertire]
    SelectRedeem --> CalcDiscount[Il sistema converte i punti in sconto es: 1000pt = 10€]
    CalcDiscount --> Apply[Lo sconto viene applicato come forma di pagamento]
    Apply --> DeductBalance[I punti riscossi vengono detratti dal saldo del cliente]
Regole di Funzionamento:
  • Soglie di Conversione: Configurate dal portale KBE (es. 500 punti = 5,00€, 1000 punti = 10,00€).
  • Riscatto in Cassa: Il cassiere, in fase di totale pagamento, seleziona il pagamento "Punti Fidelity". La cassa scala i punti dal profilo del cliente e applica il corrispondente sconto in euro. Il portale KBE registra la transazione di rimborso per i controlli amministrativi di fine mese.

---

Configurazione Promozioni, Coupon e Gift Card

Questo modulo descrive le procedure per impostare le campagne promozionali (prezzi speciali, offerte NxM, panieri), generare in blocco coupon sconto e gestire l'emissione e il saldo delle Gift Card.

---

1. Creazione di una Campagna Promozionale

KBE invia automaticamente le promozioni attive a tutte le casse collegate del punto vendita.

Procedura per creare una Promozione:

1. Accedere a Gestione -> Promozioni.

2. Premere Nuova Promozione.

3. Definire i parametri fondamentali:

  • Periodo di Validità: Inserire la data e ora di inizio e di fine della campagna.
  • Stato: Impostare su "Attiva".
  • Tipologia Offerta: Selezionare il tipo di promozione desiderato (vedi elenco sotto).

4. Associare i prodotti in promozione:

  • Aggiungere i codici a barre o selezionare intere categorie di prodotti (es: "Ortofrutta", "Reparto Colazione").

5. Salvare la promozione. Il sistema invierà l'offerta alle casse che la applicheranno in automatico al momento del pagamento.

---

2. Tipologie di Promozione Supportate

  • Taglio Prezzo: Riduce il prezzo di vendita di un articolo a un valore fisso o applica una percentuale di sconto fissa (es: sconto del 20% su tutti i biscotti).
  • Offerte NxM (es. 3x2): Permette di vendere un gruppo di prodotti regalando il meno caro (es: prendi 3 articoli, ne paghi solo 2).
  • Paniere (Basket Promotion): Consente di applicare un prezzo fisso se il cliente acquista una combinazione di articoli diversi (es: 1 pacco di pasta + 1 sugo + 1 bottiglia d'acqua a soli 3,50€).
  • Sconto su Totale: Applica uno sconto in percentuale o euro se lo scontrino supera una determinata soglia di spesa (es: ricevi 5,00€ di sconto su una spesa minima di 50,00€).
  • Articolo Omaggio: Consente di regalare un prodotto a fronte dell'acquisto di un altro articolo (es: compra un profumo, ricevi il bagnoschiuma in omaggio).

---

3. Generazione e Gestione dei Coupon (Buoni Sconto)

I coupon sono codici promozionali monouso che danno diritto a uno sconto in euro o percentuale.

Come creare una campagna Coupon:

1. Accedere a Gestione -> Serie Coupon.

2. Definire le regole della campagna (es: valore del buono, scadenza, se è cumulabile con altre promozioni).

3. Utilizzare il generatore integrato per creare in blocco un elenco di codici a barre univoci.

4. I codici generati possono essere stampati in coda allo scontrino dei clienti meritevoli o inviati via email.

5. Monitoraggio: Nel pannello di controllo è possibile verificare in tempo reale lo stato di ciascun codice (Disponibile, Utilizzato in cassa con indicazione di data e ora, Scaduto).

---

4. Gestione delle Gift Card (Carte Regalo)

Le Gift Card sono carte ricaricabili che i clienti acquistano come regalo o come metodo di pagamento prepagato.

Come attivare una serie di Gift Card:

1. Accedere a Gestione -> Serie Gift.

2. Creare una nuova serie definendo i tagli disponibili (es: carte a taglio fisso da 25€, 50€ o a importo libero).

3. Generare i codici a barre identificativi da stampare sulle tessere fisiche.

4. Attivazione:

  • In cassa: Quando un cliente acquista una carta, il cassiere scansiona il barcode e inserisce l'importo desiderato. La cassa invia il segnale a KBE che attiva la carta caricandovi il saldo.
  • Da Back Office: Il manager può pre-attivare un lotto di carte per scopi promozionali o aziendali caricando direttamente il saldo da KBE.

5. Consultazione: Ricercando il codice di una Gift Card a sistema, il manager può visualizzare il saldo residuo e l'elenco dettagliato degli acquisti effettuati con essa.

---

Dashboard e Statistiche (KPI)

La Dashboard KPI (Key Performance Indicators) di KBE è lo strumento principale a disposizione degli Store Manager e della Direzione per monitorare in tempo reale le vendite, le marginalità e l'efficienza complessiva dei punti vendita.

---

1. Selezione del Periodo e Logica di Confronto

La dashboard permette di filtrare i dati di performance impostando diversi intervalli temporali. Il sistema confronta automaticamente il periodo selezionato con lo stesso intervallo dell'anno precedente, applicando una logica di calendario commerciale (Retail Calendar) per allineare correttamente i giorni della settimana (es. confrontando l'ultimo sabato di questo mese con l'ultimo sabato dello stesso mese dell'anno precedente, anziché basarsi solo sulla data numerica).

Opzioni di Periodo Disponibili:
  • Oggi: Mostra le vendite in tempo reale della giornata in corso. Il confronto viene effettuato con lo stesso giorno della settimana dell'anno precedente.
  • Ieri: Mostra il riepilogo consolidato del giorno precedente.
  • Settimana in Corso: Raggruppa i dati a partire dal lunedì fino al giorno corrente.
  • Mese in Corso: Raggruppa i dati a partire dal 1° giorno del mese corrente fino all'ultimo giorno consolidato.
  • Personalizzato (Custom): Consente di inserire una data di inizio e di fine specifiche. Il sistema calcolerà automaticamente le date di confronto corrispondenti dell'anno precedente.

---

2. Metriche di Vendita e Indicatori di Performance (KPI)

Per ciascun periodo selezionato, la dashboard presenta a schermo le seguenti metriche fondamentali, indicando per ognuna la variazione percentuale (in positivo o in negativo) rispetto all'anno precedente:

| Metrica / KPI | Descrizione Funzionale | Utilizzo Pratico per lo Store Manager |

| :--- | :--- | :--- |

| Totale Venduto (€) | Il volume totale delle vendite registrate dalle casse, al netto di resi e storni. | Misura il fatturato reale generato nel periodo selezionato. |

| Numero Scontrini | Il numero complessivo di transazioni completate in cassa. | Indica il flusso di clienti che hanno effettuato un acquisto (traffico scontrinato). |

| Scontrino Medio (€) | Calcolato come: Totale Venduto / Numero Scontrini. Indica la spesa media di ogni cliente. | Aiuta a capire se i clienti acquistano prodotti a valore più alto o aderiscono a promozioni. |

| Battute Medie | Il numero medio di righe articolo presenti all'interno di ogni scontrino. | Misura la capacità di cross-selling (quanti articoli diversi acquista in media ogni cliente). |

| Margine (€) | Il margine di guadagno in valore assoluto, calcolato sulla differenza tra il prezzo di vendita e il costo d'acquisto delle merci. | Indica l'effettiva redditività delle vendite al netto del costo del venduto. |

| Margine (%) | La percentuale di marginalità calcolata sul venduto. | Consente di verificare la sostenibilità economica delle promozioni attive. |

---

3. Classifiche e Analisi di Dettaglio (Ranking)

Oltre alle metriche generali, la dashboard fornisce visualizzazioni grafiche e tabelle di classificazione (Ranking) per individuare i punti di forza e di debolezza del negozio:

Classifica Punti Vendita (per Store Manager Multinegozio / Direzione)

Mostra l'elenco dei punti vendita attivi ordinati in base al fatturato o al margine. Consente di confrontare rapidamente le performance dei diversi negozi della rete.

Classifica Categorie Merceologiche

Raggruppa le vendite in base alle categorie dei prodotti (es. Alimentari, Casalinghi, Ortofrutta).

  • Aiuta a capire quali reparti stanno trainando il fatturato.
  • Permette di pianificare il riassortimento delle merci e la disposizione fisica delle corsie.
Classifica Venditori / Operatori di Cassa

Mostra le performance di vendita suddivise per singolo operatore.

  • Numero transazioni gestite: Utile per verificare la velocità e l'efficienza alle casse.
  • Valore venduto e scontrino medio: Permette di monitorare l'efficacia del personale nel consigliare prodotti o promuovere articoli speciali.

---

Flusso Decisionale dell'Analisi Dashboard


flowchart TD
    Start([Accesso a Dashboard KBE]) --> SelectStore[Seleziona Punto Vendita]
    SelectStore --> SelectPeriod[Scegli Periodo Temporale es: Settimana]
    SelectPeriod --> AutoCompare[Il sistema calcola le date di confronto dell'anno precedente]
    AutoCompare --> FetchKPI[Aggregazione metriche: Venduto, Scontrini, Margine]
    FetchKPI --> DisplayKPI[Visualizzazione KPI con variazioni percentuali]
    DisplayKPI --> ChoiceRank{Cosa vuoi analizzare?}
    ChoiceRank -- Reparti/Categorie --> RankCat[Analizza Classifica Categorie Merceologiche]
    ChoiceRank -- Staff/Casse --> RankStaff[Analizza Classifica Operatori]
    ChoiceRank -- Negozi della rete --> RankStores[Analizza Classifica Punti Vendita]
    RankCat --> ActionPromo[Ottimizza promozioni su categorie a basso margine]
    RankStaff --> ActionStaff[Pianifica turni o formazione sul personale di cassa]
    RankStores --> ActionStock[Rialloca le merci tra i negozi della rete]

---

Gestione dei Documenti e Inventario

Questo modulo descrive le procedure per la registrazione e il controllo dei documenti di magazzino (carico merci, registrazione fatture passive e DDT), la gestione delle anomalie di consegna e la conduzione degli inventari.

---

1. Registrazione dei Documenti di Carico e Fatture Passive

Per aggiornare lo stock a seguito dell'arrivo di nuove merci dai fornitori, occorre registrare i documenti passivi (DDT, Fatture di acquisto, Note di Credito) nel pannello Gestione Documenti.

Procedura di Inserimento Documento:

1. Accedere a Gestione -> Documenti.

2. Premere Nuovo Documento e selezionare la tipologia (es. Fattura Passiva, DDT fornitore).

3. Compilare i dati di testata:

  • Azienda e Punto Vendita di destinazione.
  • Fornitore / Cliente Business: Selezionabile tramite ricerca avanzata. Il sistema caricherà le sue condizioni di pagamento e le eventuali esenzioni fiscali.
  • Note aggiuntive, data del documento e numero di protocollo originale del fornitore.

4. Inserire gli articoli ricevuti nella griglia (tramite scansione codice a barre o ricerca descrittiva). Per ogni riga specificare:

  • Quantità ricevuta.
  • Prezzo al pubblico e Costo unitario di acquisto (IVA inclusa/esclusa).
  • Codice IVA e valore percentuale.
Regole di Controllo e Chiusura del Documento:

flowchart TD
    Start([Avvio Chiusura Documento]) --> CheckSuppliers{Verifica fornitori diversi abilitata?}
    CheckSuppliers -- Sì --> ValidateSuppliers{Gli articoli hanno fornitori diversi?}
    ValidateSuppliers -- Sì --> BlockSuppliers[Errore: Blocco Chiusura. Gli articoli devono avere lo stesso fornitore.]
    ValidateSuppliers -- No --> CalcVAT[Calcolo IVA e imponibili basati su esenzioni e aliquote]
    CheckSuppliers -- No --> CalcVAT
    CalcVAT --> CheckLimit{Il totale supera il limite massimo per il tipo di documento?}
    CheckLimit -- Sì --> BlockLimit[Errore: Blocco Chiusura. Limite di valore superato.]
    CheckLimit -- No --> ReserveNumber[Richiesta blocco numeratore in stores-series]
    ReserveNumber --> GetNumber[Generazione anno, serie e numero progressivo]
    GetNumber --> InsertDoc[Salvataggio del documento consolidato]
    InsertDoc --> UpdateContainers[Collega l'ID documento ai contenitori di riordino coinvolti]
    UpdateContainers --> Done([Documento Chiuso e Giacenze Aggiornate])
  • Controllo Fornitori Univoci: Se configurato per quel tipo di documento, il sistema blocca il salvataggio se si tenta di registrare articoli associati a fornitori differenti nello stesso documento.
  • Calcolo IVA ed Esenzioni: Le aliquote IVA e gli imponibili vengono calcolati automaticamente. Se il cliente business o il tipo di documento dispone di un'agevolazione o di una Esenzione IVA, il sistema azzera l'imposta o applica l'aliquota ridotta associata all'esenzione.
  • Controllo Limiti di Valore: Prima della chiusura, il sistema verifica che il valore totale del documento non superi il limite massimo consentito per quella categoria.
  • Assegnazione del Numero (Blocco Concorrenziale): All'atto della chiusura, per evitare che due operatori generino lo stesso numero di documento contemporaneamente, il sistema inserisce una marcatura temporanea di blocco (lock_expiry_date) sulla serie del punto vendita, incrementa il numeratore ed effettua il salvataggio, sbloccando la serie subito dopo.

---

2. Controllo Carico (Gestione Anomalie e TRD)

Il pannello Controllo Carico si occupa di intercettare le discrepanze tra quanto dichiarato nei documenti di trasferimento merce tra negozi (Internal Load) e quanto effettivamente contato dal personale all'arrivo.

Quando si genera un'anomalia?

Un documento di carico interno passa in stato Anomalo (Anomaly: True) quando la merce arriva a destinazione, viene contata tramite palmari mobili, e la quantità contata (check_qty) risulta differente da quella dichiarata nel documento di spedizione (document_qty).

Procedura di Risoluzione delle Anomalie:

1. Accedere a Gestione -> Controllo Carico (Anomalie).

2. Filtrare per negozio mittente (punto di partenza) e negozio destinatario (punto di arrivo).

3. Selezionare il documento anomalo. Il sistema mostrerà le righe prodotto in cui le quantità non corrispondono.

4. L'operatore può:

  • Modificare la quantità contata: Se viene riscontrato un errore di conteggio manuale.
  • Aggiungere note di carico: Per specificare le cause (es. "collo danneggiato", "articolo mancante all'origine").
  • Risolvere l'anomalia: Il sistema calcola la differenza e genera automaticamente un documento di Trasferimento (TRD) per riallineare i magazzini dei due negozi.
Come funziona la compensazione tramite TRD:
  • Caso A: Quantità Spedita > Quantità Ricevuta (mancano dei pezzi a destinazione).
  • Il sistema genera un documento di Trasferimento (TRD) con partenza dallo store di destinazione e arrivo allo store di spedizione per la quantità mancante. Questo corregge l'inventario del negozio destinatario (che non riceve merce mai arrivata) e riaddebita lo stock al mittente.
  • Caso B: Quantità Spedita < Quantità Ricevuta (sono arrivati pezzi in più a destinazione).
  • Il sistema genera un documento di Trasferimento (TRD) con partenza dallo store di spedizione e arrivo allo store di destinazione per la quantità in eccedenza.
  • Consolidamento: Una volta generato il TRD (con numeratore protetto da blocco concorrenziale come per le fatture), la riga anomala viene marcata con la data di risoluzione e il nome dell'operatore. Quando tutte le righe anomale del carico sono risolte, lo stato di anomalia dell'intero documento viene disattivato.

---

3. Gestione dell'Inventario (Stocktake)

La procedura di inventario serve a allineare periodicamente lo stock teorico presente nel database con lo stock fisico realmente presente in negozio.

Fasi dell'Inventario:

1. Creazione Sessione: Accedere a Gestione -> Inventari e premere Crea Inventario.

2. Definizione Zone: Creare le zone fisiche del punto vendita (es. Scaffale Corsia 1, Cella Frigo, Vetrinette). In questo modo, più operatori possono contare contemporaneamente zone diverse con i palmari senza sovrapporsi.

3. Blocco Articoli: Durante il conteggio, le giacenze teoriche a sistema vengono temporaneamente congelate per evitare discrepanze dovute a vendite o carichi concomitanti.

4. Lettura e Invio: Gli operatori scansionano i prodotti con i palmari mobili (KMA) inviando i conteggi a KBE.

5. Verifica Discrepanze (Proposta di Inventario):

  • Il Manager visualizza a schermo il report di confronto: Giacenza Teorica vs Giacenza Rilevata = Differenza (Delta).
  • È possibile ordinare una nuova lettura per le zone che presentano differenze anomale.

6. Rettifica Finale: Premendo Conferma Rettifica Inventario, il sistema aggiorna definitivamente lo stock teorico con quello realmente contato, calcolando i cali o le eccedenze, e sblocca gli articoli per le normali attività di cassa.

---

Gestione dell'E-commerce e Liste di Prelievo (PKL)

Questo modulo descrive le procedure di back-office per la gestione degli ordini e-commerce (Click & Collect, Pick from Store) e la stampa delle liste di prelievo merci (Picking Lists).

---

1. E-commerce Click & Collect (Ritiro in Negozio)

La funzione Click & Collect consente ai clienti di acquistare online e ritirare in negozio un pacco spedito dall'hub centrale.

FASE 1: Ricezione del Pacco in Negozio (da Corriere)

Quando il corriere consegna i pacchi e-commerce al negozio:

1. Accedere a Gestione -> E-commerce Click & Collect.

2. Il sistema mostra la lista degli ordini in arrivo.

3. Selezionare l'ordine e scansionare il codice a barre del pacco (Parcel Code).

4. KBE registra automaticamente la data/ora di ricezione e il nome dell'operatore che ha preso in carico il pacco, inviando la conferma di "Pacco Pronto per il Ritiro" al cliente.

FASE 2: Consegna del Pacco al Cliente

Quando il cliente si presenta in negozio per il ritiro:

1. Ricercare l'ordine per codice ordine o nome del cliente nel pannello Click & Collect.

2. Premere il pulsante Consegna al Cliente e scansionare il codice del pacco consegnato.

3. Il sistema registra la data/ora esatta di consegna e l'operatore che ha effettuato l'operazione.

FASE 3: Consultazione Informazioni Aggiuntive

Nel dettaglio della consegna, il manager può consultare:

  • La lista degli articoli contenuti nel pacco.
  • Il numero della tessera fedeltà associata al cliente.
  • La data dell'ultimo scontrino emesso al cliente in qualsiasi punto vendita della rete (utile per verifiche di reso o controlli amministrativi).

---

2. E-commerce Pick from Store (Preparazione Spedizioni da Negozio)

Nel servizio Pick from Store, il punto vendita non fa solo da punto di ritiro, ma si occupa di preparare fisicamente l'ordine prelevando i prodotti direttamente dai propri scaffali.

Fasi di Preparazione:

1. Accedere a Gestione -> Pick from Store.

2. Ordini da Preparare (Receive): Il sistema elenca gli ordini assegnati al negozio con indicazione della data e ora limite entro cui devono essere preparati (Scadenza Ritiro).

3. Prelievo e Packaging: Gli addetti prelevano i prodotti dagli scaffali. Una volta completato il prelievo, lo stato dell'ordine passa a Elaborato / Processato (Processed).

4. Stampa e Spedizione (Delivery): Il manager accede all'elenco degli ordini pronti per la spedizione, stampa i documenti di trasporto ed etichette di spedizione, e marca l'ordine come Stampato/Spedito (Printed). Questo aggiorna le giacenze di magazzino scalando i prodotti spediti.

---

3. Liste di Prelievo (Picking Lists - PKL)

Le Picking Lists (PKL) sono liste di prelievo generate per il riassortimento dei reparti o per trasferimenti stock di massa.

Procedura di Gestione PKL:

1. Accedere a Strumenti -> Gestione PKL (Picking Lists).

2. Il sistema interroga il server centrale per recuperare le liste di prelievo generate per la data selezionata.

3. L'operatore visualizza l'elenco delle liste disponibili con il riepilogo del numero di articoli da prelevare.

4. Selezionare la lista e premere Stampa Lista di Prelievo per inviare il documento di lavoro agli addetti di magazzino.

---

Flusso Operativo della Gestione E-commerce in Negozio


flowchart TD
    Start([Ordine E-commerce Ricevuto]) --> TypeCheck{Tipologia Ordine?}
    
    TypeCheck -- Click & Collect --> CC_Arrival[Pacco inviato dall'Hub Centrale]
    CC_Arrival --> CC_Scan[Scansione codice pacco all'arrivo in store]
    CC_Scan --> CC_Notify[KBE registra la ricezione ed invia notifica al cliente]
    CC_Notify --> CC_Pickup[Il cliente arriva in store]
    CC_Pickup --> CC_Delivery[Scansione codice pacco e consegna al cliente]
    CC_Delivery --> CC_Done([Ordine Concluso])
    
    TypeCheck -- Pick from Store --> PFS_List[Visualizzazione ordine da preparare su KBE]
    PFS_List --> PFS_Shelves[Prelievo fisico dei prodotti dagli scaffali del negozio]
    PFS_Shelves --> PFS_Processed[Segna ordine come Processato]
    PFS_Processed --> PFS_Print[Stampa etichette e bolla di spedizione]
    PFS_Print --> PFS_Ship[Consegna al corriere e flag su Stampato/Spedito]
    PFS_Ship --> PFS_Done([Giacenze scalate e Ordine Concluso])

---

Interrogazione Articoli e Movimenti

Questo modulo descrive le procedure per la ricerca delle informazioni sui prodotti (anagrafiche e promozioni attive), la stampa delle etichette da scaffale e la consultazione storica dei movimenti di magazzino e di cassa.

---

1. Interrogazione Articoli (Ricerca Prodotto)

Il pannello Interrogazione Articoli consente di consultare in tempo reale le schede dei prodotti presenti a sistema, i relativi prezzi di vendita, i costi di acquisto e le promozioni collegate.

Filtri di Ricerca Principali:
  • Filtro di Testo: Ricerca per descrizione dell'articolo o per codice a barre (EAN).
  • Filtri di Classificazione: Marca, Fornitore, Buyer (responsabile acquisti) e Categoria Merceologica.
  • Stato Commerciale: Filtra i prodotti attivi, in esaurimento o bloccati.
  • Filtri di Data: Ricerca in base alla data di inserimento dell'articolo o all'ultimo aggiornamento del prezzo.
Informazioni Visibili nella Scheda Prodotto:

1. Dati Generali: Codice interno, descrizione, codice a barre primario, unità di misura.

2. Dati Economici: Prezzo al pubblico (IVA inclusa), costo di acquisto (al netto di IVA) e aliquota IVA applicata.

3. Promozioni Attive: Mostra l'elenco di tutte le promozioni in corso che colpiscono l'articolo.

Importante

Come fa il sistema ad associare le promozioni attive a un articolo?

Il sistema esegue un controllo automatico incrociato:

  • Controlla se il codice del prodotto è inserito esplicitamente nella lista di una promozione attiva.
  • Verifica se il prodotto rientra in un filtro dinamico basato su regole di marca, categoria merceologica o parole chiave presenti nella descrizione (es. una promozione attiva su tutti i prodotti di una specifica marca o categoria).

---

2. Stampa Etichette Scaffale (Servizio KPL)

KBE integra una funzione per la stampa di etichette segnaprezzo da scaffale, interfacciata con il servizio di stampa KPL (Key Print Label).

Procedura per la Stampa delle Etichette:

1. Effettuare la ricerca dei prodotti da etichettare e aggiungerli alla Lista di Stampa.

2. Selezionare il Template/Layout dell'etichetta (es. etichetta grande per offerte, etichetta standard, etichetta con codice a barre per riordino).

3. Avviare il comando di stampa. Il sistema esegue i seguenti passaggi automatici:


flowchart TD
    Start([Avvio Stampa Etichette da KBE]) --> IdentifyMaster[Il sistema individua la Cassa Master dello store]
    IdentifyMaster --> PingMaster{La Cassa Master è online?}
    PingMaster -- No --> ErrorOffline[Errore: Impossibile contattare la cassa master. Stampa interrotta.]
    PingMaster -- Sì --> ApplyPrices[Applica i prezzi e calcola le promozioni per la data di oggi]
    ApplyPrices --> CallKPL[Il servizio KPL genera il layout grafico delle etichette]
    CallKPL --> RoutePrint[Invia il file di stampa alla stampante di negozio tramite la Cassa Master]
    RoutePrint --> CheckPrinted{Le etichette sono state stampate?}
    CheckPrinted -- Sì --> SetPrinted[KBE registra lo stato: Stampato]
    CheckPrinted -- No --> AlertPrinted[Segnala errore di stampa su alcune etichette]
  • Controllo Cassa Master: La stampa fisica dei segnaprezzo è instradata attraverso il terminale di cassa configurato come "Master" per il punto vendita. Se la cassa master è spenta o disconnessa, KBE impedisce la stampa per evitare discrepanze nei prezzi.
  • Consolidamento Prezzo Promozionale: Se il prodotto è in offerta, KPL inserisce automaticamente sull'etichetta il prezzo promozionale barrando quello originale e indicando la data di fine della promozione.

---

3. Interrogazione Movimenti

Il pannello Interrogazione Movimenti permette di tracciare ogni singolo movimento fisico e contabile registrato nel sistema (vendite, resi, trasferimenti tra negozi, carichi merce).

Filtri per la Ricerca dei Movimenti:
  • Intervallo di Date: Data di inizio e data di fine per circoscrivere l'audit.
  • Tipo di Documento: Consente di isolare specifiche transazioni (es. scontrini di cassa, documenti di trasporto DDT, trasferimenti interni, fatture passive).
  • Filtri Articolo/Marca: Ricerca per specifico codice prodotto o marca.
Ricerca Cliente Associata ai Movimenti:

Durante la ricerca dei movimenti, se si desidera analizzare gli acquisti effettuati da un cliente specifico (es. per verificare un reso o analizzare la cronologia acquisti), KBE implementa una procedura di ricerca multilivello:

1. Ricerca Avanzata CRM (CDP): Se attiva, il sistema interroga l'anagrafica centralizzata esterna tramite nome, cognome o città per recuperare i dettagli in tempo reale del cliente.

2. Ricerca Locale MongoDB: Se la ricerca centralizzata è disattivata o non restituisce risultati, il sistema interroga il database locale per:

  • Codice tessera fedeltà.
  • Codice cliente del software gestionale.
  • Ricerca testuale per nome e cognome.

3. Selezionato il cliente, il report mostrerà tutti i movimenti a lui associati.

---

Quadratura Cassa e Riconciliazione Contabile

Questo modulo descrive le procedure di quadratura di fine giornata delle casse (Daily Check), la riconciliazione contabile delle fatture passive dei fornitori con i documenti di consegna (DDT/Ordini) e la gestione dei registri fiscali.

---

1. Quadratura Cassa e Verifica Chiusure (Daily Check)

Il pannello Controllo Chiusure (Daily Check) raccoglie l'elenco di tutte le casse del punto vendita che hanno effettuato la chiusura giornaliera ma la cui quadratura non è stata ancora approvata.

Riconciliazione con la Stampante Fiscale:

1. Accedere a Area Contabilità -> Controllo Chiusure.

2. Il sistema esegue una verifica automatica:

  • Ping Stampante: Verifica che la stampante fiscale di quella cassa sia raggiungibile in rete IP.
  • Download Totali Fpmate: Scarica i totali memorizzati all'interno dei registri della stampante per la data selezionata.

3. Vengono confrontati a schermo tre valori chiave:

  • Totale Giorno Vendite (Venduto reale stampato).
  • Totale Giorno Resi (Valore dei resi registrati in stampante).
  • Totale Giorno Annullamenti (Valore degli scontrini stornati in stampante).

4. Se i dati del database e quelli della stampante coincidono, la quadratura è corretta.

Scarico DGFE e Recupero Scontrini:
  • Scarica DGFE: Consente di scaricare in ufficio il file XML del Giornale di Fondo Elettronico della stampante per la conservazione legale.
  • Recupero Scontrini da Cassa: In caso di sbalzi di tensione o blocchi di rete che creano un salto nella numerazione scontrini, questa funzione si collega via IP al log locale della cassa, estrae il file originale in formato JSON dello scontrino e lo reinserisce nel database centrale per sanare la sequenza.
Approvazione della Quadratura:
  • Approvazione Ordinaria: Premere Approva Quadratura se i dati contante coincidono con le letture fiscali.
  • Approvazione Forzata (Forced): Consente di chiudere la quadratura anche in presenza di discrepanze inevitabili, inserendo una nota esplicativa per l'amministrazione.

---

2. Registrazione e Quadratura delle Fatture Fornitore (Fatture Passive)

Il pannello Fatture Passive (in Area Contabilità -> Fatture Passive) consente all'ufficio amministrativo e agli Store Manager di quadrare e registrare le fatture elettroniche ricevute dai fornitori rispetto alla merce realmente ricevuta in negozio (DDT e Ordini di acquisto).

A. Sblocco del Mese Contabile (Month Unlock)

Prima di poter registrare qualsiasi fattura, un amministratore con specifici permessi deve autorizzare il mese contabile di riferimento.

1. Accedere alla funzione Sblocco Mese.

2. Inserire la propria password per confermare l'identità.

3. Il sistema verifica il permesso e aggiorna la data dell'ultimo mese sbloccato (passive_invoices_last_month_unlock).

4. Regola di Sicurezza: Non è possibile registrare o modificare fatture fornitore riferite a mesi contabili ancora bloccati.

B. Procedura di Quadratura e Associazione (Matching)

Quando si riceve una fattura fornitore (es. importata da file XML), occorre associarla ai documenti fisici che hanno registrato l'ingresso delle merci a magazzino.


flowchart TD
    Start([Seleziona Fattura Passiva da registrare]) --> OpenDetail[Apri Dettaglio Fattura]
    OpenDetail --> ChooseMatch{Come importare le righe?}
    ChooseMatch -- Da DDT / Ordini --> ImportDDT[Seleziona DDT di carico registrati in magazzino]
    ChooseMatch -- Da Note di Credito --> ImportCN[Associa Note di Credito fornitore]
    ChooseMatch -- Inserimento Manuale --> ManualEntry[Aggiungi manualmente righe di rettifica]
    ImportDDT --> CompareTotals[Verifica quadratura: Totale Imponibile e IVA]
    ImportCN --> CompareTotals
    ManualEntry --> CompareTotals
    CompareTotals --> Balanced{I totali quadrano con la fattura?}
    Balanced -- No --> UploadAttach[Carica allegato PDF per segnalare discrepanze]
    Balanced -- Sì --> InputDates[Inserisci Data Registrazione, IVA e Scadenza]
    InputDates --> ConfirmReg[Conferma Registrazione]
    ConfirmReg --> SetProtocol[Il sistema assegna il Numero di Protocollo]
    SetProtocol --> Done([Fattura Registrata e DDT Consolidati])

1. Importazione Righe: Nel dettaglio della fattura, l'operatore associa la merce selezionando:

  • Importa da Ordini/Bolle: Mostra l'elenco dei DDT di carico precedentemente registrati a magazzino (tramite *Gestione Documenti*) per quel fornitore.
  • Importa da Note di Credito: Associa le note di accredito fornitore.
  • Inserimento Manuale: Consente di digitare righe di storno o costi aggiuntivi (es. spese di spedizione).

2. Verifica della Quadratura: L'operatore confronta il totale imponibile e l'IVA calcolati sulle bolle di consegna associate con i valori riportati nella fattura del fornitore.

3. Gestione Allegati: È possibile caricare copie PDF dei documenti per archivio o per documentare discrepanze di prezzo/quantità.

C. Consolidamento e Protocollo
  • Conferma Registrazione: Una volta accertata la quadratura dei valori, inserire la data di registrazione, la data IVA, la data di ricezione e le scadenze di pagamento. Premere Conferma.
  • Assegnazione Protocollo: Il sistema genera e associa al documento un Numero di Protocollo progressivo di registrazione.
  • Storico e Sblocco: Le fatture registrate passano nella scheda Fatture Registrate. Se si elimina una registrazione, il sistema sblocca automaticamente i DDT/Ordini precedentemente associati, rendendoli nuovamente disponibili per una nuova quadratura.

---

---

3. Esportazione Bolli su Fatture (Extra-UE)

Il sistema KBE prevede un tool per la gestione dell'imposta di bollo virtuale applicata alle fatture emesse verso clienti residenti in paesi Extra-UE (esteri) che superano le soglie di legge (es. 77,47€).

Procedura di Esportazione:

1. Accedere a Strumenti -> Esportazione Bolli.

2. Filtrare per punto vendita, data di emissione delle fatture ed eventualmente per codice del cliente business.

3. Il sistema elenca le fatture dirette emesse in quel giorno che presentano un'esenzione IVA Extra-UE e che superano la soglia per l'applicazione dell'imposta di bollo.

4. Verifica Dati Cliente (Cellulare/Email): Se il profilo del cliente business non contiene un numero di cellulare valido o un'email, KBE richiede l'inserimento immediato dei contatti prima di procedere, aggiornando l'anagrafica centralizzata.

5. Generazione CSV di Esportazione: Il sistema interroga le casse per ricostruire gli sconti spaccati per riga, calcola l'imponibile e l'IVA per ciascuna aliquota (0%, 4%, 10%, 22%) e genera un file CSV contenente tutti i dati anagrafici e contabili delle fatture per la dichiarazione fiscale dell'imposta di bollo.

---

Manuale Operativo Back Office - KBE (Key Back End)

Benvenuto nel Manuale Operativo di Back Office per la suite KBE (Key Back End).

Questo portale web è progettato per i responsabili di negozio (Store Manager), il personale d'ufficio e gli amministratori del sistema Key Solution. Consente di gestire anagrafiche, documenti, inventari, promozioni e verificare la quadratura contabile giornaliera dei punti vendita.

---

Indice dei Contenuti

1. [Quadratura e Contabilità](file:///C:/KSolution/KBE/Manuale/Quadratura_e_Contabilita.md):

  • Verifica delle chiusure giornaliere (Daily Check) e quadratura delle casse.
  • Riconciliazione dei totali con la stampante fiscale e download del Giornale di Fondo (DGFE).
  • Ricerca e recupero scontrini mancanti dai log di cassa.
  • Riconciliazione, quadratura e registrazione delle fatture passive dei fornitori (Month Unlock, associazione DDT e ordini).
  • Approvazione finale.

2. [Dashboard e Statistiche (KPI)](file:///C:/KSolution/KBE/Manuale/Dashboard_e_Statistiche.md):

  • Monitoraggio delle performance vendite, scontrino medio e transazioni.
  • Criteri di confronto temporale con l'anno precedente (retail calendar).
  • Margine commerciale in valore e percentuale.
  • Classifiche per categorie merceologiche, operatori e punti vendita.

3. [Interrogazione Articoli e Movimenti](file:///C:/KSolution/KBE/Manuale/Interrogazione_Articoli_e_Movimenti.md):

  • Ricerca avanzata schede articolo per codice a barre, marche e fornitori.
  • Abbinamento promozioni attive e stampa etichette scaffale (KPL).
  • Ricerca dei movimenti cassa/magazzino e tracciamento anagrafiche clienti tramite CRM/CDP.

4. [Gestione Documenti e Inventario](file:///C:/KSolution/KBE/Manuale/Gestione_Documenti_e_Inventario.md):

  • Registrazione fatture passive e DDT con controllo IVA ed esenzioni fiscali.
  • Gestione anomalie di carico interno (Controllo Carico) e generazione automatica di documenti di trasferimento (TRD).
  • Conduzione di sessioni di inventario (Stocktake) e rettifiche automatiche di stock.

5. [Gestione E-commerce e Liste di Prelievo (PKL)](file:///C:/KSolution/KBE/Manuale/Gestione_Ecommerce.md):

  • Gestione ritiro pacchi da hub centrale e consegna al cliente (Click & Collect).
  • Preparazione degli ordini online prelevando merce dagli scaffali del negozio (Pick from Store).
  • Stampa delle liste di prelievo (Picking Lists) per il riassortimento e trasferimenti.

6. [Anagrafiche e Fidelity](file:///C:/KSolution/KBE/Manuale/Anagrafiche_e_Fidelity.md):

  • Creazione e gestione schede clienti.
  • Assegnazione carte fedeltà, gestione saldi punti e campagne a bollini.
  • Regole per cashback (rimborso spesa tramite punti).

7. [Configurazione Promozioni](file:///C:/KSolution/KBE/Manuale/Configurazione_Promozioni.md):

  • Impostazione di nuove promozioni (NxM, taglio prezzo, paniere, omaggi).
  • Generazione massiva e gestione di Coupon/Buoni Sconto.
  • Attivazione e ricarica di Gift Card.

8. [Utenti e Sicurezza](file:///C:/KSolution/KBE/Manuale/Utenti_e_Sicurezza.md):

  • Creazione profili operatore (cassieri, manager, admin).
  • Configurazione dei permessi di cassa.
  • Verifica delle licenze delle casse.

---

Mappa Relazionale del Back Office

Ecco come il Back Office KBE si relaziona con i punti vendita fisici e la sede centrale:


graph TD
    KBE["Portale Web KBE (Store Manager / Ufficio)"] <--> |Lettura/Scrittura Dati| CloudDB["Database Cloud Sincronizzato"]
    KFE1["Cassa 1 (KFE)"] <--> |Sincronizzazione Corrispettivi & DGFE| CloudDB
    KFE2["Cassa 2 (KFE)"] <--> |Sincronizzazione Corrispettivi & DGFE| CloudDB
    KMA["App Mobile (KMA)"] <--> |Verifica Inventario / Prezzi| CloudDB
    KBE --> |Verifica Connessione IP| KFE1
    KBE --> |Verifica Connessione IP| KFE2

---

Gestione Utenti, Permessi e Sicurezza

Questo modulo descrive le procedure per creare e gestire gli account degli operatori (cassieri e manager), configurare i permessi di sicurezza in cassa e monitorare le licenze attive dei terminali.

---

1. Creazione Profili Operatori (Utenti)

Tutti i dipendenti che utilizzano le casse (KFE) o accedono al Back Office (KBE) devono possedere un account personale con credenziali protette.

Procedura per creare un Utente:

1. Accedere a Sistema -> Utenti.

2. Premere Nuovo Utente.

3. Compilare i dati del dipendente:

  • Nome e Cognome.
  • Nome Utente (Username per il login).
  • Password Temporanea (che l'operatore dovrà modificare al primo accesso).

4. Assegnare il Ruolo di sicurezza (vedi dettaglio sotto).

5. Premere Salva.

---

2. Configurazione Ruoli e Permessi Operativi

Il ruolo assegnato determina quali operazioni l'utente può eseguire all'interno del negozio.

Ruoli Principali del Sistema:
  • Cassiere (User): Può effettuare le vendite ordinarie, registrare pagamenti e utilizzare i propri buoni. Non può effettuare sconti non autorizzati, storni di scontrini già emessi, o aprire il cassetto senza una vendita in corso.
  • Responsabile (Manager): Accede alle funzioni di quadratura cassa KBE e può autorizzare operazioni critiche sulle casse (es. sbloccare un prezzo manuale, autorizzare un rimborso o aprire manualmente il cassetto cassa).
  • Amministratore (Admin): Accesso completo a tutte le configurazioni di sistema, anagrafiche aziendali, gestione licenze e report KPI.
Configurazione Permessi Specifici di Cassa:

Dalla scheda utente, è possibile attivare o disattivare autorizzazioni puntuali per l'attività in cassa:

  • *Abilitazione sconti manuali (Valore / Percentuale)*.
  • *Abilitazione storno riga o storno scontrino emesso*.
  • *Abilitazione apertura cassetto senza vendita*.
  • *Abilitazione variazione prezzo di listino (Prezzo Manuale)*.

---

3. Monitoraggio Licenze Cassa

Ogni cassa fisica installata nel punto vendita richiede una licenza attiva registrata a sistema per poter funzionare correttamente.

Procedura di Controllo Licenze:

1. Accedere a Sistema -> Licenze.

2. Il pannello mostrerà l'elenco di tutti i terminali registrati del punto vendita con:

  • Identificativo Terminale (Terminal ID) e nome cassa.
  • Indirizzo IP del computer di cassa.
  • Data di Scadenza della licenza.
  • Stato Licenza (Attiva, In Scadenza, Scaduta).

3. Impatto delle Licenze Scadute: Se la licenza di una cassa scade, il software KFE bloccherà le funzioni di checkout impedendo l'emissione di scontrini fiscali. Il manager deve assicurarsi di rinnovare le licenze in scadenza contattando il supporto e aggiornando il codice di licenza sul portale KBE.

---

Nessun risultato per la ricerca.

Modulo KMA — Key Mobile App (magazzino)

Controlli di Reparto - Palmare KMA

Questo modulo descrive le operazioni quotidiane effettuate dagli addetti all'interno dei reparti del punto vendita: il Controllo Scadenze (Freshness Control) per garantire la qualità dei prodotti e la Rilevazione Prezzi dei Concorrenti (Price Detection).

---

1. Controllo Scadenze (Freshness Control)

Il controllo scadenze consente di mappare ed eliminare dagli scaffali i prodotti scaduti o prossimi alla scadenza, registrando a sistema le quantità riscontrate per lotto.


graph TD
    A[Avvia Controllo Scadenze] --> B{Seleziona o Crea Sessione per Data}
    B --> C[Scansione Barcode Articolo]
    C -->|Articolo Non Trovato| D[Mostra Errore e Ripristina Lettura]
    C -->|Articolo Trovato| E[Visualizza Info & Dati di Reparto]
    
    E --> F[Inserisci Data Scadenza]
    F -->|Immissione a 6 cifre: MMYYYY| G[Calcola in automatico ultimo giorno del mese]
    F -->|Immissione a 8 cifre: DDMMYYYY| H[Converte in formato GG/MM/AAAA]
    F -->|Immissione a 10 cifre: GG/MM/AAAA| I[Accetta data standard]
    
    G --> J[Immetti Quantità Rilevata]
    H --> J
    I --> J
    
    J --> K{Controllo Quantità > 9999?}
    K -->|Sì| L[Mostra Richiesta di Conferma Straordinaria]
    K -->|No| M{Articolo già rilevato per stessa data?}
    L --> M
    
    M -->|Sì| N[Mostra avviso matematico somma/sottrazione/sostituzione]
    M -->|No| O[Invia Lettura al Server]
    N -->|Accetta| O
Fase 1: Avvio e Scansione Prodotto

1. Seleziona Controllo Scadenze dal menu principale.

2. Scegli se riprendere l'ultima sessione attiva (tasto Conferma) o crearne una nuova (tasto Nuova Rilevazione nel menu in alto).

3. Scansione il codice a barre del prodotto (o digita il codice interno).

4. Visualizzazione Dati del Reparto: A schermo verrai informato sullo stato del prodotto:

  • Informazioni Anagrafiche: Codice interno, codice fornitore, descrizione, prezzo al pubblico, imballo standard.
  • Dati Stock: Giacenza del punto vendita, giacenza totale di magazzino, quantità in transito (in viaggio verso il negozio), ordini in corso al fornitore e vendite registrate nell'ultima settimana.
  • Stati Commerciali Speciali: Se il prodotto è in esaurimento scorte o fuori assortimento, apparirà un'etichetta colorata (*"Scorte in esaurimento"* o *"Fuori assortimento"*).

---

Fase 2: Inserimento della Data di Scadenza (Calcolo Facilitato)

Per velocizzare le operazioni ed evitare errori di digitazione sul tastierino numerico del palmare, la data di scadenza può essere inserita in tre formati:

  • Inserimento Rapido Mese/Anno (6 cifre - MMYYYY): Digita solo il mese e l'anno (es. per dicembre 2026 digita 122026). Il palmare calcolerà automaticamente l'ultimo giorno del mese indicato, trasformando il testo in 31/12/2026.
  • Inserimento a 8 cifre (DDMMYYYY): Digita giorno, mese e anno consecutivamente (es. 15082026). Il palmare formatterà la data in 15/08/2026.
  • Inserimento Standard (10 caratteri - GG/MM/AAAA): Inserisci la data comprensiva delle barre separatici.
  • Premi Invio per confermare la data. Il palmare verificherà se sul server è già presente una rilevazione di questo articolo per la medesima data e mostrerà la quantità precedentemente contata.

---

Fase 3: Inserimento Quantità e Regole di Sicurezza

1. Digita la quantità di prodotto rilevata a scaffale per quella scadenza.

2. Scegli l'operatore matematico dal menu: Somma (aggiunge alla quantità precedente), Sottrai (riduce) o Uguale (sostituisce).

3. Avviso Quantità Elevate: Se digiti una quantità superiore a 9999 pezzi, il palmare bloccherà l'inserimento chiedendo conferma: *"Hai inserito una quantità maggiore di 9999 pezzi, vuoi procedere?"*.

4. Avviso Sovrascrittura/Somma: Se per quella scadenza avevi già salvato un conteggio, il palmare mostrerà una notifica matematica per prevenire sovrascritture accidentali (es. *"Se decidi di procedere sommerai 5 a quella già rilevata 10 portando la rilevazione a 15. Vuoi procedere?"*). Premi Sì per confermare la transazione.

5. Cancellazione di una Rilevazione: Se desideri rimuovere un prodotto scansionato per errore, premi il tasto Elimina e rispondi Sì alla richiesta: *"Procedere con l'eliminazione di questo articolo dalla rilevazione?"*. La riga verrà rimossa dal server.

---

2. Rilevazione Prezzi Concorrenti (Price Detection)

La rilevazione prezzi permette di registrare i prezzi dei prodotti esposti nei negozi competitor. Essendo svolta al di fuori del proprio punto vendita, questa procedura è progettata per funzionare interamente in modalità offline.


graph TD
    A[Avvia Rileva Prezzi] --> B[Nuova Rilevazione: Inserisci Nome Competitor]
    B --> C[Il palmare copia il modello benchmark in locale]
    C --> D[Operatore si reca nel negozio competitor - Modalità Offline]
    
    D --> E[Scansione Barcode Prodotto]
    E -->|Presente nel modello| F[Mostra descrizione e richiede Prezzi]
    E -->|Non presente nel modello| G[Mostra Non Trovato - Richiede Descrizione manuale]
    
    F --> H[Immetti Prezzo Base & Prezzo Speciale/Promo]
    G --> I[Immetti Descrizione Competitor] --> H
    
    H --> J[Salva in locale - contrassegna Non Sincronizzato]
    
    J --> K[Rientro in Negozio sotto WiFi]
    K --> L[Tocca pulsante Sincronizza]
    L --> M[Invio dati al Server - Aggiorna database locale]
Fase 1: Creazione e Inizializzazione della Rilevazione

1. Tocca Rileva Prezzi nel menu principale del palmare.

2. Tocca Nuova in alto a destra per creare una nuova scheda.

3. Digita il nome del negozio concorrente nel campo Competitor (es. *"Supermercato Rossi Via Roma"*) e tocca Conferma.

4. Download Automatico del Modello: All'atto della creazione, il palmare copia nella propria memoria locale un modello benchmark di prodotti sensibili (i prodotti più significativi del mercato). Questa operazione ti permette di avere le decodifiche degli articoli anche in assenza di internet all'interno del negozio concorrente.

---

Fase 2: Rilevazione Prezzi sul Campo (Offline)

Nel punto vendita competitor, apri la scheda creata e inizia a scansionare i prodotti a scaffale:

  • Articolo presente nel modello: Il palmare decodifica istantaneamente il barcode e mostra a schermo la descrizione del prodotto.
  • Articolo extra-modello (Nuovo competitor product): Se il prodotto scansito non è nel modello benchmark precaricato, il palmare mostrerà il messaggio *"Non trovato inserisci descrizione"*.
  • Tocca il campo Descrizione, digita il nome del prodotto e premi Invio.
  • Inserimento Prezzi:
  • Digita il Prezzo Base (prezzo normale a scaffale del concorrente).
  • Digita il Prezzo Speciale (se l'articolo è in promozione/volantino). Se l'articolo non è in promozione, lascia il campo vuoto o a zero.
  • Tocca Conferma. Il prezzo viene memorizzato localmente nel palmare e il documento viene marcato come *"Non sincronizzato"*.

---

Fase 3: Sincronizzazione dei Dati col Negozio

Una volta rientrato nel tuo punto vendita e sotto copertura WiFi del negozio:

1. Apri la schermata principale di Rileva Prezzi.

2. Tocca il pulsante Sincronizza presente sulla barra delle azioni.

3. Il palmare identificherà tutte le schede contrassegnate come non sincronizzate, invierà i blocchi di prezzi rilevati al server centrale ed evidenzierà a schermo il messaggio *"Invio rilevazione completata"*, impostando lo stato locale su *"Sincronizzato"*.

E-commerce e Fulfillment - Palmare KMA

KMA integra moduli dedicati alle vendite online: Pick From Store (la preparazione delle liste di spesa per ordini e-commerce dei clienti direttamente dagli scaffali del negozio) e Click & Collect (la ricezione e la consegna al cliente di pacchi spediti da magazzini centrali).

---

1. Pick From Store (Preparazione Ordini/Picking)

La preparazione degli ordini richiede la massima tempestività. KMA gestisce le priorità degli ordini tramite un sistema di notifiche colorate direttamente sul menu principale.


graph TD
    A[Rilevamento Ordini e-commerce] --> B{Verifica scadenze di ritiro}
    B -->|< 8 Ore alla scadenza| C[Colore Pulsante ROSSO & Alert acustico]
    B -->|> 8 Ore alla scadenza| D[Colore Pulsante GIALLO]
    
    C --> E[Seleziona Ordine & Avvia Prelievo]
    D --> E
    
    E --> F[Scansione Barcode Prodotto]
    F -->|Articolo Corretto| G[Immetti Quantità Prelevata]
    F -->|Articolo Mancante/Danneggiato| H{Seleziona Anomalia}
    
    H -->|Non Conforme| I[Imposta Qtà = 0 & Blocca Riga]
    H -->|Riservato| I
    H -->|Fine Stock| I
    
    G --> J[Verifica Multiplo min_package_unit]
    J --> K[Conferma Prodotto]
    I --> K
Fase 1: Gestione Notifiche e Avvio

1. Il palmare esegue un monitoraggio continuo degli ordini e-commerce pendenti.

2. In caso di nuovi ordini, il palmare emette un suono di avviso e mostra a schermo il messaggio: *"Attenzione ci sono X ordini Pick From Store, da prelevare!"*.

3. Il pulsante Pick From Store del menu principale cambia colore in base all'ordine più urgente:

  • Rosso: almento un ordine scade entro le prossime 8 ore (priorità massima).
  • Giallo: ci sono ordini in attesa ma con scadenza superiore a 8 ore.

4. Ottimizzazione Risorse: Quando selezioni un ordine e avvii la preparazione, il palmare disattiva automaticamente il servizio di sincronizzazione dati in background. Questo assicura che il palmare non subisca rallentamenti o disconnessioni durante il prelievo della spesa.

---

Fase 2: Spunta e Prelievo Articoli

1. Scansiona il codice a barre del prodotto da prelevare.

  • Se il prodotto non appartiene all'ordine del cliente, il palmare bloccherà la lettura: *"L'articolo non fa parte dell'ordine, prova ad usare il codice interno"*.

2. Inserisci la quantità prelevata:

  • Regola di Confezionamento: La quantità inserita deve essere obbligatoriamente un multiplo dell'unità minima di confezionamento (min_package_unit). In caso contrario, il palmare mostrerà un errore e non salverà la riga.
  • La quantità non può mai essere superiore a quella ordinata dal cliente.

3. Gestione Anomalie di Prelievo (Rotture di stock):

  • Se il prodotto a scaffale è mancante o danneggiato, non puoi inserire una quantità inferiore a quella richiesta senza specificarne il motivo. Attiva uno dei tre interruttori di anomalia a schermo:
  • Non Conforme: la merce a scaffale presenta difetti di confezionamento, sporco o danneggiamento.
  • Riservato: la merce è accantonata o riservata per altre promozioni/clienti.
  • Fine Stock: il prodotto è esaurito a scaffale.
  • *Effetto*: Attivando uno di questi interruttori, il palmare imposta automaticamente a 0 la quantità prelevata per quell'articolo e blocca la riga, registrando la motivazione da inviare al server.

---

Fase 3: Sostituzione con Prodotti Alternativi o Generici

Una volta scansionati tutti gli articoli, se ci sono stati dei prodotti non trovati (quantità contata inferiore a quella ordinata), il palmare mostrerà il messaggio:

*"X prodotti non hanno soddisfatto la richiesta del cliente. Potranno essere aggiunti articoli in sostituzione o ad integrazione. Procedere con la sostituzione?"*


flowchart TD
    A[Avvio Modalità Sostituzione] --> B{Scelta Tipo Sostituto}
    
    B -->|Alternativo Consigliato| C[Tasto Aggiungi Alternativo accanto a riga vuota]
    C --> D[Interrogazione Server e visualizzazione prodotti simili]
    D --> E[Selezione prodotto & Scansione per riscontro]
    E --> F[Inserisci quantità e conferma]
    F --> G[Aggiunto all'ordine come ALTERNATIVO]
    
    B -->|Sostituto Generico| H[Tasto Alternativo Generico in basso]
    H --> I[Scansione barcode di un prodotto qualsiasi in negozio]
    I --> J[Verifica anagrafica server e sblocco riga]
    J --> K[Inserisci quantità e conferma]
    K --> L[Aggiunto all'ordine come AGGIUNTIVO]

Se rispondi Sì, l'interfaccia si aggiorna abilitando l'inserimento di prodotti sostitutivi:

  • Prodotti Alternativi Consigliati (Dal Sistema):
  • Tocca il pulsante Aggiungi Alternativo in corrispondenza del prodotto mancante.
  • Il palmare chiederà al server la lista di prodotti alternativi idonei (stessa categoria merceologica, prezzo simile).
  • Seleziona il prodotto dall'elenco, scansiona il suo codice a barre per sicurezza, inserisci la quantità e tocca Conferma. Il prodotto verrà inserito con la dicitura (ALTERNATIVO).
  • Prodotti Alternativi Generici (Scelta Libera dell'Operatore):
  • Se i consigliati non sono presenti o desideri proporre un altro articolo, tocca il tasto Alternativo Generico in basso.
  • Scansiona il codice a barre di qualsiasi prodotto presente nel punto vendita.
  • Se il prodotto non fa già parte dell'ordine ed esiste in anagrafica, verranno mostrati descrizione e prezzo.
  • Inserisci la quantità (multiplo della confezione) e premi Conferma. Il prodotto verrà accodato con la dicitura (AGGIUNTIVO).

---

Fase 4: Chiusura dell'Ordine e Ripartizione Imballaggi

Una volta terminato il prelievo (e le eventuali sostituzioni), tocca il pulsante Conferma Spesa per accedere alla schermata di imballaggio e immettere i seguenti dati obbligatori:

1. Numero di Colli (Pacchi): digita il numero di scatole/borse totali utilizzate per contenere la spesa del cliente (il valore deve essere maggiore di zero).

2. Scatole utilizzate: indica il numero di scatole di cartone rigide utilizzate per il confezionamento.

3. Shopper utilizzati: indica il numero di borse in plastica/carta biodegradabile utilizzate.

4. Controlli di Quadratura degli Imballaggi:

  • Per garantire un rendiconto dei costi corretto, il palmare effettua i seguenti controlli incrociati prima di sbloccare la chiusura:
  • Il numero di scatole inserito non può superare il numero totale di colli:

$$\text{Scatole} \le \text{Colli Totali}$$

  • Il numero di shopper inserito non può superare il numero totale di colli:

$$\text{Shopper} \le \text{Colli Totali}$$

  • La somma combinata di scatole e shopper non può mai essere superiore al numero totale di colli dichiarati:

$$\text{Scatole} + \text{Shopper} \le \text{Colli Totali}$$

5. Chiusura: Se i controlli sono soddisfatti, premi Conferma. Lo stato dell'ordine sul server passerà a *"Pronto per il Ritiro"* (Stato P), notificando il cliente tramite SMS o email.

  • *Nota*: In caso di rifiuto dell'ordine per totale irreperibilità di merce idonea, lo stato verrà aggiornato in *"Rifiutato"* (Stato N, D o R) e l'ordine verrà annullato.

---

2. Click & Collect (Gestione Pacchi in Negozio)

Questa procedura gestisce i pacchi e-commerce ordinati dai clienti e spediti al punto vendita per il ritiro self-service.

Ricezione Pacchi (Da Corriere/Magazzino Centrale)

Questa fase serve a registrare l'arrivo fisico dei pacchi in negozio.

1. Seleziona Click & Collect dal menu e tocca Ricezione Pacchi.

2. Il palmare mostrerà la lista delle spedizioni in transito previste per il negozio.

3. Inquadra il codice a barre applicato sul pacco consegnato dal corriere.

4. Verifiche e Controlli:

  • Se scansionando il pacco appare l'avviso: *"Il pacco selezionato risulta già consegnato al cliente!!!"*, contatta il responsabile di negozio.
  • Se il pacco risulta già registrato in magazzino: *"Il pacco selezionato risulta già ricevuto in negozio"*.
  • Se il pacco non è presente nella lista di spedizioni attese, il palmare mostrerà un errore: *"Il pacco non è tra quelli in attesa dal vostro punto vendita"*. Verifica di aver letto il codice corretto.

5. Conferma Ricezione:

  • Se il codice è valido, premi Conferma. KMA registrerà l'arrivo del pacco a tuo nome sul server.
  • Se l'ordine del cliente è composto da più pacchi, il palmare mostrerà un avviso: *"Il pacco è stato ricevuto correttamente. Devi ricevere altri Y pacchi di questo ordine."*. In questo modo saprai che la spedizione per quel cliente non è ancora completa.
  • Se invece era l'ultimo pacco atteso, apparirà il messaggio: *"Tutti i pacchi di questo ordine sono stati ricevuti."*.

---

Consegna al Cliente (Ritiro in Negozio)

Questa fase viene eseguita quando il cliente si presenta al banco accoglienza per ritirare la sua spesa.

1. Seleziona Click & Collect dal menu e tocca Consegna al Cliente.

2. Verrà mostrato l'elenco degli ordini presenti in negozio e pronti per la consegna (ordini i cui pacchi sono stati tutti ricevuti).

3. Seleziona l'ordine del cliente toccando la riga corrispondente in elenco (il campo scansione barcode si sbloccherà solo dopo aver selezionato la riga).

4. Scansione obbligatoria di riscontro: Prendi il pacco dallo scaffale di deposito e scansiona il suo codice a barre.

  • *Controllo di Sicurezza*: Se scansioni per errore il pacco di un altro cliente, il palmare bloccherà l'operazione con un avviso sonoro e visivo: *"Il pacco che hai letto non appartiene all'ordine che hai selezionato."*. Questo impedisce la consegna di pacchi errati.
  • Se il pacco scansionato non era stato precedentemente spuntato in ingresso dal corriere, verrà mostrato l'avviso: *"Il pacco non risulta ancora ricevuto in negozio"*.

5. Conferma Consegna:

  • Se il riscontro del barcode ha successo, tocca Conferma.
  • La consegna viene salvata sul server registrando la data/ora e la firma dell'operatore, ed emettendo un segnale acustico positivo. Se l'ordine prevedeva più colli, il palmare segnalerà quanti pacchi rimangono ancora da consegnare al cliente per completare il ritiro.

Gestione Merci e Magazzino - Palmare KMA

Questo modulo descrive le procedure operative per la gestione dei flussi di merce in entrata nel punto vendita: la spunta dei documenti di carico (DDT/Bolle) e la conferma di arrivo delle spedizioni.

---

1. Spunta e Controllo Carico (DDT)

Il controllo del carico garantisce che la merce consegnata dai fornitori o trasferita da altri punti vendita corrisponda a quanto dichiarato nei documenti di trasporto.


graph TD
    A[Avvia Controllo Carico] --> B{Seleziona Documento}
    B -->|Scansione Barcode Bolla| C{Verifica Tipo Documento}
    B -->|Inserimento Manuale Protocollo| C
    B -->|Selezione da Lista Interni/Esterni| C
    
    C -->|Carico Automatico| D[Conferma Carico Automatico]
    C -->|Carico Standard/Manuale| E[Apertura Spunta Righe]
    
    D --> F[Imposta Qtà Contata = Qtà DDT]
    F --> G[Invio Diretto al Server]
    
    E --> H{Modalità Spunta}
    H -->|Spunta Cieca| I[Visualizza solo descrizione - Qtà attesa nascosta]
    H -->|Spunta Aperta| J[Visualizza Qtà attesa da DDT]
    
    I --> K[Scansione Articoli e Conteggio]
    J --> K
    K --> L[Schermata di Completamento]
Fase 1: Selezione del Documento

1. Seleziona Controllo Carico dal menu principale del palmare.

2. Scegli il documento da elaborare in uno dei seguenti modi:

  • Scansione Barcode del Documento: Assicurati che l'interruttore a schermo sia impostato su Scan Barcode e leggi il codice a barre stampato sulla bolla cartacea.
  • Inserimento Protocollo: Imposta l'interruttore su Inserisci Protocollo, digita il numero di protocollo del documento e premi Invio.
  • Selezione da Elenco: Tocca le etichette Interni (per i trasferimenti di stock tra negozi della stessa azienda) o Esterni (per le consegne dei fornitori terzi) e seleziona il documento dalla lista visualizzata a schermo.

3. Restaurazione Bozze in Sospeso: Se il palmare si spegne o l'applicazione viene chiusa accidentalmente, KMA conserva le spunte non salvate sul server per un periodo di 3 giorni. Questi documenti sono evidenziati nella lista con un'icona a forma di spilla (pinned). Selezionandoli riprenderai la spunta dal punto in cui ti eri fermato.

4. Controllo Utente Concorrente: Se il documento è già stato preso in carico da un altro operatore, e il sistema è configurato per vietare il controllo simultaneo, apparirà l'avviso: *"Il protocollo è stato aperto dall'utente X, solo lui può continuare la spunta."* L'accesso al documento ti sarà precluso.

---

Fase 2: Carico Automatico (Bolla Veloce)

Se il documento è configurato come Carico Automatico (solitamente per spedizioni interne certificate):

1. Devi obbligatoriamente scansionare il codice a barre del documento per sbloccarlo.

2. Il palmare mostrerà la richiesta: *"Il documento verrà caricato in modo automatico. Vuoi procedere?"*

3. Premendo Sì, l'applicazione compilerà automaticamente le righe della bolla ponendo la quantità contata pari a quella attesa, assocerà ad ogni riga la nota *"Carico Automatico"*, invierà il documento al server centrale per l'archiviazione ed emetterà il segnale acustico di successo.

---

Fase 3: Spunta Articoli (Carico Standard)

All'interno del documento di spunta manuale, scansiona i prodotti uno alla volta. A seconda della configurazione del negozio, si applicheranno le seguenti logiche:

  • Spunta Cieca: Non vedrai a schermo la quantità ordinata/attesa dal fornitore. Dovrai effettuare un conteggio fisico reale senza farti influenzare dal dato teorico.
  • Spunta Aperta: A schermo viene mostrata la quantità teorica da ricevere.
  • Scansione Continua: Attivando l'interruttore Scansione Continua, ogni lettura del codice a barre del prodotto aggiunge automaticamente +1 alla quantità contata, emettendo un bip di conferma ed evitando schermate intermedie.
  • Inserimento Manuale: Se lo scanner continuo è spento, la scansione dell'articolo apre la scheda di inserimento quantità:
  • Digita la quantità riscontrata nell'apposito campo.
  • Utilizza l'Operatore Matematico per velocizzare l'inserimento:
  • Somma: Aggiunge la quantità digitata a quella precedentemente contata per quel prodotto (es. conto una seconda scatola da 6).
  • Sottrai: Sottrae la quantità indicata da quella contata (utile per correggere errori).
  • Uguale: Sovrascrive il totale contato con il valore digitato.
  • Controllo Unità di Imballo (Confezione Standard):
  • Se il prodotto ha un imballo standard (es. scatole da 6 o 12 pezzi), lo stepper di incremento del palmare aumenterà di 6 o 12 unità alla volta per facilitare il conteggio dei colli chiusi.
  • Se digiti una quantità che non è multiplo dell'imballo standard, il palmare emetterà un suono di avviso a schermo: *"La quantità indicata non è multipla della confezione standard"*. Controlla l'integrità del collo.
  • Gestione Articoli Non a Documento (Fuori Bolla):
  • Se scansioni un prodotto non inserito nella bolla originale:
  • Se il sistema vieta l'eccedenza, il palmare mostrerà un errore bloccante ed emetterà un suono cupo. Non potrai inserire l'articolo.
  • Se il sistema consente l'eccedenza, apparirà il messaggio: *"Articolo non trovato sul documento, vuoi che provo ad inserirlo?"*. Se rispondi Sì, il palmare interrogherà l'anagrafica di rete del server per recuperare la decodifica del prodotto e aggiungerà una nuova riga in fondo alla bolla.

---

Fase 4: Chiusura della Spunta e Risoluzione Anomalie

Una volta spuntata tutta la merce, tocca il pulsante Completa per accedere alla schermata riassuntiva di chiusura.


flowchart TD
    A[Schermata Chiusura Bolla] --> B{Attiva Filtro Anomalie}
    B -->|Acceso| C[Visualizza solo righe con discrepanze]
    B -->|Spento| D[Visualizza elenco completo prodotti]
    
    C --> E{Verifica Congruità Righe}
    D --> E
    
    E -->|Differenze senza Nota| F[Pulsante Conferma NASCOSTO]
    F --> G[Operatore seleziona la riga difforme]
    G --> H[Seleziona Nota Anomalia obbligatoria]
    H --> E
    
    E -->|Tutte le differenze giustificate| I[Pulsante Conferma VISIBILE]
    I --> J[Pulsante Conferma premuto]
    J --> K[Documento inviato al Server - Stato Terminato]

1. Filtro Anomalie: Attiva l'interruttore Anomalie per isolare a schermo solo i prodotti la cui quantità contata differisce da quella dichiarata in bolla (righe evidenziate in rosso).

2. Regole di Quadratura Obbligatorie:

  • Se un prodotto presenta una differenza (in difetto o in eccesso) rispetto al documento, devi obbligatoriamente assegnare una nota di giustificazione. Se anche solo una riga difforme è priva di nota, il pulsante Conferma finale rimarrà nascosto.
  • Tocca la riga anomala per aprire il menu di selezione note e seleziona una delle motivazioni predefinite:
  • Per articoli in difetto (mancanti):
  • ARRIVATO ROTTO (merce danneggiata durante il trasporto)
  • ARRIVATO SCADUTO (merce con scadenza non conforme consegnata dal fornitore)
  • BARCODE NON RICONOSCIUTO (prodotto corretto ma codice a barre illeggibile o non codificato)
  • MANCANTE (il fornitore non ha inserito l'articolo nel pacco)
  • Per articoli in eccesso (più merce del previsto):
  • QTA MAGGIORE DELLA QTA DDT

3. Conferma e Invio:

  • Una volta giustificate tutte le anomalie, tocca il pulsante Conferma.
  • Conferma l'avviso a schermo: *"Stai per concludere la procedura di carico, non sarà più possibile modificare il documento. Vuoi procedere?"*
  • Il palmare invierà la bolla chiusa al server (stato *Terminato*) e cancellerà la copia di sicurezza locale.
  • Se sei offline: Il palmare mostrerà un errore di rete ma salverà i dati localmente nel database interno per consentirne l'invio non appena tornerà disponibile la connettività.

---

2. Conferma Arrivo Merci

Questa funzione viene utilizzata alla ricezione della merce sul retro del negozio per registrare l'arrivo fisico dei bancali o dei colli consegnati dai vettori, prima ancora che venga effettuata la spunta dei singoli articoli.

Passaggi operativi:

1. Seleziona Conferma arrivo merce dal menu principale.

2. Inquadra con il lettore il codice a barre della spedizione applicato sul pallet o sulla lettera di vettura (oppure digita il codice nel campo Codice Spedizione e tocca l'icona di ricerca).

3. Controllo Destinazione: Il palmare verifica che la spedizione sia indirizzata al tuo punto vendita. Se la spedizione appartiene ad un altro store, il palmare mostrerà un avviso bloccante: *"Attenzione: Il documento è di un altro punto vendita (Nome Store)"* e non ti permetterà di proseguire.

4. Visualizzazione Dati: A schermo verranno riepilogate le informazioni della spedizione: Nome del Fornitore, Numero Bolla, Data del documento e Negozio destinatario.

5. Inserimento colli:

  • Digita il numero di Bancali fisicamente ricevuti (deve essere un valore maggiore di zero).
  • Digita eventuali note nel campo Note (es. *"Bancale scondizionato"*, *"Accettato con riserva per imballo bagnato"*).

6. Conferma:

  • Tocca il pulsante Conferma.
  • Rispondi Sì alla richiesta: *"Vuoi procedere con la conferma dell'arrivo di questa merce?"*.
  • L'arrivo viene registrato sul server a tuo nome, autorizzando la successiva fase di spunta degli articoli.

Operazioni di Inventario - Palmare KMA

KMA supporta due modalità di inventario: l'Inventario Standard (di fine anno o straordinario, solitamente diviso per zone fisiche del punto vendita) e l'Inventario Ciclico (parziale, periodico o mirato su specifici prodotti/reparti).

---

1. Inventario Standard

L'inventario standard organizza i conteggi del punto vendita mappando i prodotti all'interno di aree o scaffali fisici chiamati Zone.


graph TD
    A[Avvia Inventario] --> B{Seleziona Richiesta Attiva}
    B --> C[Seleziona Zona Fisica]
    C --> D{Scegli Fascia di Scadenza}
    D --> E[Scansione Articolo]
    
    E -->|Non in anagrafica richiesta| F{Richiedi Aggiunta?}
    F -->|Sì| G[Recupero Costo da Server + Inserimento]
    F -->|No| H[Annulla Lettura]
    
    E -->|In anagrafica| I{Scegli Modalità Conteggio}
    I -->|Scansione Continua| J[Incremento +1 automatico - Campi bloccati]
    I -->|Inserimento Manuale| K[Digita Qtà e seleziona Somma/Sottrai/Uguale]
    
    J --> L[Salvataggio Diretto su Server]
    K --> L
Fase 1: Impostazione Zona e Scadenza

1. Tocca Inventario nel menu principale del palmare.

2. Seleziona la sessione d'inventario attiva dall'elenco.

3. Selezione Zona: Tocca il menu a tendina Zona e seleziona l'area fisica in cui ti trovi (es. *"Scaffale 03"*, *"Cella Frigo 1"*). Non è possibile avviare una scansione se non è stata selezionata una zona.

4. Fascia di Scadenza: Se l'inventario prevede il monitoraggio dei lotti di freschezza, tocca il menu Scadenze e seleziona la fascia temporale appropriata per l'articolo da contare (es. *"Nessuna scadenza"*, *"Scade entro il..."*, *"Scade oltre il..."*).

---

Fase 2: Lettura Articoli

Scansione il codice a barre del prodotto (o digita il codice interno disattivando lo scanner barcode):

  • Articoli Fuori Richiesta (Non a Inventario): Se scansioni un prodotto non previsto per quella sessione di inventario, il palmare mostrerà la richiesta: *"L'articolo non fa parte della richiesta di inventario, lo inserisco?"*.
  • Se rispondi Sì, l'applicazione interrogherà il server per recuperare il costo dell'articolo (informazione necessaria per calcolare la valorizzazione dello stock) e lo aggiungerà alle liste locali dell'inventario.
  • Modalità Scansione Continua:
  • Attivando l'interruttore Scansione Continua, il palmare nasconde la tabella riassuntiva e blocca i campi di testo. Ogni scansione incrementerà di +1 la quantità nella zona/scadenza impostata, consentendo di contare gli scaffali ad alta velocità.
  • Modalità Inserimento Manuale:
  • Se la scansione continua è disattivata, vedrai a schermo i dettagli del prodotto: descrizione, stock teorico (se abilitato da configurazione), quantità già contata nella zona corrente e quantità totale contata nel negozio.
  • Digita il quantitativo e scegli se usare l'operatore matematico Somma, Sottrai o Uguale (per sovrascrivere).
  • Tocca Conferma. KMA salverà immediatamente la lettura sul server centralizzato. In caso di errore di connessione, il palmare chiederà ripetutamente: *"Non sono riuscito a salvare questa modifica, riprovo?"*. Premi Sì per ritentare l'invio.

---

Fase 3: Importazione da Contenitore (Caricamento di Massa)

Se hai precedentemente raggruppato e contato una serie di prodotti all'interno di un contenitore logico (vedi modulo *Gestione Merci e Magazzino*):

1. Assicurati di aver selezionato la Zona fisica corretta nel palmare.

2. Tocca il pulsante Contenitore (disponibile se hai le autorizzazioni necessarie).

3. Seleziona il contenitore desiderato dall'elenco (sono visibili solo i contenitori contrassegnati come Chiusi).

4. Scegli la Fascia di Scadenza da associare a questi prodotti e premi Conferma.

5. Il palmare importerà in blocco tutti gli articoli del contenitore all'interno della zona fisica attiva dell'inventario, aggiornando le quantità sul server. In caso di errore per singoli prodotti, verrà mostrata una lista dei codici non importati.

---

Fase 4: Revisione e Reset delle Zone Fisiche

Nella parte inferiore della schermata d'inventario viene visualizzato il riepilogo delle zone lavorate.

  • Dettaglio Zona: Tocca il pulsante Dettaglio in corrispondenza di una zona per vedere l'elenco di tutti i prodotti contati all'interno di quell'area fisica. Se rilevi un errore, tocca l'articolo per caricarlo direttamente nella schermata di conteggio e correggerne la quantità.
  • Reset Zona (Cancellazione): Se una zona è stata contata in modo errato o da due operatori contemporaneamente, tocca il pulsante Reset accanto alla zona (se abilitato da configurazione). Conferma il messaggio: *"Hai premuto il tasto di reset per la zona X, vuoi azzerare tutte le quantità contate per questa zona?"*. Tutti i conteggi di quella zona verranno cancellati sia sul palmare che sul server centrale.

---

2. Chiusura e Quadratura Inventario

Una volta completati i conteggi fisici in tutte le zone del punto vendita, tocca il pulsante Completa per accedere alla quadratura.


sequenceDiagram
    autonumber
    Operatore->>Palmare: Clicca su Completa Inventario
    Palmare->>Server: Richiesta dettagli inventario (GetInventoryProductsDetails)
    Server-->>Palmare: Restituisce quantitativi e costi
    Note over Palmare: Calcola differenza economica totale
    Note over Palmare: Abilita Filtro Differenze (contato != richiesto)
    Operatore->>Palmare: Clicca su Chiudi Inventario
    Palmare->>Operatore: Chiede Prima Conferma (Confermare e Archiviare?)
    Operatore->>Palmare: Clicca SI
    Palmare->>Operatore: Chiede Seconda Conferma (Sicuro di voler procedere?)
    alt Operatore clicca SI
        Note over Palmare: Annulla la chiusura e torna alle modifiche
    else Operatore clicca NO
        Palmare->>Server: Invia Chiusura Definitiva (SetInventoryClose)
        Server-->>Palmare: Inventario archiviato con successo
    end
Procedure di Quadratura e Chiusura:

1. Analisi degli Scostamenti: A schermo viene mostrato il Valore Totale della Differenza Inventariale espresso in valuta, calcolato come la somma della differenza tra stock contato e stock teorico moltiplicato per il costo del prodotto:

$$\text{Differenza Economica} = \sum (\text{Quantità Contata} - \text{Quantità Teorica}) \times \text{Costo Prodotto}$$

2. Filtro Differenze: Attiva l'interruttore Differenze per isolare solo i prodotti che presentano discrepanze tra stock teorico e reale. È possibile cercare un prodotto specifico per descrizione o codice tramite la barra di ricerca.

3. Analisi per Prodotto: Toccando l'icona informativa di un articolo, il palmare mostra la scomposizione delle letture, indicando in quali zone del negozio è stato contato e per quali quantità. Toccando una riga di dettaglio zona verrai reindirizzato direttamente alla schermata di modifica del conteggio di quella zona.

4. Doppia Conferma di Sicurezza (Salvataggio Antierrore):

  • Per evitare la chiusura accidentale di un inventario non terminato, KMA adotta una logica di sicurezza a doppia domanda:
  • Domanda 1: *"Stai per chiudere l'inventario, tutti i dati saranno archiviati... vuoi procedere?"*. Premi Sì per andare al passaggio successivo.
  • Domanda 2 (Blocco di Sicurezza): *"Questa è l'ultima occasione per fermare la procedura di chiusura, premi SI per FERMARE la chiusura dell'inventario?"*.
  • ATTENZIONE: Per chiudere definitivamente l'inventario devi premere NO. Se premi SI, la procedura viene interrotta e verrai riportato alla schermata di modifica per consentire ulteriori controlli.

---

3. Inventario Ciclico

L'inventario ciclico viene utilizzato per eseguire conteggi a rotazione su liste ristrette di prodotti inviate dal sistema gestionale centrale (proposte di inventario).

Passaggi operativi:

1. Seleziona Inventario Ciclico dal menu principale.

2. Regola di Esclusione Concorrente: Seleziona una proposta di inventario ciclico dall'elenco.

  • *Regola*: Al momento della conferma, la proposta selezionata viene bloccata a tuo nome sul server. Per evitare sovrapposizioni, l'elenco nasconderà tutte le altre proposte cicliche disponibili in negozio. Sarai obbligato a completare l'inventario ciclico aperto (o ad annullarlo sbloccandolo) prima di poterne visualizzare o selezionare altri.

3. Scansione e Conteggio:

  • Scansiona l'articolo o inserisci il codice. Se l'articolo letto non appartiene alla proposta selezionata, il palmare rifiuterà la lettura mostrando l'errore: *"Barcode letto non trovato"*.
  • Inserisci la quantità contata (Somma/Sottrai/Uguale).
  • Conferma la riga per contrassegnare il prodotto come spuntato (a schermo apparirà una spunta verde accanto al prodotto).

4. Chiusura:

  • Quando tutti i prodotti della lista risultano spuntati, si attiverà il pulsante Conferma Generale.
  • La schermata di chiusura mostrerà lo scostamento economico complessivo. Premi Conferma per completare l'allineamento dello stock sul server e sbloccare l'applicazione per le successive proposte.

Manuale Operativo KMA (Key Mobile App) - Introduzione e Avvio

Benvenuto nel manuale operativo di KMA (Key Mobile App), l'applicazione mobile per palmari e terminali portatili Android utilizzata dal personale del punto vendita. KMA consente di gestire tutte le operazioni di reparto e di magazzino in mobilità: controllo carichi, inventari, controllo scadenze, prelievo ordini e-commerce (picking) e rilevazione prezzi dei competitor.

---

Indice dei Moduli del Manuale

1. [Introduzione e Avvio (README.md)](file:///C:/KSolution/KMA/Manuale/README.md)

  • Guida alla connessione (Riposiziona), manutenzione del database locale, abilitazione lettore e login.

2. [Gestione Merci e Magazzino](file:///C:/KSolution/KMA/Manuale/Gestione_Merci_e_Magazzino.md)

  • Controllo Carico (Spunta bolle DDT), Spunta cieca o automatica, note anomalie e Accettazione Spedizioni.

3. [Operazioni di Inventario](file:///C:/KSolution/KMA/Manuale/Operazioni_di_Inventario.md)

  • Inventario standard per zone e scadenze, importazione da contenitori, chiusura con doppia conferma e inventario ciclico programmato.

4. [Controlli di Reparto](file:///C:/KSolution/KMA/Manuale/Controlli_di_Reparto.md)

  • Controllo Scadenze (Freshness Control) con immissione facilitata e Rilevazione prezzi dei concorrenti (Price Detection offline).

5. [E-commerce e Fulfillment](file:///C:/KSolution/KMA/Manuale/E-commerce_e_Fulfillment.md)

  • Prelievo ordini Pick From Store (con gestione prodotti alternativi/generici), Ricezione e Consegna pacchi Click & Collect.

---

1. Connessione alla Cassa Master (Riposiziona)

Il terminale palmare comunica in tempo reale con la Cassa Master del negozio tramite la rete WiFi locale. All'avvio dell'applicazione, o in caso di cambio rete o perdita di connettività, il palmare deve essere "localizzato" per potersi agganciare alla cassa master corretta.


sequenceDiagram
    autonumber
    Palmare->>Rete WiFi: Avvio ricerca Cassa Master (UDP Broadcast)
    alt Cassa Master risponde correttamente
        Rete WiFi-->>Palmare: Connessione stabilita
        Note over Palmare: Sincronizzazione autorizzazioni
        Palmare->>Schermata Login: Reindirizzamento automatico
    else Connessione fallita / Offline
        Rete WiFi-->>Palmare: Timeout connessione
        Note over Palmare: Visualizza icona Wi-Fi disattivata
        Palmare->>Operatore: Messaggio "Tentativo fallito" (Abilita tasto Riprova)
    end
Procedura di Connessione (Riposiziona)

1. Dalla schermata iniziale del palmare, seleziona la voce Riposiziona (icona con segnaposto di localizzazione).

2. L'applicazione mostrerà a schermo il messaggio: *"Tentativo di connessione alla cassa master in corso..."* e tenterà di rilevare l'indirizzo IP della cassa master.

3. Se il collegamento ha successo:

  • L'icona del WiFi diventerà blu (ic_wifi.png) e apparirà la dicitura *"Trovata"*.
  • Verrai automaticamente reindirizzato alla schermata di Login.

4. Se il collegamento fallisce:

  • L'icona del WiFi diventerà grigia/barrata (ic_wifi_off.png) e apparirà il messaggio *"Tentativo di connessione fallito"*.
  • Si attiverà il pulsante Riprova. Verifica che il palmare sia collegato alla rete WiFi corretta del negozio e premi Riprova.

---

2. Manutenzione del Database Interno (Compattazione)

Per consentire l'utilizzo offline di alcune funzioni (es. la rilevazione prezzi concorrenti o la ricerca rapida dei prodotti), il palmare memorizza una copia dell'anagrafica in un database locale. Se questo database diventa troppo grande, potrebbe rallentare il palmare. KMA esegue una manutenzione automatica all'avvio della localizzazione:

  • Soglia di Attenzione (> 100 Megabyte):
  • Se la dimensione del database supera i 100 MB, il palmare mostra un avviso: *"Alla pressione del tasto OK inizierà la compattazione del database interno. È necessario attendere qualche minuto al termine della compattazione."*
  • Premi OK e attendi che il processo finisca senza spegnere il palmare.
  • Soglia di Emergenza (> 1 Gigabyte):
  • Se il database supera 1 GB (1000 MB), le prestazioni sono compromesse. Il palmare mostrerà un avviso e procederà alla cancellazione e successiva ricostruzione pulita del database locale. Attendi che il processo sia completato.

---

3. Gestione manuale del lettore Barcode (Scanner)

In alcune schermate di errore o configurazione, potrebbe essere necessario accendere o spegnere manualmente il fascio di luce del lettore di codici a barre integrato nel palmare. Nella schermata di localizzazione sono presenti due tasti dedicati:

  • Attiva Scanner: accende l'hardware del lettore del palmare.
  • Disattiva Scanner: spegne l'hardware del lettore (utile per risparmiare batteria o evitare letture accidentali).

---

4. Procedura di Accesso (Login)

Una volta stabilita la connessione con la cassa master, viene mostrata la schermata di login.


graph TD
    A[Schermata Login] --> B{Seleziona Store/Negozi}
    B --> C{Seleziona Anno di Esercizio}
    C --> D{Scegli Modalità di Accesso}
    D -->|Scansione Badge| E[Leggi Barcode Personale]
    D -->|Digitazione| F[Inserisci Login Name + Password]
    E --> G[Pulsante Accedi]
    F --> G
    G --> H{Verifica Credenziali}
    H -->|OK| I[Reindirizzamento a Home Menu]
    H -->|KO| J[Errore: Utente non riconosciuto]
Passaggi operativi per il Login:

1. Selezione Negozio: Tocca il menu a tendina del punto vendita (Store) e seleziona il tuo negozio di riferimento (se nel database è presente un solo punto vendita, questo verrà selezionato automaticamente).

2. Selezione Esercizio: Seleziona l'anno di esercizio corrente dal menu a tendina (di default è impostato l'anno solare corrente).

3. Scelta modalità di inserimento:

  • Modalità Lettura Badge (Consigliata):
  • Assicurati che l'interruttore a schermo sia impostato su Scan Barcode (la tastiera virtuale viene nascosta).
  • Punta il lettore sul codice a barre del tuo badge personale e premi il grilletto di scansione. L'accesso avverrà istantaneamente.
  • Modalità Digitazione manuale:
  • Sposta l'interruttore su Login Name.
  • Tocca il campo e digita il tuo nome utente tramite la tastiera, premi invio per spostarti sul campo password, inserisci la password e tocca il pulsante Accedi.

4. Verifica:

  • Se le credenziali sono corrette, il palmare emetterà un segnale acustico positivo di conferma e caricherà il menu principale.
  • In caso contrario, verrà mostrato in rosso il messaggio *"Utente non riconosciuto"* ed emesso un suono di errore. Riprova la lettura o l'inserimento delle credenziali.
Nessun risultato per la ricerca.
KEY · TO · RETAIL · ®