: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

verificarAutenticacion – Verifica la validez del token JWT

validateUpdateClient – Valida el parámetro ruc y los campos del body

validateRequest – Maneja errores de validación

🔢 Parámetros

🛣️ Path Parameters

Parámetro	Tipo	Requerido	Descripción
`ruc`	number	✅	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."
}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Actualizar Cliente

✏️ PATCH `/clients/update/:ruc`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

🔢 Parámetros

🛣️ Path Parameters

📥 Request Body

✅ Respuestas

✔️ 200 OK – Cliente actualizado correctamente

❌ Errores

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

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

🚫 401 Unauthorized – Token inválido o ausente

🔍 404 Not Found – Cliente no encontrado

🚫 409 Conflict – Email duplicado

💥 500 Internal Server Error – Falla inesperada

Request

Responses

Actualizar Cliente

✏️ PATCH /clients/update/:ruc#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

🧰 Middleware#

🔢 Parámetros#

🛣️ Path Parameters#

📥 Request Body#

✅ Respuestas#

✔️ 200 OK – Cliente actualizado correctamente#

❌ Errores#

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

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

🚫 401 Unauthorized – Token inválido o ausente#

🔍 404 Not Found – Cliente no encontrado#

🚫 409 Conflict – Email duplicado#

💥 500 Internal Server Error – Falla inesperada#

Request

Responses

✏️ PATCH `/clients/update/:ruc`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

🔢 Parámetros

🛣️ Path Parameters

📥 Request Body

✅ Respuestas

✔️ 200 OK – Cliente actualizado correctamente

❌ Errores

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

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

🚫 401 Unauthorized – Token inválido o ausente

🔍 404 Not Found – Cliente no encontrado

🚫 409 Conflict – Email duplicado

💥 500 Internal Server Error – Falla inesperada