Il Service Layer è un'interfaccia applicativa che espone funzioni di SAP Business One attraverso servizi web. Permette a software esterni di interrogare dati e interagire con numerosi oggetti dell'ERP.
Non tutte le integrazioni sono uguali
Una soluzione esterna può dialogare con SAP Business One attraverso API applicative invece di scrivere direttamente sulle tabelle. Questo mantiene la logica gestionale dentro gli oggetti dell'ERP e rende più chiaro il confine fra i sistemi.
L’applicazione invia una richiesta all’interfaccia di SAP. Il Service Layer applica autenticazione e regole degli oggetti aziendali, poi restituisce l’esito.
Esempio: POST /b1s/v2/Orders crea un ordine tramite l’oggetto applicativo; la risposta comunica l’esito o l’errore.
I concetti essenziali
REST
È uno stile architetturale per organizzare richieste HTTP verso risorse identificabili. Le operazioni usano metodi standard come GET, POST e PATCH.
OData
È un protocollo che consente di interrogare risorse applicando filtri, selezioni e ordinamenti con una sintassi coerente.
JSON
È il formato testuale usato comunemente per scambiare i dati fra applicazione e Service Layer.
Business Object
Ordini, articoli, Business Partner e documenti non sono semplici righe di database: sono oggetti applicativi con relazioni e regole.
Sessioni e autenticazione
L'applicazione esegue il login, ottiene una sessione e la utilizza nelle richieste successive. Devono essere gestiti in modo corretto credenziali, scadenza, autorizzazioni, HTTPS e rinnovo della sessione.
Interrogare e creare documenti
Le API permettono di leggere collezioni, filtrare dati e creare o aggiornare gli oggetti supportati. Non tutte le operazioni sono disponibili nello stesso modo per ogni versione: la compatibilità va verificata sul sistema concreto.