Documentazione KSIDol > Moduli KSIDol > Negozio (KSIRetail)

Guida del modulo: Negozio (KSIRetail)

Una guida non tecnica: a cosa serve il modulo, come usarlo ogni giorno e come si integra con Dolibarr.

Tab aggiunte alle schede native13

Permessi dedicati17

Lingue disponibili5 (650 voci ciascuna)

Compatibilità Dolibarrda v18 a v24

1. Panoramica del modulo

KSIRetail trasforma Dolibarr in una cassa da negozio completa, senza mai uscire dai suoi oggetti nativi: prodotti, giacenze, fatture, note di credito e ordini fornitore restano quelli che già conoscete. Al banco, la vendita a scanner, le sessioni di cassa tracciate e le chiusure sigillate rispondono alla normativa francese antifrode IVA (NF525). Dietro le quinte, inventari, trasferimenti, ricevimenti e riordino dialogano con i magazzini e gli ordini fornitore nativi. Fidelità, carte regalo, promozioni e connettori per la vendita online completano il quadro, per un negozio gestito dall'inizio alla fine direttamente da Dolibarr.

Cassa impostata sulla scansione, pensata per la velocità al banco
Sessioni di cassa tracciate e chiusure sigillate, in linea con i requisiti NF525
Più codici a barre per articolo e stampa etichette direttamente dal browser
Inventari, trasferimenti e ricevimenti gestiti negozio per negozio, sulla giacenza nativa Dolibarr
Riordino calcolato in automatico, resi e note di credito collegati alle fatture native
Programma fedeltà, carte regalo e promozioni mirate
Connettori per la vendita online, senza copiare i dati fuori da Dolibarr
Disponibile in 5 lingue, compatibile dalle versioni Dolibarr v18 a v24

2. Un modulo che si appoggia a Dolibarr, senza duplicare nulla

KSIRetail non crea alcun circuito parallelo a Dolibarr: si innesta sugli oggetti che già utilizzate.

Prodotti, giacenze, fatture, pagamenti, note di credito e ordini fornitore restano gli oggetti nativi di Dolibarr: nulla viene duplicato in un database separato.
Il modulo aggiunge 13 tab alle schede esistenti (terzi, fatture, prodotti, fornitori, ordini fornitore, ricevimenti, magazzini, utenti...) invece di creare nuove schermate isolate.
17 permessi distinti permettono di dare a ciascuno esattamente ciò di cui ha bisogno, senza aprire o chiudere tutto in blocco.
I moduli di cassa (TakePOS) e di ricevimento (Receptions) non sono obbligatori: si attivano separatamente secondo le esigenze.

3. Negozi, casse e venditori

Tre elementi strutturano l'uso quotidiano: il negozio, la cassa e il venditore che la utilizza.

Ogni negozio è collegato a un magazzino Dolibarr: la giacenza del punto vendita è quella nativa di quel magazzino, non una copia separata. Questo collegamento è necessario per poter aprire una cassa.
Ogni cassa è associata a un numero di terminale TakePOS.
Un venditore può essere assegnato a uno o più negozi, con un ruolo e un negozio predefinito.
La cassa si apre solo se il venditore collegato è assegnato al negozio corrispondente.

4. La cassa al banco: scansione rapida e conformità NF525

Al banco il modulo privilegia la velocità, e ogni giornata di cassa si apre e si chiude in un quadro tracciato pensato per resistere ai controlli.

Il cursore si posiziona subito nel campo del lettore, con le anteprime dei prodotti dietro un pulsante Catalogo per non rallentare la vendita a scanner; densità, tastierino e modalità predefinita si adattano a ogni negozio o postazione.
All'apertura il venditore dichiara un fondo cassa; ogni movimento di contante durante la giornata deve essere motivato e viene marcato con data e ora.
Questi eventi sono concatenati da un'impronta crittografica: ogni movimento porta la traccia del precedente, il che rende rilevabile qualsiasi riscrittura silenziosa della cronologia.
Alla chiusura il modulo confronta, per ogni mezzo di pagamento (contanti, carta, assegno), l'importo previsto, quello dichiarato e lo scarto tra i due, poi produce un archivio sigillato e numerato, esportabile in JSON.
Se il modulo nativo di registrazione inalterabile di Dolibarr (blockedlog) è attivo, una chiusura già registrata non può più essere eliminata: può solo essere riaperta.
Questo risponde ai requisiti di sicurezza, inalterabilità e conservazione dei dati di incasso della normativa francese antifrode IVA, ma non costituisce di per sé una certificazione: presuppone un'installazione Dolibarr correttamente configurata e, se necessario, debitamente attestata.

