Language
Portal de Clientes (DoliPortal)
Module Description
Doliportal es un portal privado para clientes de Dolibarr. Permite consultar facturas, presupuestos, pedidos, expediciones, proyectos, tareas y tickets; pagar facturas online; firmar presupuestos; descargar documentos en ZIP; editar datos personales; comprar desde un catalogo con carrito y solicitar presupuestos. Incluye diseno responsive, PWA para instalar en el movil y un dashboard interno de metricas.
Disponible en Dolistore.
Manual del modulo
Indice
- Descripcion
- Instalacion
- Crear usuario del portal
- Permisos
- Configuracion general
- Diseno e imagenes
- Modulos del portal
- Catalogo de productos
- Carrito y presupuestos del catalogo
- Pagos online
- Firma de presupuestos
- Tickets de soporte
- Descarga ZIP
- Datos personales
- Multiempresa
- Acceso por dominio
- PWA en el movil
- Dashboard interno
- Documentos recientes
- Seguridad
- Mantenimiento y actualizacion
- Solucion de problemas
- Changelog
1. Descripcion: Doliportal es un portal web privado para los clientes de una empresa que utiliza Dolibarr. Cada cliente accede con su usuario y contrasena y ve unicamente la informacion de su empresa. El portal reutiliza los datos, permisos y documentos de Dolibarr: no duplica informacion, solo ofrece una capa de acceso externa, segura y adaptada a movil.
Incluye dashboard, facturas, presupuestos, pedidos, expediciones, proyectos, tareas, tickets, pagos online, firma de presupuestos, datos personales, descarga ZIP, catalogo, carrito, multiempresa, PWA y metricas internas de uso.
2. Instalacion: Copiar la carpeta del modulo en htdocs/custom/doliportal/. Despues, en Dolibarr entrar en Configuracion > Modulos/Apps, buscar Doliportal y activarlo. A continuacion, abrir la configuracion del modulo y definir la URL publica del portal, por ejemplo:
https://portal.midominio.com/
Tambien se puede usar una subcarpeta como https://midominio.com/custom/doliportal/public/. Comprobar que la carpeta public/ sea accesible desde el navegador.
Insertar video de YouTube mostrando la copia, activacion y primer acceso
3. Crear usuario del portal: El usuario del portal es un usuario de Dolibarr asociado a un tercero cliente. Crear el tercero, crear el usuario, asociarlo al tercero, asignar los permisos de Doliportal y entrar al portal con ese usuario. El cliente solo vera los documentos de la empresa a la que esta asociado.
Insertar captura de un usuario Dolibarr asociado a un tercero
4. Permisos: Doliportal anade permisos propios para controlar que ve cada usuario:
- Ver facturas: acceso al listado de facturas.
- Ver presupuestos: acceso al listado de presupuestos.
- Ver pedidos: acceso al listado de pedidos.
- Ver expediciones: acceso al listado de expediciones.
- Ver tickets: acceso a tickets de soporte.
- Ver proyectos: acceso a proyectos.
- Ver tareas: acceso a tareas.
- Ver facturas de proveedor: acceso a facturas de proveedor.
- Ver catalogo: acceso al catalogo de productos.
- Ver dashboard: acceso al dashboard interno de metricas.
- Editar datos personales: permite modificar sus datos desde el portal.
Insertar captura de permisos de Doliportal en un usuario
5. Configuracion general: La configuracion esta dividida en tarjetas para facilitar su lectura. Incluye:
- Acceso publico: URL publica, titulo del portal, URL de retorno, recuperacion de contrasena, enlace magico y duracion del enlace.
- Inicio de sesion: titulo, subtitulo, imagen de fondo, logo y texto adicional.
- Diseno: logo del menu, logo de sustitucion, icono PWA y favicon.
- Contacto y textos: telefono, email, aviso RGPD y textos de tickets.
- Modulos del portal: activacion de facturas, presupuestos, pedidos, expediciones, tickets, proyectos, tareas, facturas de proveedor y catalogo.
- Tickets: seguimiento por email y gravedad.
- Experimental: archivos subidos como publicos.
Insertar captura de la configuracion en tarjetas de dos columnas y boton Guardar fijo
6. Diseno e imagenes: Los campos de imagen usan selector de archivo y muestra de vista previa. Las imagenes se guardan en public/custom_assets/. Se pueden cambiar el fondo del login, el logo del login, el logo del menu, el logo de sustitucion, el icono PWA y el favicon.
Recomendaciones: usar PNG transparente para logos, imagenes ligeras para el login, favicon cuadrado de al menos 32x32 px e icono PWA de 256x256 px o superior. La imagen de fondo del login solo aparece en la pantalla de acceso, no en el interior del portal.
Insertar captura del login con logo, titulo, subtitulo e imagen de fondo
7. Modulos del portal: Cada seccion aparece en el menu del cliente solo si esta activa en la configuracion y el usuario tiene el permiso correspondiente. Se pueden activar o desactivar facturas, presupuestos, pedidos, expediciones, tickets, proyectos, tareas, facturas de proveedor y catalogo.
Insertar captura de la tarjeta Modulos del portal
8. Catalogo de productos: Permite elegir una categoria raiz, navegar por subcategorias, mostrar productos con imagen, nombre, referencia y precio opcional, abrir un detalle de producto, anadir productos al carrito, comentar cada linea, generar un presupuesto en borrador, mostrar u ocultar precios y elegir formato TTC, HT o ambos.
Configuracion: activar Catalogo, seleccionar la categoria raiz, elegir si se muestran precios, elegir formato y guardar. La seccion de opciones del catalogo solo aparece cuando el catalogo esta activado. La categoria raiz no se muestra como categoria hija; las subcategorias se ordenan alfabeticamente; al entrar se abre la primera categoria; si la raiz no tiene subcategorias se muestran sus productos.
El buscador busca por nombre, referencia o descripcion. El carrito se conserva al cambiar de pantalla y se abre desde la barra superior. Permite cambiar cantidades, eliminar lineas y comentar cada linea. El comentario se guarda en la descripcion de la linea del presupuesto.
Insertar captura con categorias, tarjetas de producto y carrito
Insertar video mostrando busqueda, carrito, comentarios y generacion de presupuesto
9. Carrito y presupuestos del catalogo: El presupuesto se crea en estado borrador y con precios reales. Aparece en un listado separado de solicitudes pendientes dentro de Presupuestos. Se puede abrir el detalle de lineas. Cuando un comercial lo valida, pasa al listado normal de presupuestos. Si los precios estan ocultos, tambien se ocultan en el catalogo, carrito, listado y detalle.
10. Pagos online: Doliportal reutiliza los modulos nativos de pago de Dolibarr. Requiere Stripe y/o PayPal activos, claves API configuradas, cuenta bancaria asociada y token de seguridad de pagos. Cuando la factura esta validada y tiene saldo pendiente aparece el boton de pago; al pulsarlo se abre la pasarela nativa y Dolibarr registra el pago y actualiza la factura.
Si no aparece el boton, revisar que Stripe o PayPal este activo, que la factura este validada, que tenga saldo pendiente, que el token de seguridad de pagos este configurado y que el usuario tenga permiso de facturas.
Insertar captura del boton de pago y pasarela Stripe/PayPal
11. Firma de presupuestos: En Dolibarr 21 o superior se usa la firma online nativa. En Dolibarr 16 a 20, Doliportal usa una pagina de firma propia y anade la firma al PDF como respaldo. El cliente firma con el dedo o raton, se registra la firma y se genera el PDF firmado.
Insertar captura de la pantalla de firma y del PDF firmado
12. Tickets de soporte: El cliente puede ver sus tickets, crear uno nuevo, ver el detalle, responder, adjuntar archivos y consultar el historial. Los tickets se gestionan desde Dolibarr, se pueden configurar campos extra visibles y activar el seguimiento por email.
Insertar captura del listado y detalle de tickets
13. Descarga ZIP: Desde el listado de facturas se pueden descargar los documentos de un ano en un unico ZIP. Se selecciona el ano, se pulsa Descargar ZIP y el portal genera un archivo con los PDF disponibles.
Insertar captura del selector de ano y boton Descargar ZIP
14. Datos personales: El cliente puede consultar y editar sus datos desde el portal: nombre, apellidos, direccion, codigo postal, ciudad, email, telefono movil, telefono de oficina y fax. Los cambios se guardan en el usuario de Dolibarr.
Insertar captura de la pantalla de informacion personal
15. Multiempresa: Doliportal funciona con Dolibarr Multicompany. En el modo recomendado, el cliente entra por una sola URL, el portal detecta la empresa al iniciar sesion y, si el usuario pertenece a varias, aparece una ventana para elegir. Desde el menu de usuario puede cambiar de empresa. No hace falta configurar dominios ni DNS.
Insertar captura de la ventana de seleccion de empresa
16. Acceso por dominio: El acceso por dominio es una opcion avanzada para empresas que quieran usar un dominio distinto por cada entidad. Para activarlo: crear el dominio o subdominio en DNS, configurar el virtual host de Apache o Nginx apuntando a custom/doliportal/public/, configurar HTTPS, entrar en Configuracion > Modulos > Doliportal > Acceso por dominio, activar Activar acceso por dominio, crear un registro por dominio con su entidad y validarlo.
El dominio debe coincidir con el usado para entrar, sin http:// ni rutas. Ejemplo: portal.clientea.com para la entidad 2, portal.clienteb.com para la entidad 3.
Insertar captura de la pestana Acceso por dominio y su activacion
17. PWA en el movil: El portal incluye manifest, iconos y service worker. Para que el navegador ofrezca la instalacion automatica se necesita HTTPS, manifest accesible, service worker activo e iconos 192x192 y 512x512. En Android se puede usar el boton Instalar aplicacion del menu de usuario o el menu del navegador con Anadir a pantalla de inicio.
Importante: si se accede por http:// a una IP local, Chrome o Samsung pueden no ofrecer la instalacion automatica. En ese caso hace falta HTTPS o usar la opcion manual del navegador.
Insertar captura del portal instalado en la pantalla de inicio del movil
Insertar video mostrando el proceso de instalacion en Android
18. Dashboard interno: Los usuarios internos con permiso pueden ver un dashboard de uso del portal con: usuarios del portal, accesos, paginas vistas, usuarios activos, facturas vistas, presupuestos firmados, presupuestos creados desde el catalogo, conversion del catalogo, paginas mas visitadas y ultima actividad.
Tambien muestra los ultimos 10 presupuestos firmados, los ultimos 10 presupuestos del portal pendientes de validar, productos mas presupuestados, productos mas vistos y ultimos tickets del portal. Los listados incluyen enlaces al listado completo de Dolibarr.
Insertar captura del dashboard interno con metricas y listados
19. Documentos recientes: El dashboard del cliente muestra los ultimos 10 documentos: facturas, presupuestos, pedidos y expediciones. Cada tipo aparece solo si el modulo esta activo y el usuario tiene permiso.
Insertar captura de la tabla de documentos recientes
20. Seguridad: Doliportal aplica acceso solo con usuario autenticado, cada usuario ve solo su tercero, validacion de permisos por seccion, descargas protegidas, validacion de pertenencia de documentos, token CSRF en operaciones sensibles, recalculo de precios del catalogo en el servidor, validacion de productos contra la categoria raiz, presupuestos del catalogo en borrador y dashboard interno solo con permiso.
Recomendaciones: usar HTTPS, no compartir usuarios, asignar solo los permisos necesarios, mantener Dolibarr actualizado y revisar periodicamente el acceso de usuarios externos.
Insertar captura de permisos asignados a un usuario del portal
21. Mantenimiento y actualizacion: Para actualizar el modulo: hacer copia de seguridad de la base de datos, sustituir la carpeta custom/doliportal, entrar en Dolibarr, revisar la configuracion, reactivar el modulo si se anadieron nuevas tablas, permisos, menus o campos extra, y probar el acceso al portal.
22. Solucion de problemas:
- No aparece el boton de pago: revisar Stripe o PayPal, token de seguridad, estado de la factura y permisos.
- No aparecen productos en el catalogo: revisar la categoria raiz, que los productos esten a la venta, que las categorias sean de productos y que el catalogo este activo.
- No aparece la opcion de instalar la PWA: revisar HTTPS, manifest y service worker. En HTTP local puede no aparecer.
- El usuario no ve nada: revisar que este asociado al tercero y tenga permisos.
- No aparece el menu Catalogo: revisar activacion del catalogo, categoria raiz y permisos.
- No se ve el dashboard interno: revisar el permiso view_dashboard.
Insertar captura de revision de permisos o configuracion
23. Changelog:
- 2.1.0 - Catalogo de productos, carrito, presupuestos desde catalogo, comentarios por linea, busqueda, modal de producto, listado de solicitudes pendientes y detalle.
- 2.1.0 - Dashboard interno de uso del portal y registro de metricas.
- 2.1.0 - Mejoras de configuracion, imagenes con selector de archivo, acceso por dominio opcional y selector de empresa multiempresa.
- 2.1.0 - PWA con manifest, iconos, service worker y boton de instalacion.
- 2.0.0 - Rebranding completo a Doliportal, eliminacion de dependencias antiguas y base para enlace magico, firma digital, descarga ZIP.


