Source: [Original HTML page](https://stolenorbit.com/it/risorse/automazioni-errori-duplicati/)

Language: Italiano

GUIDA PRATICA PER LE IMPRESE

# Un’automazione affidabile sa cosa fare quando l’esito è incerto.

Un timeout non significa sempre che l’azione sia fallita. Prima di ripetere un’operazione, il sistema deve capire se rischia di creare un duplicato o lasciare due strumenti in disaccordo.

[A cura di Stolen Orbit](https://stolenorbit.com/it/chi-siamo/) Aggiornato il 24 settembre 2026

## Distingui errore, rifiuto ed esito sconosciuto

[Fonte di questa sezione](https://stolenorbit.com/it/risorse/automazioni-errori-duplicati/#incertezza)

Se un’API rifiuta un dato perché manca un campo, ripetere la stessa richiesta non lo corregge. Se il servizio risponde lentamente e il collegamento scade, l’operazione potrebbe essere stata eseguita senza che sia arrivata la conferma. Trattare entrambi i casi come “riprova” può produrre risultati sbagliati.

Per ogni integrazione, definisci stati osservabili: ricevuto, validato, in lavorazione, completato, rifiutato e da verificare. Conserva il riferimento dell’operazione esterna quando esiste. Chi interviene deve poter capire quale passo è riuscito, non soltanto leggere una generica notifica “flusso fallito”.

## Ripetere senza moltiplicare gli effetti

[Fonte di questa sezione](https://stolenorbit.com/it/risorse/automazioni-errori-duplicati/#retry)

L’idempotenza permette di trattare tentativi della stessa operazione come un’unica intenzione. Amazon descrive questo principio per rendere più sicuri i retry. Il supporto concreto dipende dall’API: alcune accettano una chiave, altre richiedono verifiche o un registro delle operazioni. Non presumere che qualunque connettore impedisca automaticamente i duplicati.

Se l’API offre una chiave di idempotenza, riutilizzala soltanto per il medesimo tentativo logico secondo il suo contratto. Una richiesta diversa non dovrebbe ereditare la chiave di una precedente. La documentazione Stripe è un esempio di regole specifiche del fornitore, non una garanzia applicabile ad altri servizi.

Fai scorrere la tabella per confrontare tutte le colonne.

Comportamenti da definire per tipo di esito

| Esito | Azione proposta | Da evitare |
| --- | --- | --- |
| Dato non valido | Correggere o inviare a revisione | Ripetere senza cambiare nulla |
| Limite temporaneo o indisponibilità | Retry limitato con attesa, secondo il contratto API | Tentativi infiniti o tutti simultanei |
| Timeout dopo un invio | Verificare stato o usare deduplicazione prevista | Creare una nuova operazione alla cieca |
| Passaggi parzialmente completati | Riconciliare gli stati e riprendere dal punto sicuro | Rieseguire l’intero flusso senza controllo |

## Esempio illustrativo: ordine creato, risposta persa

[Fonte di questa sezione](https://stolenorbit.com/it/risorse/automazioni-errori-duplicati/#esempio)

1.  ### Primo tentativo
    
    Il workflow invia un ordine al gestionale. Il gestionale lo registra, ma la risposta non raggiunge il workflow entro il tempo previsto.
    
2.  ### Verifica
    
    Il workflow mantiene la stessa identità dell’operazione. Se il contratto lo permette, verifica lo stato tramite riferimento esterno o ripete con la chiave prevista.
    
3.  ### Intervento
    
    Se l’esito resta incerto, il caso entra in una coda con dati e tentativi visibili. Una persona controlla il gestionale prima di autorizzare una nuova creazione.
    

Un retry sicuro non è una promessa di esecuzione “esattamente una volta” per l’intero sistema. Occorre verificare i confini e le garanzie di ogni componente.

## Controlla periodicamente che i sistemi concordino

[Fonte di questa sezione](https://stolenorbit.com/it/risorse/automazioni-errori-duplicati/#riconciliazione)

La riconciliazione confronta gli esiti attesi con quelli registrati: un caso completato nel workflow deve avere il riferimento corretto nel gestionale, e viceversa. Definisci quali divergenze contano, chi le esamina e come si correggono senza perdere traccia della modifica.

Non ogni passo può essere annullato. Una bozza può essere eliminata; un’email inviata non può essere recuperata con la stessa facilità. Progetta ordine delle azioni e interventi correttivi in base a questa differenza. Un rollback del codice non annulla gli effetti già prodotti nei sistemi esterni.

## Le prove da chiedere prima del rilascio

[Fonte di questa sezione](https://stolenorbit.com/it/risorse/automazioni-errori-duplicati/#collaudo)

Documenta queste prove insieme al runbook operativo. Il valore non è soltanto tecnico: il team deve sapere come recuperare una pratica senza chiedere al fornitore di ricostruire ogni incidente da zero.

-   Simulare timeout prima e dopo la registrazione esterna.
-   Consegnare due volte lo stesso evento e verificare il risultato.
-   Fermare il processo tra due sistemi e riprenderlo senza duplicati.
-   Esaurire i retry e verificare coda, avviso e assegnazione del caso.
-   Confrontare stati esterni e interni dopo una correzione manuale.

DALLE IDEE A UN BRIEF

## Un modello su cui lavorare.

[Fonte di questa sezione](https://stolenorbit.com/it/risorse/automazioni-errori-duplicati/#downloads)

### Mappa delle integrazioni

Una scheda per collegamento, con campi mappati, autorizzazioni, gestione dei duplicati e un controllo di riconciliazione.

[Scarica il modello Markdown](https://stolenorbit.com/downloads/integration-map-it.md)

### Registro delle eccezioni

Una coda di eccezioni con stato, priorità, responsabile e prova di chiusura; le ricorrenze alimentano il miglioramento del flusso.

[Scarica il modello Markdown](https://stolenorbit.com/downloads/exception-register-it.md)

### Runbook di gestione operativa AI

Istruzioni accessibili al personale incaricato: segnali, allarmi, diagnosi iniziale, ripristino e revisione periodica.

[Scarica il modello Markdown](https://stolenorbit.com/downloads/monitoring-runbook-it.md)

## Domande pratiche

[Fonte di questa sezione](https://stolenorbit.com/it/risorse/automazioni-errori-duplicati/#faq)

**Un connettore pronto garantisce assenza di duplicati?**

No. Verifica il comportamento della specifica operazione, inclusi retry, timeout, durata delle chiavi e gestione degli eventi duplicati. Un’integrazione va provata sul percorso completo.

**Dobbiamo riprovare tutti gli errori?**

No. Errori permanenti e dati invalidi richiedono correzione. Gli esiti incerti richiedono verifica; gli errori transitori possono consentire retry limitati secondo le regole del servizio.

**Perché serve una coda manuale?**

Alcuni esiti non possono essere risolti automaticamente con evidenza sufficiente. Una coda assegnata, con storico e riferimenti, permette un recupero controllato invece di un nuovo invio alla cieca.

## Riferimenti e metodo

[Fonte di questa sezione](https://stolenorbit.com/it/risorse/automazioni-errori-duplicati/#sources)

[Amazon Builders’ Library — Making retries safe with idempotent APIs](https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/)

Principio di idempotenza e gestione dei retry. L’esempio d’ordine è illustrativo.

[Stripe — Idempotent requests](https://docs.stripe.com/api/idempotent_requests)

Esempio concreto di un contratto di idempotenza; le regole vanno verificate per ogni API utilizzata.

CONTINUA DA QUI

[Mappa delle integrazioni](https://stolenorbit.com/it/modelli/mappa-integrazioni/)

[Registro delle eccezioni](https://stolenorbit.com/it/modelli/registro-eccezioni/)

[Runbook di gestione operativa AI](https://stolenorbit.com/it/modelli/gestione-operativa-ai/)

[Dai documenti ai dati, con controlli prima di usarli.](https://stolenorbit.com/it/servizi/estrazione-dati-documenti-ai/)

[Un CRM aggiornato dal lavoro reale del team.](https://stolenorbit.com/it/servizi/automazione-crm-ai/)

[Tutte le guide pratiche](https://stolenorbit.com/it/risorse/)

## Qual è il primo processo da migliorare?

[Fonte di questa sezione](https://stolenorbit.com/it/risorse/automazioni-errori-duplicati/#growth-closing-heading)

Partiamo da un processo concreto, dai sistemi che usi e dalle persone che dovranno gestirlo ogni giorno.

[Parliamo del tuo processo](https://stolenorbit.com/it/contatti/)

## Dal dubbio al prossimo passo.

-   [Usare ciò che hai, collegarlo o costruire il pezzo mancante?](https://stolenorbit.com/it/risorse/automazioni-native-connettori-integrazioni/)
-   [Mappa delle integrazioni](https://stolenorbit.com/it/modelli/mappa-integrazioni/)
-   [Integrazione del gestionale](https://stolenorbit.com/it/servizi/integrazione-gestionale-ai/)