5. Catalogo: codici a barre, etichette e importazione CSV

Ogni articolo può portare più codici, e un catalogo esistente può essere caricato senza reinserire tutto a mano.

Codice interno, EAN-8, EAN-13, UPC-A, ISBN-13, Code 128, QR code o codice fornitore possono coesistere sullo stesso articolo; la cifra di controllo è verificata per i codici numerici standard (EAN, UPC, ISBN).
Una serie di etichette si stampa direttamente dal browser, da 1 a 100 copie di uno stesso codice.
L'importazione da file CSV richiede 11 colonne documentate e un'intestazione conforme: una colonna non riconosciuta fa rifiutare l'intero file, per evitare importazioni parziali silenziose; un'anteprima è mostrata prima di ogni applicazione definitiva.
L'importazione crea o aggiorna prodotti, prezzi e codici nativi Dolibarr, ma non tocca giacenza, categorie o foto, che restano da gestire separatamente.

6. Inventari per negozio e doppio conteggio alla cieca

L'inventario si basa sull'oggetto nativo di Dolibarr, ma si gestisce negozio per negozio.

Il conteggio si effettua a scanner, in aggiunta o in valore assoluto secondo l'organizzazione, con gestione di lotti e numeri di serie.
Nulla si muove in giacenza prima della registrazione finale: si può contare e ricontare senza rischi.
Per un inventario sensibile, due persone possono contare la stessa zona alla cieca, senza vedere il valore inserito dall'altra; gli scarti tra i due conteggi vanno riconciliati manualmente prima di essere riportati nell'inventario nativo, senza alcuna validazione automatica.

7. Trasferimenti tra negozi

Spostare la giacenza da un negozio all'altro passa per una fase di transito, per mantenere la tracciabilità a ogni estremità della catena.

Il trasferimento passa per un magazzino di transito dedicato.
Il negozio destinatario controlla la merce all'arrivo e motiva eventuali scarti riscontrati.
La quantità non ancora ricevuta resta visibile nella giacenza di transito finché non viene movimentata: non c'è un passaggio automatico, il controllo resta nelle mani del personale.

8. Ricevimento merci e riordino per negozio

La merce in arrivo si riceve a scanner direttamente dall'ordine fornitore spedito, e una campagna di riordino calcola poi, negozio per negozio, cosa riordinare.

Il ricevimento può avvenire in più passaggi, ad esempio se la merce arriva in più volte o più persone partecipano; la giacenza si muove solo alla validazione del ricevimento nativo Dolibarr, che conserva la traccia del negozio e del magazzino coinvolti.
Il calcolo del riordino tiene conto della giacenza corrente, di quella in transito, degli ordini già emessi dal modulo, della vendita media giornaliera osservata in cassa, nonché dei tempi di consegna e degli imballi ripresi dalle tariffe fornitore native.
Ogni riga proposta resta modificabile o può essere scartata, indicando un motivo; gli ordini fornitore nativi vengono creati raggruppati per fornitore e lasciati in bozza per la validazione.

9. Resi clienti e note di credito

Un reso parte sempre da una fattura già validata, mai da un inserimento libero.

Questa funzione richiede un Dolibarr in cui la giacenza si scala alla fattura (parametro nativo STOCK_CALCULATE_ON_BILL), così come la vendita in cassa richiede TakePOS: una condizione dichiarata, non nascosta.
Il modulo controlla il saldo ancora restituibile prima di accettare il reso.
Viene creata e validata una nota di credito Dolibarr nativa, collegata al reso, senza mai modificare la fattura d'origine; l'articolo torna sullo scaffale o va in quarantena, secondo un motivo scritto ogni volta.

10. Fidelità e carte regalo

Il programma fedeltà si basa sui conti dei clienti già presenti in Dolibarr, mentre le carte regalo completano l'offerta per le vendite occasionali.

