Saltar a contenido

Admin → Centros de costos (/admin/centros_costos)

  • Permisos mínimos: AccessAdmin.CENTROS_COSTOS_VIEW. Para crear/editar/eliminar se requiere además AccessAdmin.CENTROS_COSTOS_EDIT.
  • APIs principales:
  • GET /api/admin/centros_costos (listado, filtros DSL).
  • POST /api/admin/centros_costos (crear).
  • PATCH /api/admin/centros_costos (editar).
  • DELETE /api/admin/centros_costos (eliminar).
  • GET /api/admin/proyectos?size=1000 (relleno del selector de proyectos).

Objetivo

Administrar el catálogo de centros de costos: alta, edición, baja, asignación a proyectos y activación/desactivación.

Pasos de trabajo

1. Consultar y filtrar

  1. Ingresa a /admin/centros_costos. La tabla se alimenta con DynamicTable.
  2. Usa la barra de búsqueda DSL para filtrar por clave, nombre, contrato, proyecto o estado. Ejemplos:
  3. nombre~=MAZATLAN
  4. is_active=false
  5. proyecto_nombre~=offshore
  6. Cambia el orden con los encabezados (Clave, Proyecto, Estatus, etc.) o ajusta el tamaño de página en la parte inferior.

2. Crear un centro de costos

  1. Haz clic en “Nuevo centro de costos” (botón con ícono Plus).
  2. Completa el formulario:
  3. Clave y nombre (obligatorios).
  4. Contrato, descripción opcional.
  5. Proyecto asociado (selector Select precargado con /api/admin/proyectos).
  6. Marca si debe iniciar como activo.
  7. Pulsa “Crear”. Si la operación resulta exitosa, la tabla se actualiza (tableRef.current?.reload()).

3. Editar registros existentes

  1. Desde la columna de acciones abre “Editar” (ícono Edit).
  2. Ajusta los campos necesarios. Puedes cambiar el proyecto sin perder auditoría.
  3. Guarda con “Guardar cambios”.

4. Activar/Desactivar

  • El interruptor en la columna Activo usa toggleActive: solicita confirmación (toast) y luego dispara PATCH con el nuevo estado. Úsalo para suspender temporalmente la visibilidad.

5. Eliminar definitivamente

  1. Selecciona “Eliminar” (ícono Trash2).
  2. Confirma en el diálogo. El borrado es irreversible y requiere que no existan vínculos críticos en backend (la API responderá con error si hay dependencias).

Consejos

  • Antes de crear un centro, valida que el proyecto asociado esté activo. El selector muestra clave y empresa para evitar errores.
  • Usa las exportaciones integradas de DynamicTable si necesitas enviar listados a otras áreas (botón “Exportar”).
  • Si gestionas grandes volúmenes, guarda búsquedas frecuentes con la opción de plantillas en la barra DSL.