:id`

Actualiza los datos de un producto específico, identificado por su id numérico. Permite modificar campos individuales y subir una nueva imagen (reemplazando la anterior si existía).

🔐 Requiere autenticación JWT.

📍 Ruta

PATCH /api/products/update/:id

📝 Descripción

Este endpoint permite actualizar uno o más campos de un producto existente. Se puede incluir opcionalmente una nueva imagen que reemplazará la anterior en Cloudinary. Solo los campos enviados serán actualizados. Si ocurre un error, también se gestiona la eliminación de la imagen recientemente subida (si aplica).

🔒 Autenticación

Middleware: verificarAutenticacion

Header requerido: Authorization: Bearer <token>

🧱 Middleware Aplicado

verificarAutenticacion

upload.single('image') – Carga archivo de imagen (multipart/form-data)

imageRequired

updateProductValidator

validateRequest

processImage – Sube imagen a Cloudinary y la adjunta como req.imageUrl

🔢 Parámetros de Ruta

Parámetro	Tipo	Requerido	Descripción
`id`	number	✅	ID numérico del producto a actualizar

📤 Request Body (`multipart/form-data`)

Campo	Tipo	Requerido	Descripción
`product_name`	string	❌	Nombre del producto
`measure`	string	❌	Unidad de medida (`UND` o `REP`)
`price`	number	❌	Precio (decimal positivo)
`stock`	number	❌	Cantidad disponible (entero positivo)
`image`	file	❌	Imagen nueva del producto

⚠️ Se debe proporcionar al menos un campo o una nueva imagen para procesar la actualización.

✅ Respuestas

200 OK – Producto actualizado correctamente

{
  "status": "success",
  "code": "PRODUCT_UPDATED",
  "msg": "Producto actualizado correctamente.",
  "data": {
    "id": 1,
    "product_name": "Pan integral",
    "measure": "UND",
    "price": 3.50,
    "stock": 40,
    "imgUrl": "https://res.cloudinary.com/..."
  },
  "info": {
    "fieldsUpdated": ["product_name", "stock"],
    "imageAction": "Reemplazada",
    "oldImageStatus": "Eliminada correctamente"
  }
}

200 OK – Sin cambios detectados

{
  "status": "success",
  "code": "NO_CHANGES_DETECTED",
  "msg": "No se proporcionaron datos nuevos para actualizar.",
  "info": {
    "imageAction": "Ninguna",
    "fieldsAttempted": []
  }
}

❌ Errores

400 Bad Request – ID inválido o datos incorrectos

{
  "status": "error",
  "code": "VALIDATION_ERROR",
  "msg": "El id debe ser un número.",
  "errors": [
    {
      "field": "id",
      "msg": "El id debe ser un número entero válido."
    }
  ]
}

401 Unauthorized – Token inválido o ausente

{
  "status": "error",
  "code": "AUTH_ERROR",
  "msg": "Acceso no autorizado. Se requiere token válido."
}

404 Not Found – Producto no encontrado

{
  "status": "error",
  "code": "NOT_FOUND",
  "msg": "Producto con ID 22 no encontrado.",
  "info": {
    "productStatus": "No encontrado",
    "imageAction": "Eliminada (Producto No Encontrado)",
    "imageStatus": "Eliminada correctamente"
  }
}

500 Internal Server Error – Fallo en la actualización

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al actualizar el producto. Intente de nuevo más tarde.",
  "info": {
    "detail": "Fallo al conectar con base de datos.",
    "imageAction": "Error al eliminar (Error Actualización)",
    "imageStatus": "Fallo en eliminación de imagen nueva"
  }
}

application/json

Body

message

string

required

updatedProduct

object

required

integer

required

product_name

string

required

measure

string

required

price

number

required

stock

integer

required

imgUrl

string

required

__v

integer

required

Actualizar Producto

🔧 PATCH `/products/update/:id`

📍 Ruta

📝 Descripción

🔒 Autenticación

🧱 Middleware Aplicado

🔢 Parámetros de Ruta

📤 Request Body (`multipart/form-data`)

✅ Respuestas

200 OK – Producto actualizado correctamente

200 OK – Sin cambios detectados

❌ Errores

400 Bad Request – ID inválido o datos incorrectos

401 Unauthorized – Token inválido o ausente

404 Not Found – Producto no encontrado

500 Internal Server Error – Fallo en la actualización

Request

Responses

Actualizar Producto

🔧 PATCH /products/update/:id#

📍 Ruta#

📝 Descripción#

🔒 Autenticación#

🧱 Middleware Aplicado#

🔢 Parámetros de Ruta#

📤 Request Body (multipart/form-data)#

✅ Respuestas#

200 OK – Producto actualizado correctamente#

200 OK – Sin cambios detectados#

❌ Errores#

400 Bad Request – ID inválido o datos incorrectos#

401 Unauthorized – Token inválido o ausente#

404 Not Found – Producto no encontrado#

500 Internal Server Error – Fallo en la actualización#

Request

Responses

🔧 PATCH `/products/update/:id`

📍 Ruta

📝 Descripción

🔒 Autenticación

🧱 Middleware Aplicado

🔢 Parámetros de Ruta

📤 Request Body (`multipart/form-data`)

✅ Respuestas

200 OK – Producto actualizado correctamente

200 OK – Sin cambios detectados

❌ Errores

400 Bad Request – ID inválido o datos incorrectos

401 Unauthorized – Token inválido o ausente

404 Not Found – Producto no encontrado

500 Internal Server Error – Fallo en la actualización