Conector SAP Business One

El conector SAP Business One lee datos maestros y documentos transaccionales directamente desde la base de datos de SAP B1. También escribe cotizaciones y pedidos de ventas de vuelta en SAP B1 a través de la API REST de SAP Service Layer. Dado que la extracción usa la capa de base de datos y la escritura de vuelta usa un endpoint REST separado, ambos lados requieren sus propias credenciales y pueden probarse de forma independiente.

Cuándo usar este conector

Sincronizar catálogos de artículos, socios de negocio, listas de precios y datos de referencia desde SAP B1 hacia EZY Portal.
Enviar datos de productos desde SAP B1 a una tienda de comercio electrónico como Shopify.
Extraer cotizaciones o pedidos de SAP B1 para procesamiento posterior.
Escribir cotizaciones o pedidos generados en Portal de vuelta en SAP B1 como documentos confirmados.
Alimentar datos maestros de SAP B1 hacia cualquier destino compatible con EZY Integrations (Archivo Plano, API Genérica, entre otros).

Tipos de entidad compatibles

Tipo de entidad	Dirección	Notas
Artículo	Origen	Datos maestros de artículos incluyendo precios, niveles de stock, imágenes y adjuntos.
Socio de Negocio	Origen	Clientes y proveedores.
Grupo de Socios de Negocio	Origen	Datos de referencia de grupos de socios de negocio.
Condiciones de Pago	Origen	Datos de referencia de condiciones de pago.
Grupo de Artículos	Origen	Datos de referencia de grupos de artículos.
Lista de Precios	Origen	Listas de precios nombradas con lista base y factor opcionales.
Almacén	Origen	Datos de referencia de almacenes.
Grupo de Impuestos	Origen	Datos de referencia de categoría de impuesto / grupo de impuesto.
Grupo de Unidades de Medida	Origen	Grupo de unidades de medida y sus unidades miembro.
Período Fiscal	Origen	Definiciones de períodos contables.
Cotización de Ventas	Origen + Destino	Extrae cotizaciones de SAP B1; escribe cotizaciones originadas en Portal de vuelta vía Service Layer.
Pedido de Ventas	Origen + Destino	Extrae pedidos de SAP B1; escribe pedidos originados en Portal de vuelta vía Service Layer.

Los tipos de entidad de datos maestros (Artículo hasta Período Fiscal) se extraen desde la base de datos. La escritura de vuelta solo está disponible para Cotización de Ventas y Pedido de Ventas, y requiere que la sección Service Layer esté configurada.

Requisitos previos

Antes de crear un perfil de conexión para SAP Business One, confirme que:

El servidor de EZY Integrations puede comunicarse con el host SQL Server de SAP B1 en el puerto de base de datos (1433 por defecto).
Existe un usuario de base de datos con acceso de lectura a la base de datos de empresa de SAP B1. Se requiere como mínimo el permiso SELECT sobre todas las tablas de SAP B1 que referencien sus configuraciones de mapeo.
Solo para escritura de vuelta: Hay una instancia de SAP Service Layer en ejecución y accesible desde el servidor de EZY Integrations. Debe haber disponible un usuario de Service Layer con permiso para crear y actualizar documentos de ventas.
Solo para sincronización de imágenes o adjuntos: Un recurso compartido de red que contiene imágenes de artículos o adjuntos de documentos de SAP B1 es accesible, y hay credenciales de red disponibles si el recurso compartido requiere autenticación.
Un operador con acceso de DBA ha habilitado opcionalmente SQL Server Change Tracking en la base de datos de SAP B1. Consulte Change Tracking y el modelo de extracción para más detalles.

Campos del perfil de conexión

El perfil de conexión de SAP Business One tiene tres secciones independientes. Cada sección tiene su propio botón de Probar Conexión.

Conexión (requerida para todos los tipos de entidad)

