RFQ flow: dalla richiesta al pagamento

State machine RFQ → Order

RFQ (created by buyer) ↓ QUOTED (seller responds) ↓ ACCEPTED (buyer confirms) ↓ PAID (Stripe charge succeeded) ↓ SHIPPED (corriere label generated) ↓ DELIVERED (final confirmation) ↓ [FATTURA SDI auto-generated]

## Step 1 — Crea RFQ

Sei tu **buyer** che richiede a cantina:

[/app/marketplace/rfq/new](/app/marketplace/rfq/new) → form:

- **Cantina destinataria** (relationship LIVE)
- **Vino richiesto** (search da loro listino)
- **Quantità** (bottiglie + formato)
- **Deadline consegna**
- **Note** (urgenza, evento, customizzazione richiesta)
- **Validità** (default 7 giorni)

Esempio:

Cantina: Cantina Roero Piemonte Vino: Barolo Cannubi 2018 750ml Quantità: 50 bottiglie (8.3 casse 6-bot) Deadline: martedì 18 dicembre 2024 Note: cliente fine dining richiede pronto pronta consegna

## Step 2 — Cantina riceve RFQ

Cantina riceve notifica in-app + email. Vede:
- I tuoi termini
- Disponibilità stock loro inventory
- Storia tua relationship (volume YTD)
- Tempo medio decision tuo

## Step 3 — Quote dal cantina

Cantina genera **Quote** in [/app/marketplace/rfq/[id]/quote](/app/marketplace/rfq/[id]/quote):

- **Prezzo unitario** € (default da listino, override possibile)
- **Disponibilità stock** (check auto inventory)
- **Termini pagamento** (15gg, 30gg, contanti)
- **Termini consegna** (corriere + costo + ETA)
- **Validità quote** (default 7 giorni)
- **Note** (es. "ultima cassa disponibile, prossimo lotto marzo 2025")

Esempio:

Prezzo: €28 unitario (vs listino €30) Stock: 60 bottiglie disponibili, OK 50 Termini: 30gg bonifico Consegna: GLS €12 cassa, ETA 2-3gg lavorativi Note: prezzo speciale relationship esclusiva

Click "Invia Quote" → tu ricevi notifica.

## Step 4 — Accept Quote

[/app/marketplace/rfq/[id]](/app/marketplace/rfq/[id]) → review:
- Prezzo accettabile?
- Stock + ETA + termini OK?
- Conta totale (50 × €28 + €12 cassa × 8.3 = €1500)

Click "**Accept Quote**":
- Sistema crea **B2BOrder** state ACCEPTED
- Stripe payment_intent created (€1500)
- Email notification cantina

## Step 5 — Pagamento Stripe

Stripe Connect destination_charge:
- Carta credito o SEPA bonifico
- Vinacta application fee **1.5%** auto-trattenuto (€22.50)
- Stripe fee **2.9%** + €0.30 (€43.80)
- Net al venditore: €1500 - €22.50 - €43.80 = **€1433.70**

Su Stripe Dashboard:
- Tu vedi €1500 charged (uscita)
- Cantina vedere €1433.70 (entrata Vinacta + Stripe fee trattenuti)
- Vinacta riceve €22.50 application fee

## Step 6 — Shipment

Cantina genera spedizione:

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

- **Corriere** (GLS / BRT / SDA / DirectFromItaly)
- **Tracking ID** auto-generato
- **Etichetta PDF** download + stampa
- **ETA delivery** (auto-calc da corriere)

Tu ricevi:
- Email "Order shipped" + tracking link
- Notification in-app

## Step 7 — Delivered

Quando il corriere conferma delivery:

- Status → DELIVERED
- **FatturaPA SDI auto-generata** (XML schema 1.2.x via Aruba)
- Email con PDF fattura
- Stripe payout settimanale + 7 giorni a IBAN

## Recurring RFQ

Per top clienti con ordini ricorrenti:

[/app/marketplace/orders/recurring](/app/marketplace/orders/recurring) — setup:

- **Frequenza** (settimanale, mensile, trimestrale)
- **Mix vini standard**
- **Volume default**

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

Riduce friction enormemente.

## Errori comuni

| Errore | Causa | Soluzione |
|---|---|---|
| "Quote expired" | Validità scaduta | Rinegotia con cantina, genera nuovo RFQ |
| "Stock not available" | Inventory cambiato dopo RFQ | Riduci quantità o split |
| "KYC pending" | Stripe Connect non attivo | Completa KYC e ritenta |
| "PEC obbligatoria B2G" | FatturaPA destinatario senza canale SDI | Setup IPA code |

## Performance metrics

Misura:
- **Conversion rate RFQ → Quote** (cantina responsiveness)
- **Conversion rate Quote → Order** (tua decision speed)
- **Lead time RFQ → Delivered** (full lifecycle, target < 7gg)
- **Order accuracy** (% senza dispute)

## Best practice

✅ **RFQ chiaro con tutti i dettagli** (riduce roundtrip clarification)
✅ **Validità realistica** (7gg per vini commodity, 30gg per vini rari/allocati)
✅ **Recurring per top 20%** clienti
✅ **Tracking proattivo** (notify cliente automaticamente)
❌ Non spammare RFQ a 20 cantine simultaneamente (rovini relationship trust)

## Prossimo step

Vai a [Stripe Connect](/help/distributore/stripe-connect).