:id`

Busca y devuelve la información de un vendedor a partir de su _id de MongoDB.

📍 Ruta

GET /api/sellers/:id

📝 Descripción

Este endpoint permite buscar a un vendedor existente mediante su _id. Si se encuentra, se retornan los detalles completos del vendedor.

🔐 Autenticación

✅ Requiere token JWT válido de administrador

Encabezado: Authorization: Bearer <token>

🧰 Middleware

verificarAutenticacion

validateFindSellerById

validateRequest

🔗 Parámetros de Ruta

Parámetro	Tipo	Descripción
`id`	string	ObjectId único 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 – ID inválido

{
  "status": "error",
  "code": "VALIDATION_ERROR",
  "msg": "Errores de validación en la solicitud.",
  "errors": [
    {
      "type": "field",
      "value": "id-invalido",
      "msg": "El ID proporcionado no es un ObjectId válido.",
      "path": "id",
      "location": "params"
    }
  ]
}

o bien:

{
  "status": "error",
  "code": "INVALID_FORMAT",
  "msg": "El ID 'id-invalido' no tiene un formato válido."
}

🚫 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 ID {id}."
}

💥 500 Internal Server Error – Error inesperado

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

curl --location -g --request GET 'https://back-prima-s-a.onrender.com/api/sellers/' \ --header 'User-Agent: insomnia/10.3.0' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzM4NjI4MjgxLCJleHAiOjE3Mzg2NTcwODF9.0or08xMGWjpppL1Lm2dGM6yX-5Y6ozETnKFwpXPgxxE'

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

User-Agent

string

optional

Example:

insomnia/10.3.0

Authorization

string

optional

Example:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzM4NjI4MjgxLCJleHAiOjE3Mzg2NTcwODF9.0or08xMGWjpppL1Lm2dGM6yX-5Y6ozETnKFwpXPgxxE

Visualizar Vendedores por Mongo ID

🔍 GET `/sellers/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

🔗 Parámetros de Ruta

📦 Request Body

✅ Respuestas

✔️ 200 OK – Vendedor encontrado

❌ Errores

⚠️ 400 Bad Request – ID inválido

🚫 401 Unauthorized – Token inválido o ausente

🔍 404 Not Found – Vendedor no encontrado

💥 500 Internal Server Error – Error inesperado

Request

Responses

Visualizar Vendedores por Mongo ID

🔍 GET /sellers/:id#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

🧰 Middleware#

🔗 Parámetros de Ruta#

📦 Request Body#

✅ Respuestas#

✔️ 200 OK – Vendedor encontrado#

❌ Errores#

⚠️ 400 Bad Request – ID inválido#

🚫 401 Unauthorized – Token inválido o ausente#

🔍 404 Not Found – Vendedor no encontrado#

💥 500 Internal Server Error – Error inesperado#

Request

Responses

🔍 GET `/sellers/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

🔗 Parámetros de Ruta

📦 Request Body

✅ Respuestas

✔️ 200 OK – Vendedor encontrado

❌ Errores

⚠️ 400 Bad Request – ID inválido

🚫 401 Unauthorized – Token inválido o ausente

🔍 404 Not Found – Vendedor no encontrado

💥 500 Internal Server Error – Error inesperado