Capa REST con caché sobre Multibase / Informix

Es la pieza menos visible y la que más usan las demás. Integraciones CGestion es la capa REST que se asienta sobre la base de datos del ERP y expone, en JSON moderno, los datos y operaciones que el resto del ecosistema necesita: tu web, tu PDA, tu portal B2B, tu integración con la AEAT.

Sin esta capa, cada nueva pieza tendría que hablar SQL-89 directamente con Informix. Es decir: cero seguridad, cero caché, cero rate-limit, cero trazabilidad y un cuello de botella sobre el ERP cada vez que un desarrollador despistado lance un SELECT *.

Por qué importa

Tres objetivos muy concretos:

1. Aislar Informix. El ERP factura. Que no sea él quien aguante 10 000 peticiones por minuto desde una web.
2. Hablar JSON con el mundo. Cualquier framework moderno consume JSON. Ningún framework moderno habla SQL-89 con gracia.
3. Auditoría. Cada operación contra el ERP queda registrada con quién, cuándo, qué pidió y qué se devolvió.

Funcionalidades clave

API REST

• Endpoints versionados (/v1/...) con contrato estable.
• Autenticación OAuth2, API keys o tokens firmados según el consumidor.
• Rate-limit configurable por endpoint y por cliente.
• Documentación OpenAPI generada automáticamente.

Caché

• Caché por Redis o database driver según infraestructura disponible.
• Invalidación por evento (cuando cambia el dato, no por reloj).
• Tiempos de respuesta típicos por debajo de 50 ms para lecturas cacheables.

Conectores listos

• PrestaShop / WooCommerce / Magento: catálogo, stock, pedidos, facturas, clientes.
• Bancos (CSB-19, CSB-43, SEPA): remesas, cobros, conciliación.
• AEAT: SII (Suministro Inmediato de Información) y Verifactu.
• Organismos pagadores agrarios: integración con expedientes PAC.

Webhooks y colas

Para procesos que no encajan en la sincronía petición-respuesta: un cobro bancario notifica vía webhook, el ETL nocturno corre como job en cola, las notificaciones de la AEAT entran asíncronas.

Stack y arquitectura

Consumidores externos
   (Web / Móvil / B2B / BI)
            │
            ▼  HTTPS · OAuth2 · JSON
   ┌──────────────────────────┐
   │   Capa REST GPInfor      │  Laravel · PHP 8.3
   │   Cache · Rate-limit     │  Redis o database
   │   Auditoría · Webhooks   │
   └─────────────┬────────────┘
                 ▼  ODBC · SQL-89
        CGestion (Informix / Multibase)

Despliegue

La capa REST se despliega como aplicación Laravel junto al servidor de CGestion (Linux, Ubuntu/Debian) o en contenedor separado. La conexión a Informix se hace por ODBC con el cliente oficial. Sin tocar la configuración del ERP. Sin esquemas espejo. Sin réplicas.