Quando tre software diventano uno solo: un caso di integrazione

Il cliente non ci ha chiesto un software nuovo. Ci ha chiesto di smettere di ricopiare le prenotazioni. In mezzo c’erano tre cose che non si parlavano — il gestionale dove si controllano disponibilità e clienti, il sito dove la gente prenota, i pagamenti — e una persona che ogni mattina faceva da ponte fra loro. Da lì è nato il sistema di prenotazione integrato con il gestionale che seguiamo dal 2023, e che oggi gira su più attività contemporaneamente.

Ti racconto com’è fatto, perché il problema di fondo non riguarda solo chi noleggia qualcosa.

Il contesto: tre sistemi e un ponte fatto di persone

La situazione di partenza è quella di tante aziende che vendono tempo o disponibilità. C’è un backoffice dove sta la verità: cosa è libero, cosa è già impegnato, chi è il cliente, quanto ha pagato. C’è un sito pubblico, dove arrivano le richieste. E ci sono gli incassi, che vivono in un terzo posto ancora.

Finché i volumi sono piccoli la cosa regge, perché qualcuno in azienda tiene insieme i pezzi a mano. Prende la richiesta arrivata dal sito, la ribatte nel gestionale, controlla che non si sovrapponga a un’altra, registra il pagamento quando arriva la ricevuta. È un lavoro invisibile, non compare in nessun report, e quando quella persona è in ferie il sistema informativo aziendale va in ferie con lei.

I danni non sono drammatici, sono quotidiani: lo stesso slot promesso a due clienti, l’anagrafica scritta due volte con due grafie diverse, il pagamento che risulta il giorno dopo. Piccole cose che però costano telefonate, scuse e ogni tanto una prenotazione persa.

Finché il collegamento fra due software è una persona, il dato è aggiornato quanto è disponibile quella persona.

L’architettura: quattro pezzi, un flusso solo

La soluzione non è stata un software unico che rimpiazza tutto. È stata una catena in cui ogni pezzo fa una cosa sola e la fa per gli altri.

• Il gestionale multi-tenant. Backend in Laravel 11 con pannello di amministrazione Filament 3: è il posto dove vive la verità su disponibilità, prenotazioni, clienti e abbonamenti. Multi-tenant vuol dire che la stessa piattaforma serve più attività, ognuna con i suoi dati e il suo calendario, con un livello di super amministrazione sopra e permessi granulari su chi può vedere o toccare cosa.
• L’API in NestJS. Uno strato in TypeScript con TypeORM che espone i dati verso l’esterno in modo controllato. Non è un tubo che passa informazioni: decide cosa può essere chiesto, da chi, e cosa succede quando una richiesta arriva incompleta o fuori tempo.
• Il plugin WordPress. Installato sul sito pubblico dell’attività, porta il calendario di prenotazione dentro le pagine che il cliente finale già conosce.
• Stripe. Il pagamento è agganciato alla prenotazione, non registrato accanto ad essa.

Quattro tecnologie diverse, un unico percorso del dato. Chi prenota dal sito compila un modulo e basta: dietro, la disponibilità viene verificata sul gestionale nel momento stesso in cui la sta guardando, non su una copia aggiornata stanotte.

Il plugin WordPress è la parte che si vede

Questa è la scelta che ha cambiato di più l’esperienza di chi prenota. L’alternativa comune è mandare il cliente su una piattaforma esterna: cambia il dominio, cambia la grafica, e una parte delle persone si ferma lì.

Con un plugin WordPress su misura il calendario sta dentro il sito, con i colori e il carattere del sito. Il plugin però non contiene la logica di prenotazione: chiede all’API cosa è libero e le comunica cosa è stato scelto. È una differenza che si sente il giorno in cui cambiano le regole di disponibilità, perché si aggiorna il motore e tutti i siti collegati si adeguano senza doverli toccare uno per uno.

I pagamenti dentro il flusso, non accanto

Il pezzo che molti progetti sottovalutano è l’incasso. Non perché sia difficile aggiungere un pulsante di pagamento — quello lo fa chiunque — ma perché il pagamento deve tornare indietro e chiudere il cerchio.

Con Stripe agganciato all’API, la conferma dell’incasso aggiorna lo stato della prenotazione nel gestionale. Anche le email al cliente partono dallo stesso strato, da template condivisi, così chi prenota riceve sempre lo stesso tono di voce indipendentemente da dove è partita l’azione. Gli abbonamenti seguono la stessa strada: rinnovo, scadenza e stato del cliente sono un dato solo, non tre versioni da conciliare a fine mese.

Multi-tenant: la stessa piattaforma per attività diverse

La parte multi-tenant è quella che rende il progetto sostenibile nel tempo. Ogni attività ha il suo spazio, i suoi listini, il suo calendario e i suoi utenti, e non vede nulla degli altri. Il codice però è uno.

Significa che una correzione o una funzione nuova arriva a tutti insieme, e che aggiungere un’attività non vuol dire riaprire un progetto da zero. Quando ci hanno chiesto di seguire questa piattaforma, nel 2023, non sapevamo quante realtà avrebbe ospitato: averlo previsto fin dall’architettura è il motivo per cui ci lavoriamo ancora adesso senza averla dovuta riscrivere.

Il risultato: i dati restano allineati da soli

Non ho una percentuale da mostrarti, e preferisco dirlo. Quel tempo, prima, nessuno lo misurava: era semplicemente come si fa qui. Quello che è cambiato si racconta meglio in negativo.

È sparito il doppio inserimento: una prenotazione si scrive una volta sola, dove nasce. È sparito il foglio di calcolo che teneva insieme incassi e prenotazioni. È sparita la telefonata «controllo e ti richiamo», perché la disponibilità che il cliente vede sul sito è quella vera. E soprattutto è sparita la dipendenza da una persona sola: se quella persona è in ferie, il flusso continua.

La scheda tecnica completa, con tutte le tecnologie in campo, sta nel progetto di sistema booking multi-tenant del nostro portfolio.

Perché un sistema di prenotazione integrato con il gestionale riguarda anche te

Se la tua azienda non noleggia niente e non prende prenotazioni, l’esempio sembra lontano. Il meccanismo però è sempre quello: due o più software che devono restare d’accordo su cosa è vero, e nel mezzo qualcuno che li tiene allineati a mano.

Cambia solo il vocabolario. Al posto di prenotazione metti ordine, commessa, ticket, pratica. Al posto del sito di prenotazione metti l’e-commerce, il portale clienti, il CRM dei commerciali. Il ponte umano resta, e resta il punto in cui il dato invecchia. È il lavoro che facciamo quasi sempre: far parlare tra loro i sistemi che l’azienda usa già, invece di sostituirli tutti con qualcosa di nuovo.

Se mentre leggevi ti è venuto in mente un nome — la persona che in azienda fa da ponte fra due software — probabilmente vale la pena guardare insieme quanto è largo quel ponte. Da Castelnuovo del Garda lavoriamo con aziende di Verona e del Nord Italia, e la prima cosa che facciamo in un’analisi di fattibilità è capire se l’integrazione conviene davvero. Certe volte la risposta è no, e lo diciamo prima di scrivere una riga di codice.