Prima-Back
  1. Vendedores Operaciones
Prima-Back
  • API DOCUMENTATION
  • Principal
    • /
      GET
  • Modulo Administradores
    • Vendedores Operaciones
      • Registro de Vendedores
        POST
      • Visualizar Vendedores
        GET
      • Visualizar Vendedores por Mongo ID
        GET
      • Visualizar Vendedores por cedula
        GET
      • Actualizar Vendedor
        PATCH
      • Eliminar Vendedor
        DELETE
    • Estadisticas
      • Estadisticas de documentos
      • Visualizacion de top Vendedores
      • Visualizar Ventas por Vendedor
    • Login Administradores
      POST
    • Recuperacion de contraseña Administrador
      POST
  • Modulo Vendedores
    • Inicio de Sesión Vendedores
      POST
    • Confirmación de Cuenta
      GET
    • Solicitud de restablecimiento de contraseña
      POST
    • Restablecimiento de contraseña
      POST
  • Modulo Clientes
    • Registrar Cliente
      POST
    • Visualizar Clientes
      GET
    • Visualizar Clientes por RUC
      GET
    • Actualizar Cliente
      PATCH
    • Eliminar Cliente
      DELETE
  • Modulo Productos
    • Crear Producto
      POST
    • Visualizar Productos
      GET
    • Visualizar Productos por ID
      GET
    • Actualizar Producto
      PATCH
    • Eliminar Producto
      DELETE
  • Modulo Pedidos
    • Crear Orden
    • Visualizar Ordenes
    • Visualizar Ordenes por ID
    • Actualizar Orden
    • Actualizar Estado de Orden
    • Eliminar Orden
  1. Vendedores Operaciones

Visualizar Vendedores por cedula

GET
/api/sellers-numberid/{{cedulaSeller}}

🔍 GET /sellers-numberid/: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#

1.
verificarAutenticacion
2.
validateFindSellerByNumberId
3.
validateRequest

🔗 Parámetros de Ruta#

ParámetroTipoDescripción
cedulanumberNú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')"
  }
}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://back-prima-s-a.onrender.com/api/sellers-numberid/' \
--header 'User-Agent: insomnia/10.3.0' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzM4NjI4MjgxLCJleHAiOjE3Mzg2NTcwODF9.0or08xMGWjpppL1Lm2dGM6yX-5Y6ozETnKFwpXPgxxE' \
--header 'Content-Type: application/json'
Response Response Example
{}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params
Content-Type
string 
optional
Example:
application/json
User-Agent
string 
optional
Example:
insomnia/10.3.0
Authorization
string 
optional
Example:
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzM4NjI4MjgxLCJleHAiOjE3Mzg2NTcwODF9.0or08xMGWjpppL1Lm2dGM6yX-5Y6ozETnKFwpXPgxxE

Responses

🟢200Success
application/json
Body
object {0}
Modified at 2025-06-14 22:52:07
Previous
Visualizar Vendedores por Mongo ID
Next
Actualizar Vendedor
Built with