Si usas SAP Business One y vendes en una tienda online o un marketplace, necesitas sacar del ERP el stock y los precios, y meter de vuelta los pedidos. Este artículo explica qué API ofrece SAP para eso, cómo se accede y qué hace falta para conectar tu canal.
Qué es SAP Business One
SAP Business One es el ERP de SAP para pequeñas y medianas empresas. Según la página del producto en sap.com, lo usan más de 85.000 clientes en el mundo, sobre todo en distribución mayorista, manufactura liviana, retail y servicios profesionales. Se puede usar en la nube o instalado en servidores propios.
En una nota de diciembre de 2025, SAP indica que el producto tiene el apoyo de una red global de 850 partners, 28 idiomas y 50 localizaciones. Lo habitual es que tu SAP Business One lo haya implementado un partner, que también administra el servidor y las licencias.
Hay dos versiones según la base de datos: Microsoft SQL Server y SAP HANA. La diferencia importa en instalaciones antiguas, como verás más abajo.
Las APIs de SAP Business One
SAP ofrece varias interfaces para que otros sistemas lean y escriban en el ERP. La guía oficial del Service Layer las compara así:
| Interfaz | Tecnología | Para qué sirve |
|---|---|---|
| Service Layer | HTTP, OData v3 y v4, JSON | Integraciones web y aplicaciones en cualquier lenguaje |
| DI API | COM de Microsoft | Add-ons que corren en Windows |
| DI Server | SOAP | Integraciones por web services en arquitecturas antiguas |
| Integration Framework (B1if) | Paquetes de integración | Escenarios que SAP entrega para terceros y dispositivos móviles |
Fuente: Working with SAP Business One Service Layer y SAP Business One Administrator’s Guide, SAP Help Portal.
Las tres primeras se construyen sobre el mismo núcleo, llamado DI Core. Por eso los objetos y sus propiedades tienen la misma definición en el Service Layer y en la DI API.
Para una integración nueva con una tienda online, la opción natural es el Service Layer. La DI API es una librería COM que se instala junto al cliente de SAP Business One; la verás en instalaciones antiguas y en add-ons para Windows.
El Integration Framework es un componente de servidor. Según la guía de administración, sus paquetes incluyen la solución móvil, DATEV HR (solo Alemania), facturación electrónica (solo México), aprobación de documentos (solo Portugal) y la conexión con SAP Customer Checkout. En esa lista no aparece ningún paquete para tiendas online ni marketplaces.
El Service Layer: la API REST de SAP Business One
El Service Layer es un servidor de aplicaciones construido sobre Apache. Expone los objetos de negocio de SAP Business One por HTTP, siguiendo el protocolo OData. Envía y recibe JSON; el formato XML no está soportado en las operaciones normales de crear, leer, modificar y borrar.
Datos generales que publica SAP:
- Usa HTTPS por defecto.
- La URL base tiene la forma
https://<servidor>:<puerto>/b1s/v1para OData v3 y/b1s/v2para OData v4. En los ejemplos de SAP el puerto es 50000. - Usa GET, POST, PATCH, PUT y DELETE. SAP recomienda PATCH para modificar, porque solo cambia los campos que envías.
- Admite filtros, ordenamiento, selección de campos y paginación con las opciones estándar de OData (
$filter,$select,$orderby,$top). - La página por defecto trae 20 registros. Se cambia con el encabezado
Prefer: odata.maxpagesizeo en la configuración del servidor. - Permite enviar varias operaciones en una sola llamada con batch.
Disponibilidad según la base de datos
El historial de la guía oficial muestra cómo llegó a cada versión:
| Versión de SAP Business One | Service Layer |
|---|---|
| Versión para SAP HANA | Disponible desde la primera versión del Service Layer, en 2014 |
| Versión para Microsoft SQL Server | Disponible desde SAP Business One 10.0 PL01 |
| 10.0 FP 2011 | Consultas SQL a través del Service Layer, en SQL Server y en HANA |
| 10.0 FP 2602 | Webhooks |
Fuente: Working with SAP Business One Service Layer, versión 1.29 del documento, SAP Help Portal.
La consecuencia práctica: si tu empresa tiene SAP Business One sobre SQL Server en una versión 9.x, no tienes Service Layer. Ahí la integración pasa por la DI API o por actualizar a la versión 10.0.
Login y sesión
Antes de cualquier operación hay que iniciar sesión con un POST a /Login, enviando la base de datos de la empresa, el usuario y la contraseña de SAP Business One. Este es el ejemplo de la guía oficial:
{"CompanyDB": "US506", "UserName": "manager", "Password": "1234"}La respuesta trae una cookie B1SESSION que debe ir en cada llamada posterior, y una cookie ROUTEID para el balanceo de carga. Desde la versión 10.0 FP 2305 también se puede iniciar sesión con un usuario de dominio de Windows.
La sesión expira tras 30 minutos sin actividad por defecto, un valor configurable en el servidor. Cuando expira, el Service Layer responde 401 con el mensaje “Invalid session or session already timeout” y hay que volver a iniciar sesión. SAP advierte que el login es una operación pesada, así que una integración bien hecha reutiliza la sesión en lugar de abrir una por llamada.
Webhooks
Desde la versión 10.0 FP 2602, el Service Layer puede avisar a un sistema externo cuando se crea, modifica o borra un objeto, por ejemplo un pedido o un socio de negocio. Vienen desactivados por defecto en cada empresa y requieren instalar un servicio adicional, el Webhook Messenger Service.
En versiones anteriores no hay avisos: para enterarte de un cambio de stock hay que consultar la API cada cierto tiempo.
Limitaciones que conviene conocer
La guía oficial lista algunas diferencias con la DI API:
- No hay transacciones entre llamadas. Cada llamada, o cada batch, es una transacción por sí sola.
- Un campo o tabla de usuario recién creado no queda accesible hasta reiniciar el Service Layer.
Qué objetos importan para una tienda online
La referencia de la API del Service Layer publica la lista completa de entidades. Estas son las que usa una integración típica con comercio electrónico:
| Entidad | Qué representa |
|---|---|
Items |
Artículos. Incluye sus precios por lista (ItemPrices) y su información por bodega (ItemWarehouseInfoCollection) |
Warehouses |
Bodegas del módulo de inventario |
PriceLists |
Listas de precios. Un artículo puede tener un precio distinto en cada lista |
SpecialPrices |
Descuentos para un artículo en una lista de precios, para un socio de negocio o para todos |
BusinessPartners |
Socios de negocio: clientes, proveedores y leads |
Orders |
Pedidos de venta |
DeliveryNotes |
Entregas |
Invoices |
Facturas de clientes |
IncomingPayments |
Pagos recibidos |
Returns y CreditNotes |
Devoluciones y notas de crédito |
Fuente: Service Layer API Reference y Working with SAP Business One Service Layer, SAP Help Portal.
Con esto se cubre el flujo completo: leer artículos, stock y precios para publicarlos, y crear cliente, pedido y factura cuando entra una venta. Las listas de precios y los precios especiales por socio son útiles si vendes a empresas con condiciones distintas, como explicamos en precios por cliente en un ecommerce B2B.
Cómo se obtiene acceso y cuánto cuesta
No hay una API key que se pida a SAP. El Service Layer es un componente que se instala en el servidor de SAP Business One, y el acceso se hace con un usuario de la propia empresa. En la práctica, lo habilita tu partner: instala o configura el Service Layer, abre el puerto hacia donde corre la integración y crea el usuario con los permisos necesarios.
SAP no publica precios de SAP Business One ni del uso de sus APIs. La página del producto remite a pedir una cotización. Qué licencia necesita el usuario que usa la integración es algo que tienes que confirmar con tu partner antes de partir, porque puede afectar el costo del proyecto.
SAP Business One en Chile
SAP Business One tiene localización para Chile. Las notas de versión de SAP mencionan funciones propias del país, como el campo RUT, la numeración de folios en los documentos de venta y retenciones de impuestos en facturas de proveedores. El cliente web también soporta la localización chilena.
En la documentación oficial de SAP que revisamos no encontramos la emisión de documentos tributarios electrónicos ante el SII como función estándar para Chile. Pregúntale a tu partner qué solución usa tu empresa para los DTE: una integración que crea facturas desde la tienda tiene que pasar por ese mismo camino.
Qué hace falta para conectar tu tienda o marketplace con SAP Business One
SAP Business One no incluye una conexión con tiendas ni marketplaces. Para Shopify, WooCommerce y Magento existe un conector empaquetado, el Integration Hub: nació en SAP, corre sobre el Integration Framework y hoy lo vende por suscripción Walldorf Integration Solutions a través de los partners. Para Mercado Libre y los demás marketplaces no hay nada equivalente. Tienes tres caminos.
Un desarrollo de tu partner. Conoce tu instalación y tus personalizaciones, lo que reduce el riesgo. A cambio, cada canal nuevo suele ser un proyecto aparte.
Un desarrollo propio sobre el Service Layer. Necesitas un programador con experiencia en OData y acceso al servidor. Antes de partir, define cinco cosas:
- Qué versión y qué base de datos tienes. Sin Service Layer, el proyecto cambia por completo.
- Qué código de artículo usas en cada canal y que sea el mismo en SAP y en la tienda.
- De qué bodega o bodegas sale el stock que publicas, y si descuentas lo comprometido en otros pedidos.
- Qué lista de precios usa cada canal.
- Qué documento crea una venta en SAP (pedido, entrega o factura), cómo se emite el DTE y qué pasa con las cancelaciones.
Un integrador. Un servicio que ya resolvió la conexión con el Service Layer y con cada canal. Es lo habitual si vendes en varios marketplaces a la vez. En sobreventa de stock multicanal explicamos por qué la sincronización tiene que salir del ERP y no de cada canal por separado.
Si vienes de otro ERP, el patrón es el mismo que describimos en API Softland: conecta tu ERP con WooCommerce: el ERP es la fuente de verdad y cada canal lee de ahí.
ERPSync con SAP Business One
ERPSync conecta el ERP con tiendas y marketplaces: WooCommerce, Shopify, VTEX, Magento, PrestaShop, Jumpseller, Mercado Libre, Falabella, Ripley, Paris y Walmart. Nuestra especialidad es Softland, y también trabajamos con SAP Business One previa revisión técnica de tu caso, usando el Service Layer.
Cuesta 0,80 UF al mes por integración, sin límite de pedidos. Puede haber un costo inicial, que cotizamos después de revisar tu caso. Hay prueba de 14 días. El detalle está en precios.
Preguntas frecuentes
¿SAP Business One tiene API?
Sí. La principal es el Service Layer, una API REST basada en OData que envía y recibe JSON. También existe la DI API, una interfaz COM para Windows.
¿Qué es el Service Layer de SAP B1?
Es el servidor que expone los objetos de SAP Business One por HTTP y OData, con la misma definición de objetos que la DI API.
¿El Service Layer funciona con SQL Server?
Sí, desde SAP Business One 10.0 PL01. En la versión para SAP HANA existe desde 2014. Si tienes SQL Server en una versión anterior a la 10.0, no tienes Service Layer.
¿Cuánto cuesta la API de SAP Business One?
SAP no publica precios. La licencia que necesita el usuario de la integración la confirmas con tu partner.
¿SAP Business One avisa cuando cambia el stock o entra un pedido?
Desde la versión 10.0 FP 2602, el Service Layer tiene webhooks que avisan cuando se crea, modifica o borra un objeto. En versiones anteriores hay que consultar la API periódicamente.
¿SAP Business One se conecta con Mercado Libre o Shopify?
Con Mercado Libre, no con una conexión propia: necesitas un desarrollo sobre el Service Layer o un integrador. Para Shopify existe el Integration Hub, un conector empaquetado que se contrata aparte a través de un partner. Si tu canal principal es Mercado Libre, revisa también cómo vender en Mercado Libre Chile con tu ERP.
Fuentes
Consultadas el 8 de noviembre de 2026.
- SAP Business One, página del producto en sap.com
- Global success of SAP Business One, SAP News Center
- Working with SAP Business One Service Layer, SAP Help Portal
- Service Layer API Reference, SAP Help Portal
- SAP Business One Administrator’s Guide, versión para Microsoft SQL Server, SAP Help Portal
- What’s New in SAP Business One 10.0, SAP Help Portal
- Integration Hub, Walldorf Integration Solutions
Escrito por el equipo de ERPSync, especialistas en integraciones con Softland. Quiénes somos
