Biblioteca delle integrazioni

Portale rivenditori B2B con SAP Business One: Service Layer e flusso dei dati

Decisioni di architettura, accesso ai dati e sicurezza per un portale rivenditori basato su SAP Business One Service Layer.

Codariva ·

  1. SAP Business OneRecord principali e regole commerciali
  2. Servizio di integrazione autorizzatoMappatura, coda e verifica degli esiti
  3. Portale rivenditoriVisualizzazione autorizzata e richiesta di operazione
Architettura esemplificativa: prodotti, prezzi e stock passano dall'ERP al portale; le richieste d'ordine dal portale all'ERP. Titolarità e condizioni di accettazione si definiscono separatamente per ogni dato.

Per un'azienda che usa SAP Business One, il valore del portale rivenditori sta nel presentare in modo affidabile i dati ERP appropriati a ogni cliente. Ma collegare i sistemi e far funzionare correttamente il processo non sono la stessa cosa. Approvazioni, prezzi e permessi sui dati vanno progettati dall'inizio.

Cosa offre il Service Layer?

Il documento SAP Business One Service Layer API Reference descrive il Service Layer come API dati accessibile via OData. Secondo la documentazione SAP corrente, da FP 2405 OData v3 è deprecato e OData v4 è il protocollo principale. Non si dovrebbe garantire un unico metodo di integrazione senza verificare installazione e feature package.

Architettura consigliata

Il browser del rivenditore non deve collegarsi direttamente all'ERP. Serve un backend separato che gestisca autenticazione, ruoli, accesso ai campi e limiti di traffico. Il backend invia richieste all'ERP con permessi appropriati e restituisce soltanto i dati necessari.

  1. Associa gli account dei rivenditori ai business partner SAP.
  2. Definisci prodotti e prezzi visibili nel catalogo.
  3. Definisci regole di magazzino e prenotazione per lo stock.
  4. Dividi la creazione ordine in “richiesta → controllo → accettazione ERP”.
  5. Testa errori, timeout e duplicazioni.
  6. Definisci il comportamento del portale durante la manutenzione ERP.

Tabella delle decisioni architetturali

Domanda Perché è importante?
Sono disponibili la versione ERP e l'accesso al Service Layer? Determina protocolli ed endpoint utilizzabili
Ci sono più magazzini? Modifica il calcolo dello stock disponibile
Come funziona il prezzo per rivenditore? Impedisce la visualizzazione non autorizzata dei prezzi
Quando l'ordine diventa definitivo? Evita messaggi di successo errati
Come vengono comunicate le modifiche all'ordine? Mantiene la coerenza tra portale ed ERP

Un test critico nella pratica

Misura il caso di due rivenditori che ordinano contemporaneamente lo stesso prodotto. Il sistema deve rispettare regole di stock e approvazione, non soltanto dare l'impressione di una schermata veloce.

Una risposta HTTP positiva significa che l'ordine è approvato?

Non sempre. Nel flusso di creazione ordini documentato da SAP Service Layer, una procedura di approvazione attiva può generare una bozza invece di un ordine. Controllare il solo codice di risposta non basta: occorre verificare oggetto creato, riferimento e stato operativo. SAP Service Layer API Reference.

Scenario di esempio: L'ordine del rivenditore richiede approvazione per il suo importo. Il portale mostra “In attesa di approvazione”, non “Ordine completato”. Quando il responsabile approva, si aggiorna il collegamento al record definitivo nell'ERP. Se l'esito è incerto, prima di ricreare il record si cerca il riferimento esterno.

Dato Responsabile della decisione Compito del portale
Codice business partner/conto cliente Responsabile ERP Associarlo sul server al rivenditore della sessione
Prezzo, imposte e unità di vendita Regole commerciali approvate Distinguere importo mostrato e importo definitivo
Stato bozza/ordine Flusso di approvazione ERP Mostrare lo stato verificato
Accesso al servizio Responsabile IT Non esporre le credenziali ERP nel browser

Trovi le decisioni generali di ambito nella guida alla pianificazione dell'integrazione ERP.

Cosa deve essere pronto sul lato SAP prima del pilota?

Questa guida riguarda SAP Business One 10.0 Service Layer, non un'integrazione SAP S/4HANA. Si registrano feature package/patch, tipo di database, installazione Service Layer, database aziendale e versione OData. Accesso, permessi utente necessari e idoneità della licenza vanno confermati dal responsabile SAP del cliente; l'esistenza di un endpoint non conferisce diritti di licenza.

Per il pilota servono azienda di test, mappatura rivenditori–business partner, magazzino/listino, procedura di approvazione e accesso con privilegi limitati. Se la sessione si apre ma la lettura successiva è negata, usa la guida alle sessioni Service Layer 401. Credenziali e cookie di sessione non devono finire nel browser o negli screenshot inviati all'assistenza.

Esempio di ambito: prodotti, stock, prezzi e saldo cliente vengono letti dall'ERP; la richiesta d'ordine del portale viene verificata nell'ERP. Modificare anagrafiche o prezzi in entrambe le direzioni richiede ulteriori decisioni su permessi e conflitti. Se un portale pronto copre flusso e stati di approvazione, lo sviluppo su misura non è obbligatorio; con gerarchie o approvazioni differenti, si misura il divario.

La sessione Service Layer si apre, ma la richiesta successiva restituisce 401

Questo controllo riguarda client Service Layer che aprono la sessione con Login. Verifica prima che le richieste usino lo stesso server, azienda e versione API e che i dati di sessione siano trasmessi alla chiamata successiva. Sono possibili anche scadenza o riutilizzo di una sessione chiusa. L'esempio SAP sul ciclo di vita della sessione mostra il passaggio a una versione API differente e il rifiuto di accesso dopo Logout.

Con una nuova sessione controllata, esegui una lettura che non modifichi dati. Se la lettura funziona ma la scrittura è negata, verifica il permesso specifico senza assegnare diritti amministrativi generali. Se la sessione si perde dietro un proxy, l'amministratore deve esaminare l'inoltro di cookie e header. Non registrare i valori di sessione nei log. Se l'esito di una scrittura resta incerto, riaprire la sessione non rende sicuro ricreare l'ordine: cerca prima il record tramite riferimento.

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 →