RECURSOS · SAP BUSINESS ONE
Service Layer de SAP Business One
Lo que tienes que saber sobre el Service Layer de SAP Business One para hacer integraciones con tu ERP: qué es, para qué sirve y cómo empezar a usarlo con seguridad.
El Service Layer de SAP Business One es la API RESTful oficial del ERP: expone los objetos de negocio (socios, artículos, órdenes) vía HTTP, OData y JSON para que los desarrolladores integren aplicaciones web, móviles y de comercio electrónico sin instalar componentes en el cliente. Es la vía que SAP recomienda para toda integración nueva, en reemplazo de DI Server.
¿Qué es el Service Layer de SAP Business One?
El Service Layer es una herramienta de integración y desarrollo basada en la arquitectura RESTful que permite la comunicación entre SAP Business One y aplicaciones externas, como plataformas de eCommerce o CRM. En la documentación de SAP aparece con su nombre oficial: SAP Business One Service Layer.
Esta capa de servicios corre como un servidor web de alta disponibilidad junto a tu ERP: disponible para SAP HANA desde la versión 9.2 y también para Microsoft SQL Server a partir de la versión 10.0. Expone las funciones y los objetos de negocio del sistema mediante OData, para que los desarrolladores interactúen con el ERP de manera sencilla y segura.
Las empresas lo usan para manejar la integración de datos de manera eficiente, escalable y flexible, con interacción en tiempo real a través de servicios web.
En este video conocerás cómo Service Layer, la API oficial de SAP Business One, permite integrar aplicaciones y automatizar procesos de forma segura y eficiente.
Beneficios del Service Layer
Por qué el Service Layer se volvió la vía recomendada para integrar SAP Business One.
Flexibilidad
Se integra con una amplia variedad de sistemas y aplicaciones externas, usando distintos lenguajes de programación como JavaScript y protocolos como HTTP.
Escalabilidad
Gracias a su arquitectura RESTful, las integraciones con SAP Business One escalan fácilmente y crecen a medida que lo hace tu empresa.
Seguridad
Utiliza autenticación por sesión y HTTPS, garantizando que los datos entre sistemas viajen protegidos.
Eficiencia
Simplifica el mantenimiento de integraciones y deja a los desarrolladores centrarse en mejorar procesos y optimizar operaciones.
Alta disponibilidad
Asegura que los servicios estén siempre activos y accesibles, reduciendo tiempos de inactividad y aumentando la eficiencia operativa.
Casos de uso y ejemplos de integración
Escenarios reales donde el Service Layer conecta SAP Business One con el resto de tu operación.
Comercio electrónico
Sincroniza automáticamente productos, pedidos, clientes e inventario entre SAP Business One y plataformas como Shopify, WooCommerce o Magento.
Sistemas CRM
Integra SAP Business One con un CRM para compartir datos de clientes, oportunidades de venta y más — por ejemplo con el CRM B2B de Aventi sobre SAP B1.
Gestión de almacenes (WMS)
Conecta tu ERP con un WMS para SAP Business One y mejora la eficiencia en inventario y logística con una capa de servicios uniforme y de alta disponibilidad.
Aplicaciones móviles
Permite a los usuarios acceder a información y funciones del ERP desde cualquier lugar, con una entrada de datos más ágil y mayor adopción del personal.
Cómo se conecta el Service Layer
El Service Layer se ubica entre SAP Business One y tus aplicaciones externas, exponiendo los objetos de negocio del ERP como una API REST uniforme.
Service Layer vs DI Server: por qué migrar
Muchas integraciones siguen corriendo sobre DI Server o DI API, las interfaces COM/SOAP de la generación anterior. SAP las mantiene en soporte pasivo y posiciona el Service Layer como el estándar para todo desarrollo nuevo: procesa más solicitudes, escala horizontalmente y habilita despliegues en la nube de manera nativa.
| Criterio | DI Server (legado) | Service Layer |
|---|---|---|
| Protocolo | SOAP/XML, COM | REST/OData, JSON |
| Escalabilidad | Limitada | Horizontal, alta disponibilidad |
| Nube | Despliegue complejo | Nativo |
| Clientes | Windows/.NET (WCF) | Cualquier lenguaje que hable HTTP |
| Soporte SAP | Pasivo | Activo |
Según pruebas publicadas por SAP, la capa de servicio procesa alrededor de 6.7 ciclos completos de venta por segundo (orden → entrega → factura) con 60 solicitudes concurrentes. Los candidatos típicos a migración: conectores de e-commerce antiguos, integraciones con WMS, aplicaciones de captura en planta y servicios de Windows sin bibliotecas modernas. Si es tu caso, el primer paso es auditar las integraciones existentes — escríbenos y lo revisamos contigo.
¿Quieres sacarle más provecho a SAP Business One?
Agenda una asesoría gratis hoy mismo con un especialista en SAP Business One.
Cómo empezar con el Service Layer SAP B1
Para comenzar a utilizar el Service Layer en SAP Business One necesitas una versión compatible del ERP (9.3 o posterior) y una base de datos SAP HANA o SQL. Además, es fundamental trabajar con un especialista en SAP B1 que te brinde asesoría y soporte durante la implementación y la configuración.
Con la ayuda de un experto podrás definir tus necesidades de integración, activar el complemento del Service Layer en tu instalación de SAP y aprender las mejores prácticas para aprovechar al máximo esta herramienta.
Configuración y despliegue
Requisitos del sistema
- SAP Business One versión 9.3 o superior
- Base de datos SAP HANA o Microsoft SQL Server
- Servidor web compatible (por ejemplo, IIS)
- .NET Framework 4.8 o superior
Proceso de instalación
- Instalar el Service Layer desde el SAP Business One Setup Wizard.
- Configurar el servidor web para hospedar el Service Layer.
- Establecer los certificados SSL para comunicaciones seguras.
Activación y configuración inicial
- Activar el complemento del Service Layer en SAP Business One.
- Configurar los usuarios y permisos para el acceso al Service Layer.
- Definir las políticas de seguridad y los límites de uso de recursos.
Trabajando con el Service Layer
Autenticación y autorización
La autenticación es por sesión: envías un POST a /b1s/v2/Login con la base de datos de la empresa, el usuario y la contraseña, y recibes una cookie de sesión que acompaña a las siguientes solicitudes.
POST https://tu-servidor:50000/b1s/v2/Login
{ "CompanyDB": "SBODEMOMX", "UserName": "integracion", "Password": "********" }Usa siempre HTTPS, usuarios de integración dedicados con permisos mínimos y cierra las sesiones que no estés usando.
Manejo de solicitudes y respuestas
Las solicitudes usan métodos HTTP estándar (GET, POST, PATCH, DELETE) contra endpoints específicos, con consultas OData ($filter, $select, $top) para traer justo la información que necesitas. Las respuestas devuelven los datos en formato JSON, con códigos de estado estándar y mensajes de error cuando corresponde.
Operaciones CRUD básicas
Ejemplo de operaciones básicas sobre los socios de negocio:
POST /b1s/v2/BusinessPartners # Crear
GET /b1s/v2/BusinessPartners('C20000') # Leer
PATCH /b1s/v2/BusinessPartners('C20000') # Actualizar
DELETE /b1s/v2/BusinessPartners('C20000') # EliminarDocumentación y referencia de la API (OData)
¿Buscas el manual o el API reference? La referencia completa vive en tu propia instalación: el endpoint /b1s/v2/$metadata devuelve el modelo OData con todas las entidades expuestas (BusinessPartners, Items, Orders, Invoices…). La documentación oficial se publica en el portal de ayuda de SAP como SAP Business One Service Layer — API Reference.
- Usa la ruta
/b1s/v2/(OData v4): la versión 3 quedó marcada como obsoleta en las versiones recientes del producto. - Hay bibliotecas cliente para .NET (WCF/Web API), JavaScript (fetch, Axios), Python y Java; cualquier lenguaje que hable HTTP sirve, sin instalar el ERP en el cliente que hace la solicitud.
- Prueba primero con Postman o curl apuntando a la URL del Service Layer y, cuando el piloto funcione, conviértelo en una extensión o conector formal.
- Un buen primer ejercicio para los desarrolladores: la generación de una orden de venta de prueba, validando la respuesta JSON antes de conectar el sistema productivo.
Preguntas frecuentes sobre el Service Layer
01¿Cuál es la principal ventaja del Service Layer frente a otros métodos de integración?
El Service Layer permite una integración más rápida y segura mediante APIs basadas en REST, lo que lo hace más flexible y escalable que los métodos de integración tradicionales.
02¿El Service Layer soporta alta disponibilidad?
Sí. Está diseñado para ofrecer alta disponibilidad, lo que asegura que las integraciones y operaciones estén siempre en funcionamiento.
03¿Qué versión de SAP Business One necesito para usar el Service Layer?
Necesitas SAP Business One 9.3 o posterior, sobre una base de datos SAP HANA o Microsoft SQL Server. Las versiones más recientes del ERP incorporan mejoras y nuevas funciones del Service Layer.
04¿Funciona con SAP HANA y con SQL Server?
Sí. El Service Layer opera tanto sobre SAP HANA como sobre Microsoft SQL Server; algunas funciones avanzadas pueden variar según el motor de base de datos.
05¿Qué formato de datos usa el Service Layer?
Las solicitudes usan métodos HTTP estándar (GET, POST, PATCH, DELETE) y las respuestas se devuelven en formato JSON, lo que facilita su consumo desde cualquier lenguaje.
06¿Necesito un especialista para implementarlo?
Es muy recomendable. Un especialista en SAP B1 te ayuda a definir las integraciones, activar el complemento, configurar la seguridad y aplicar buenas prácticas desde el inicio.
07¿Qué diferencia hay entre DI API, DI Server y Service Layer?
DI API es una biblioteca COM que corre en el equipo del cliente y DI Server su versión servidor vía SOAP; ambas son tecnología de la generación anterior. El Service Layer es la interfaz RESTful/OData que SAP recomienda para integraciones nuevas, con mejor rendimiento, escalabilidad y soporte activo.
08¿Qué versión de OData usa el Service Layer?
Soporta OData v3 y v4, pero la v3 está marcada como obsoleta: todo desarrollo nuevo debe usar la ruta /b1s/v2/ (OData v4).
ASESORÍA
¿Quieres ver cómo otras empresas le sacan el máximo provecho a su ERP?
Agenda una consultoría gratuita con un especialista en SAP Business One y resuelve tus dudas de integración.
También te puede interesar
Intralog WMS para SAP Business One
El WMS creado exclusivamente para SAP B1: picking dirigido e inventario en tiempo real.
Ver más →IA para ventas sobre SAP Business One
Cómo la inteligencia artificial de Aventi acelera las ventas sobre tu ERP.
Ver más →Glosario de SAP Business One
Términos, transacciones y consultas de SAP Business One explicados en español.
Ver más →