Campo	Tipo	Requerido	Descripción	Ejemplo
Host	Texto	Sí	Nombre de host o dirección IP del SQL Server. Incluya un puerto personalizado usando la notación `host:puerto` si no usa el valor predeterminado.	`192.168.1.100` o `dbserver:1433`
Base de Datos	Texto	Sí	Nombre de la base de datos de empresa de SAP B1.	`SBODemoUS`
Usuario	Texto	Sí	Nombre de usuario de inicio de sesión de SQL Server.	`sa`
Contraseña	Contraseña	Sí	Contraseña de inicio de sesión de SQL Server.	—

Service Layer (requerida para escritura de vuelta)

Campo	Tipo	Requerido	Descripción	Ejemplo
URL de Service Layer	URL	No	URL base de la instancia de SAP Service Layer. Solo se requiere si se usa escritura de vuelta.	`https://<servidor>:50000/b1s/v1`
Base de Datos de la Empresa	Texto	No	Nombre de la base de datos de empresa tal como lo reconoce el Service Layer. Generalmente es el mismo nombre de la base de datos SQL.	`SBODemoUS`
Usuario SL	Texto	No	Nombre de usuario de inicio de sesión del Service Layer.	`manager`
Contraseña SL	Contraseña	No	Contraseña de inicio de sesión del Service Layer.	—
Omitir verificación de certificado TLS	Casilla	No	Deshabilita la validación TLS para el endpoint del Service Layer. No se recomienda en entornos de producción.	Sin marcar

Rutas de Archivos (requerida para sincronización de imágenes o adjuntos)

Campo	Tipo	Requerido	Descripción	Ejemplo
Usuario de Red	Texto	No	Usuario para autenticarse en el recurso compartido de red. Déjelo vacío si el recurso es de acceso público o si la cuenta del servidor de EZY Integrations ya tiene acceso.	`DOMINIO\svc-integracion`
Contraseña de Red	Contraseña	No	Contraseña del usuario de red.	—
Ruta de Imágenes	Texto	No	Ruta al directorio donde se almacenan las imágenes de artículos de SAP B1.	`smb://servidor/recurso/imagenes`
Ruta de Adjuntos	Texto	No	Ruta al directorio donde se almacenan los adjuntos de documentos de SAP B1.	`smb://servidor/recurso/adjuntos`

Tres acciones de Probar Conexión independientes

El formulario de SAP Business One tiene cuatro botones de Probar Conexión — uno por sección (Conexión, Service Layer, Ruta de Imágenes, Ruta de Adjuntos). Cada prueba es independiente y verifica únicamente esa sección.

Prueba	Qué verifica
Probar Conexión (sección Conexión)	Establece una conexión SQL al host de la base de datos usando el Host, Base de Datos, Usuario y Contraseña indicados. Un resultado exitoso confirma que la integración puede consultar datos de SAP B1.
Probar Conexión (sección Service Layer)	Envía una solicitud de inicio de sesión a la URL del Service Layer usando la Base de Datos de la Empresa, Usuario SL y Contraseña SL. Un resultado exitoso confirma que la escritura de vuelta está disponible.
Probar Conexión (sección Ruta de Imágenes)	Intenta acceder a la Ruta de Imágenes usando el Usuario de Red y la Contraseña de Red. Un resultado exitoso confirma que las imágenes de artículos pueden leerse.
Probar Conexión (sección Ruta de Adjuntos)	Intenta acceder a la Ruta de Adjuntos usando las mismas credenciales de red. Un resultado exitoso confirma que los adjuntos de documentos pueden leerse.

Ejecute cada prueba de forma independiente después de completar esa sección. No es necesario configurar las secciones Service Layer ni Rutas de Archivos si solo necesita extraer datos maestros.

Change Tracking y el modelo de extracción

EZY Integrations lee datos de SAP B1 mediante consultas directas a la base de datos, definidas por el bloque de extracción en su configuración de mapeo. Puede configurar qué columnas recuperar, aplicar filtros y unir tablas relacionadas, todo sin escribir SQL manual.

Sincronización incremental

