Biblioteca delle integrazioni
Portale B2B con Business Central: API, webhook e sincronizzazione
Indicazioni architetturali per integrare un portale B2B con API e webhook di Microsoft Dynamics 365 Business Central.
- Business CentralRecord principali e regole commerciali
- Servizio di integrazione autorizzatoMappatura, coda e verifica degli esiti
- Portale rivenditoriVisualizzazione autorizzata e richiesta di operazione
In un portale B2B con Dynamics 365 Business Central, il problema non è soltanto trasferire l'ordine. Occorre rilevare tempestivamente i cambiamenti, gestire richieste contemporanee e aggiornare i dati senza superare i limiti API.
Differenza tra API e webhook
L'API consente al portale di richiedere dati o operazioni specifici. Il webhook aiuta a notificare al sistema sottoscritto i cambiamenti di una risorsa supportata. La documentazione Microsoft spiega che, creando una sottoscrizione webhook Business Central, è necessario un handshake di verifica tramite validationToken.
L'approccio consigliato è quindi ricevere gli eventi disponibili via webhook e interrogare i record via API quando serve, anziché riscaricare tutti i record ogni pochi secondi.
Flusso esemplificativo
- Il portale verifica identità e ruolo del rivenditore.
- L'utente crea la richiesta d'ordine.
- Il portale aggiunge un record alla coda di integrazione con un identificativo univoco dell'ordine.
- Il backend autorizzato avvia l'operazione necessaria tramite l'API Business Central.
- La risposta API viene registrata; in caso di errore, non si comunica un successo inesistente all'utente.
- I cambiamenti supportati vengono riportati nel portale tramite webhook o sincronizzazione controllata.
Perché i limiti API sono importanti?
Microsoft documenta i limiti delle API Business Central e la risposta 429 Too Many Requests. In questo caso servono una pausa e tentativi controllati. Suddividere i trasferimenti voluminosi in blocchi e usare webhook dove opportuno può ridurre il carico.
Test prioritari
- La richiesta di verifica della sottoscrizione riceve la risposta corretta?
- Un webhook ripetuto genera operazioni duplicate?
- Dopo un 429, l'operazione torna in coda senza andare persa?
- Ogni rivenditore vede soltanto i propri dati commerciali?
- Attese ed errori sono comprensibili durante operazioni lunghe?
Quando serve software su misura?
Una progettazione personalizzata può essere sensata se, oltre alla schermata standard degli ordini, servono listini regionali, livelli di approvazione, gerarchie di ruoli dei rivenditori e report operativi.
Cosa verificare se la sottoscrizione non invia più notifiche?
Le sottoscrizioni Business Central scadono se non vengono rinnovate; creazione e rinnovo richiedono una risposta di verifica. Controlla il supporto webhook della risorsa e il valore expirationDateTime della sottoscrizione. Le notifiche possono essere ritardate o aggregate; non interpretarle come garanzia di consegna immediata ed esattamente una volta per ogni record. Documentazione Microsoft sui webhook.
Scenario di esempio: Supponiamo che la copia del catalogo nel portale diventi obsoleta dopo una modifica di prezzo. Il servizio che riceve la notifica verifica prima le informazioni di autenticazione, registra il lavoro in modo persistente e poi legge il record necessario via API. Se lo stesso record arriva di nuovo, non sovrascrive dati nuovi con quelli vecchi. Se la sottoscrizione si interrompe, confronta in modo controllato le modifiche successive all'ultima sincronizzazione riuscita.
| Controllo | Esito atteso prima del rilascio |
|---|---|
| Rinnovo non riuscito | Avviso al responsabile; nessuna apparenza ingannevole di dati aggiornati |
| Notifica ripetuta | Nessun secondo ordine o effetto collaterale duplicato |
| Identità del rivenditore errata | Accesso negato sul server, non soltanto un filtro nell'interfaccia |
| Nessun dato ricevuto per molto tempo | Sottoscrizione e freschezza dei dati verificate separatamente |
Per distinguere gli errori API, consulta la guida al 429 e la guida al 504.
Online e on-premises usano lo stesso accesso?
Questa guida riguarda l'API v2.0 di Business Central e le risorse webhook supportate. Per l'ambiente Online si verificano tenant, environment e company; per l'installazione locale, versione, pubblicazione API e provider di identità. Nell'accesso server-to-server, l'applicazione Microsoft Entra deve essere registrata anche in Business Central con i set di autorizzazioni necessari. Ottenere un token non significa avere accesso a tutti i dati aziendali. Requisiti Microsoft per l'accesso S2S.
Prima del pilota prepara: tipo e versione dell'installazione, azienda di test, risorse API interessate, autorizzazioni applicative, supporto webhook, conferma del responsabile cliente sull'idoneità della licenza e dell'uso, volume giornaliero previsto. Concorda un metodo di accesso autorizzato invece di inviare chiavi segrete o token.
Esempio di assegnazione delle responsabilità: prodotti, prezzi, stock e conti cliente si leggono dall'ERP; il portale invia la richiesta d'ordine e mostra l'esito accettato dall'ERP. Trasferimento bidirezionale non significa che entrambi i lati possano modificare liberamente lo stesso campo. I campi modificabili nel portale e il sistema che decide in caso di conflitto vengono definiti per iscritto. Se un connettore pronto copre il flusso standard, se ne valutano prima ambito e manutenzione.
Fonti e verifica
I flussi esemplificativi sono proposte architetturali, non progetti cliente completati né dichiarazioni di partnership con i produttori. Verifica delle fonti tecniche: 17 ottobre 2026. Versione, licenza e autorizzazioni dell'installazione vanno verificate separatamente.
Adatta il flusso alla tua azienda
Consulta la guida alla pianificazione dell'integrazione ERP. Puoi approfondire il perimetro previsto per lo sviluppo di portali B2B; possiamo valutare insieme il tuo processo attuale.
Parliamo delle tue esigenze →