Saltar al contenido principal

Registro de nueva empresa

POST 
/auth/register

Endpoint para registrar nuevas empresas y su usuario administrador inicial. Realiza las siguientes operaciones:

  1. Valida datos obligatorios (NIF, nombre, contraseñas coincidentes)
  2. Verifica unicidad del NIF y email
  3. Crea dirección fiscal
  4. Crea empresa en base de datos
  5. Crea usuario administrador
  6. Configura cuenta Stripe
  7. Envía email de bienvenida
  8. Crea tarifa inicial gratuita por 1 mes

Flujo detallado:​

  1. Cliente envía datos de empresa y usuario en formato JSON
  2. Servidor valida campos obligatorios (400 si faltan)
  3. Verifica NIF según normas fiscales españolas (400 si inválido)
  4. Comprueba unicidad de NIF y email (409 si existen)
  5. Crea dirección fiscal con datos proporcionados
  6. Registra empresa en base de datos
  7. Crea usuario administrador con contraseña hasheada
  8. Configura cuenta Stripe para pagos futuros
  9. Envía email de activación con token único
  10. Crea tarifa inicial gratuita por 30 días

Requisitos de datos:​

  • NIF/CIF válido según normativa española
  • Razón social completa
  • Email corporativo no registrado
  • Contraseña segura (mínimo 8 caracteres, mayúsculas, números y especiales)
  • Dirección fiscal completa

Ejemplo de petición:​

{
  "email": "admin@empresa.com",
  "password": "ContraseñaSegura123!",
  "password_confirm": "ContraseñaSegura123!",
  "invoice_data": {
    "taxid": "B12345678",
    "socialName": "Transportes Ejemplo S.L."
  },
  "address": {
    "street": "Calle Ejemplo 123",
    "city": "Madrid",
    "zipcode": "28001",
    "country": "ES"
  }
}

Códigos de error:​

  • 400: Datos faltantes, NIF inválido o contraseñas no coinciden
  • 403: Empresa ya registrada con mismo NIF
  • 406: Error en validación de datos
  • 409: Email ya registrado
  • 500: Error interno del servidor

Request​

Responses​

Registro exitoso