Superia.Brief · GO WORLD
Brief di progetto · per lo sviluppatore

GO WORLD — automazione dei
processi amministrativo-contabili

Scopo di questo documento

Mettere lo sviluppatore in condizione di capire il progetto e di ragionare sul preventivo (giornate per figura e per fase). Non è una specifica tecnica di dettaglio: quella nasce dopo l'analisi con il cliente.

§ 1-2 Cliente e obiettivo

Chi è il cliente e cosa dobbiamo fare

Il cliente

GO WORLD, tour operator di Ancona (gruppo, ~15 società, ~19 brand), specializzato in viaggi outgoing extra-UE su misura.

Marco · Innovation Manager Andrea · admin/fiscale Consulente senior · TCO

Valutano 3-4 fornitori. Badano al Total Cost of Ownership e al tasso di correttezza.

L'obiettivo

Automatizzare 3 processi con una squadra di agenti AI, lasciando il controllo finale a una persona e facendo tornare le registrazioni dentro il loro gestionale (niente sistema contabile parallelo).

  • Biglietteria IATA → rendiconto BSP in registrazioni, con quadratura
  • Riconciliazione bancaria → movimento ↔ pratica giusta
  • Registrazioni 74-ter → fatture, UE/extra-UE, margine per pratica
§ 3 Il gradiente di difficoltà

Da deterministico a euristico

Fondamentale per stimare: la difficoltà (e quindi lo sforzo) cresce da sinistra a destra. Il valore del progetto si concentra a destra.

Facile · deterministico

Biglietteria IATA

Il rendiconto BSP ha campi certi (n. biglietto, nome, documento). Match con la pratica o "record non abbinato". Rischio basso.

⚠︎ SferaNet lo fa già in parte nativamente → valore aggiunto limitato
Medio

Riconciliazione

In più c'è il cambio: pagano fornitori in USD, addebitati in EUR a date diverse. Importo in pratica ≠ importo addebitato. Serve human-in-the-loop sui casi che non tornano.

Difficile · il cuore

74-ter

Documenti destrutturati, niente tracciati, cambio da recuperare alla data operazione, fonti multiple e multilingua. Qui si vince o si perde: abbinare ogni documento alla pratica e comporre il margine.

IATA →→→ Riconciliazione →→→ 74-ter · più a destra = più sforzo = più valore
§ 4 Architettura proposta

Agenti → cancello → SferaNet

🛰️
Agenti sulle fonti
email/PEC, BSP, banca, marketplace
🚦
Orchestratore = cancello
validazione umana, audit trail
📥
SferaNet
nessun portale parallelo
  • Un agente per "luogo" presidia una fonte e prepara il lavoro.
  • Cancello: tutto converge in un punto dove una persona dà il via libera; nulla passa senza controllo; ogni azione tracciata.
  • Metodo a cascata sui modelli: parti dal modello più economico che dà il risultato, sali di tier solo dove il tasso di correttezza lo richiede.
§ 5 Le fonti dati e come si accede

Da dove arrivano i dati

📨
Email / PEC

Deposito centrale delle rendicontazioni fornitori. Idea validata dal cliente: un osservatore intelligente che cattura report/allegati e li smista. SferaNet ha un Mail Reader nativo (casella → CRM) usabile come gancio.

✈️
BSP / biglietteria

File periodico. SferaNet lo importa già: da capire quanto ci appoggiamo al nativo.

🏦
Banca

Via Open Banking (PSD2) in sola lettura, oppure import estratto conto (CAMT/MT940). Mai credenziali del cliente.

🌍
Marketplace servizi a terra

Piattaforme internazionali (transfer, escursioni): alcune espongono report via login (a volte 2FA), altre mandano PDF via email. Numero limitato di fornitori → pochi modelli/formati. I casi limite (es. email in francese da operatore locale) restano all'uomo.

📄
Fatture elettroniche

Ciclo SdI (XML).

§ 6 Integrazione con SferaNet

Il punto decisivo (Partner Solution / Dylog)

Lettura — solida, basso rischio

SferaNet espone Export Data, API REST JSON su pratiche, anagrafiche, preventivi (ACL per azienda/utente). È da qui che l'agente pesca i dati per l'abbinamento.

±

Scrittura — esiste ma canalizzata

Import Data API (2FA + HTTPS, XML/JSON) scrive entità operative: prenotazioni, pratiche, anagrafiche, incassi. Esistono già integrazioni terze reali che scrivono in SferaNet (Pliant, Sekurest).

!

Limite critico

NON risulta un'API che scriva direttamente le registrazioni contabili/IVA/74-ter. Quelle le genera SferaNet internamente, a valle dei dati operativi. → Scriviamo a monte (agganciamo il documento fornitore alla pratica) e lasciamo che SferaNet produca lui la scrittura fiscale. Coerente col vincolo "un solo sistema contabile".

