API REST Local de Bentian Agent (Puerto 39281)

El agente de Bentian ejecuta un servidor HTTP ligero interno que escucha exclusivamente en la dirección loopback http://127.0.0.1:39281. Esta interfaz permite interactuar con el motor de sincronización de forma programática desde scripts de PowerShell, sistemas de monitorización locales (Zabbix, Nagios) o desde la propia interfaz de usuario.

1. Arquitectura de la API Local

Por seguridad estricta, la API local solo acepta conexiones originadas desde la propia máquina (127.0.0.1 o localhost). Cualquier intento de conexión desde otra IP de la red local o desde Internet es rechazado inmediatamente.

2. GET /api/local/status (Telemetría y Estado)

Devuelve el estado de salud en tiempo real de todos los subsistemas (conexión Factusol, tienda web, licencia y cola de pedidos):

GET http://127.0.0.1:39281/api/local/status

HTTP/1.1 200 OK
Content-Type: application/json

{
  "running": true,
  "version": "0.3.8",
  "uptimeSeconds": 1420,
  "factusol": {
    "connected": true,
    "configured": true,
    "dbPath": "C:\\Software DELSOL\\Factusol\\Datos\\FS\\0012026.accdb",
    "orderSeries": "1",
    "latencyMs": 18
  },
  "channel": {
    "type": "woocommerce",
    "connected": true,
    "storeUrl": "https://www.suministrosrubio.com"
  },
  "license": {
    "valid": true,
    "plan": "founder_annual",
    "daysRemaining": 348
  },
  "queue": {
    "pendingOrders": 0,
    "syncedToday": 14,
    "failed": 0
  }
}

3. POST /api/local/sync-now (Forzar Sincronización)

Fuerza la ejecución inmediata de una pasada de sincronización de stock y comprobación de nuevos pedidos en la tienda web sin esperar al temporizador automático:

POST http://127.0.0.1:39281/api/local/sync-now
Content-Type: application/json

{}

HTTP/1.1 200 OK
{
  "success": true,
  "message": "Sincronización manual completada en 245 ms."
}

4. POST /api/local/save-full-config

Guarda de forma atómica la configuración completa del sistema en %APPDATA%\Bentian Agent\agent-config.json y reinicializa los adaptadores de Factusol y canal de ventas en caliente sin necesidad de reiniciar el proceso.

5. POST /api/local/test-email

Envía un correo de prueba con firma criptográfica DKIM a la dirección indicada para verificar la correcta recepción de alertas transaccionales de nuevos pedidos.

Referencia de la API REST Local del Agente (39281)