Connessioni ERP-API di terze parti
ERP verso terzi: CRM, logistica, fisco e identità
Connessioni REST, SOAP, webhook e iPaaS tra il Suo ERP e i servizi che lo circondano, con nuovi tentativi e avvisi.
Blueprint
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).
Panoramica
Questo è il flusso tra il Suo ERP e i servizi che lo circondano: il CRM, i corrieri e i fornitori di logistica, le piattaforme di fatturazione elettronica e fiscali, e i fornitori di identità e KYC. Ogni partner ha la propria API, il proprio formato e i propri errori, e ciascuno arriva di solito come un progetto separato.
Il progetto di riferimento invia gli eventi aziendali dall’ERP una sola volta, a una piattaforma di integrazione che li consegna a ogni partner nel formato atteso, su REST, SOAP, webhook o EDI su AS2 dove i partner commerciali lo richiedono. Le call-back, come gli eventi di tracciamento o gli esiti dei controlli, tornano attraverso la stessa piattaforma.
Un partner non disponibile è un evento normale, non un’emergenza. I guasti temporanei vengono ritentati. Un messaggio che fallisce ancora dopo i nuovi tentativi finisce in una coda dei messaggi non recapitabili, e un avviso raggiunge il team di supporto con il payload e l’errore, così può essere corretto e riprodotto.
Come funziona il flusso
L’ERP pubblica un evento
Quando un cliente, un ordine o una fattura cambia, l’ERP pubblica un evento aziendale alla piattaforma di integrazione, tramite la sua API, i servizi OData o i webhook.
Il CRM resta aggiornato
La piattaforma aggiorna account, contatti e ordini nel CRM, così i team vendite e servizio vedono ciò che l’ERP sa.
Le spedizioni vengono prenotate
Gli ordini pronti alla spedizione vengono prenotati con il corriere o il fornitore logistico tramite la sua API, e tornano etichette e riferimenti.
Il tracciamento ritorna
Il corriere invia eventi di tracciamento e prova di consegna via webhook, e la piattaforma aggiorna l’ordine nell’ERP.
Le fatture vengono convalidate
Le fatture sono inviate alla piattaforma di fatturazione elettronica o fiscale nel formato richiesto dall’autorità, e lo stato di convalida è conservato con la fattura.
Le identità vengono verificate
I nuovi clienti o fornitori sono inviati al fornitore di KYC o di identità, e il risultato torna via webhook prima dell’attivazione dell’account.
Quando qualcosa fallisce
Un partner è temporaneamente non disponibile
La chiamata viene ritentata con attese crescenti. Una chiave di idempotenza su ogni scrittura fa sì che un nuovo tentativo non crei mai una seconda spedizione o fattura.
Un messaggio fallisce ancora dopo i nuovi tentativi
Finisce in una coda dei messaggi non recapitabili con il payload e l’errore del partner, e il team di supporto riceve un avviso. Una volta corretto, viene riprodotto dalla coda.
Un partner cambia la propria API
I test dei contratti girano contro l’ambiente di collaudo di ogni partner e intercettano il cambiamento. I cambiamenti annunciati vengono pianificati e collaudati prima della scadenza del partner.
I dati vengono rifiutati
Un partner che rifiuta dati per un motivo aziendale, come una partita IVA mancante, restituisce l’errore al record dell’ERP, dove il responsabile può correggerlo.
Standard e sistemi
- Integrazione
- REST
- SOAP
- Webhooks
- OpenAPI
- EDI (EDIFACT, ANSI X12)
- AS2
- MuleSoft
- Boomi
- Azure Logic Apps
- Identità e accesso
- OAuth 2.0
Domande e risposte
Quali servizi di terze parti potete collegare?
Qualsiasi servizio con un’API o un’interfaccia su file documentata. Esempi tipici sono piattaforme CRM, corrieri e fornitori di logistica, marketplace, piattaforme di fatturazione elettronica e fiscali, paghe, fornitori di KYC e identità e partner commerciali che scambiano documenti EDI su AS2. Esaminiamo API, limiti e ambiente di collaudo di ogni partner prima di impegnarci su un piano.
Serve una piattaforma di integrazione per questo?
Quando più partner sono collegati a un ERP, una piattaforma come MuleSoft, Boomi o Azure Logic Apps, o un insieme di servizi personalizzati costruiti su una coda di messaggi, tiene mapping, nuovi tentativi e monitoraggio in un unico posto. Con uno o due partner, le connessioni dirette possono bastare. Esponiamo i compromessi, compresi i costi delle licenze, per il Suo caso.
Potete collegarci a piattaforme di fatturazione elettronica e convalida fiscale?
Sì. Molti Paesi ormai richiedono che le fatture siano emesse o convalidate tramite una piattaforma governativa o accreditata in un formato definito. Integriamo l’ERP con la piattaforma richiesta dal Suo Paese o con un fornitore accreditato, conserviamo stato di convalida e identificativi con ogni fattura e gestiamo i rifiuti. I Suoi consulenti fiscali confermano le regole applicabili.
Come proteggete i webhook in ingresso?
Ogni webhook in ingresso è verificato prima dell’elaborazione: tramite firma dove il partner firma i propri messaggi, e tramite controlli su token, origine e timestamp dove non lo fa. I payload sono validati rispetto al contratto, e gli eventi vengono elaborati una sola volta anche se il partner li invia più di una volta.
Che cosa succede quando un partner ha un’interruzione?
Il resto dei flussi continua a funzionare. I messaggi per quel partner vengono ritentati e poi messi in coda, il team di supporto riceve un avviso e nulla va perso. Quando il partner torna disponibile, i messaggi in coda vengono riprodotti in ordine. La dashboard mostra quale partner è interessato e quanti messaggi sono in attesa.
A chi appartengono i connettori che costruite?
La proprietà intellettuale del lavoro che costruiamo per Lei è Sua dal primo commit, senza passaggi di cessione alla fine. I connettori sono consegnati con codice sorgente, test e documentazione, così il Suo team o un altro fornitore può mantenerli. Gli strumenti XSIS preesistenti restano nostri e Le sono concessi in licenza. Le API dei partner e le licenze delle piattaforme di integrazione restano soggette alle condizioni dei rispettivi fornitori.
Inizi con una conversazione, non con un contratto.
Ci racconti che cosa deve costruire, collegare o proteggere. Un architetto lo esamina con Lei e poi consiglia da dove iniziare.
Che cosa succede dopo
Concordare un orario
Il nostro team Le invia un’e-mail per concordare un orario per la sessione.
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.