Distribuzione HoReCa: digitalizzare l ordine ristorante

Ordini ristorante via WhatsApp, listini per canale (HoReCa, GDO, e-commerce), agenti commerciali, workflow stato. Come funziona il modulo distribuzione vino in Loogico.

Una cantina vinicola italiana media vende attraverso 3 canali distinti:

B2C web — e-commerce cantina (proprietario)
Cantina diretta — punti vendita / fiere / degustazioni
B2B HoReCa — ristoranti, enoteche, wine bar, hotel, distributori, importatori

Il canale HoReCa è quello più frammentato e tipicamente il meno digitalizzato: ordini che arrivano via email, WhatsApp, telefono, fax (sì, ancora). Nessuna visibilità in tempo reale. Provvigioni agente calcolate a fine mese su Excel.

Loogico Vino edition include il modulo Distribuzione B2B HoReCa completo, con anagrafica clienti, listini per canale, ordini con workflow stato, e calcolo provvigioni automatico.

Anagrafica clienti HoReCa

Il modello dati distingue il cliente HoReCa dal cliente core (clienti table comune al gestionale). La tabella vino_clienti_horeca ha attributi specifici di canale:

Tipo attività — RISTORANTE / ENOTECA / WINE_BAR / HOTEL / WHOLESALER / IMPORTATORE
Indirizzo consegna (può differire dalla sede legale)
Contatto referente (chef, sommelier, gestore acquisti)
Agente di riferimento (chi segue il cliente)
Listino prezzi attivo (per canale)
Stato (attivo / inattivo)

Una enoteca di Roma specializzata in vini biodinamici riceverà un listino diverso da una catena di hotel 5 stelle — sia in termini di etichette proposte che di sconti volume.

Listini per canale

In vino_listini definisci listini multipli, ognuno con:

Nome (es. “HoReCa Centro Italia 2026”)
Canale (B2C_WEB / B2B_HORECA / CANTINA_DIRETTA)
Validità (data inizio + data fine, opzionali)
IVA (inclusa o esclusa, aliquota %)
Stato (attivo / disattivato)

Per ogni etichetta in catalogo, una riga vino_listini_righe definisce:

Prezzo unitario (per bottiglia 0.75L)
Sconto volume (es. 5% sopra 60 bottiglie)
Disponibilità minima d’ordine (es. cassa da 6)

L’agente che inserisce un ordine vede automaticamente i prezzi corretti per il canale del cliente.

Workflow stato ordine

Ogni ordine HoReCa attraversa un workflow di stato esplicito:

BOZZA → CONFERMATO → IN_PREPARAZIONE → SPEDITO → CONSEGNATO
                                               ↘ ANNULLATO (da qualsiasi stato)

Cosa succede ad ogni transizione:

BOZZA → CONFERMATO: ordine validato dall’agente, vincola le quantità in catalogo
CONFERMATO → IN_PREPARAZIONE: cantina inizia a preparare la spedizione
IN_PREPARAZIONE → SPEDITO: pacco affidato al corriere, traccia inserita
SPEDITO → CONSEGNATO: consegna verificata. Trigger automatico provvigione agente.
* → ANNULLATO: rilascia le quantità in catalogo, registra reason

Ogni transizione è tracciata nell’audit log con timestamp + utente + IP.

Provvigioni agenti automatiche

Quando un ordine passa a CONSEGNATO, il VinoOrdineHorecaController.transizione() invoca automaticamente il VinoProvvigioneCalculatorService::calcolaPerOrdine($ordine).

Il servizio:

Identifica l’agente dall’agente_riferimento del cliente (matching token-based)
Seleziona lo scaglione appropriato in base al volume dell’ordine + canale (priorità canale-specifico → catch-all)
Calcola la provvigione = imponibile_ordine × percentuale_scaglione
Registra il calcolo in vino_provvigioni_calcoli con snapshot immutabile (idempotente per (agente, ordine))

Esempio scaglioni configurabili per agente “Mario Rossi”:

Range volume	Canale	Percentuale
0–500 €	B2B_HORECA	8%
500–2.000 €	B2B_HORECA	10%
2.000+ €	B2B_HORECA	12%
0–∞	* (catch-all)	5%

Un ordine HoReCa da 1.200 € genera 120 € di provvigione (10% scaglione 500-2.000) calcolata in automatico, visibile nel report periodo agente, segnabile come “pagata” alla data del bonifico.

Pagina /vino/distribuzione/ordini

L’index degli ordini ha:

Hero con KPI clienti HoReCa, ordini in corso, da spedire, consegnati 30gg
Tabella infinita con scroll continuo (no pagine), filtri stato + agente
Click ordine → detail con righe, totali, workflow transitions, agente, provvigione calcolata

E sulla pagina dell’ordine: bottoni “Conferma”, “In preparazione”, “Spedito”, “Consegnato” che applicano la transizione di stato e triggerano i side-effect (es. calcolo provvigione).

Cosa cambia per la tua cantina

✓ Anagrafica clienti HoReCa strutturata, non più foglio Excel ✓ Listini per canale automatici quando inserisci l’ordine ✓ Workflow stato esplicito con audit di chi ha fatto cosa ✓ Provvigioni calcolate automaticamente al CONSEGNATO ✓ Niente più Excel a fine mese per quadrare gli importi agente

E se hai un agente che lavora con 50 ristoranti, gli mostri il suo report periodo (calcoli + da pagare + pagato) con un click.

Esplora edition Vino →