Prima-Back
  1. Modulo Clientes
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 Clientes

Actualizar Cliente

PATCH
/api/clients/update/{ruc}

✏️ PATCH /clients/update/:ruc#

Actualiza información de un cliente existente identificado por su número de RUC.

📍 Ruta#

PATCH /api/clients/update/:ruc

📝 Descripción#

Este endpoint permite modificar uno o varios campos de un cliente existente, identificado por su número de RUC.
Solo se actualizan los campos presentes y válidos en el body de la solicitud.
Si se modifica el email, se verifica que no esté registrado por otro cliente.

🔐 Autenticación#

Requiere token JWT válido
Cabecera: Authorization: Bearer <token>
Middleware: verificarAutenticacion

🧰 Middleware#

1.
verificarAutenticacion – Verifica la validez del token JWT
2.
validateUpdateClient – Valida el parámetro ruc y los campos del body
3.
validateRequest – Maneja errores de validación

🔢 Parámetros#

🛣️ Path Parameters#

ParámetroTipoRequeridoDescripción
rucnumber✅Número de RUC del cliente a actualizar

📥 Request Body#

Debe incluir al menos uno de los siguientes campos válidos:
{
  "Name": "string (opcional)",
  "Address": "string (opcional)",
  "telephone": "number (opcional)",
  "email": "string (opcional, formato email)",
  "credit": "string (opcional)",
  "state": "string (opcional)"
}

✅ Respuestas#

✔️ 200 OK – Cliente actualizado correctamente#

{
  "status": "success",
  "code": "CLIENT_UPDATED",
  "msg": "Cliente actualizado correctamente.",
  "data": {
    "Name": "string",
    "Ruc": number,
    "Address": "string",
    "telephone": number,
    "email": "string",
    "credit": "string",
    "state": "string"
  }
}

❌ Errores#

⚠️ 400 Bad Request – Parámetro RUC inválido o faltante#

{
  "status": "error",
  "code": "MISSING_FIELD",
  "msg": "El parámetro 'ruc' es obligatorio."
}

❌ 400 Bad Request – Body sin campos válidos para actualizar#

{
  "status": "error",
  "code": "NO_UPDATABLE_FIELDS",
  "msg": "No se proporcionaron campos válidos para actualizar."
}

🚫 401 Unauthorized – Token inválido o ausente#

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

🔍 404 Not Found – Cliente no encontrado#

{
  "status": "error",
  "code": "NOT_FOUND",
  "msg": "No se encontró cliente con RUC {ruc} para actualizar."
}

🚫 409 Conflict – Email duplicado#

{
  "status": "error",
  "code": "RESOURCE_ALREADY_EXISTS",
  "msg": "El email '{email}' ya está registrado por otro cliente."
}

💥 500 Internal Server Error – Falla inesperada#

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al actualizar el cliente. Intente de nuevo más tarde."
}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://back-prima-s-a.onrender.com/api/clients/update/' \
--header 'User-Agent: insomnia/11.0.0' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzQyOTMxNzg3LCJleHAiOjE3NDI5NjA1ODd9.nwBdY2DmiTAjEYfxGukAQHJkbrsLHqMosjmOSgzfbR4' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Name": "Juan Pérez",
    "Address": "Av. Principal 123, Quito",
    "telephone": 987654321,
    "credit": "Rechazado",
    "state": "Falto"
  }'
Response Response Example
{"msg":"Cliente actualizado correctamente","data":{"Name":"Juan Pérez","Address":"Av. Principal 123, Quito","telephone":987654321,"credit":"Rechazado","state":"Falto"}}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
ruc
string 
required
Header Params
Content-Type
string 
optional
Example:
application/json
User-Agent
string 
optional
Example:
insomnia/11.0.0
Authorization
string 
optional
Example:
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzQyOTMxNzg3LCJleHAiOjE3NDI5NjA1ODd9.nwBdY2DmiTAjEYfxGukAQHJkbrsLHqMosjmOSgzfbR4
Body Params application/json
Name
string 
required
Address
string 
required
telephone
integer 
required
credit
string 
required
state
string 
required
Examples

Responses

🟢200Success
application/json
Body
msg
string 
required
data
object 
required
Name
string 
required
Address
string 
required
telephone
integer 
required
credit
string 
required
state
string 
required
Modified at 2025-04-24 17:58:15
Previous
Visualizar Clientes por RUC
Next
Eliminar Cliente
Built with