Da confermare con Partner Solution / Dylog (dimensiona costo e integrazione)
  1. L'Import Data API accetta payload che agganciano un documento fornitore a una pratica esistente?
  2. Supporta l'aggiornamento di pratiche già create, non solo la creazione?
  3. Esiste export CSV/XLS dei dati contabili, o solo JSON/XML?

Due scenari da prevedere: A) scrittura via API → integrazione lineare. B) solo lettura → l'agente produce un file di import mappato esattamente sulla struttura pratica, caricato con validazione umana. In entrambi: nessuna contabilità parallela.

§ 7 Il cuore tecnico

Abbinamento documento → pratica (74-ter)

Per ogni pratica (un viaggio), la catena di agenti deve produrre la registrazione finale. Qui si concentra lo sforzo di sviluppo.

1
Recuperare tutti i documenti fornitore della pratica (email/PEC, marketplace).
2
Estrarre i dati da ciascuno (OCR + LLM): fornitore, importo, valuta, data.
3
Recuperare il tasso di cambio alla data dell'operazione per i costi in valuta (spesso non è nel documento).
4
Abbinare ogni documento alla pratica giusta. Chiavi: codice pratica, nome cliente, date, destinazione, importi. È il passo che vale il progetto.
5
Riconciliare importo pagato vs importo in pratica.
6
Separare costi UE / extra-UE.
7
Comporre la bozza del margine.
8
Validare solo i casi a bassa confidenza (confidence gating): sotto soglia, l'agente NON decide, mette in coda a una persona.
!

Requisito non negoziabile

Un errore sul 74-ter (IVA) è grave. Il sistema deve isolare l'incerto, non forzarlo. Soglie di confidenza + human-in-the-loop obbligatori; il commercialista firma.

§ 8 · 10 Modelli AI e come costiamo

Modelli a cascata, costo per pratica

  • OCR / estrazione: Gemini Flash (economico, buono).
  • Matching / riconciliazione media: modello economico; Claude Sonnet dove serve più ragionamento.
  • 74-ter ambiguo: modello più forte (Claude Opus) solo sulla frazione di casi difficili.
  • Leve di risparmio: cache del contesto ripetuto + Batch API per i lavori non real-time.

Unità di esercizio = la PRATICA, per complessità (non per documento). Costo per pratica = Σ (estrazione documenti + abbinamento + margine) lato AI [centesimi] + validazione umana [solo eccezioni]. Il costo AI è trascurabile; il driver è il minuto-uomo residuo, che cala con l'auto-approvazione.

Semplice
1-3 fornitori, tutto extra-UE, valuta unica
~0,15-0,30 €
a regime, per pratica
Media
4-8 fornitori, un po' di cambio
~0,30-0,70 €
a regime, per pratica
Complessa
8-15 fornitori, multivaluta, misto UE/extra-UE
~0,70-1,70 €
a regime, per pratica

In rodaggio (si valida tutto) il costo umano è ~2-3× più alto; poi scende a regime. Numeri indicativi, da misurare in demo su documenti reali.

§ 11 Da rispondere per stimare

Le domande aperte

Volumi mensili reali: n. biglietti IATA, n. movimenti banca, n. pratiche 74-ter, e n. medio di documenti fornitore per pratica.
Distribuzione delle pratiche: % semplici / medie / complesse.
Formati e canali reali delle rendicontazioni fornitori (quali marketplace, quali via email, quali lingue).
SferaNet: conferma scrittura via Import Data API (aggancio documento→pratica, update pratica).
Target di auto-approvazione accettabile per il cliente (quanto human-in-the-loop all'inizio).
Da quale flusso partire per l'MVP/demo: IATA come quick win o 74-ter dove c'è il valore?
§ 12 · 9 Fasi e vincoli

Come si procede

Fase 1

Analisi

Con Marco/Andrea: workflow reali, volumi, fonti, conferma SferaNet.

Fase 2

Demo in 3-4 settimane

Già offerta al cliente, con garanzia di recesso: un flusso end-to-end su dati loro.

Fase 3

Build a fasi

Base condivisa (osservatore email + estrazione) → flusso più semplice → riconciliazione → 74-ter.

i

Vincoli da tenere presenti

Un solo sistema contabile (SferaNet), l'output torna lì. Accuratezza critica sul 74-ter. GDPR su dati bancari e fiscali (cliente titolare, noi responsabili). Human-in-the-loop obbligatorio sui numeri; il commercialista firma.

🎯

Obiettivo dell'incontro con lo sviluppatore

Stimare le giornate per figura e per fase (vedi § 3 e § 12), per costruire insieme il preventivo di produzione + il modello di esercizio.