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

  1. Descripcion
  2. Instalacion
  3. Crear usuario del portal
  4. Permisos
  5. Configuracion general
  6. Diseno e imagenes
  7. Modulos del portal
  8. Catalogo de productos
  9. Carrito y presupuestos del catalogo
  10. Pagos online
  11. Firma de presupuestos
  12. Tickets de soporte
  13. Descarga ZIP
  14. Datos personales
  15. Multiempresa
  16. Acceso por dominio
  17. PWA en el movil
  18. Dashboard interno
  19. Documentos recientes
  20. Seguridad
  21. Mantenimiento y actualizacion
  22. Solucion de problemas
  23. 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.

VIDEO 01 - INSTALACION
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.

IMAGEN 02 - USUARIO DEL PORTAL
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.
IMAGEN 03 - PERMISOS
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.
IMAGEN 04 - CONFIGURACION
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.

IMAGEN 05 - LOGIN
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.

IMAGEN 06 - MODULOS
Insertar captura de la tarjeta Modulos del portal

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.

IMAGEN 07 - CATALOGO
Insertar captura con categorias, tarjetas de producto y carrito
VIDEO 02 - CATALOGO 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.

IMAGEN 08 - PAGO
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.

IMAGEN 09 - FIRMA
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.

IMAGEN 10 - TICKETS
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.

IMAGEN 11 - DESCARGA ZIP
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.

IMAGEN 12 - DATOS PERSONALES
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.

IMAGEN 13 - MULTIEMPRESA
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.

IMAGEN 14 - ACCESO POR DOMINIO
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.

IMAGEN 15 - PWA
Insertar captura del portal instalado en la pantalla de inicio del movil
VIDEO 03 - INSTALAR EN 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.

IMAGEN 16 - DASHBOARD INTERNO
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.

IMAGEN 17 - DOCUMENTOS RECIENTES
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.

IMAGEN 18 - SEGURIDAD Y PERMISOS
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.
IMAGEN 19 - PROBLEMAS
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.

 

Doliportal - GPL-3.0-or-later - Editor: Codlines <info@codlines.com>

Similar Products

3780613352368986924

Web Hosting