Sito e gestionale: come evitare richieste perse o duplicate

A cura di

Prima di automatizzare il passaggio dei contatti, definiamo conferme, gestione degli errori e responsabilità: una guida pratica per hotel e PMI.

Sito e gestionale: richieste perse o duplicate?

Che cosa significa davvero “richiesta ricevuta”?

Un cliente compila il modulo, vede una conferma e chiude la pagina. Nel frattempo la richiesta deve arrivare al software usato dal commerciale o dalla reception. Sono due passaggi distinti: il messaggio sul sito, da solo, non dimostra che il dato sia già disponibile nel gestionale.

Questa guida durevole è aggiornata al 16 novembre 2026. Noi proponiamo di partire dal percorso della richiesta, non dal nome del collegamento. Le API, cioè le interfacce con cui due programmi scambiano dati, rendono possibile il trasferimento; il progetto deve stabilire anche cosa succede quando qualcosa va storto.

La nostra scheda del passaggio: sei decisioni prima dello sviluppo

Per rendere verificabile il lavoro, suggeriamo una scheda condivisa fra azienda, agenzia e fornitore del gestionale. Deve rispondere a sei domande:

  • Che cosa trasferiamo? Una richiesta commerciale, un contatto o una prenotazione sono oggetti diversi. Non vanno confusi.
  • Quali dati servono? Concordiamo campi obbligatori, formati e corrispondenze: per esempio, lingua, date e numero di ospiti.
  • Dove nasce la conferma? Identifichiamo il punto in cui la richiesta è stata effettivamente conservata e può essere recuperata.
  • Entro quando deve arrivare? Definiamo un tempo operativo accettabile. Una richiesta di preventivo e la conferma di disponibilità possono avere esigenze differenti.
  • Come riconosciamo lo stesso invio? Prevediamo un riferimento della richiesta e regole per distinguere una ripetizione da una nuova esigenza del cliente.
  • Chi gestisce le eccezioni? Assegniamo un referente, un avviso e una procedura di recupero.

Prima di promettere un’integrazione, noi verifichiamo con il fornitore quali operazioni siano disponibili, con quali autorizzazioni, limiti, costi e ambiente di prova. La presenza di un’API non implica che ogni funzione del gestionale sia accessibile.

Un’interruzione non significa sempre che l’invio sia fallito

Il gestionale potrebbe avere registrato la richiesta, ma la risposta di conferma potrebbe non essere arrivata al sito. Ripetere tutto senza controlli rischia quindi di creare un secondo elemento. È una situazione descritta nella documentazione Microsoft sul recupero dagli errori temporanei.

Il termine tecnico è idempotenza: ripetere la stessa operazione non deve produrre effetti aggiuntivi indesiderati. Stripe documenta l’uso di una chiave di idempotenza per ripetere richieste senza creare due volte lo stesso oggetto. È un esempio concreto, non una funzione che possiamo presumere presente in ogni gestionale: il meccanismo va verificato nella documentazione del sistema utilizzato.

Noi distinguiamo sempre il duplicato tecnico da due richieste legittime della stessa persona. Usare soltanto l’indirizzo email per scartare i doppioni, per esempio, potrebbe cancellare una seconda richiesta per un periodo diverso. Il criterio deve riguardare l’operazione, non semplicemente l’identità del cliente.

Tre stati operativi, con messaggi coerenti

Proponiamo tre stati comprensibili anche a chi non sviluppa software:

  • Ricevuta e conservata: il sito dispone di una registrazione recuperabile, ma il trasferimento può essere ancora da completare.
  • Trasferita: è disponibile una conferma verificabile dal sistema di destinazione.
  • Da verificare: c’è un errore o un esito incerto e serve un controllo prima di ritentare.

Questi stati sono una nostra proposta organizzativa, da adattare al progetto. Non presuppongono che il sito conservi già le richieste: se manca tale funzione, va prevista oppure il messaggio all’utente deve rispecchiare il comportamento effettivo.

Il W3C raccomanda notifiche chiare sull’esito dei moduli, con istruzioni comprensibili quando occorre correggere un errore. Noi traduciamo questo principio in una regola: non mostrare “prenotazione confermata” se è stata acquisita soltanto una richiesta di preventivo.

Il collaudo che proponiamo prima di andare online

In un ambiente di prova, usando dati fittizi, chiediamo di verificare almeno questi cinque scenari. Se manca un ambiente separato, concordiamo prima con il fornitore una procedura controllata che eviti effetti reali indesiderati.

  1. Invio ordinario: i dati arrivano nei campi corretti e il referente sa dove trovarli.
  2. Doppio invio della stessa operazione: il sistema non crea due elementi operativi identici.
  3. Destinazione temporaneamente indisponibile: la richiesta resta recuperabile oppure l’utente riceve un errore coerente con ciò che è realmente avvenuto.
  4. Risposta persa dopo la registrazione: si verifica l’esito prima di ripetere un’operazione potenzialmente già conclusa.
  5. Dato rifiutato: l’errore diventa visibile a chi può correggerlo e il recupero non richiede una nuova compilazione inutile al cliente.

Per ogni prova annotiamo riferimento, risultato atteso, risultato osservato e responsabile della correzione. Microsoft distingue gli errori temporanei da quelli che non si risolvono ripetendo la chiamata: noi evitiamo quindi tentativi automatici senza fine e definiamo quando avvisare una persona.

Misurare il passaggio, non soltanto il clic

Immaginiamo dieci richieste di prova: nove risultano trasferite e una resta da verificare. Non è un risultato cliente né una statistica di settore; è un esempio di controllo. La domanda utile è se sappiamo individuare quella richiesta, comprenderne lo stato e recuperarla senza duplicare le altre.

Noi suggeriamo di controllare richieste acquisite, trasferite e ancora in attesa, insieme al tempo trascorso. Nei registri tecnici manteniamo solo le informazioni necessarie alla diagnosi, senza esporre credenziali o copiare indiscriminatamente i messaggi dei clienti.

Se vuoi collegare il tuo sito aziendale agli strumenti operativi, possiamo partire da un singolo passaggio e valutarne fattibilità e controlli. Con le nostre soluzioni software su misura analizziamo processi e sistemi esistenti prima di definire lo sviluppo necessario.