Middleware e servizi di integrazione API
Un unico strato di integrazione per ogni sistema e partner, con i casi di errore gestiti
Quando ogni connessione è uno script a sé
La maggior parte delle aziende dipende da servizi che non gestisce: un CRM, corrieri e fornitori di logistica 3PL, piattaforme fiscali, screening KYC e AML e strumenti SaaS. Ognuno ha la propria API, i propri limiti e il proprio modo di fallire.
Collegati uno alla volta, diventano un insieme di script punto a punto che nessuno comprende del tutto. Un partner cambia la propria API, un messaggio si perde di notte, e il primo segnale è il reclamo di un cliente.
Che cosa cambia per Lei
Uno strato invece di una rete di script
I sistemi pubblicano e ricevono eventi attraverso un unico strato governato, così aggiungere un partner non significa toccare ogni sistema.
Nulla perso, nulla duplicato
Scritture idempotenti, nuovi tentativi con back-off e una coda dei messaggi non recapitabili, così un errore viene intercettato e riprodotto invece di andare perso.
Ogni flusso visibile
Tracce, tassi di errore e latenza per partner, con avvisi che indicano quale partner ha fallito e come.
Che cosa consegniamo
API gateway
Un’unica porta d’ingresso governata per le API che pubblica: autenticazione, limiti di frequenza, quote, versioning e analisi dell’utilizzo.
Event mesh e enterprise service bus
Un event mesh è una rete di broker che instrada gli eventi tra sistemi e sedi in tempo reale. Dove il Suo patrimonio gira già su un enterprise service bus (ESB), progettiamo ed estendiamo anche quello.
Automazione dei flussi BPMN
Processi che attraversano sistemi e persone, come onboarding o approvazioni, modellati in BPMN (Business Process Model and Notation) ed eseguiti da un motore di flusso di lavoro.
Connettori per l’ecosistema di terze parti
Connettori su REST, SOAP e webhook, o tramite un iPaaS (integration platform as a service), per CRM, logistica 3PL e fornitori fiscali, KYC e AML.
Contratti API e versioning
Definizioni OpenAPI o WSDL per ogni interfaccia, con regole sui campi, codici di errore e limiti, e una politica per assorbire i cambiamenti dei partner.
Identità e segreti
Single sign-on con OpenID Connect o SAML, accesso ai servizi con OAuth 2.0 e credenziali in un cassaforte dei segreti, con ambito limitato e rotazione.
Affidabilità e monitoraggio
Chiavi di idempotenza, nuovi tentativi, code dei messaggi non recapitabili e un percorso di intervento umano per ogni eccezione, con dashboard e avvisi per partner.
Come lavoriamo
Fare l’inventario
Elenchiamo i sistemi e i partner da cui dipende, i dati che ciascuno richiede e gli errori che vede oggi.
Progettare lo strato
Scriviamo i contratti API e scegliamo chiamate dirette, eventi, un ESB o una piattaforma di integrazione per ogni flusso.
Realizzare i connettori
Realizziamo ogni connettore con la gestione degli errori, la protezione dai duplicati e la registrazione già in atto dall’inizio.
Collaudare con ogni partner
Eseguiamo test dei contratti e scenari end-to-end nell’ambiente di collaudo di ogni partner, compresi i guasti.
Rilasciare in sicurezza
Rilasciamo per fasi e manteniamo disponibile il vecchio percorso finché il nuovo non è dimostrato.
Esercire e adattare
Monitoriamo tassi di errore e messaggi non recapitabili e adattiamo i connettori quando i partner cambiano le proprie API.
Scorra lateralmente per vedere l’intero disegno.
Da ERP a terze parti: una piattaforma, molti partner
Gli eventi di business escono dall’ERP una volta sola e la piattaforma di integrazione li consegna a ogni partner nel formato che si aspetta. Le callback tornano per la stessa via. Un messaggio che fallisce ancora dopo i nuovi tentativi finisce in una coda dei messaggi non recapitabili e genera un avviso con il payload allegato.
- Flusso principale
- Asincrono
- Percorso di eccezione
Il flusso in 9 passi
Il flusso, passo per passo
- Da ERP a Piattaforma di integrazione: Eventi di business, tramite REST · OData · webhook (flusso principale).
- Da Piattaforma di integrazione a CRM: Clienti e ordini, tramite REST/JSON (flusso principale).
- Da Piattaforma di integrazione a Logistica e corrieri: Spedizioni prenotate, tramite REST/JSON (flusso principale).
- Da Logistica e corrieri a Piattaforma di integrazione: Eventi di tracciamento, tramite webhook (asincrono).
- Da Piattaforma di integrazione a Piattaforma di fatturazione elettronica e fisco: Fatture da validare, tramite SOAP/XML · REST (flusso principale).
- Da Piattaforma di integrazione a Fornitore KYC e di identità: Controlli di identità, tramite REST/JSON (flusso principale).
- Da Fornitore KYC e di identità a Piattaforma di integrazione: Esiti dei controlli, tramite webhook (asincrono).
- Da Piattaforma di integrazione a Coda dei messaggi non recapitabili e avvisi: Non recapitato dopo i tentativi, verso una coda dei messaggi non recapitabili (percorso di eccezione).
- Da Coda dei messaggi non recapitabili e avvisi a Team di assistenza: Avviso con il payload e l’errore (percorso di eccezione).
Protocolli, piattaforme e standard
Se possiede già una piattaforma di integrazione, costruiamo su quella. Citare un prodotto non implica una partnership con il suo fornitore.
- Dati e analisi
- Apache Kafka
- Integrazione
- REST
- SOAP
- GraphQL
- Webhooks
- OpenAPI
- MuleSoft
- Boomi
- Azure Logic Apps
- Apache Camel
- RabbitMQ
- Identità e accesso
- OAuth 2.0
- OpenID Connect
- SAML 2.0
- SCIM
- Keycloak
- Microsoft Entra ID
- Standard sanitari
- HL7 v2
- HL7 FHIR
Risultati in produzione
Per una banca Tier-1 del GCC e un conglomerato regionale abbiamo realizzato un middleware a eventi su Apache Kafka. Collega SAP S/4HANA a banche e autorità fiscali, con i segreti conservati in HashiCorp Vault.
Come iniziare
Un elenco chiaro di partner e flussi porta direttamente a una proposta. Una rete di integrazioni esistente e non documentata inizia con il Brownfield Diagnostic Bridge.
Che cosa succede dopo
Sessione di preconsulenza
Una sessione di preconsulenza online gratuita di 30 minuti: esaminiamo i Suoi obiettivi, i Suoi sistemi e i Suoi vincoli.
Revisione di preparazione
Nell’ambito di una revisione di preparazione gratuita di 48 ore, un architetto principal verifica il Suo progetto rispetto alla definizione di «pronto» in 6 punti e raccomanda il Track più adatto.
Scelta del Track
I progetti con perimetro definito ricevono una proposta vincolante entro 3–5 giorni lavorativi. I progetti in fase di concept iniziano nel Blueprint Studio. Un sistema in produzione che non funziona, non è documentato o richiede integrazione inizia con una diagnosi di 1–2 settimane. Il Blueprint Studio e la diagnosi hanno ciascuno un compenso fisso, indicato nella proposta.
Consegna in cinque fasi
Mobilitazione, sprint con dimostrazioni dal vivo, integrazione e consolidamento, collaudo e go-live, poi servizi gestiti. Dopo il lancio seguono un periodo di garanzia, poi supporto e manutenzione opzionali.
Progetti a risultato fisso e servizi gestiti 24 ore su 24
Erogazione a perimetro fisso guidata da milestone con responsabili della consegna nominati, e servizi gestiti applicativi 24 ore su 24 sotto governance SLA.
Specialisti integrati e potenziamento strategico
Ingegneri principali e specialisti nearshore e on-site, e architetti di soluzioni, trasformazione, PQC e integrazione integrati.
Domande e risposte
Dovremmo usare una piattaforma di integrazione o codice personalizzato?
Dipende da quante connessioni ha e da chi le gestirà. Una piattaforma di integrazione come MuleSoft, Boomi o Azure Logic Apps offre connettori pronti, mapping e monitoraggio in un unico posto, al costo di una licenza. Servizi personalizzati danno pieno controllo e nessuna licenza, ma più codice da mantenere. Confrontiamo entrambe le strade per il Suo caso.
Qual è la differenza tra un ESB e un event mesh?
Un enterprise service bus instrada e trasforma i messaggi attraverso un hub centrale. Un event mesh distribuisce gli eventi attraverso una rete di broker connessi, così i sistemi in cloud e sedi diverse pubblicano e sottoscrivono direttamente. Molti patrimoni usano entrambi mentre passano dall’uno all’altro.
Che cosa succede quando l’API di un partner non è disponibile?
Le richieste che falliscono per motivi temporanei vengono ritentate con attese crescenti. Ogni scrittura porta una chiave di idempotenza, così un nuovo tentativo non crea mai un secondo ordine o una seconda fattura. Un messaggio che fallisce comunque finisce in una coda dei messaggi non recapitabili con il payload e l’errore. Un avviso raggiunge il Suo team e il messaggio viene riprodotto quando il partner torna disponibile.
Come gestite i cambiamenti di versione delle API?
Per le API che pubblica, le versioniamo, manteniamo in funzione le vecchie versioni per un periodo concordato e comunichiamo ai consumatori che cosa cambia. Per le API che chiama, seguiamo gli avvisi di dismissione di ogni partner e collaudiamo le nuove versioni nella sua sandbox. I test dei contratti intercettano un cambiamento non annunciato prima che arrivi in produzione.
Potete collegare il nostro identity provider?
Sì. Aggiungiamo il single sign-on con OpenID Connect o SAML 2.0 tramite provider come Microsoft Entra ID o Keycloak. Gli utenti vengono provisionati con SCIM dove l’applicazione lo supporta. Il Suo identity provider resta l’unico punto in cui l’accesso viene concesso e revocato.
Come gestite i limiti di frequenza?
Progettiamo intorno ai limiti pubblicati da ogni partner. Raggruppiamo le richieste dove l’API lo consente, mettiamo in cache i dati che cambiano di rado, distribuiamo i processi pianificati e rallentiamo quando un limite è vicino. Il monitoraggio mostra quanto ogni flusso si avvicina al proprio limite.
Pronto a costruire? Chieda una proposta.
Invii i Suoi requisiti o la Sua RFP. I nostri architetti li validano e restituiscono una proposta vincolante a perimetro fisso.
Che cosa succede dopo
Revisione di preparazione
Nell’ambito di una revisione di preparazione gratuita di 48 ore, un architetto principal verifica il Suo progetto rispetto alla definizione di «pronto» in 6 punti e raccomanda il Track più adatto.
Proposta vincolante
Dopo la validazione architetturale senza costi, riceve una proposta vincolante a perimetro fisso entro 3–5 giorni lavorativi: milestone, architettura, struttura del team e SLA. Su richiesta firmiamo con Lei un accordo di riservatezza (NDA) prima che condivida i Suoi requisiti.
Mobilitazione
Alla firma, i nostri pod di ingegneria iniziano lo Sprint 0 entro 5–10 giorni lavorativi dalla firma del contratto.
Consegna in cinque fasi
Mobilitazione, sprint con dimostrazioni dal vivo, integrazione e consolidamento, collaudo e go-live, poi servizi gestiti. Dopo il lancio seguono un periodo di garanzia, poi supporto e manutenzione opzionali.