Servizio arades · cluster specializzazione · API-first

Integration & Interfaces — collegare Microsoft con il mondo che parla con Microsoft.

ERP, eCommerce, logistica, banking — Microsoft Dynamics 365 e Microsoft 365 raramente sono soli. Costruiamo interfacce che sopravvivono alle Microsoft Release Wave: documentate, testate, con gestione degli errori e monitoring integrati. Referenze live da progetti produttivi con Oxaion, Shopify, Amazon e GLS.

API-First REST · OData · SOAP Microsoft Graph Event-Driven Monitoring & Retry
Oxaion + SAP · referenza live Shopify + Amazon · multi-shop, multi-marketplace GLS / DHL / DPD · integrazione spedizioni Microsoft Graph · 20+ anni di pratica API

Amministratori delegati · titolari

Eliminare i silos di dati — il ROI spesso si ripaga nel primo anno.

Doppia digitazione, ponti Excel e trasferimenti manuali costano davvero — di solito invisibili nel quotidiano. Un'interfaccia pulita sostituisce tipicamente da 1 a 3 quote di posizione nella manutenzione manuale dei dati e accelera in modo misurabile i processi di ordine e spedizione. Forniamo il business case di integrazione in euro: effort, costi successivi, ore risparmiate — pronto per la decisione del board.

Responsabili di reparto · linea di business

Consolidare i dati inter-dipartimentali — senza politica di reparto.

Vendita, service e logistica lavorano con stati di dati propri — non per cattiva volontà, ma per mancanza di ponti. Nel Discovery Spike (prezzo su richiesta) forniamo una mappa dati pulita: sistemi sorgente, ownership dei master data, tabella di mapping, percorso di consolidamento. Report di outcome documentato per comitato di indirizzo e ufficio acquisti — prima che venga costruito il primo connector.

Direzione IT · CIO · Solution Architect

REST, SOAP, event-driven, Service Bus, connector Dataverse — supportati.

Pattern: REST con OAuth 2 e facciata API Management, SOAP legacy con mapping XML, event-driven su Azure Service Bus ed Event Grid, custom connector per Power Platform, Dataverse Web API e Microsoft Graph. Idempotenza, retry con exponential backoff, dead-letter queue, monitoring con Application Insights. Direttamente con lo specialista — niente filtro sales.

Per amministratori delegati · ROI di integrazione in euro

Cosa risparmia davvero un'interfaccia — e cosa può costare.

Forniamo il business case di integrazione su una pagina: quote di posizione risparmiate, doppia digitazione evitata, tempi di ciclo accelerati, costi di rischio da silos di dati. Più stima dell'effort e dei costi successivi. Quello che vede il CFO: un investimento quantificato con payback chiaro. Ingresso a prezzo fisso via Discovery Spike — nessun business a ore aperto, nessuna brutta sorpresa.

Calcola il case di integrazione

Per responsabili di reparto · mappa dati in anticipo

Consolidamento dei dati con percorso documentato — difendibile nel comitato di indirizzo.

Consegna del Discovery Spike: inventario dei sistemi sorgente, tabella di mapping (campi, tipi, obbligatorietà), ownership dei master data per dominio, roadmap di consolidamento con quick win. Più scheletro di business case per CFO e ufficio acquisti. Così parlate con gli altri responsabili di reparto non di problemi Excel, ma di una decisione architetturale documentata — pronta per il prossimo steering.

Avvia la mappa dati

Per la direzione IT · conversazione di architettura di 45 min

REST/SOAP, Service Bus, Event Grid, connector Dataverse — discussi alla lavagna.

Argomenti: point-to-point vs. architettura event-driven, Azure Service Bus (queue, topic, sessioni), Event Grid per eventi cross-dominio, flussi OAuth 2 / OIDC, API Management come facciata, idempotenza e retry con exponential backoff, dead-letter queue, Microsoft Graph vs. Dataverse Web API, custom connector vs. Logic Apps. Direttamente con l'architetto di integrazione.

Conversazione di architettura di 45 min

Cosa è questo servizio

