Endpoints / Clientes
Crear cliente
Crea un nuevo cliente dentro de la empresa indicada.
/clientsCaso de Uso
Se usa cuando la aplicación necesita registrar un cliente para ventas, proformas u otros procesos comerciales. Al usarlo, el usuario obtiene el cliente creado con sus datos de identificación, contacto, estado y fecha de registro.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`.
Parámetros de ruta
Este endpoint no recibe parámetros de ruta.
Body
clnteemidstringobligatorioIdentificador de la empresa a la que pertenecerá el cliente.
clntetipoidentificacionstringobligatorioTipo de identificación del cliente; acepta cedula o ruc.
clnteidentificacionstringobligatorioNúmero de identificación válido según clntetipoidentificacion.
clntenombrestringobligatorioNombre del cliente.
clntecorreostringobligatorioCorreo electrónico válido del cliente.
clntedireccionstringobligatorioDirección del cliente.
clntetelefonostringobligatorioTeléfono móvil válido de 10 dígitos.
Reglas de negocio
Solo permite crear clientes en la misma empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
El usuario autenticado debe tener rol jefe o empleado.
Todos los campos del body son obligatorios.
clntetipoidentificacion solo acepta cedula o ruc.
Si clntetipoidentificacion es cedula, clnteidentificacion debe tener 10 dígitos.
Si clntetipoidentificacion es ruc, clnteidentificacion debe tener 13 dígitos.
clntecorreo debe tener formato de correo válido.
clntetelefono debe ser un número móvil válido de 10 dígitos.
clnteidentificacion no puede repetirse dentro de la misma empresa.
clntecorreo no puede repetirse dentro de la misma empresa.
El cliente 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.
No se envió clnteemid o se envió vacío.
No se envió clntetipoidentificacion o se envió vacío.
clntetipoidentificacion tiene un valor distinto de cedula o ruc.
No se envió clnteidentificacion o se envió vacío.
clnteidentificacion no cumple el formato requerido para cedula o ruc.
No se envió clntenombre o se envió vacío.
No se envió clntecorreo o se envió vacío.
clntecorreo no tiene formato de correo válido.
No se envió clntedireccion o se envió vacía.
No se envió clntetelefono o se envió vacío.
clntetelefono no cumple el formato de teléfono móvil requerido.
La empresa indicada en clnteemid o la empresa del usuario autenticado no fue encontrada.
La empresa asociada a la solicitud 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.
clnteemid pertenece a una empresa distinta a la del usuario autenticado.
El rol del usuario no está permitido para acceder al módulo de clientes.
El usuario autenticado no tiene un rol permitido para crear clientes.
El usuario autenticado está inactivo y no puede usar el sistema.
Ya hay un cliente registrado con la misma clnteidentificacion dentro de la empresa.
Ya hay un cliente registrado con el mismo clntecorreo dentro de la empresa.
Ocurrió un error interno al guardar el cliente.
El cliente fue guardado, pero no pudo consultarse para devolver la respuesta.
Notas de uso
Este endpoint no recibe parámetros de ruta.
Envía el body en formato JSON con el header Content-Type: application/json.
Envía identificaciones y teléfonos como texto para conservar ceros iniciales.
Todos los campos son obligatorios en la creación.
La validación de clnteidentificacion depende de clntetipoidentificacion.
La respuesta devuelve los datos guardados del cliente creado.