Por defecto, cada ejecución de extracción lee únicamente los registros que cambiaron desde la ejecución anterior. El sistema rastrea un cursor — un valor (comúnmente una fecha de última modificación o un número de versión) almacenado al final de cada ejecución exitosa. La siguiente ejecución comienza consultando solo los registros más recientes que ese cursor.

Para que la sincronización incremental funcione con un tipo de entidad dado, la tabla origen debe exponer un indicador de cambio confiable. SAP B1 soporta dos modelos:

Columna UpdateDate: Muchas tablas de SAP B1 incluyen una columna UpdateDate. El cursor de extracción avanza hasta la fecha más reciente vista en cada ejecución. Las tablas sin columna UpdateDate deben usar un escaneo completo (el cursor no avanza).
SQL Server Change Tracking: Cuando un DBA habilita SQL Server Change Tracking a nivel de base de datos y de tabla, el extractor puede usar sincronización incremental basada en versiones. Esto es más confiable que UpdateDate porque captura eliminaciones además de inserciones y actualizaciones.

Su DBA de SAP B1 debe habilitar Change Tracking antes de que pueda usarse la sincronización incremental basada en versiones. Los pasos son:

Habilitar Change Tracking a nivel de base de datos, especificando una ventana de retención (se recomiendan 7 días para cubrir sincronizaciones perdidas durante una semana laboral completa).
Habilitar Change Tracking en cada tabla de SAP B1 que desee sincronizar de forma incremental.
Después de habilitar Change Tracking, la primera ejecución de sincronización captura una instantánea de versión inicial. Las ejecuciones posteriores usan extracción incremental.

Si el cursor de sincronización almacenado cae fuera de la ventana de retención de Change Tracking (por ejemplo, tras una interrupción prolongada), la integración retrocede automáticamente a una extracción completa para esa ejecución y luego reanuda la sincronización incremental desde la nueva versión.

Retroceso a escaneo completo

Cualquier tipo de entidad cuya tabla origen no tenga una columna de cursor compatible, o cuya configuración de mapeo no declare una columna de cursor, siempre realiza un escaneo completo. Los escaneos completos leen la tabla entera en cada ejecución y son adecuados para tablas de referencia pequeñas que cambian con poca frecuencia.

Limitaciones y peculiaridades conocidas

Sin extracción vía Service Layer. Todos los datos se leen mediante acceso SQL directo. El Service Layer solo se usa para escritura de vuelta. Esto significa que las credenciales SQL son necesarias incluso cuando la intención es solo escritura de vuelta; se usan para verificar la conectividad y consultar registros fuente.
Las credenciales de red se comparten entre ambas rutas de archivos. El mismo Usuario de Red y Contraseña de Red aplican tanto para la Ruta de Imágenes como para la Ruta de Adjuntos. Si sus recursos compartidos de imágenes y adjuntos requieren credenciales diferentes, contacte a su administrador para consolidar el acceso bajo una sola cuenta.
El tipo de entidad order se enruta a SAP B1. Cuando una configuración de mapeo apunta a SAP B1 con el tipo de entidad order (proveniente de una fuente de comercio electrónico), el handler de escritura de vuelta lo trata igual que salesorder. Esto permite crear pedidos de e-commerce directamente en SAP B1 sin un paso de remapeo.
Notación de puerto en el host. Si su SQL Server escucha en un puerto no predeterminado, ingrese el host como hostname:puerto (por ejemplo, dbserver:49123). El conector convierte automáticamente esto al formato de coma separada de SQL Server (dbserver,49123) de forma interna.
TLS siempre está habilitado para la conexión SQL. La conexión a SQL Server usa transporte cifrado con TrustServerCertificate = true. No hay opción para deshabilitar TLS de SQL Server desde la interfaz.

Relacionados

Credenciales y Secretos — Cómo se almacenan y protegen las credenciales de los perfiles de conexión.
Configuración de Mapeo — Cómo configurar las reglas de extracción, normalización y transformación para los tipos de entidad de SAP B1.
Historial de Ejecuciones — Cómo activar una sincronización manual y monitorear los resultados de las ejecuciones.
Todos los Conectores — Compare SAP Business One con otros conectores disponibles.