Interfacce che non si rompono alla prossima Release Wave.

Un'interfaccia non è pronta quando trasmette dati per la prima volta. È pronta quando, dopo tre Microsoft Release Wave, cinque salti di versione API del sistema terzo e un cambio del modello di autenticazione, gira ancora — e quando, se mai non lo facesse, lo sapete subito.

Costruiamo interfacce da oltre 20 anni. Agli inizi erano XML web service e drop di file via FTP; oggi sono API REST con autenticazione OAuth 2, webhook di evento e Microsoft Graph. Ciò che non è cambiato: un'interfaccia produttiva ha bisogno di più del solo happy path. Servono gestione degli errori per i fuori servizio API del sistema terzo, idempotenza perché i retry non creino duplicati, strategie di retry con exponential backoff, monitoring con capacità di escalation e documentazione comprensibile a qualcuno diverso dallo sviluppatore originale.

Esattamente questo consegniamo. Un'interfaccia arades arriva con documento di architettura, tabella di mapping, test automatizzati, dashboard di monitoring e sessione di passaggio. Costruiamo sia classici collegamenti point-to-point sia architetture event-driven con message bus, a seconda di ciò che la richiesta supporta. E siamo onesti quando un'architettura esistente è il problema vero — a volte una facciata API davanti a un sistema legacy è l'investimento migliore della dodicesima connessione point-to-point.

Sei aree di integrazione

Cosa colleghiamo in produzione — e con quale esperienza di piattaforma.

Integrazione ERP

SAP, Oxaion, Microsoft Business Central, altri ERP mid-market. Sincronizzazione master data per clienti, articoli, condizioni. Handoff degli ordini, ritorno dello stato fatture, export delle registrazioni contabili. Coda di eccezioni con logica di escalation. Oxaion gira live da anni.

eCommerce

Shopify (multi-shop), WooCommerce, Magento, Salesforce Commerce Cloud. Push delle giacenze, pull degli ordini, ritorno di stato spedizione con tracking. Integrazioni multi-shop con logica di stock centralizzata. Basato su webhook con polling di fallback.

Marketplace

Amazon Reseller API (multi-marketplace DE, UE e mondo), eBay Trading e Sell API, Otto Market, idealo Direktkauf. Sincronizzazione delle inserzioni, pull degli ordini, push di stato, gestione resi. Alta quota di logica di idempotenza per la politica di retry aggressiva dei marketplace.

Logistica & spedizione

GLS, DHL, DPD, UPS, Hermes. Generazione di label, tracking number, webhook di stato. Routing multi-carrier per peso, paese, livello di servizio. GLS è l'integrazione standard, altri provider seguono la stessa architettura — sostituibili come plug-in.

Banking & payment

DATEV (export delle registrazioni contabili, sincronizzazione master data), lexoffice, Stripe, PayPal, Klarna. Riconciliazione degli incassi, aggiornamento dello stato di sollecito, generazione delle registrazioni. Conforme PSD2 per le API bancarie dove richiesto.

Microsoft Graph & API custom

Microsoft Graph per i dati Microsoft 365 — Teams, SharePoint, Outlook, Entra ID. Inoltre qualsiasi API custom su base REST, OData o SOAP. Se una piattaforma ha un'interfaccia documentata, la colleghiamo — in 20 anni abbiamo visto pochissimo che non si potesse fare.

Principi architetturali

Quattro decisioni che prendiamo deliberatamente per ogni interfaccia.

01

API-first

L'API è il contratto — non l'implementazione. Disegnamo prima il mapping e la logica degli endpoint, poi la struttura del codice. Accessi diretti al database o «aggiustiamo dopo con SQL» sono l'eccezione, non la regola. Un'API definita in modo pulito è leggibile anche dopo la prossima Release Wave.

OpenAPI spec Tabella di mapping
02

Event-driven vs. request-response

Non ogni interfaccia deve essere event-driven. Se un sistema terzo offre webhook e il carico lo giustifica, costruiamo event-driven con message bus. Se un drop di file notturno è funzionalmente sufficiente, costruiamo un drop notturno. L'architettura segue il requisito, non la moda.

