Endpoints / Métodos de Pago
Crear método de pago
Registra un nuevo método de pago dentro de la empresa del usuario autenticado.
/playment-methodsCaso de Uso
Se usa cuando la aplicación necesita crear un nuevo método de pago para usarlo en proformas, ventas y otros procesos comerciales. Al usarlo, el usuario obtiene los datos completos del método de pago creado, incluyendo su identificador único y fecha de registro.
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
Este endpoint no recibe parámetros de ruta.
Body
mpemidstringobligatorioIdentificador de la empresa a la que pertenecerá el método de pago; debe coincidir con la empresa del usuario autenticado.
mpnombrestringobligatorioNombre del método de pago; debe ser único dentro de la empresa.
Reglas de negocio
Solo un usuario con rol jefe o empleado puede registrar métodos de pago.
Solo permite crear métodos de pago en la misma empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
Todos los campos del body son obligatorios.
mpnombre no puede repetirse dentro de la misma empresa.
El método de pago se crea con estado activo.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
mpemid fue enviado vacío.
mpnombre fue enviado vacío.
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.
mpemid pertenece a una empresa distinta a la del usuario autenticado.
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 crear métodos de pago.
El usuario autenticado está inactivo y no puede usar el sistema.
Ya hay un método de pago registrado con el mismo mpnombre dentro de la empresa.
El método de pago fue guardado, pero no pudo consultarse para devolver la respuesta.
Ocurrió un error interno al guardar el método de pago.
Notas de uso
Este endpoint no recibe parámetros de ruta ni query params.
mpnombre debe ser único dentro de la empresa; puede repetirse entre empresas distintas.
mpemid debe coincidir con la empresa del usuario autenticado; no se permite crear métodos de pago para otras empresas.