Quincefin ↔ OpenCart & Horoshop
Quincefin ↔ Shops Sync es un middleware de integración entre QUINCEFIN (contabilidad / inventario) y las tiendas online:
- OpenCart 2.3
- Horoshop
QUINCEFIN es el sistema principal para gestionar el stock y los precios. El middleware se sitúa entre los sistemas: recibe eventos, obtiene los datos completos de productos y pedidos y envía los cambios a las tiendas online (y también recupera los pedidos de las tiendas hacia QUINCEFIN).
El sistema existe porque:
- Los webhooks de QUINCEFIN solo envían un id y una marca de tiempo (timestamp): es necesario confirmar su recepción, volver a obtener los datos reales y distribuirlos entre las tiendas.
Las claves API están restringidas por dirección IP; las tiendas tienen límites de solicitudes.
- OpenCart 2.3 no dispone de una API integrada para gestionar el stock o los precios.
- Un único servicio con una IP fija, una cola y un sistema de correspondencia de productos/pedidos mantiene todos los datos sincronizados.
Qué hace el sistema
QUINCEFIN → tiendas
El stock y los precios minoristas se sincronizan con OpenCart (y, opcionalmente, con el catálogo de Horoshop). Los webhooks de productos se agrupan, de modo que una serie de cambios realizados rápidamente se convierte en una única actualización. Una reconciliación nocturna detecta cualquier dato que los webhooks hayan podido omitir.
### Tiendas → QUINCEFIN
Los pedidos nuevos y actualizados se descargan cada 5 minutos en QUINCEFIN como documentos de venta (`OC-…` para OpenCart, `HS-…` para Horoshop), con los datos del cliente en el comentario, los descuentos aplicados a las líneas y un nombre fijo para el socio minorista.
Las páginas de estado del operador (`/status`, registros de pedidos, live probes) muestran el estado de los canales, las ejecuciones recientes y los pedidos asociados sin utilizar el panel de administración de la tienda.
Plugin de OpenCart: Dimoks Sync
Dimoks Sync es una pequeña extensión para OpenCart 2.3 (tipo: Feed) instalada en la tienda OpenCart.
Es un módulo completo y visible en el panel de administración (Extensions → Feeds → Dimoks Sync), no simplemente un conjunto de archivos independientes. Proporciona una API JSON protegida mediante token a la que se conecta el middleware.
Configuración del administrador
- Activar / desactivar la integración
- Sync token (debe coincidir con `OPENCART_TOKEN` en el servicio middleware)
- Campo de clave del producto: `model` o `sku` (artículo / article utilizado para asociarlo con QUINCEFIN)
- Indicación del endpoint para la URL de ping
Qué proporciona la API del módulo
- Ping — comprobación del estado y de la versión
- Products — lectura y actualización de cantidad, precio y estado mediante la clave del artículo
- Orders — obtención de la lista de pedidos modificados desde una determinada marca de tiempo (para importarlos a QUINCEFIN)
- Optional order status push back to OpenCart — envío opcional del estado del pedido de vuelta a OpenCart
Sin este módulo, OpenCart 2.3 no puede gestionarse desde QUINCEFIN para actualizar el stock y los precios.
En una sola frase
El middleware mantiene sincronizados el stock y los precios de QUINCEFIN con OpenCart (mediante el plugin Dimoks Sync) y Horoshop, y también importa los pedidos de las tiendas online a QUINCEFIN como documentos `OC-…` / `HS-…`.