Vinacta

Cosa è il Marketplace B2B Vinacta

Produttori ↔ Enoteche (sub-tenants Enterprise)
Produttori ↔ Distributori (Enterprise tier)

Step 1 — Crea relationship

Per nome ristorante (es. "Osteria del Vino Milano")
Per P.IVA (esatto)
Per email OWNER

Invia richiesta → cliente accept → relationship LIVE.

Cliente assegnato (relationship LIVE)
Vino + prezzo + condizioni:
SKU (bottling reference)
Prezzo unitario €
Minimum order quantity (es. 6 bottiglie cassa)
Sconto volume (es. 5% > 50 bottiglie)
Validità da/al

Cliente vede solo questo listino nel suo marketplace.

Vino richiesto + quantità
Note (urgenza, vincoli particolari)
Deadline risposta

Step 4 — Genera Quote

Prezzo unitario (default da listino, override possibile)
Disponibilità stock (check inventory auto)
Termini pagamento (15gg, 30gg, contanti)
Termini consegna (corriere + costo)
Validità quote (default 7gg)

Invia → cliente riceve notifica.

DRAFT → QUOTED → ACCEPTED → PAID → SHIPPED → DELIVERED


Tu vedi in [/app/marketplace/orders](/app/marketplace/orders):

- Ordini DRAFT (cliente sta creando)
- QUOTED (in attesa response cliente)
- ACCEPTED (da pagare)
- PAID (paid, da spedire)
- SHIPPED (corriere tracciamento)
- DELIVERED (completato, fattura SDI auto-generata)

## Step 6 — Stripe Connect

[/app/settings/billing/stripe-connect](/app/settings/billing/stripe-connect):

Setup account Stripe Connect Custom (Enterprise tier):
1. Verifica identity (KYC)
2. Submit business documents
3. Receive payouts setup
4. Vinacta application fee 1.5% sui transactions

Quando cliente paga ordine:
- Stripe destination_charge directly al tuo account
- Vinacta application fee 1.5% trattenuto auto
- Payout settimanale al tuo IBAN

## Step 7 — Logistica corrieri

[/app/marketplace/orders/[id]/shipping](/app/marketplace/orders/[id]/shipping):

5 adapter pre-integrati:
- **GLS Italia** (Italia + intra-UE)
- **BRT Bartolini** (Italia)
- **SDA** (Italia)
- **DirectFromItaly** (export specialista vino)
- **Mock** (development + test)

Crea spedizione:
- Tracking ID auto-generato
- Etichetta PDF download
- Label cliente con QR tracking
- Email cliente con tracking link

## Step 8 — Recurring orders

[/app/marketplace/orders/recurring](/app/marketplace/orders/recurring) → setup ordini ricorrenti:

- **Frequenza** (settimana, mese, trimestre)
- **Prodotti standard** (default mix)
- **Quantità typical**
- **Conditions** (sconto, termini)

Cron auto-genera **Draft Order** ogni periodo → cliente conferma con 1 click.

Esempio:

Cliente Marco Frequenza: mensile Prodotti standard:

24 bottiglie Barolo Estate
12 bottiglie Barbaresco Reserve
12 bottiglie Roero Arneis bianco


## Sub-tenants Enterprise

Se distributore con filiali regionali (Enterprise):

[/app/marketplace/sub-tenants](/app/marketplace/sub-tenants) → "Crea filiale":

- Filiale Milano (sub-tenant)
- Filiale Roma
- ...

Ogni filiale eredita listini parent ma agisce in autonomia.

## Open Banking integration

[/app/marketplace/banking](/app/marketplace/banking) — riconciliazione pagamenti:

- Multi-EU country (10 paesi via Salt Edge + Token.io)
- Multi-currency (EUR/USD/GBP/CHF)
- Auto-match ordine con bonifico ricevuto
- Cross-currency FX rate snapshot

## Analytics Marketplace

[/app/marketplace/analytics](/app/marketplace/analytics):

- Top clienti per fatturato
- Lifetime value per cliente
- Conversion rate RFQ → Order
- Tempo medio quote → order
- Top SKU venduti
- Geographic distribution

## Costi

- Vinacta tier Cellar: included
- Stripe Connect: 1.5% application fee + 2.9% Stripe fee = ~4.4% sui transactions
- Corrieri: tariffe variabili (GLS €5-15/cassa Italia)

## Best practice

✅ **Listini privati personalizzati** per cliente (no listino unico)
✅ **Stripe Connect setup** day-1 (KYC richiede 5-10 giorni)
✅ **Recurring orders** per top 20 clienti (riduce friction)
✅ **Multi-country** Open Banking se export > 10% revenue
❌ Non skippare KYC Stripe (no payments senza)

## Prossimo step

Vai a [Wine club + DTC](/help/produttore/wine-club-dtc).