:id`

Actualiza información parcial de un vendedor existente mediante su _id de MongoDB.

📍 Ruta

PATCH /api/updateSeller/:id

📝 Descripción

Permite modificar campos específicos de un vendedor. Solo se actualizan los campos permitidos que estén presentes en la solicitud.

🔐 Autenticación

✅ Requiere token JWT válido de administrador

Encabezado: Authorization: Bearer <token>

🧰 Middleware

verificarAutenticacion

validateUpdateSeller

validateRequest

🔗 Parámetros de Ruta

Parámetro	Tipo	Descripción
`id`	string	`_id` del vendedor (formato ObjectId)

📦 Request Body

Debe contener uno o más de los siguientes campos:

email: string

PhoneNumber: number

SalesCity: string

names: string

lastNames: string

cedula: number

role: string

status: boolean

Ejemplo:

{
  "PhoneNumber": 987654321,
  "SalesCity": "Nueva Ciudad",
  "status": false
}

✅ Respuestas

✔️ 200 OK – Vendedor actualizado correctamente

{
  "status": "success",
  "code": "SELLER_UPDATED",
  "msg": "Vendedor actualizado correctamente.",
  "data": {
    "_id": "ObjectId",
    "names": "string",
    "lastNames": "string",
    "cedula": number,
    "email": "string",
    "username": "string",
    "PhoneNumber": number,
    "SalesCity": "string",
    "role": "string",
    "status": boolean
  },
  "info": {
    "updatedFields": ["PhoneNumber", "SalesCity", "status"]
  }
}

❌ Errores

⚠️ 400 Bad Request – ID inválido

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

⚠️ 400 Bad Request – Sin campos actualizables

{
  "status": "error",
  "code": "NO_UPDATABLE_FIELDS",
  "msg": "No se proporcionaron campos válidos o permitidos para actualizar.",
  "info": {
    "receivedFields": ["campoInvalido1", "campoInvalido2"],
    "allowedFields": ["email", "PhoneNumber", "SalesCity", "names", "lastNames", "cedula", "role", "status"]
  }
}

⚠️ 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"
    }
  ]
}

🚫 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} para actualizar."
}

🛑 409 Conflict – Email o cédula duplicados

{
  "status": "error",
  "code": "RESOURCE_ALREADY_EXISTS",
  "msg": "El email 'correo.existente@ejemplo.com' ya está en uso por otro vendedor."
}

{
  "status": "error",
  "code": "RESOURCE_ALREADY_EXISTS",
  "msg": "La cédula '123456789' ya está en uso por otro vendedor."
}

💥 500 Internal Server Error – Error inesperado

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al actualizar el vendedor. 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 ********************

Actualizar Vendedor

✏️ PATCH `/updateSeller/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

🔗 Parámetros de Ruta

📦 Request Body

✅ Respuestas

✔️ 200 OK – Vendedor actualizado correctamente

❌ Errores

⚠️ 400 Bad Request – ID inválido

⚠️ 400 Bad Request – Sin campos actualizables

⚠️ 400 Bad Request – Error de validación

🚫 401 Unauthorized – Token inválido o ausente

🔍 404 Not Found – Vendedor no encontrado

🛑 409 Conflict – Email o cédula duplicados

💥 500 Internal Server Error – Error inesperado

Request

Responses

Actualizar Vendedor

✏️ PATCH /updateSeller/:id#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

🧰 Middleware#

🔗 Parámetros de Ruta#

📦 Request Body#

✅ Respuestas#

✔️ 200 OK – Vendedor actualizado correctamente#

❌ Errores#

⚠️ 400 Bad Request – ID inválido#

⚠️ 400 Bad Request – Sin campos actualizables#

⚠️ 400 Bad Request – Error de validación#

🚫 401 Unauthorized – Token inválido o ausente#

🔍 404 Not Found – Vendedor no encontrado#

🛑 409 Conflict – Email o cédula duplicados#

💥 500 Internal Server Error – Error inesperado#

Request

Responses

✏️ PATCH `/updateSeller/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

🔗 Parámetros de Ruta

📦 Request Body

✅ Respuestas

✔️ 200 OK – Vendedor actualizado correctamente

❌ Errores

⚠️ 400 Bad Request – ID inválido

⚠️ 400 Bad Request – Sin campos actualizables

⚠️ 400 Bad Request – Error de validación

🚫 401 Unauthorized – Token inválido o ausente

🔍 404 Not Found – Vendedor no encontrado

🛑 409 Conflict – Email o cédula duplicados

💥 500 Internal Server Error – Error inesperado