Endpoints / Métodos de Pago
Actualizar método de pago
Actualiza parcialmente los datos editables de un método de pago, dentro de la empresa del usuario autenticado.
/playment-methods/:idCaso de Uso
Se usa cuando la aplicación necesita modificar el nombre o el estado de un método de pago existente. Al usarlo, el usuario obtiene los datos completos del método de pago actualizado.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`. Permite acceso a usuarios con rol jefe o empleado. La empresa y el usuario autenticado deben estar activos.
Parámetros de ruta
idstringobligatorioIdentificador del método de pago.
Body
mpnombrestring opcionalNuevo nombre del método de pago; debe ser único dentro de la empresa.
mpestadostring opcionalNuevo estado del método de pago; acepta activo, inactivo o eliminado.
Reglas de negocio
Solo un usuario con rol jefe o empleado puede actualizar métodos de pago.
Solo permite actualizar métodos de pago de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
El método de pago debe existir dentro de la empresa autenticada.
Un método de pago con estado eliminado no puede actualizarse.
Debe enviarse al menos un campo editable con un valor diferente al actual.
Si se envía mpnombre, no puede estar vacío.
mpnombre no puede repetirse en otro método de pago de la misma empresa.
Si se envía mpestado, solo puede ser activo, inactivo o eliminado.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
No se envió el parámetro id en la ruta.
El método de pago no existe dentro de la empresa del usuario autenticado o la actualización no devolvió resultados.
mpnombre fue enviado vacío.
mpestado fue enviado vacío.
mpestado tiene un valor no permitido.
El método de pago existe, pero está en estado eliminado.
Otro método de pago de la misma empresa ya usa el mpnombre enviado.
No se envió ningún campo editable o todos los valores enviados son iguales a los actuales.
La empresa asociada al usuario autenticado no fue encontrada.
La empresa asociada al usuario autenticado está inactiva.
El usuario autenticado no fue encontrado dentro de su empresa.
El usuario autenticado no pertenece a la empresa indicada por su sesión.
El usuario autenticado intentó acceder a una empresa distinta a la suya.
El rol del usuario no está permitido para acceder al módulo de métodos de pago.
El usuario autenticado no tiene un rol permitido para actualizar métodos de pago.
El usuario autenticado está inactivo y no puede usar el sistema.
Notas de uso
Este endpoint no recibe query params.
Envía solo los campos que deseas actualizar.
El body debe incluir al menos un campo editable con un valor distinto al actual.
mpestado permite el valor eliminado para eliminación lógica del método de pago.