Webhook Message bus
03

Idempotenza

Elaborare un messaggio due volte non deve creare due record. Ogni interfaccia arades usa ID di correlazione, code di elaborazione deduplicate e logica di upsert invece di insert ciechi. Così sopravviviamo alla politica di retry aggressiva dei marketplace e alle consegne doppie di webhook senza caos nei dati.

ID di correlazione Logica di upsert
04

Strategie di retry & monitoring

Exponential backoff con tetto configurabile, dead-letter queue per errori non recuperabili, escalation degli alert via mail, Teams o PagerDuty. Dashboard di monitoring mostra throughput, latenza, tasso di errore per endpoint. Se un'interfaccia fallisce, lo sapete prima dei vostri clienti finali.

Dead-letter queue Dashboard

Tre modelli di consegna

Quale modello si adatta alla vostra situazione.

Non ogni interfaccia ha bisogno dello stesso modello contrattuale. Un requisito ben delimitato vive nel prezzo fisso. Un landscape di integrazione in evoluzione vive nella logica sprint. Un'interfaccia esistente vive nel modello Care.

Interfaccia a prezzo fisso

Quando: requisito ben delimitato con scope chiaro — ad es. «ordini da Shopify a Dynamics 365 con ritorno di stato». Durata: 4–8 settimane dal kick-off. Cosa ottenete: offerta a prezzo fisso dopo workshop dei requisiti, date di consegna fisse, test di accettazione rispetto alle specifiche. Prevedibile, pianificabile, fatturabile.

Tempo-e-materiale con logica sprint

Quando: requisiti ancora in evoluzione — sviluppo multi-shop in crescita, espansione marketplace, nuova integrazione con sistema terzo con scope poco chiaro. Durata: sprint di due settimane, cancellabile in qualsiasi momento. Cosa ottenete: ogni due settimane un incremento utilizzabile in produzione, fatturazione oraria trasparente, gestione condivisa del backlog.

Modello Care per interfacce esistenti

Quando: le interfacce sono live e devono essere curate — adeguamenti Release Wave, salti di versione API del sistema terzo, estensioni minori. Durata: canone mensile, minimo 12 mesi. Cosa ottenete: monitoring, bug fix guidati da SLA, test Release Wave preventivi, quota oraria per l'evoluzione.

Chi usa tipicamente questo servizio

Quattro profili in cui la nostra pratica sulle interfacce regge particolarmente bene.

PMI con un landscape Microsoft cresciuto nel tempo

Dynamics 365 o Microsoft 365 è in casa, accanto a un ERP più vecchio, uno shop, un sistema contabile, una soluzione di spedizione. Volete collegare le isole senza avviare un nuovo mega-progetto — pragmatici, a tappe, con ROI chiaro per interfaccia.

Aziende commerciali con vendita multi-canale

Shop proprio, Amazon, più istanze Shopify, oltre alla vendita diretta B2B tramite Dynamics 365. L'ERP deve restare single source of truth, tutti i canali agganciati, giacenze e ordini che fluiscono senza ponti Excel.

Aziende industriali con base SAP

SAP è in casa per finanza e produzione, accanto arriva un mondo Microsoft per CRM, service o forza vendita esterna. Vi serve un flusso dati affidabile tra SAP e il mondo Microsoft — bidirezionale, documentato, pronto per audit.

Software house con prodotti custom

State costruendo un prodotto proprio su Microsoft Power Platform o Dynamics 365 e servono interfacce produttive verso i sistemi dei clienti. Forniamo il layer di integrazione come sub-engineering — white-label, documentato, pronto al passaggio.

Correlato

Cosa si collega direttamente a questo servizio.

Domande frequenti

Cosa i committenti vogliono sapere prima dell'incarico.

Con quali sistemi avete esperienza?

