Endpoints / Sucursales
Crear sucursal
Crea una nueva sucursal dentro de la empresa indicada.
/branchesCaso de Uso
Se usa cuando la aplicación necesita registrar una nueva sucursal para operar inventario, ventas o procesos internos de una empresa. Al usarlo, el usuario obtiene la sucursal creada con su identificador, 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
suemidstringobligatorioIdentificador de la empresa a la que pertenecerá la sucursal.
sunombrestringobligatorioNombre de la sucursal.
suidentificadorstringobligatorioCódigo único de 3 dígitos para identificar la sucursal dentro de la empresa.
sudireccionstring | null opcionalDirección física de la sucursal.
sucorreostring | null opcionalCorreo electrónico de contacto de la sucursal.
Reglas de negocio
Solo un usuario con rol jefe puede crear sucursales.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
La sucursal solo puede crearse en la misma empresa del usuario autenticado.
suemid, sunombre y suidentificador son obligatorios.
suidentificador debe tener exactamente 3 dígitos.
suidentificador no puede repetirse dentro de la misma empresa.
Si se envía sucorreo, debe tener formato de correo válido.
Después de crear la sucursal, el sistema crea una secuencia asociada a esa sucursal.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
No se envió suemid o se envió vacío.
No se envió sunombre o se envió vacío.
No se envió suidentificador o se envió vacío.
suidentificador no cumple el formato de 3 dígitos.
sucorreo fue enviado, pero no tiene formato de correo válido.
La empresa indicada en suemid 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.
suemid pertenece a una empresa distinta a la del usuario autenticado.
El rol del usuario no está permitido para acceder al módulo de sucursales.
El usuario autenticado no tiene el rol requerido para crear sucursales.
El usuario autenticado está inactivo y no puede usar el sistema.
Ya hay una sucursal registrada con el mismo suidentificador dentro de la empresa.
La sucursal fue creada, pero no pudo encontrarse al crear su secuencia asociada.
La sucursal creada no está activa al momento de crear su secuencia asociada.
Ya existe una secuencia asociada a la sucursal.
Ocurrió un error interno al guardar la sucursal.
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.
suidentificador debe enviarse como texto para conservar ceros iniciales, por ejemplo "001".
sudireccion y sucorreo pueden enviarse como null si no están disponibles.
La sucursal se crea con estado activo.
La respuesta devuelve los datos guardados de la sucursal creada.