I conti fedeltà sono collegati ai terzi nativi, non a un database clienti separato; l'accredito dei punti è un'azione manuale dalla scheda cliente, secondo un barème impostato da voi, e non avviene automaticamente a ogni fattura pagata.
I punti si convertono in uno sconto fisso nativo Dolibarr, mai in un mezzo di pagamento parallelo, e hanno una data di scadenza gestita da un'azione dedicata.
Ogni carta regalo ha un saldo e un registro dei movimenti consultabile; il codice è mostrato una sola volta alla creazione e poi conservato solo come impronta, mai in chiaro.

11. Promozioni e sconti mirati

Le promozioni si configurano nel dettaglio, per colpire esattamente ciò che si vuole valorizzare.

Percentuale di sconto, date di validità, quantità minima, priorità tra regole, targeting per negozio, prodotto, categoria di prodotto o categoria di cliente.
Quando più regole sono applicabili, viene mantenuta solo la migliore; uno sconto manuale più favorevole inserito in cassa resta sempre valido e non è mai sovrascritto da una promozione automatica.
Ogni applicazione di promozione viene registrata.

12. Vendita online e connettori (omnicanale)

KSIRetail può dialogare con un negozio online o un altro canale di vendita, senza che i dati lascino l'installazione Dolibarr.

Tre servizi sono disponibili: ricevere un ordine, restituirne lo stato, pubblicare la giacenza disponibile di un negozio; gli ordini dal web arrivano come ordini Dolibarr nativi in bozza, con ritiro in negozio o consegna secondo il caso.
Un ordine inviato due volte dallo stesso negozio online viene elaborato una sola volta; in caso di conflitto l'ordine viene messo in quarantena e registrato in un log di sincronizzazione per il trattamento manuale.
La giacenza pubblicata corrisponde a quella nativa, ridotta di una soglia di sicurezza e delle quantità già riservate; ogni connettore ha un proprio account interno, per mantenere la traccia di chi ha fatto cosa. Questa funzione richiede che il modulo nativo di API REST di Dolibarr sia attivo.

13. Cruscotto

Novità della versione 0.5.4, un cruscotto offre una visione d'insieme dell'attività a colpo d'occhio.

Vendite del giorno, casse attualmente aperte, fatturato del mese, non pagati, elenco dei negozi e dei conti fedeltà.
Un grafico su 6 mesi incrocia fatturato e vendite incassate.
Le promozioni in corso e il punto del giorno (preventivi in attesa, fatture non saldate) completano la vista.

14. Compatibilità e lingue

KSIRetail è pensato per integrarsi a lungo termine nella vostra installazione, qualunque sia la sua versione o lingua di lavoro.

Compatibile con le versioni Dolibarr dalla v18 alla v24.
Disponibile in 5 lingue, con circa 650 voci di traduzione per lingua: nessun testo è fisso nel codice.
A parte i tre servizi di scambio con un negozio online, il modulo non effettua alcuna chiamata di rete in uscita di propria iniziativa: i dati restano nella vostra installazione Dolibarr.

15. Collegamenti con Dolibarr

Il modulo non funziona in modo isolato: si integra con i blocchi nativi di Dolibarr.

Terzi : I conti fedeltà e le carte regalo si collegano alle schede terzi native, senza un database clienti separato.
Prodotti e servizi : Gli articoli venduti in negozio restano i prodotti e servizi nativi Dolibarr, con i loro codici a barre e prezzi.
Giacenze e magazzini : Ogni negozio è collegato a un magazzino nativo: la giacenza del punto vendita è quella di Dolibarr, non una copia.
Fatture : Le vendite incassate si registrano come fatture native; i resi partono sempre da una fattura già validata.
Note di credito : Un reso accettato crea e valida una nota di credito Dolibarr nativa, collegata al reso, senza modificare la fattura d'origine.
Ordini fornitore : Il riordino crea ordini fornitore nativi, raggruppati per fornitore e lasciati in bozza.
Ricevimenti : Il ricevimento a scanner valida un ricevimento Dolibarr nativo, che conserva la traccia del negozio e del magazzino.
API REST : Gli scambi con un negozio online passano dal modulo nativo di API REST di Dolibarr.