Referenze live con Oxaion ERP, SAP, Microsoft Business Central, Shopify (multi-shop), Amazon Reseller API, eBay, GLS, DHL, DPD, DATEV, lexoffice, Stripe e PayPal. Inoltre Microsoft Graph per i dati Microsoft 365 e qualsiasi API REST, OData o SOAP. Per piattaforme sconosciute, verifichiamo la situazione delle API nel primo colloquio — il prerequisito è un endpoint documentato con permessi di lettura e scrittura.

Quanto costa un'interfaccia tipica?

Un'interfaccia a prezzo fisso ben delimitata (ad es. push degli ordini da Shopify a Dynamics 365 con ritorno di stato) si colloca tipicamente nella fascia bassa a cinque cifre, a seconda della complessità del mapping, dei requisiti di gestione degli errori e della profondità di monitoring. Sincronizzazioni di master data bidirezionali più complesse o setup multi-mandante si muovono più in alto. Stimiamo dopo un discovery call con un documento di requisiti.

Chi cura l'interfaccia dopo il go-live?

A scelta noi nel modello Care (monitoring, bug fix, adeguamenti Release Wave, evoluzione) o il vostro team con documentazione di passaggio e sessioni di knowledge transfer. Il modello Care è la regola per le interfacce verso sistemi terzi che rilasciano regolarmente modifiche API — ad es. Amazon, Shopify, Microsoft Graph.

Cosa succede con una Microsoft Release Wave?

Seguiamo gli annunci Microsoft Release Wave dal primo giorno di public preview e testiamo tutte le interfacce da noi costruite sull'ambiente preview della wave, prima che la release produttiva venga distribuita. Le anomalie vengono affrontate direttamente nel modello Care. Così un'interfaccia arades sopravvive tipicamente a più Release Wave senza un'interruzione produttiva.

Sapete fare anche vecchie interfacce SOAP o a file?

Sì. SOAP, XML-RPC, web service classici, drop di file CSV/EDIFACT su SFTP, accessi diretti al database e perfino ponti di screen-scraping per sistemi host legacy: li abbiamo realizzati in progetti produttivi. REST e OData sono oggi la regola, ma proprio i sistemi industriali e gli ERP legacy portano spesso con sé protocolli più vecchi — li colleghiamo direttamente o li avvolgiamo dietro una facciata API moderna.

Quanto dura l'implementazione di un'interfaccia?

Un'interfaccia a prezzo fisso delimitata dura tipicamente da 4 a 8 settimane dal kick-off — workshop dei requisiti, design del mapping, implementazione, test in sandbox, setup di monitoring, go-live. Sincronizzazioni di master data bidirezionali più complesse con logica di conflitto sono tra 8 e 16 settimane. In sprint a tempo-e-materiale consegniamo ogni 2 settimane un incremento utilizzabile in produzione.

Da portare con sé · due materiali

Factsheet e whitepaper.

Due livelli di profondità per esigenze di lettura diverse. Il factsheet è un riferimento rapido (3–5 min) e immediatamente scaricabile. Il whitepaper è formazione di mercato con metodologia e dati di confronto (15–30 min) — lo ricevete via e-mail dopo una breve richiesta.

Factsheet · 2 pagine

Factsheet Integration & Interfaces

3–5 min di lettura · download diretto · senza modulo

Panoramica compatta: portata, indicatori chiave, modello di pricing, processo — ideale da inoltrare a CFO, ufficio acquisti o linea di business.

Scarica factsheet (PDF)

Whitepaper · 12 pagine

Integration & Interfaces — approfondimento

15–30 min di lettura · via e-mail su richiesta

Metodologia, dati di confronto, framework di raccomandazione — materiale per l'argomentazione interna con stakeholder.



Servizi correlati

L'integrazione ha temi vicini — cosa tipicamente arriva insieme.

30 min · Discovery call

Richiedi un'integrazione.

Discovery call di 30 min con il nostro engineering di integrazione: ascoltiamo il vostro requisito, verifichiamo la situazione API del sistema terzo e torniamo con un'indicazione di effort e una proposta per il modello di consegna adatto. Un esempio di prodotto concreto della nostra pratica sulle interfacce lo vedete sulla pagina prodotto Intercompany.