Portal contable seguro para dolibarr
Portal contable Ventas y compras Factur-X Invitaciones nominativas Exportación ZIP API segura Acceso autenticado Trazabilidad
Presentación
ComptaPortal es un módulo externo para Dolibarr ERP/CRM (editor KSIDol) que añade un extranet contable seguro.
Permite a una empresa dar a su asesoría contable un acceso estrictamente limitado a sus facturas de clientes y proveedores, sin abrir la interfaz interna de Dolibarr. El acceso está siempre autenticado: el contable dispone de una cuenta nominativa y de permisos explícitos (consulta, descarga, envío por correo electrónico, API).
El contable consulta, filtra, descarga, recibe por correo electrónico o recupera mediante la API las facturas validadas, sin manipular la interfaz interna de Dolibarr y sin acceder a otros datos que los autorizados.
Editor y soporte
| Elemento | Información |
|---|---|
| Editor | KSIDol |
| Especialidad | Integrador Dolibarr |
| Servicios | Desarrollo a medida, alojamiento SaaS, acompañamiento Dolibarr |
| Sitio web | https://www.ksidol.io |
| Soporte | support@ksidol.io |
| Módulos Dolistore | https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= |
Información del módulo
| Información | Detalle |
|---|---|
| Nombre del módulo | ComptaPortal |
| Uso principal | Extranet contable seguro: acceso controlado a facturas de ventas y compras |
| Tipo | Módulo externo de Dolibarr |
| Familia | Interfaz / Contabilidad |
| Versión documentada | 1.0.2 |
| Compatibilidad Dolibarr | Dolibarr 18.0 a 24.x |
| Compatibilidad PHP | PHP 7.4 o superior |
| Modificación del núcleo de Dolibarr | No |
| Licencia | GNU GPLv3 |
| Idiomas disponibles | Francés, Inglés, Alemán, Español, Italiano |
Enlaces oficiales
- Vídeo de demostración: ComptaPortal — demo (YouTube)
- Tienda: KSIDol.io
- Ficha del módulo: ksidol.io/es
- Página del editor K.S.I en DoliStore: Módulos K.S.I en DoliStore
Objetivos del módulo
Agilizar los intercambios entre la empresa y su asesoría contable, manteniendo el control de los datos:
- dar al contable un acceso nominativo y limitado únicamente a las facturas autorizadas;
- evitar compartir una cuenta interna de Dolibarr o exportar documentos manualmente;
- trazar cada transmisión (descarga, correo electrónico, API);
- permitir la automatización mediante una API de solo lectura para el software de contabilidad.
¿Para qué sectores?
- Empresas que trabajan con una asesoría contable externa y quieren transmitir las facturas sin abrir todo Dolibarr.
- Empresas con varios establecimientos que desean centralizar la puesta a disposición de los documentos contables.
- Cualquier organización que busque industrializar la transmisión periódica de facturas a su asesor.
Funcionalidades principales
- Invitación nominativa: correo electrónico, despacho, idioma y permisos por cuenta (facturas de clientes, facturas de proveedores, descarga, envío por correo electrónico, API). Envío por correo o copia del enlace temporal.
- Creación de cuenta por el contable: define él mismo su contraseña (al menos 12 caracteres, con mayúscula, minúscula y cifra) desde el enlace recibido.
- Banner de la empresa: identifica a la empresa emisora en el portal.
- Búsqueda de documentos: filtros por periodo, origen (ventas/compras), tipo (factura, abono, anticipo, factura de situación), tercero y estado de transmisión.
- Descarga: PDF individuales, variante Factur-X cuando existe.
- Exportación ZIP: archivo con un manifiesto CSV.
- Envío por correo electrónico: archivo enviado a uno o varios destinatarios (separados por «,» o «;»), con firma KSIDol.io automática.
- API de solo lectura: endpoints de listado y de descarga para la integración en el software de contabilidad.
- Trazabilidad: registro de transmisiones y registro de seguridad.
Seguridad y acceso
El acceso a los datos está siempre autenticado; ningún documento es accesible mediante un simple enlace anónimo.
- Cuenta nominativa por contable, con permisos explícitos.
- Contraseña definida por el contable (mínimo 12 caracteres, mayúscula + minúscula + cifra).
- Bloqueo tras varios intentos de conexión fallidos.
- Caducidad de sesión por inactividad (duración configurable).
- Token CSRF en los formularios.
- Registro de seguridad sin conservar la dirección IP en texto claro.
API de solo lectura
Destinada a la integración en el software de contabilidad:
- endpoints de listado y de descarga;
- autenticación Bearer;
- tokens con hash y revocables;
- ámbitos limitados y cuota de llamadas por hora;
- cada llamada se registra.
Menús principales
El módulo se integra en el menú Contabilidad de Dolibarr. Un grupo «ComptaPortal» añade:
- Panel de control (cuentas activas, invitaciones pendientes, transmisiones de los últimos 30 días)
- Invitaciones
- Cuentas del portal
- Transmisiones (registro)
- Configuración
Cada entrada solo es visible para un usuario que disponga del permiso asociado.
Configuración
La configuración (Contabilidad → ComptaPortal → Configuración) expone en particular:
- activación del portal público autenticado;
- URL pública y título del portal;
- idioma predeterminado;
- duración de validez de las invitaciones (horas) y duración de inactividad antes de la desconexión (minutos);
- límites de exportación (número de documentos, tamaño en MB);
- cuota de llamadas a la API por hora;
- dirección de correo del remitente y cuerpo del mensaje enviado al contable.
Uso diario
- La empresa crea una invitación nominativa y marca los permisos.
- El contable recibe el enlace, crea su cuenta y se conecta.
- Busca y descarga las facturas, las exporta en ZIP o las recibe por correo electrónico.
- Para automatizar, crea un token de API y configura su software de contabilidad.
- Cada transmisión queda registrada.
Permisos de usuario
El módulo declara cuatro permisos, cada uno protegiendo las entradas de menú correspondientes:
- Leer el panel de ComptaPortal (portal/read)
- Gestionar las invitaciones y cuentas del contable (portal/write)
- Leer los registros de transmisión y de seguridad (audit/read)
- Configurar ComptaPortal (setup/write)
Nota técnica
- Estándares de Dolibarr respetados: permisos, CSRF,
GETPOST, escape. Sin modificación del núcleo. - Hooks en las fichas de factura de cliente y de factura de proveedor.
- Tablas creadas: cuentas del portal, invitaciones, tokens de API, transmisiones, registro de eventos.
- El módulo expone los archivos ya producidos por Dolibarr; no genera las facturas ni el Factur-X.
Instalación
- Descomprima el archivo para obtener una carpeta
comptaportal/. - Cópiela en
htdocs/custom/de su Dolibarr. - Compruebe los permisos de escritura en
documents/comptaportal/temp(exportaciones temporales). - Active el módulo desde Inicio → Configuración → Módulos/Aplicaciones.
- Abra Contabilidad → ComptaPortal → Configuración para ajustar el portal.
Actualización
Sustituya la carpeta comptaportal/ por la nueva versión y luego recargue la página de módulos. Las tablas y constantes existentes se conservan.
Resolución de problemas
- El portal no está disponible: compruebe que el módulo está activado y que el portal público está activado en la configuración.
- La invitación no es válida o ha caducado: genere una nueva invitación (duración de validez configurable).
- Los correos no se envían: compruebe el envío de correo de Dolibarr y la dirección del remitente en la configuración.
- Un PDF no está disponible: el documento debe haber sido generado y almacenado por Dolibarr.
Posicionamiento normativo
ComptaPortal facilita la colaboración con la asesoría contable. No sustituye a una plataforma homologada de facturación electrónica. La generación de Factur-X sigue estando a cargo de Dolibarr o del módulo de generación instalado.
Véase también
- Terminal de firma KSIDol: firma de todas las fichas nativas de Dolibarr, compatible con todos los módulos KSIDol.
- Compatibilidad: Dolibarr 18.0 a 24.x — PHP 7.4+ — Licencia GPLv3 — Editor: KSIDol.
Resumen
ComptaPortal ofrece a su asesor contable un acceso seguro, autenticado y trazado a sus facturas de ventas y compras — búsqueda, descarga, exportación ZIP, envío por correo electrónico y API — sin abrir nunca la interfaz interna de Dolibarr ni exponer otros datos que los autorizados.