Admin → Sucursales (/admin/sucursales)¶
- Permisos mínimos:
AccessAdmin.SUCURSALES_VIEW. Para altas/ediciones,AccessAdmin.SUCURSALES_EDIT. - APIs:
GET /api/admin/sucursalesPOST /api/admin/sucursalesPATCH /api/admin/sucursalesDELETE /api/admin/sucursalesGET /api/admin/empresas?size=1000(rellena el selector de empresa).
Objetivo¶
Controlar las sucursales de cada empresa (ubicaciones físicas). La información se usa en otros módulos para filtrar proyectos o responsabilidades.
Procedimiento¶
1. Revisión¶
- Abre
/admin/sucursales. Verás una tabla con clave, nombre, empresa, ubicación (si aplica), estado activo y fecha de alta. - Filtra con la barra DSL (
empresa_nombre~=offshore,is_active=false, etc.). - Usa el menú de columnas para mostrar/ocultar campos.
2. Crear sucursal¶
- Pulsa “Nueva sucursal”.
- Campos requeridos:
- Clave y nombre.
- Empresa matriz (selector).
- Dirección/Descripción opcional.
- Activo (checkbox).
- Guarda con “Crear”.
3. Editar¶
- Accede a “Editar” en la fila deseada.
- Ajusta datos y confirma con “Guardar cambios”.
4. Eliminar¶
- Botón “Eliminar” (ícono
Trash2). - Confirma. Si la sucursal se usa en otros registros, la API denegará la operación y se mostrará el error proveniente de
handleErrorResponse.
Notas¶
- Antes de eliminar, revisa si la sucursal aparece asociada a proyectos; de ser así, considera desactivarla en lugar de borrarla.
- Los toasts confirman cada acción; aprovecha los mensajes de error para corregir datos duplicados (clave/nombre únicos por empresa).