Stolen Orbit
ITEN
Parliamone
MODELLO GRATUITO · COMPILA, SCARICA, RIUTILIZZA

Mappa delle integrazioni

Descrivi ogni collegamento come un contratto tra sistemi. Questa scheda chiarisce cosa può essere letto o scritto e cosa deve succedere quando una chiamata fallisce.

A cura di Stolen OrbitRevisione

Quando usarlo e cosa ottenere

Quando un’automazione deve trasferire dati tra strumenti esistenti e servono requisiti condivisi tra operations, fornitore e IT.

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

Compila i campi qui sotto e scarica il documento. Il sito non invia né salva le risposte: chiudendo la pagina puoi perderle. Gli esempi sono illustrativi e vanno sostituiti con dati del tuo processo.

Scarica il modello completo da compilare (.md)

1. Definisci il collegamento

Separa lettura, creazione e aggiornamento. Un sistema accessibile tramite interfaccia utente non dispone necessariamente delle API o dei permessi richiesti.

Vedi un esempio compilato

Esempio ipotetico: una richiesta approvata crea una bozza ordine nell’ERP. Il codice cliente arriva dall’anagrafica ERP; una denominazione libera non basta per identificare il cliente.

Indica ambiente di prova, ambiente reale e referente tecnico di ciascun sistema.

Descrivi cosa avvia il trasferimento, quando avviene e quale record viene creato o modificato.

Mappa identificativi, formato, unità e regole di precedenza quando due sistemi contengono valori diversi.

2. Limita gli effetti

Descrivi accessi e comportamento atteso prima di collegare credenziali reali. Registra riferimenti ai segreti, mai password o token nella scheda.

Vedi un esempio compilato

Esempio ipotetico: usare l’identificativo della richiesta come riferimento esterno. Se esiste già una bozza con quel riferimento, verificare lo stato prima di inviare di nuovo.

Elenca risorse e campi accessibili; specifica cosa richiede approvazione umana.

Definisci come riconoscere lo stesso evento ripetuto senza creare una seconda operazione.

Documenta limiti verificati di API, dimensione, disponibilità e versioni; marca ciò che resta da confermare.

3. Progetta il recupero

Non interpretare una risposta mancante come certezza di mancata scrittura. Prevedi controlli prima di ripetere operazioni con effetti reali.

Vedi un esempio compilato

Esempio ipotetico: dopo un timeout cercare la bozza per riferimento esterno. Se lo stato resta incerto, mettere il caso in revisione invece di creare un nuovo ordine.

Distingui errori temporanei, dati invalidi e casi che richiedono intervento; assegna limiti ai tentativi.

Indica quali identificativi, conteggi o importi confrontare e con quale frequenza.

Scrivi come fermare il flusso, riprendere dal punto corretto e verificare gli effetti già prodotti.

Errori da evitare

  • Promettere un’integrazione prima di verificare accessi e capacità effettive del sistema.
  • Ripetere una scrittura senza controllare se è già avvenuta.
  • Monitorare solo gli errori tecnici e ignorare record mancanti o duplicati.

Facciamo il prossimo passo insieme.

Usa questo documento come punto di partenza per discutere scopo, verifiche e responsabilità del progetto.

Rivedi il testo prima di inviarlo. Aggiungi solo la tua email; gli altri dettagli sono facoltativi.