Saltar al contenido principal

Self-onboard de clientes con VIES

El self-onboard permite que tus clientes completen su alta en el portal de gestoria de forma autonoma, sin que tengas que introducir sus datos manualmente. El cliente recibe un magic link por email, introduce su CIF/NIF y Frihet consulta automaticamente el censo AEAT y el registro VIES para pre-rellenar sus datos fiscales.

Esta funcionalidad reduce el tiempo de alta de un cliente de 15-20 minutos a menos de 3 minutos.

Flujo completo​

Tu (gestor) → Envia invitacion con magic link
  ↓
Cliente → Hace clic en el link (autenticacion sin password)
  ↓
Cliente → Introduce CIF/NIF
  ↓
Frihet → Consulta AEAT (censo) + VIES (si es intracomunitario)
  ↓
Cliente → Revisa y confirma datos pre-rellenados
  ↓
Cliente → Acepta condiciones y configura metodo de pago (Stripe)
  ↓
Tu → Recibes notificacion: cliente activo en portal

Enviar invitacion a un cliente​

  1. Ve a Gestoria → Clientes → Invitar cliente.
  2. Introduce el email del cliente y el nombre de la empresa (opcional).
  3. Personaliza el mensaje de bienvenida si lo necesitas.
  4. Haz clic en Enviar invitacion.

El cliente recibe un email desde tu dominio white-label (si esta configurado) con un enlace unico valido 72 horas. Puedes reenviar la invitacion si caduca.

Tambien puedes enviar invitaciones en bloque desde Gestoria → Clientes → Importar → subir CSV con columnas email, nombre_empresa.

Magic link — autenticacion sin password​

El magic link autentica al cliente sin necesidad de crear una password. Al hacer clic en el enlace:

  1. Frihet verifica que el token es valido y no ha caducado.
  2. Crea una sesion segura para ese email.
  3. El cliente accede directamente al formulario de alta — sin pantalla de login.

Una vez completado el alta, el cliente puede configurar una password o continuar usando magic links para cada acceso (configurable por el gestor en Gestoria → Configuracion → Autenticacion clientes).

Auto-relleno AEAT y VIES​

Al introducir el CIF/NIF, Frihet realiza dos consultas en paralelo:

Consulta AEAT (censo)​

Frihet consulta el censo de contribuyentes AEAT para verificar el NIF y recuperar:

  • Razon social oficial
  • Domicilio fiscal (calle, CP, municipio, provincia)
  • Actividad economica principal (CNAE)
  • Regimen de IVA (general, simplificado, recargo equivalencia)
  • Zona fiscal (peninsula, Canarias, Ceuta/Melilla)
info

La consulta AEAT requiere que el NIF este activo en el censo. NIF de personas fisicas autonomas, CIF de sociedades y NIE de extranjeros autonomos son todos validos.

Consulta VIES (operadores intracomunitarios)​

Si el cliente tiene actividades intracomunitarias, Frihet consulta el registro VIES (VAT Information Exchange System) de la Comision Europea para verificar el numero de operador intracomunitario (ROI) y recuperar:

  • Estado del ROI (valido / no valido / no registrado)
  • Nombre oficial en el registro VIES
  • Pais de la sede
Ejemplo respuesta VIES:
{
  "valid": true,
  "countryCode": "ES",
  "vatNumber": "B12345678",
  "name": "EMPRESA EJEMPLO SL",
  "address": "CALLE MAYOR 1, 28013 MADRID"
}

Los datos VIES se usan automaticamente para las facturas intracomunitarias del cliente (tipo de IVA 0% con referencia ROI).

Configuracion de pago — Stripe Connect​

Si tu gestoria cobra a los clientes a traves de Frihet, el flujo de alta incluye la configuracion del metodo de pago via Stripe Connect:

  1. El cliente introduce su tarjeta de credito o debito directamente en el formulario Stripe (PCI-compliant — Frihet no almacena datos de tarjeta).
  2. Frihet asocia el cliente a tu cuenta Stripe Connect de gestoria.
  3. Los cobros futuros (cuotas mensuales, servicios adicionales) se cargan automaticamente.

Si no usas cobros automaticos, desactiva Stripe en el flujo en Gestoria → Configuracion → Cobros → desactivar Pago en el alta.

Estado del alta y seguimiento​

Ve a Gestoria → Clientes → En proceso de alta para ver el estado de cada invitacion:

EstadoSignificado
Invitacion enviadaEl cliente aun no ha abierto el link
En progresoEl cliente ha abierto el formulario
Pendiente confirmacionEl cliente ha completado el formulario — revision tuya
ActivoAlta completada — cliente con acceso al portal
CaducadoEl magic link expiro sin completar el alta

Puedes reenviar la invitacion o extender el plazo desde cualquier estado.

Gotchas​

  • NIF no encontrado en AEAT: ocurre con NIFs recien dados de alta o NIF de actividades sin obligaciones periodicas. En ese caso, el formulario pide introduccion manual.
  • VIES no disponible: el servicio VIES de la UE tiene interrupciones periodicas (especialmente fines de semana). Frihet reintenta automaticamente 3 veces y si falla, pide introduccion manual con advertencia.
  • CIF invalido: el sistema valida el algoritmo de control del CIF/NIF antes de consultar AEAT. NIFs con errores tipograficos se detectan inmediatamente.
  • Clientes extranjeros: para clientes fuera de la UE, la consulta AEAT/VIES no aplica. El formulario pide TIN (Tax Identification Number) del pais de origen y el resto de campos manualmente.
  • Datos desactualizados en AEAT: el censo AEAT puede tener datos con hasta 3 meses de retraso. El cliente debe confirmar los datos antes de finalizar el alta.

Relacionado​