← Tutte le note

Un errore che nessuno capisce torna sempre indietro

L’operatore carica un file di ordini, preme «Invia» e dopo qualche secondo compare una finestra: un codice, una classe di messaggio, un testo tecnico tradotto male dal gestionale centrale. Fa uno screenshot, lo manda all’assistenza e passa ad altro. Mezz’ora dopo uno sviluppatore apre i log e scopre che il problema era un codice cliente sbagliato in una riga del file. Correzione: dieci secondi. Costo reale: due persone, due interruzioni, un ordine fermo per mezza giornata.

Il messaggio decide chi risolve il problema

Un errore non è solo un’informazione, è un’assegnazione. Se il messaggio parla la lingua del sistema, l’unico in grado di agire è chi conosce il sistema. Se parla la lingua del processo — «il contratto indicato non esiste per questo cliente», «la posizione 30 è già chiusa» — l’operatore corregge da solo e riprova.

In quasi tutte le integrazioni con un ERP la maggior parte degli errori ricade in poche famiglie ricorrenti: anagrafiche inesistenti o bloccate, documenti di riferimento chiusi, quantità o date fuori dalle regole, autorizzazioni mancanti. Sono errori di dato, non di software. Mandarli all’assistenza tecnica significa usare la persona più costosa per il lavoro meno tecnico.

Tradurre è un pezzo di architettura, non di interfaccia

La tentazione è sistemare i testi nella schermata. Funziona per un mese. La traduzione va invece trattata come un componente: un livello che riceve l’errore grezzo del gestionale, lo riconosce, e restituisce tre cose distinte.

  • Cosa è successo, in termini di processo, con i riferimenti che l’utente vede nel suo file: la riga, il codice, il documento.
  • Cosa può fare lui, se può fare qualcosa. Se non può, dirlo esplicitamente e indicare a chi rivolgersi.
  • Il dettaglio originale, conservato intatto per chi dovrà indagare. Tradurre non significa nascondere: il codice grezzo resta nel registro e a un clic di distanza.

E una regola che vale più delle altre: un errore che il traduttore non riconosce non va mai ammorbidito. Si mostra come «errore non previsto», con il dettaglio completo. Un messaggio rassicurante su un errore sconosciuto è peggio del codice incomprensibile.

Ancora meglio: non arrivarci

Molti di quegli errori si possono intercettare prima di scrivere nel gestionale. Una verifica preventiva, in sola lettura — il cliente esiste? il contratto è aperto? la posizione accetta ancora movimenti? — trasforma un fallimento a metà elaborazione in un elenco di correzioni presentato prima ancora di iniziare. Nessuna scrittura parziale da ripulire, nessun documento orfano.

La verifica deve però fallire chiusa: se non riesce a controllare, non dà il via libera. Un controllo che in caso di dubbio lascia passare è solo un ritardo.

Dove si misura il ritorno

Non nelle righe di codice, ma nelle richieste all’assistenza che smettono di arrivare. È uno dei pochi interventi su un’integrazione esistente che non tocca la logica di business, non richiede di fermare nulla e si ripaga in poche settimane: ogni errore che l’operatore risolve da solo è un’interruzione in meno per chi dovrebbe costruire altro.

Parliamone