📝 POST `/register`

Registra un nuevo vendedor en el sistema, genera un nombre de usuario único y una contraseña temporal, y envía un correo de confirmación con las credenciales y enlace de activación.

📍 Ruta

POST /api/register

📝 Descripción

Este endpoint permite registrar un nuevo vendedor, creando un nombre de usuario único y una contraseña temporal. Además, se envía un correo de confirmación con las credenciales y un enlace de activación.

🔐 Autenticación

✅ Requiere token JWT válido de administrador

Encabezado: Authorization: Bearer <token>

🧰 Middleware

verificarAutenticacion

validateCreateSeller (de auth_validator.js)

validateRequest (manejo de errores de validación)

📦 Request Body

{
  "email": "string (requerido, único)",
  "cedula": "number (requerido, único)",
  "names": "string (requerido)",
  "lastNames": "string (requerido)",
  "PhoneNumber": "number (requerido)",
  "SalesCity": "string (requerido)"
}

✅ Respuestas

✔️ 201 Created – Vendedor registrado y correo enviado

{
  "status": "success",
  "code": "SELLER_REGISTERED",
  "msg": "Vendedor registrado exitosamente.",
  "notification": "Se ha enviado un correo a {email} para confirmar el registro y se ha generado un usuario y una contraseña temporal.",
  "data": {
    "_id": "ObjectId",
    "names": "string",
    "lastNames": "string",
    "cedula": number,
    "email": "string",
    "username": "string",
    "PhoneNumber": number,
    "SalesCity": "string",
    "role": "string",
    "status": false,
    "confirmEmail": false
  },
  "info": {
    "emailDetails": {
      "sent": true,
      "message": "Correo enviado correctamente."
    }
  }
}

⚠️ 201 Created – Vendedor creado, fallo en envío de correo

{
  "status": "warning",
  "code": "SELLER_CREATED_EMAIL_FAILED",
  "msg": "Vendedor registrado exitosamente, pero hubo un problema al enviar el correo de confirmación.",
  "notification": "Verifica tu bandeja de entrada o contacta a soporte si no recibes el correo.",
  "data": { /* igual que en SELLER_REGISTERED */ },
  "info": {
    "emailDetails": {
      "sent": false,
      "message": "Error específico del servicio de correo (ej: 'Connection refused')."
    }
  }
}

❌ Errores

🚫 400 Bad Request – Campo faltante

{
  "status": "error",
  "code": "MISSING_FIELD",
  "msg": "Faltan campos requeridos. Asegúrate de incluir email, cedula, names, lastNames, PhoneNumber y SalesCity.",
  "info": {
    "missingFields": ["email", "cedula"]
  }
}

🚫 400 Bad Request – Error de validación

{
  "status": "error",
  "code": "VALIDATION_ERROR",
  "msg": "Errores de validación en la solicitud.",
  "errors": [
    {
      "type": "field",
      "value": "correo-invalido",
      "msg": "El email no tiene un formato válido.",
      "path": "email",
      "location": "body"
    },
    {
      "type": "field",
      "value": "123",
      "msg": "La cédula debe ser un número válido.",
      "path": "cedula",
      "location": "body"
    }
    // …
  ]
}

🚫 401 Unauthorized – Token inválido o ausente

{
  "status": "error",
  "code": "UNAUTHORIZED",
  "msg": "Acceso no autorizado. Se requiere token de autenticación válido."
}

🚫 409 Conflict – Email o cédula ya existe

{
  "status": "error",
  "code": "RESOURCE_ALREADY_EXISTS",
  "msg": "El email 'ejemplo@correo.com' ya se encuentra registrado.",
  "info": {
    "field": "email",
    "value": "ejemplo@correo.com"
  }
}

{
  "status": "error",
  "code": "RESOURCE_ALREADY_EXISTS",
  "msg": "El número de cédula '1234567890' ya se encuentra registrado.",
  "info": {
    "field": "cedula",
    "value": 1234567890
  }
}

💥 500 Internal Server Error – Error inesperado

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al registrar el vendedor. Intente de nuevo más tarde.",
  "info": {
    "detail": "Detalle interno (ej: 'Database connection failed')",
    "emailAttempted": true,
    "emailDetails": {
      "sent": false,
      "message": "Error del servicio de correo si ocurrió antes del fallo principal"
    }
  }
}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Registro de Vendedores

📝 POST `/register`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

📦 Request Body

✅ Respuestas

✔️ 201 Created – Vendedor registrado y correo enviado

⚠️ 201 Created – Vendedor creado, fallo en envío de correo

❌ Errores

🚫 400 Bad Request – Campo faltante

🚫 400 Bad Request – Error de validación

🚫 401 Unauthorized – Token inválido o ausente

🚫 409 Conflict – Email o cédula ya existe

💥 500 Internal Server Error – Error inesperado

Request

Responses

Registro de Vendedores

📝 POST /register#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

🧰 Middleware#

📦 Request Body#

✅ Respuestas#

✔️ 201 Created – Vendedor registrado y correo enviado#

⚠️ 201 Created – Vendedor creado, fallo en envío de correo#

❌ Errores#

🚫 400 Bad Request – Campo faltante#

🚫 400 Bad Request – Error de validación#

🚫 401 Unauthorized – Token inválido o ausente#

🚫 409 Conflict – Email o cédula ya existe#

💥 500 Internal Server Error – Error inesperado#

Request

Responses

📝 POST `/register`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

📦 Request Body

✅ Respuestas

✔️ 201 Created – Vendedor registrado y correo enviado

⚠️ 201 Created – Vendedor creado, fallo en envío de correo

❌ Errores

🚫 400 Bad Request – Campo faltante

🚫 400 Bad Request – Error de validación

🚫 401 Unauthorized – Token inválido o ausente

🚫 409 Conflict – Email o cédula ya existe

💥 500 Internal Server Error – Error inesperado