View source for Portal contable seguro para dolibarr

[[Category:Complementary modules]]
[[Category:K.S.I]]
[[Category:Accounting]]
[[Category:Interface]]

{{TemplateDocDev}}
{{TemplateDocUtil}}

<div style="border:1px solid #d7e3f4; border-radius:14px; padding:22px; margin:12px 0 22px 0; background:linear-gradient(135deg,#f6faff,#ffffff); box-shadow:0 2px 10px rgba(20,60,110,0.08);">
  <div style="font-size:28px; font-weight:700; color:#17365d; margin-bottom:8px;">ComptaPortal para Dolibarr</div>
  <div style="font-size:18px; color:#345; margin-bottom:14px;">Portal contable seguro: acceso autenticado y controlado a sus facturas de ventas y compras, sin abrir la interfaz interna de Dolibarr</div>
  <div style="display:flex; flex-wrap:wrap; gap:8px; margin-top:10px;">
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Portal contable</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Ventas y compras</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Factur-X</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Invitaciones nominativas</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Exportación ZIP</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">API segura</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Acceso autenticado</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Trazabilidad</span>
  </div>
</div>

== 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 ==

{| class="wikitable" style="width:100%; border-collapse:collapse;"
! style="width:24%; background:#f0f6ff;" | Elemento
! style="background:#f0f6ff;" | 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 ==

{| class="wikitable" style="width:100%;"
! style="width:24%; background:#f7f7f7;" | Información
! style="background:#f7f7f7;" | 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 : [https://youtu.be/DYhy0qoTO6M ComptaPortal — demo (YouTube)]
* Ficha del módulo : [https://www.ksidol.io/es/modules/detail?module=main_module_comptaportal ComptaPortal en KSIDol]
* Demostración en línea : [https://www.ksidol.io/t/demo-booking/custom/comptaportal/public/index.php ComptaPortal — abrir la demo]
* Manual del módulo : [https://www.ksidol.io/notices/ksidol_notice_es/comptaportal.html ComptaPortal — consultar el manual]
* Página del editor K.S.I en DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= 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, <code>GETPOST</code>, 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 <code>comptaportal/</code>.
# Cópiela en <code>htdocs/custom/</code> de su Dolibarr.
# Compruebe los permisos de escritura en <code>documents/comptaportal/temp</code> (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 <code>comptaportal/</code> 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.