Prima-Back
  1. Modulo Productos
Prima-Back
  • API DOCUMENTATION
  • Principal
    • /
      GET
  • Modulo Administradores
    • Vendedores Operaciones
      • Registro de Vendedores
      • Visualizar Vendedores
      • Visualizar Vendedores por Mongo ID
      • Visualizar Vendedores por cedula
      • Actualizar Vendedor
      • Eliminar Vendedor
    • 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
      POST
    • Visualizar Ordenes
      GET
    • Visualizar Ordenes por ID
      GET
    • Actualizar Orden
      PATCH
    • Actualizar Estado de Orden
      PATCH
    • Eliminar Orden
      DELETE
  1. Modulo Productos

Eliminar Producto

DELETE
/api/products/delete/{id}

🗑️ DELETE /products/delete/:id#

Elimina un producto del sistema, junto con su imagen asociada en Cloudinary (si existe).
🔐 Requiere autenticación JWT.

📍 Ruta#

DELETE /api/products/delete/:id

📝 Descripción#

Este endpoint elimina un producto existente usando su id numérico. Primero obtiene la URL de su imagen (si existe), la elimina de Cloudinary y luego elimina el producto de la base de datos. Si ocurre un error al eliminar la imagen, se informa pero la eliminación del producto sigue su curso.

🔒 Autenticación#

Middleware: verificarAutenticacion
Header requerido: Authorization: Bearer <token>

🧱 Middleware Aplicado#

1.
verificarAutenticacion
2.
deleteProductValidator
3.
validateRequest

🔢 Parámetros de Ruta#

ParámetroTipoRequeridoDescripción
idnumber✅ID numérico del producto a eliminar

📤 Request Body#

No se requiere cuerpo en esta solicitud.

✅ Respuestas#

200 OK – Producto eliminado correctamente#

{
  "status": "success",
  "code": "PRODUCT_DELETED",
  "msg": "Producto eliminado correctamente.",
  "info": {
    "imageAction": "Eliminada",
    "imageStatus": "Imagen asociada eliminada de Cloudinary."
  }
}

200 OK – Producto eliminado, pero ocurrió un error al borrar la imagen#

{
  "status": "warning",
  "code": "PRODUCT_DELETED_WITH_IMAGE_ERROR",
  "msg": "Producto eliminado de la base de datos, pero ocurrió un error al eliminar la imagen asociada de Cloudinary.",
  "info": {
    "imageAction": "Error al eliminar",
    "imageStatus": "Cloudinary: Signature error."
  }
}

❌ Errores#

400 Bad Request – ID inválido#

{
  "status": "error",
  "code": "VALIDATION_ERROR",
  "msg": "El parámetro 'id' es obligatorio.",
  "errors": [
    {
      "field": "id",
      "msg": "El id debe ser un número 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 101 no encontrado."
}

500 Internal Server Error – Fallo inesperado#

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al eliminar el producto. Intente de nuevo más tarde.",
  "info": {
    "detail": "Fallo al conectar con Cloudinary.",
    "imageAction": "Intentando eliminar"
  }
}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'https://back-prima-s-a.onrender.com/api/products/delete/44444' \
--header 'User-Agent: insomnia/11.0.0' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzQyOTMxNzg3LCJleHAiOjE3NDI5NjA1ODd9.nwBdY2DmiTAjEYfxGukAQHJkbrsLHqMosjmOSgzfbR4'
Response Response Example
{"message":"Producto eliminado correctamente"}

Request

Path Params
id
string 
required
Example:
44444
Header Params
User-Agent
string 
optional
Example:
insomnia/11.0.0
Authorization
string 
optional
Example:
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzQyOTMxNzg3LCJleHAiOjE3NDI5NjA1ODd9.nwBdY2DmiTAjEYfxGukAQHJkbrsLHqMosjmOSgzfbR4

Responses

🟢200Success
application/json
Body
message
string 
required
Modified at 2025-04-24 17:04:44
Previous
Actualizar Producto
Next
Crear Orden
Built with