Integrazioni

Prima si scrive il contratto

Ogni scambio ha uno schema dichiarato: quello che entra viene controllato prima di toccare qualsiasi cosa, quello che esce è documentato. Il vantaggio si vede il giorno dell’integrazione con un sistema di terzi: invece di scoprire i campi a forza di tentativi, c’è un documento che dice cosa arriva e cosa torna — e un test che fallisce se qualcuno lo cambia.

Doppioni, ritenta e rete di sicurezza

I messaggi arrivano doppi, arrivano in ordine sbagliato, o non arrivano. Ogni operazione che cambia lo stato è scritta per poter essere ripetuta senza danno, e ogni coda ha un numero massimo di tentativi con attesa crescente.

Quando il collegamento di un fornitore si dimostra inaffidabile non lo si supplica: gli si affianca un controllo periodico che riallinea lo stato. Costa poco e toglie una classe intera di telefonate.

Sistemi che non vogliono parlare

Gestionali con interfacce degli anni duemila, piattaforme che espongono solo una fetta di quello che serve, portali della pubblica amministrazione che accettano un file e basta: il lavoro è costruire uno strato che normalizza tutto questo in un modello unico, e chiudere le stranezze di ogni fornitore in un solo posto.

Chi comanda su ogni dato

Prima di scrivere una riga si decide, per ogni informazione, quale sistema è la fonte di verità: le giacenze le comanda il gestionale, gli ordini nascono dal negozio online, l’anagrafica appartiene a chi ha visto il cliente per primo. Non esiste una risposta valida per tutti — esiste quella giusta per come lavorate, e va scritta.

Quando questa decisione non viene presa, la prende l’integrazione da sola: vince l’ultimo che ha scritto, e sei mesi dopo nessuno sa più spiegare perché un prezzo è cambiato.

Quando l’altro lato non risponde

Un collegamento non fallisce quando il fornitore restituisce un errore: fallisce quando risponde "va bene" e non fa niente, o quando lo stesso ordine arriva due volte perché la conferma si è persa per strada.

Per questo ogni operazione che cambia lo stato è scritta per poter essere ripetuta senza danno, ogni coda ha un numero massimo di tentativi con attesa crescente, e quando i tentativi finiscono la cosa non muore in silenzio: qualcuno viene avvisato.

E quando il collegamento di un fornitore si dimostra inaffidabile, non lo si supplica: gli si affianca un controllo periodico che riallinea lo stato. Costa poco e toglie una classe intera di telefonate.

Sistemi vecchi, portali della pubblica amministrazione, file

Non tutto espone interfacce moderne, e va bene: si lavora con quello che c’è. Esportazioni programmate, cartelle sorvegliate, file posati su un server, in qualche caso lettura diretta della base dati con permessi di sola lettura.

Sono strade meno eleganti e perfettamente funzionanti, purché ci sia la stessa disciplina: un formato dichiarato, un controllo su quello che entra e un allarme quando il file di stanotte non è arrivato. La differenza fra un’integrazione e uno script è tutta lì.