Conector Sage 50 SQL Server: Arquitectura, Tablas y Pedidos Web

Sage 50 España (evolución sobre motor Microsoft SQL Server de la histórica línea Eurowin / Sage Murano) almacena toda su operativa mercantil, contable y logística en bases de datos relacionales alojadas en el servidor local de la empresa. El Conector Sage 50 de Bentian ERP Bridge se ejecuta como un servicio nativo en Windows y opera directamente contra dicha instancia SQL Server sin exponer puertos TCP a Internet ni depender de conectores cloud intermedios.

Selector Polimórfico Multi-ERP con perfil nativo para Sage 50 SQL Server y Modo Evaluación Sandbox SqlServerBaseAdapter · Local-First

1. Instancia SQL Server y Base de Datos del Ejercicio Activo

En una instalación estándar de Sage 50, el motor de base de datos se despliega bajo una instancia dedicada de SQL Server (habitualmente localhost\SAGE50, .\SQLEXPRESS o el nombre del servidor de dominio en red local). A diferencia de otros ERPs monolíticos, Sage 50 organiza la información separando la base de datos común de grupo y las bases de datos anuales de cada ejercicio fiscal:

Cuando la empresa realiza la apertura del nuevo año contable en Sage 50, basta con actualizar el identificador de base de datos en la interfaz local del Agente (http://127.0.0.1:39281) para continuar sincronizando sobre el nuevo ejercicio manteniendo intactas las reglas de negocio, almacenes y series.

2. Mapeo Relacional de Tablas en Sage 50

El adaptador Sage50Adapter traduce entre el modelo canónico de Bentian y las tablas físicas del esquema dbo de Sage 50. A continuación se detalla la correspondencia exacta de entidades y columnas:

3. Lecturas No Bloqueantes WITH (NOLOCK) y Dirty-Checking Criptográfico

Uno de los problemas más graves en integraciones de terceros con Sage 50 ocurre cuando un conector externo lanza consultas pesadas de lectura sobre dbo.articulo y dbo.stocks sin especificar nivel de aislamiento, provocando bloqueos compartidos (Shared Locks) que congelan la pantalla de los operarios de facturación o almacén.

Bentian erradica este cuello de botella combinando dos técnicas de ingeniería:

• • Hints explícitos WITH (NOLOCK) / READ UNCOMMITTED: Todas las consultas de catálogo y stock se ejecutan sin adquirir cerrojos de lectura en SQL Server, completándose en menos de 25 milisegundos incluso en catálogos de más de 25.000 referencias.
• • Motor Dirty-Checking SHA-256 en RAM: El Agente calcula una huella criptográfica por cada tupla (SKU, StockDisponible, PrecioTarifa, TipoIVA). En cada ciclo de sincronización solo se envían hacia WooCommerce, PrestaShop o Shopify los artículos que realmente han sufrido una variación en SQL Server, reduciendo en un 98% las llamadas HTTP salientes.

4. Inyección Transaccional en c_pediven y d_pediven y Cuadre Fiscal

Cuando entra un pedido pagado desde la tienda online, el conector abre una transacción ACID en SQL Server para garantizar que nunca quede una cabecera en c_pediven huérfana de líneas en d_pediven:

1. Control de Idempotencia: Se verifica que el identificador externo del pedido web (ej. WOO-48291) no haya sido registrado previamente en la serie asignada (LETRA).
2. Resolución de Cliente: Se busca el NIF/CIF normalizado en dbo.clientes. Si existe y tiene activada la marca de Recargo de Equivalencia, el motor fiscal aplica automáticamente los tipos vigentes (5,2% para IVA 21%, 1,4% para IVA 10% y 0,5% para IVA 4%).
3. Numeración Correlativa Segura: Se bloquea brevemente el contador de la serie (LETRA = 'W' o la serie configurada) para obtener MAX(NUMERO) + 1 sin colisionar con pedidos creados manualmente en oficina.
4. Escritura de Cabecera y Líneas: Se insertan los registros en c_pediven y d_pediven cuadrando al céntimo la base imponible y el total cobrado por Stripe, Redsys o PayPal, y se compromete el stock reservado en dbo.stocks.

5. Configuración JSON en AppData y Modo Evaluación Sandbox

La configuración de Sage 50 se persiste de forma atómica en %APPDATA%\Bentian Agent\agent-config.json. Además, si deseas probar la integración antes de conectar con el servidor SQL de producción, puedes activar "sandboxMode": true para que el Agente levante un entorno simulado de Sage 50 en memoria:

{
  "erpType": "sage50",
  "evaluationMode": { "enabled": false, "simulatedErp": "sage50" },
  "softwareErp": {
    "activeProvider": "sage50",
    "provisioned": true,
    "providers": {
      "sage50": {
        "serverInstance": ".\\SAGE50",
        "databaseName": "GESTION",
        "authMode": "windows",
        "orderSeries": "1",
        "warehouseCode": "01",
        "tariffCode": "1",
        "evaluationMode": false
      }
    }
  }
}