Portal de cliente
Frihet ofrece tres formas de compartir documentos con tus clientes, cada una para un caso de uso diferente:
| Canal | URL | Uso |
|---|---|---|
| Portal completo | app.frihet.io/portal/:token | Acceso self-service a todo: facturas, presupuestos, pagos, estado de cuenta |
| Factura pública | app.frihet.io/p/:hash | Enlace de solo lectura para compartir una factura individual |
| Página de pago | app.frihet.io/pay/:userId/:invoiceId/:token | Checkout directo con Stripe para cobrar una factura |
Portal completo
El portal es una experiencia self-service donde tu cliente accede a toda su información sin necesidad de crear cuenta ni contraseña.
Acceso
- Abre la ficha de un cliente en Frihet
- Pulsa Generar enlace del portal
- Frihet genera un token único para ese cliente
- Comparte el enlace por email, WhatsApp o donde prefieras
https://app.frihet.io/portal/eyJhbGciOiJIUzI1NiJ9...
El enlace da acceso a todo el historial del cliente, no a una sola factura. Puedes revocarlo en cualquier momento desde la ficha del cliente.
Pestañas del portal
El portal tiene 5 pestañas:
Dashboard
Vista general del cliente con:
- Saldo pendiente total
- Facturas vencidas (número e importe)
- Actividad reciente (últimas facturas, pagos, presupuestos)
Facturas
Lista completa de facturas del cliente con:
- Filtrado por estado (pendiente, pagada, vencida)
- Descarga de PDF individual
- Botón de pago en las facturas pendientes que tienen un enlace de pago
Presupuestos
Lista de presupuestos enviados al cliente con:
- Estado actual (enviado, aceptado, rechazado, expirado)
- Aceptar o rechazar presupuesto directamente desde el portal
Pagos
Historial completo de pagos realizados:
- Fecha, importe y factura asociada
- Método de pago utilizado
- Estado del pago
Estado de cuenta
Resumen consolidado del historial financiero:
- Exportable como PDF
- Total facturado, total pagado, saldo pendiente
Personalización
El portal muestra tu branding automáticamente:
- Logo de tu empresa (configurado en Ajustes > Datos de empresa)
- Color de marca principal
- Nombre de tu negocio
Factura pública
Para compartir una factura individual de forma rápida, sin dar acceso al portal completo.
https://app.frihet.io/p/a1b2c3d4e5f6
Cómo funciona
- Abre una factura en Frihet
- Pulsa Compartir > Enlace público
- Frihet genera un hash único para esa factura
- Cualquier persona con el enlace puede ver la factura
Qué ve el cliente
- Vista de solo lectura de la factura con tu branding
- Botón Descargar PDF
- Botón de pago con Stripe mientras la factura no esté cobrada ni anulada y tenga un enlace de pago
- Sin acceso a otras facturas ni datos del portal
Seguridad
- Hash aleatorio no adivinable (no contiene IDs secuenciales)
- Solo lectura — no se puede modificar nada
- Se puede revocar eliminando la factura o desde el detalle de la factura
Página de pago
Enlace específico para cobrar una factura vía Stripe.
https://app.frihet.io/pay/{userId}/{invoiceId}/{token}
Cómo funciona
- Requisito: Tener Stripe Connect configurado en Ajustes > Pagos
- El enlace se incluye automáticamente en los emails de factura con el botón "Ver y pagar factura"
- El cliente ve los datos de la factura y pulsa Pagar
- Se abre una sesión de Stripe Checkout (tarjeta, Apple Pay, Google Pay)
- Al completar el pago, la factura se marca como pagada automáticamente
Seguridad
- Token HMAC-SHA256 único por combinación usuario+factura
- Determinístico: no almacena tokens en base de datos
- Comparación timing-safe para prevenir ataques de temporización
- HTTPS obligatorio
Seguridad general
Todos los canales comparten las siguientes medidas:
- Sin autenticación tradicional: No se requiere cuenta ni contraseña. Acceso por token o hash
- HTTPS obligatorio en todos los enlaces
- Cabeceras de seguridad:
X-Frame-Options: DENY,X-Content-Type-Options: nosniff - Aislamiento: Un cliente solo ve sus propios datos. No puede acceder a facturas de otros clientes
- Revocación: Al eliminar un cliente, todos sus enlaces se invalidan inmediatamente
- Sin expiración: Los tokens son válidos indefinidamente mientras el cliente exista en tu base de datos
Notificaciones automáticas
Frihet puede enviar emails automáticos al cliente:
- Factura emitida: Email cuando creas nueva factura (con el PDF adjunto y, si la factura tiene un enlace de pago, el enlace para pagar)
- Recordatorio de pago: Email antes del vencimiento (configurable en Ajustes > Recordatorios)
- Pago recibido: Confirmación cuando se registra un pago
- Presupuesto expirado: Aviso si un presupuesto caduca sin aceptar
Configura los automatismos en Ajustes > Notificaciones.
Relacionado: Detalle de cliente · Enlace de pago · Dominio propio para gestoría