Vai al contenuto
MODELLO GRATUITO

Mappa delle integrazioni

Definisci dati, permessi e gestione degli errori per ogni collegamento.

Cosa prepari

Una scheda per collegamento: campi, permessi, duplicati e riconciliazione.

Quando usarlo

Prima di trasferire dati tra strumenti aziendali.

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

Controlla prima di usarlo
  • 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.

Parliamo del tuo progetto.

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