Vinacta

Cosa è Open Banking PSD2

Banche EU devono esporre API standard per:
Account info (saldo, transactions storico)
Payment initiation (avvio bonifici)
Con consenso utente esplicito (SCA - Strong Customer Authentication)

Vinacta integra Salt Edge (EU base) + Token.io (UK/CH fallback) per multi-country.

Cliente paga €1500 via bonifico → arriva a tuo IBAN
Tu manualmente:
Apri estratto conto banca
Cerchi nome cliente
Match fattura SDI corrispondente
Update CRM/contabilità
Tempo: 5-15 minuti per pagamento
Volume 100 pagamenti/mese = 8-25h admin

Soluzione Vinacta Open Banking:

Connect tuo IBAN via PSD2 SCA
Vinacta sync transactions ogni 24h
Auto-match con FatturaPA aperte
Auto-mark Order PAID
Ti rimane review eccezioni (5% transactions)

Setup multi-country

IT: UniCredit, Intesa Sanpaolo, Banco BPM, Crédit Agricole IT, ...
DE: Deutsche Bank, Commerzbank, Sparkasse, ...
FR: BNP Paribas, Société Générale, ...
ES: Santander, BBVA, ...
NL: ABN AMRO, ING, ...
BE: KBC, BNP Paribas Fortis, ...
AT: Erste, Raiffeisen, ...
PL: PKO BP, mBank, ...
UK (via Token.io post-Brexit): HSBC, Barclays, ...
CH (via Token.io): UBS, Credit Suisse, ...

Step 1 — Connect IBAN

Cliente login banca + consent SCA
Banca redirect Vinacta con auth_token
Vinacta scambia per access_token (encrypted, stored)

Token valido 90 giorni (PSD2 standard), auto-renewal.

GET /api/banks/transactions { "account": "IT60X0542811101000000123456", "balance": 12450.00, "currency": "EUR", "transactions": [ { "id": "tx-001", "amount": 1500.00, "date": "2024-12-15", "description": "BONIFICO DA OSTERIA DEL VINO MILANO FATT 2024-345", "counterparty_iban": "IT60X0542811101000000987654", "counterparty_name": "OSTERIA DEL VINO SRL" } ] }


## Step 3 — Auto-match

Vinacta engine cerca match con **FatturaPA SDI aperte**:

1. **Exact match**: importo + counterparty name + fattura number nelle description
2. **Fuzzy match**: importo ± 1% + counterparty name 80% similarity
3. **Manual review**: discrepancy > tolerance

Matched → Order auto-mark PAID + FatturaPA marked "Riscossa".

## Step 4 — Cross-currency reconciliation

Per pagamenti in EUR ricevuti per fatture in USD/GBP/CHF:

[/app/marketplace/banking/reconciliation](/app/marketplace/banking/reconciliation):

- FX rate snapshot tempo bonifico (da ECB cron)
- Convert importo per match
- Discrepancy tolerance 1%

Esempio:

Fattura: $1500 USD Bonifico ricevuto: €1380 EUR ECB FX rate giorno bonifico: 1 USD = 0.92 EUR $1500 × 0.92 = €1380 ✅ MATCH


## Step 5 — Manual review

Transactions non-matched in [/app/marketplace/banking/unmatched](/app/marketplace/banking/unmatched):

- Cliente paga importo errato (parziale o eccesso)
- Bonifico from terzo (es. da commercialista pagando per cliente)
- Description scarsa (no fattura reference)
- Currency conversion outside tolerance

UI per match manuale: drag-drop transaction → fattura.

## Step 6 — Reporting

[/app/marketplace/banking/reports](/app/marketplace/banking/reports):

- **Daily reconciliation rate** (target > 90% auto-match)
- **Average days fattura → riscossa**
- **Top clienti per puntualità pagamenti**
- **Aging analysis** (fatture scaduto > 30gg, > 60gg, > 90gg)
- **DSO (Days Sales Outstanding)** trend

## Security PSD2

- ✅ **SCA mandatory** ogni 90gg (Strong Customer Authentication)
- ✅ **OAuth 2.0** + JWT tokens
- ✅ **Read-only access** (Vinacta NON può iniziare bonifici)
- ✅ **Audit log** ogni API call
- ✅ **GDPR-compliant** (cliente revoke any time)

## Costi

- Salt Edge: ~€500/mese flat (post-pilot volume)
- Token.io: ~€300/mese flat (UK/CH only)
- Vinacta tier Enterprise: included setup

Vale la pena se:
- Volume > 50 bonifici/mese
- Multi-country export ATL > 30%
- Team admin > 2 persone

## Best practice

✅ **Connect IBAN day-1** (auto-renewal SCA seamless)
✅ **Multi-country se export > 10%**
✅ **Review unmatched weekly** (no batch monthly)
✅ **DSO target < 45 gg** (industry standard B2B vino)
❌ Non depender 100% auto-match (sempre manual review weekly)

## Prossimo step

Vai a [FatturaPA + SDI](/help/distributore/fatturapa-sdi).