:cedula`

Busca y devuelve la información de un vendedor a partir de su número de cédula.

📍 Ruta

GET /api/sellers-numberid/:cedula

📝 Descripción

Este endpoint permite buscar a un vendedor existente mediante su número de cédula. Retorna los datos completos del vendedor si se encuentra.

🔐 Autenticación

✅ Requiere token JWT válido de administrador

Encabezado: Authorization: Bearer <token>

🧰 Middleware

verificarAutenticacion

validateFindSellerByNumberId

validateRequest

🔗 Parámetros de Ruta

Parámetro	Tipo	Descripción
`cedula`	number	Número de cédula del vendedor requerido

📦 Request Body

❌ No requiere cuerpo (body) en la solicitud.

✅ Respuestas

✔️ 200 OK – Vendedor encontrado

{
  "status": "success",
  "code": "SELLER_FOUND",
  "msg": "Vendedor encontrado.",
  "data": {
    "_id": "ObjectId",
    "names": "string",
    "lastNames": "string",
    "cedula": number,
    "email": "string",
    "username": "string",
    "PhoneNumber": number,
    "SalesCity": "string",
    "role": "string",
    "status": boolean
  }
}

❌ Errores

⚠️ 400 Bad Request – Cédula inválida o faltante

{
  "status": "error",
  "code": "VALIDATION_ERROR",
  "msg": "Errores de validación en la solicitud.",
  "errors": [
    {
      "type": "field",
      "value": "cedula-invalida",
      "msg": "La cédula debe ser un número válido.",
      "path": "cedula",
      "location": "params"
    }
  ]
}

o bien:

{
  "status": "error",
  "code": "MISSING_FIELD",
  "msg": "El parámetro 'cedula' es obligatorio."
}

🚫 401 Unauthorized – Token inválido o ausente

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

🔍 404 Not Found – Vendedor no encontrado

{
  "status": "error",
  "code": "NOT_FOUND",
  "msg": "No se encontró vendedor con cédula {cedula}."
}

💥 500 Internal Server Error – Error inesperado

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al buscar el vendedor por cédula. Intente de nuevo más tarde.",
  "info": {
    "detail": "Mensaje específico del error interno (ej: 'Database connection failed')"
  }
}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Visualizar Vendedores por cedula

🔍 GET `/sellers-numberid/:cedula`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

🔗 Parámetros de Ruta

📦 Request Body

✅ Respuestas

✔️ 200 OK – Vendedor encontrado

❌ Errores

⚠️ 400 Bad Request – Cédula inválida o faltante

🚫 401 Unauthorized – Token inválido o ausente

🔍 404 Not Found – Vendedor no encontrado

💥 500 Internal Server Error – Error inesperado

Request

Responses

Visualizar Vendedores por cedula

🔍 GET /sellers-numberid/:cedula#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

🧰 Middleware#

🔗 Parámetros de Ruta#

📦 Request Body#

✅ Respuestas#

✔️ 200 OK – Vendedor encontrado#

❌ Errores#

⚠️ 400 Bad Request – Cédula inválida o faltante#

🚫 401 Unauthorized – Token inválido o ausente#

🔍 404 Not Found – Vendedor no encontrado#

💥 500 Internal Server Error – Error inesperado#

Request

Responses

🔍 GET `/sellers-numberid/:cedula`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

🔗 Parámetros de Ruta

📦 Request Body

✅ Respuestas

✔️ 200 OK – Vendedor encontrado

❌ Errores

⚠️ 400 Bad Request – Cédula inválida o faltante

🚫 401 Unauthorized – Token inválido o ausente

🔍 404 Not Found – Vendedor no encontrado

💥 500 Internal Server Error – Error inesperado