e-label EU 2021/2117: QR + ingredienti + nutrizionale

Regolamento EU 2021/2117

1. Dichiarazione nutrizionale per 100 ml
2. Allergeni in caratteri distinguibili (solfiti obbligatori se > 10 mg/L)

Info può essere cartacea OR elettronica via QR code linkato a pagina web.

• Product name (label name del bottling)
• Vintage
• Cellar reference

Completi:

• Ingredients (JSON array di {name, allergen, e_number})
• Nutritional (JSON per 100ml: kcal, kJ, fat, sat fat, carb, sugar, protein, salt)
• Allergens (string array: ["SOLFITI", "UOVA"])
• Description i18n (descrizione marketing multilingua)
• Production note i18n (note tecniche)

Step 2 — Esempio ingredients

[ { "name": "Uva Nebbiolo", "allergen": null, "e_number": null }, { "name": "Anidride solforosa", "allergen": "SOLFITI", "e_number": "E220" }, { "name": "Acido tartarico", "allergen": null, "e_number": "E334" } ]

### Step 3 — Esempio nutritional (per 100ml)

{ "energy_kcal": 85, "energy_kj": 355, "fat_g": 0, "saturated_fat_g": 0, "carbohydrates_g": 2.5, "sugar_g": 0.5, "protein_g": 0.2, "salt_g": 0.01 }

### Step 4 — Allergens

Obbligatori:
- **SOLFITI** (sempre se SO2 totale > 10 mg/L → quasi ogni vino)

Opzionali (se applicabili):
- **UOVA** (chiarificazione albume)
- **LATTE** (caseina chiarificante)
- **PESCE** (colla di pesce chiarificante)

### Step 5 — Pubblica

Click **Pubblica** → Vinacta:
- Genera `publicSlug` stabile (no expiration EU compliance)
- Crea URL pubblico `/e-label/[publicSlug]`
- Genera QR code (PNG + SVG + PDF DIN A8)
- Inizia version tracking

### Step 6 — Stampa QR

Download formato:
- **PDF DIN A8** (52×74 mm) → da affiancare etichetta cartacea
- **PNG 500×500** → integra in design label
- **SVG vettoriale** → tipografia

Posizione consigliata: retro bottiglia, leggibile dopo apertura.

## Multilingua

E-label supporta IT/EN/DE/FR/ES dal Sprint 2 LIVE.

Cliente scansiona QR → pagina rileva lingua browser → mostra automaticamente.

Override manuale: selettore lingua in header pagina e-label.

## Persistent + Audit

⚠️ **Importante per compliance**:

- **No expiration** sul publicSlug (EU compliance)
- **Version increment** ad ogni modifica ingredients/nutritional/allergens
- **Audit log** ogni cambio: chi, quando, valori before/after
- **No delete** una volta pubblicata (solo archive con version visibile)

Esempio: se cambi ingredients per nuovo trattamento enologico:
- e-label v1 (originale) resta accessibile in /e-label/[slug]?v=1
- e-label v2 (nuovo) è default
- Audit log mostra change v1→v2 con motivo

## View tracking

Sistema traccia view per analytics (anonimo, no PII):

[/app/cellar-production/e-label](/app/cellar-production/e-label) dashboard:
- View count per e-label
- Country breakdown (geoIP anonimo)
- Lingua utilizzata
- Mobile vs desktop ratio

## Differenze e-label vs label cartacea

| Info | Cartacea | e-label |
|---|---|---|
| Ingredients | obbligatoria | obbligatoria |
| Nutritional | obbligatoria 2024 | obbligatoria |
| Allergens | font distinguibile | font distinguibile |
| Lotto | obbligatoria | opzionale (auto) |
| Volume | obbligatoria | obbligatoria |
| Alcool | obbligatoria | obbligatoria |
| Origine | obbligatoria | obbligatoria |
| Imbottigliatore | obbligatoria | obbligatoria |

⚠️ Cartacea NON sostituibile da QR. QR è "in più" per ingredients + nutritional dettagliati.

## API access

REST endpoint:

GET /api/v1/e-labels/[publicSlug]

Risposta JSON multilingua per integrazione external (sito cantina, app proprietaria).

## Costi compliance

- Vinacta e-label: **incluso** in tier Cellar
- Stampa QR aggiuntiva: €0.01-0.05 per bottiglia (variabile cartiera)
- Audit MIPAAF eventuale: gratuita, ma costa tempo (1-2h preparation con commercialista)
- Multa non-compliance: **€2.000-15.000** per produttore (Reg. UE 2021/2117 art. 119)

## Best practice

✅ **Pubblica e-label PRIMA del bottling** (label cartacea già stampata con QR)
✅ **Foto QR sulla bottiglia** in [/app/cellar-production/e-label/[id]](/app/cellar-production/e-label/[id]) (audit evidence)
✅ **Multilingua attiva** se export EU (DE/FR/ES per Germania/Francia/Spagna)
❌ Non cambiare ingredients senza version increment (audit MIPAAF audita storico)
❌ Non delete e-label pubblicata (no compliance EU)

## Prossimo step

Vai a [SIAN/MIPAAF compliance](/help/produttore/sian-mipaaf).