Registrar nueva empresa y usuario

POST 
/register

Público (sin autenticación). Crea en una sola transacción el usuario (activo), la empresa (el DV se calcula a partir de dni y el email de la empresa es el del usuario) y el vínculo entre ambos. Verificación del email según type_id: 2 y 3 quedan verificados automáticamente y pueden iniciar sesión de inmediato; 4 (Partner) recibe un correo de verificación y no puede iniciar sesión hasta verificarlo. No retorna token: después se debe llamar a POST /auth/login.

Request

Responses

200

Empresa y usuario creados. message es Empresa creada con éxito. para type_id 2 y 3, o Empresa creada con éxito. Verifique su dirección de correo electrónico: {email} para type_id 4.

400

Violación de integridad en base de datos al crear usuario o empresa que la validación no detectó (p. ej. un duplicado concurrente de email o dni). message es un texto genérico sin SQL ni datos, p. ej. Ya existe un registro con ese valor (dato duplicado). No se crea nada.

422

Validación fallida. Mensajes posibles, entre otros: El tipo de usuario no es válido, El tipo de usuario seleccionado no está permitido para registro, El correo electrónico no es válido, El correo electrónico ya existe, El NIT ya existe, El país no existe, El tipo de documento no existe, El tipo de organización no existe y, para un correo con formato válido que no puede recibir mensajes (p. ej. píchincha@hotmail.com), El correo electrónico no puede recibir mensajes: revisa que no tenga tildes, eñes ni espacios y que el dominio sea válido (por ejemplo, nombre@empresa.com)..

429

Límite general de 60 peticiones por minuto excedido (sin sesión, se cuenta por IP). Cuerpo {"message":"Too Many Attempts."}, sin success; la cabecera Retry-After indica los segundos de espera. No se crea nada.

500

Error interno. Si ocurre al crear usuario o empresa, la transacción se revierte y no se crea nada; si ocurre al enviar el correo de verificación (type_id 4), la cuenta ya quedó creada y el correo puede reenviarse con POST /email/verification-notification. Un dni numérico de 16 a 19 cifras que no supere 9223372036854775807 también responde 500 con este formato (ver la propiedad dni). Nota: con un dni que no es un número, o mayor que 9223372036854775807 (ver la propiedad dni), el cuerpo no sigue este formato: en producción es {"message":"Server Error"}, sin success (o una página HTML si la petición no envía Accept: application/json), y tampoco se crea nada.