Tracciare i bollini Stato in cantina senza errori

I bollini di Stato dell’Agenzia Dogane Monopoli (ADM) sono fascette numerate che ogni bottiglia di vino DOC/DOCG italiana deve riportare. Per la cantina, significa che ogni serie di bollini ricevuta dall’ADM va tracciata: quanti hai, quanti hai consumato, quanti residui, con range numerico sequenziale.

In molte cantine questo tracciamento si fa ancora a mano sui quaderni. Errore facile, sanzione potenziale.

Loogico Vino offre un sistema di tracciamento bollini integrato con il movimento di imbottigliamento: 1 bottiglia = 1 bollino consumato in automatico.

Anatomia di una serie bollini

Ogni serie ricevuta dall’ADM ha:

• Codice serie (es. S-2026-001)
• Range numerico (es. da 0000001 a 0050000 → 50.000 bollini)
• Data acquisto
• Categoria (DOC, DOCG, IGT)
• Costo (per quadratura amministrativa)

Queste 5 info bastano per gestire il ciclo di vita della serie.

Modello dati Loogico

Loogico Vino crea due tabelle dedicate:

vino_bollini_serie
├─ codice_serie (univoco)
├─ data_acquisto
├─ range_da, range_al
├─ quantita_totale (calcolata)
├─ quantita_consumata (incrementata ad ogni imbottigliamento)
├─ quantita_residua (calcolata)
├─ percentuale_consumata
├─ sotto_soglia_reorder (boolean alert)
└─ attiva (false quando esaurita)

vino_bollini_consumi (append-only)
├─ serie_id (FK)
├─ movimento_id (FK al imbottigliamento)
├─ quantita_consumata
├─ range_da_consumato, range_al_consumato
├─ data_consumo
└─ operatore

Hook automatico al imbottigliamento

Quando registri un movimento IMBOTTIGLIAMENTO (es. 600 litri di Sangiovese 2024 imbottigliati in formato 0.75L → 800 bottiglie), il VinoMovimentoController.store() invoca automaticamente il VinoBolliniSimulatorService::consuma($movimento, 800).

Il servizio fa FIFO selection: trova la serie più vecchia ancora attiva, ne consuma 800 bollini sequenziali, registra il consumo nel log append-only vino_bollini_consumi. Se la serie attiva ha solo 300 residui, ne consuma 300 dalla prima e 500 dalla successiva.

// Esempio invocazione automatica
$movimento = VinoMovimento::create([
    'tipo' => 'IMBOTTIGLIAMENTO',
    'lotto_id' => $lotto->id,
    'volume_litri' => 600,
    // ...
]);

$bottiglie = floor($movimento->volume_litri / 0.75);  // 800
app(VinoBolliniSimulatorService::class)->consuma($movimento, $bottiglie);
// → Aggiorna serie_attiva.quantita_consumata += 800
// → Crea record in vino_bollini_consumi
// → Se serie_attiva.residua < soglia_reorder, marca alert

Best-effort: l’eventuale errore di consumo (es. nessuna serie attiva con stock sufficiente) non blocca il movimento. L’amministratore vede l’alert nella dashboard bollini e ricarica le serie.

Dashboard stock + alert reorder

La pagina /vino/cantina/bollini mostra in real-time:

• 4 KPI: serie attive, bollini totali ricevuti, consumati, residui
• Alert reorder: serie sotto la soglia (es. residui < 1.000) con badge rosso
• Lista serie: con progress bar di consumo (verde sotto 80%, ambra 80-95%, rosso oltre 95%)
• Storico consumi per ogni serie (drill-down)

Alert visivi inviano un segnale chiaro: “stai per esaurire la serie attiva, ordina la prossima”.

Modalità simulazione vs telematica

Loogico Vino è in modalità simulazione di default: tracciamento end-to-end ma niente integrazione live con i sistemi telematici ADM.

La modalità live richiede:

• Registrazione e accreditamento ADM Dogane
• Stock fisico bollini in cantina
• Validazione amministrativa con commercialista (~€500-1.500)

Le cantine sotto la soglia di volume non sono comunque obbligate al telematico. La simulazione end-to-end è sufficiente per audit interno, controllo gestione, prevenzione errori.

Cosa cambia per la tua cantina

✓ Bollini consumati in automatico al imbottigliamento (no scrittura manuale) ✓ Range numerico sequenziale garantito (no doppi consumi) ✓ Alert reorder prima che la serie si esaurisca ✓ Audit log completo dei consumi (chi, cosa, quando) ✓ Niente quaderni cartacei — tutto digitale + esportabile

Esplora edition Vino →