Bentian Bentian | Documentación
Descargar v0.5.3
SQL Express · Ágora POS · 8 min de lectura · Actualizado v0.5.3

Conector Ágora POS / Retail: Sincronización SQL Express en Tiempo Real

Documentación técnica para integrar terminales TPV Ágora Retail y Hostelería (SQL Server Express local) con WooCommerce, Shopify y PrestaShop con latencia delta inferior a 5 segundos.

Ágora POS / Retail es uno de los sistemas de punto de venta (TPV) más veloces y extendidos en el comercio minorista español (tiendas de moda, calzado, alimentación especializada, electrónica, deporte y franquicias). Su motor de persistencia descansa sobre una instancia local de Microsoft SQL Server Express alojada en el terminal principal de caja o servidor de backoffice. El Conector Ágora POS de Bentian ERP Bridge enlaza directamente con esa instancia local para sincronizar existencias y pedidos web en menos de 5 segundos.

Configuración de Ágora POS / Retail sobre SQL Server Express en Bentian ERP Bridge
Configuración del adaptador Ágora POS / Retail sobre .SQLEXPRESS en la interfaz local del Agente Delta Sync <5s · Sin Bloqueos TPV

1. Motor SQL Server Express en Terminales Ágora POS

En una topología típica de tienda con uno o varios terminales táctiles Ágora, uno de los equipos Windows actúa como nodo servidor ejecutando SQL Server Express. Bentian se instala en ese mismo equipo (o en cualquier ordenador de administración dentro de la misma subred LAN) y establece una conexión local persistente:

Instancias SQL Server por defecto en Ágora Retail:
localhost\SQLEXPRESS o localhost\AGORA
192.168.1.100\SQLEXPRESS (conexión desde PC de oficina al TPV maestro en LAN)
Protocolo y Latencia de Red Local:
Shared Memory / TCP Loopback con tiempo de respuesta < 10 ms por consulta diferencial

2. Mapeo de Tablas Product, PriceList y WarehouseStock

El adaptador AgoraPosAdapter inspecciona de forma no intrusiva las tablas relacionales de catálogo, tarifas e inventario de Ágora para construir el estado canónico de sincronización:

Entidad SQL Ágora Campos y Claves Relacionales Mapeo hacia WooCommerce / Shopify / PrestaShop
Product / SaleItem Id, Code, Barcodes, Name, FamilyId, VatId, IsForSale Emparejamiento por SKU (Code) o código de barras EAN-13, nombre comercial, categoría y tipo de IVA aplicable.
PriceList / PriceListItem PriceListId, SaleItemId, MainPrice, StandardPrice Sincronización del precio de venta al público de la tarifa asignada al canal online o tarifa general de mostrador.
Stock / WarehouseStock WarehouseId, ProductId, Quantity, MinStock Control de existencias reales del almacén vinculado (WarehouseId) tras cada venta de ticket o entrada de albarán.
CustomerOrder / Document Serie, Number, CustomerId, WarehouseId, GrossAmount, NetAmount, Lines Inyección de pedidos online con su referencia web, líneas de producto, impuestos y descuento automático de inventario.

3. Sincronización Delta (<5s) Anti-Sobreventas en Mostrador

En el comercio minorista físico, las roturas de stock suelen producirse los viernes por la tarde o sábados: un cliente presencial pasa por caja el último par de zapatillas o el último artículo de exposición con el lector de código de barras y, minutos después, un comprador online adquiere esa misma referencia porque el conector web tradicional solo sincroniza cada 30 o 60 minutos.

Bentian elimina este riesgo mediante un ciclo reactivo de baja latencia:

  • • Sondeo ligero con WITH (NOLOCK): Cada pocos segundos, el Agente consulta en memoria el vector de existencias de WarehouseStock sin bloquear jamás el hilo de cobro del TPV ni retrasar la apertura del cajón portamonedas.
  • • Propagación inmediata de deltas: En cuanto detecta que la cantidad de un SKU ha disminuido por una venta en mostrador, dispara únicamente la actualización de ese producto hacia la API de WooCommerce, Shopify o PrestaShop en menos de 5 segundos.
  • • Buffer de Stock de Vitrina: Puedes configurar safetyStockBuffer (ej. reservar 1 unidad) para que la tienda online marque el producto como agotado cuando solo quede la unidad expuesta en el escaparate físico.

4. Recepción de Pedidos Web y Click & Collect

Los pedidos confirmados en el eCommerce se descargan automáticamente y se registran en Ágora asociando el cliente web (o cliente genérico de tienda online según preferencia contable), las líneas con su tipo de IVA correspondiente y la referencia del pedido (WOO-... o SHOP-...). Si el terminal TPV se apaga por la noche al cerrar el comercio, la cola Store-and-Forward retiene las ventas nocturnas y las inyecta secuencialmente al encender el equipo por la mañana.

5. Perfil JSON y Modo Evaluación Sandbox para Distribuidores de TPV

Los distribuidores e instaladores oficiales de TPV Ágora disponen del Modo Evaluación Sandbox integrado en el Agente para realizar demostraciones comerciales en vivo ante sus clientes sin necesidad de conectarse a una caja en producción:

{
  "erpType": "agora",
  "evaluationMode": { "enabled": false, "simulatedErp": "agora" },
  "softwareErp": {
    "activeProvider": "agora",
    "provisioned": true,
    "providers": {
      "agora": {
        "serverInstance": ".\\SQLEXPRESS",
        "databaseName": "AgoraDB",
        "authMode": "windows",
        "warehouseCode": "1",
        "tariffCode": "1",
        "orderSeries": "W",
        "evaluationMode": false
      }
    }
  }
}
Conector Oficial Ágora POS / Retail

Descubre los planes para tiendas físicas, franquicias y partners instaladores de TPV.

¿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