Bentian Bentian | Documentación
Descargar v0.5.3
SQL Server · a3ERP · 9 min de lectura · Actualizado v0.5.3

Conector a3ERP Wolters Kluwer: Integración SQL Server y Pedidos

Manual de ingeniería para sincronizar Wolters Kluwer a3ERP (tablas ARTICULO, STOCKALM, CABEPEV y LINEPEV en SQL Server) con WooCommerce, PrestaShop y Shopify sin bloqueos.

Wolters Kluwer a3ERP es una solución integral de planificación de recursos empresariales ampliamente implantada en pymes industriales, distribuidoras mayoristas y empresas de servicios en España. Su arquitectura se apoya íntegramente en Microsoft SQL Server. El Conector a3ERP de Bentian ERP Bridge proporciona una integración directa, local-first y preconfigurada sobre las tablas maestras de a3ERP, eliminando la necesidad de costosos proyectos de consultoría a medida.

Configuración de Wolters Kluwer a3ERP en Bentian ERP Bridge
Selección del perfil Wolters Kluwer a3ERP y validación de instancia SQL Server en el Agente Windows CABEPEV · LINEPEV · STOCKALM

1. Conexión Local con el Servidor SQL Server de a3ERP

El Agente de Bentian se despliega dentro de la red corporativa (en el propio Windows Server donde reside la instancia SQL de a3ERP o en un equipo de operaciones conectado por LAN) y se comunica mediante el proveedor nativo ADO / SQL Server de Windows:

Parámetros habituales de instancia SQL en a3ERP:
SERVIDOR_A3\A3ERP o SERVIDOR_SQL (Instancia predeterminada MSSQLSERVER)
Seguridad y Aislamiento de Red:
• 0 puertos abiertos en el firewall perimetral: no se expone el puerto 1433 a Internet.
• Soporte para cuenta de servicio SQL con permisos acotados exclusivamente a la base de datos de la empresa.

2. Esquema de Tablas Maestras: ARTICULO, STOCKALM, CABEPEV y LINEPEV

El adaptador A3ErpAdapter interactúa con las tablas relacionales estándar de Wolters Kluwer a3ERP aplicando lecturas no bloqueantes WITH (NOLOCK) y escrituras parametrizadas:

Tabla SQL a3ERP Columnas Principales Mapeadas Función en Bentian ERP Bridge
dbo.ARTICULO CODART, DESCART, FAMILIA, PRCVENTA, TIPIVA, BLOQUEADO, OBVIARWEB Extracción del catálogo maestro de artículos activos (BLOQUEADO = 'F'), tipos de IVA y precios base de venta.
dbo.STOCKALM CODART, CODALM, UNIDADES, RESERVADO, PENDIENTE Cálculo de existencias disponibles por almacén (CODALM), restando unidades reservadas en pedidos en curso.
dbo.CLIENTES CODCLI, NOMCLI, NIFCLI, DIRCLI, CODPOSTAL, POBCLI, EMAIL, RECARGO Búsqueda de clientes por NIF/CIF o email y creación automática de fichas de nuevos compradores B2C/B2B.
dbo.CABEPEV IDPEDV, SERIE, NUMDOC, FECHA, CODCLI, CODALM, TOTBRUTO, TOTIVA, TOTDOC, REFERENCIA Inserción atómica de la cabecera del pedido de venta con su serie dedicada y referencia externa para garantizar idempotencia.
dbo.LINEPEV IDPEDV, NUMLIN, CODART, DESCLIN, UNIDADES, PRECIO, DESC1, TIPIVA, RECARGO Registro detallado de cada línea de producto vendida, gastos de envío, descuentos comerciales e impuestos aplicables.

3. Gestión Multialmacén (CODALM) y Tarifas B2B / B2C

En entornos industriales y de distribución con a3ERP es habitual disponer de múltiples almacenes lógicos o físicos (almacén central de expediciones, almacén de materia prima, delegaciones comerciales o depósito de defectuosos). Desde la configuración del Agente puedes especificar exactamente qué CODALM alimenta el stock de tu tienda online para evitar publicar inventario no vendible.

Asimismo, el motor fiscal de Bentian traduce los códigos de impuesto de a3ERP (TIPIVA) a los porcentajes impositivos vigentes (21%, 10%, 4% o exento) y soporta clientes profesionales acogidos a Recargo de Equivalencia, asegurando que el importe total en CABEPEV coincida al céntimo con el cobro de la pasarela de pago web.

4. Ingesta Transaccional de Pedidos y Cola Store-and-Forward

La creación de pedidos en dbo.CABEPEV y dbo.LINEPEV se ejecuta dentro de una transacción SQL atómica. Si durante la madrugada el servidor de SQL Server entra en ventana de mantenimiento o copia de seguridad, la cola persistente Store-and-Forward de Bentian conserva los pedidos entrantes en disco local (%APPDATA%) con escritura JSON atómica y los inyecta en a3ERP en cuanto la base de datos vuelve a aceptar conexiones.

5. Configuración JSON en el Agente y Modo Evaluación Sandbox

A continuación se muestra un ejemplo de perfil técnico de a3ERP en agent-config.json. Recuerda que puedes activar el Modo Evaluación Sandbox desde la interfaz gráfica para realizar pruebas completas de extremo a extremo antes de conectar con tu servidor SQL corporativo:

{
  "erpType": "a3erp",
  "evaluationMode": { "enabled": false, "simulatedErp": "a3erp" },
  "softwareErp": {
    "activeProvider": "a3erp",
    "provisioned": true,
    "providers": {
      "a3erp": {
        "serverInstance": ".\\SQLEXPRESS",
        "databaseName": "A3ERP",
        "authMode": "windows",
        "orderSeries": "W",
        "warehouseCode": "GEN",
        "tariffCode": "1",
        "evaluationMode": false
      }
    }
  }
}
Conector Oficial Wolters Kluwer a3ERP

Consulta las licencias anuales (199 €/año) y el servicio de implantación asistida Llave en Mano.

¿Tienes dudas sobre la configuración en tu empresa?

Nuestro equipo de ingeniería te asiste con tu base de datos Factusol, SimplyGest, SQL Server o red local.

Contactar con Soporte