Aprovisionamiento de hosting y sincronización con Plesk

Convierte los eventos de contrato en acciones de hosting

Cada vez que una línea de servicio de un contrato de Dolibarr cambia de estado, este módulo actúa: activar una línea de servicio crea la cuenta de hosting o el dominio en tu panel; cerrarla suspende el acceso; eliminarla elimina la cuenta. Tu flujo de facturación permanece en Dolibarr — el panel se mantiene sincronizado automáticamente.

Todas las acciones de aprovisionamiento son soft-fail: si el panel no está accesible o devuelve un error, el flujo de contrato en Dolibarr nunca se bloquea. Obtienes un error registrado, no un proceso de facturación congelado.

Arquitectura multipanel

La capa de adaptadores utiliza un patrón Registry/Factory para que las integraciones de paneles sean independientes e intercambiables. Adaptadores compatibles en la v1.0.0:

• Plesk (Obsidian REST v2) — probado en vivo en un sistema de producción
• cPanel / WHM — implementado; alinea las URL de los endpoints con tu versión de cPanel antes de la puesta en producción
• ISPConfig (Remote API) — implementado; verifica con tu versión de ISPConfig
• KeyHelp (REST v2) — implementado; verifica con tu versión de KeyHelp
• CloudPanel (puente clpctl) — implementado; verifica con tu versión de CloudPanel
• Webhook genérico — envía una solicitud HTTP firmada a cualquier panel o endpoint de automatización

Las API de los paneles dependen de la versión. El adaptador Plesk está verificado en producción. Todos los demás adaptadores están implementados de forma limpia y pueden requerir ajustes menores en los endpoints para tu versión específica de panel — no son plug-and-play para cada versión sin pruebas.

Sincronización del inventario de Plesk

Una página de administración integrada lee datos en vivo de tu servidor Plesk y los incorpora al contexto de Dolibarr:

• Lista todos los clientes, dominios, planes de servicio y suscripciones de Plesk
• Asocia los clientes de Plesk con los terceros existentes en Dolibarr por dirección de correo electrónico
• Importa un cliente de Plesk sin asociar como nuevo tercero de Dolibarr con un clic
• Muestra la correspondencia entre dominio y contrato para ver qué está aprovisionado y qué no

Qué incluye el módulo

• Campo adicional personalizado domain en las líneas de servicio del contrato — creado automáticamente al activar el módulo
• Almacenamiento cifrado de las credenciales de API de los paneles
• Botón "Probar conexión" por cada configuración de panel — verifica las credenciales antes de habilitar la automatización
• Interruptor de automatización — desactiva el aprovisionamiento de forma global sin tocar los flujos de contrato
• Compatibilidad con proxy de salida (forward proxy) para servidores Dolibarr sin salida directa a Internet
• 100 % autoalojado — ningún dato sale de tu servidor, sin dependencia de SaaS externo

Requisitos

• Dolibarr 18 – 23 (probado en vivo en 23.0.3)
• PHP 7.4 – 8.3
• Módulo de Contratos habilitado en Dolibarr
• Acceso de red desde el servidor Dolibarr a la API del panel de destino (o un proxy de salida configurado)

Licencia: GNU GPL v3