Manual completo de QOSTUM

Tutoriales disponibles

Guías cortas (8–18 min) sobre funciones específicas con ejemplos concretos. Léelas en cualquier orden — no son obligatorias para usar QOSTUM, pero aceleran tu curva de aprendizaje. También accesibles desde Dashboard → Recursos.

Registro e Inicio de Sesión

Para utilizar QOSTUM es necesario crear una cuenta. Esto permite guardar tu información, acceder desde cualquier dispositivo y gestionar tu suscripción.

Crear una Cuenta Nueva

Iniciar Sesión

Inicio de Sesión con Google

QOSTUM permite iniciar sesión usando tu cuenta de Google:

1. Haz clic en "Continuar con Google"
2. Selecciona tu cuenta de Google
3. Autorice el acceso a QOSTUM

Recuperar Contraseña

Si olvidaste tu contraseña:

1. Haz clic en "¿Olvidaste tu contraseña?"
2. Ingresa tu correo electrónico
3. Revisa tu correo para el enlace de recuperación
4. Crea una nueva contraseña

Cerrar Sesión

Para cerrar sesión de manera segura:

1. Haz clic en el menú de usuario (esquina superior derecha)
2. Selecciona "Cerrar Sesión"

Introducción y Conceptos Básicos

¿Qué es QOSTUM?

QOSTUM es un software especializado en la elaboración de presupuestos. Permite crear, editar, gestionar y exportar presupuestos de manera profesional y eficiente.

Características Principales

• Gestión Multi-Presupuesto: Trabaja con múltiples presupuestos simultáneamente usando pestañas
• Estructura Jerárquica: Organiza tu presupuesto en capítulos, partidas e insumos
• Catálogo Reutilizable: Crea y mantén tu propio catálogo de insumos
• Cálculos Automáticos: Fórmulas precisas para costos, porcentajes e impuestos
• Exportación Profesional: Genera PDFs y Excel con formato profesional
• Búsqueda Avanzada: Encuentra elementos rápidamente por código o descripción
• Herramientas de Análisis: Estadísticas, cuantificación, análisis de composición de costos y verificación de presupuesto
• Gestión de Desperdicio: Registra porcentajes de desperdicio por insumo para reflejar el consumo real
• Factores Específicos: Configura porcentajes de indirectos, utilidad e impuestos diferenciados por capítulo
• Diagrama de Gantt: Genera programaciones de proyecto con Curva S y distribución por tipo de insumo

Conceptos Clave

Elementos del Presupuesto

QOSTUM organiza los presupuestos en una estructura jerárquica de tres niveles:

Tipos de Insumos

Los insumos son los recursos que componen una partida:

Componentes del Precio

QOSTUM calcula el precio final de cada elemento aplicando porcentajes configurables:

• Costo Directo: Suma del costo de todos los insumos de una partida
• Indirectos: Gastos administrativos, supervisión, campamento, oficina central, fianzas y seguros. Se pueden componer en hasta 5 factores.
• Utilidad (UT): Ganancia del contratista
• Impuestos (IMP): IVA u otros impuestos aplicables

Interfaz de Usuario

Diseño General

La interfaz de QOSTUM está diseñada para máxima eficiencia y claridad. Los elementos principales son:

1. Header con Pestañas

En la parte superior se encuentran:

• Logo QOSTUM: Enlace al dashboard
• Pestañas de presupuestos: Cambia entre presupuestos abiertos
• Botón "+": Crear nueva pestaña de presupuesto
• Menú de usuario: Acceso a documentación, suscripción y cerrar sesión

2. Información del Proyecto y Parámetros

Panel superior que contiene:

• Nombre del Proyecto: Título del presupuesto
• Moneda: Selector de moneda (GTQ, USD, MXN, etc.)
• Parámetros: Botón para configurar porcentajes
• Botones de acción: Exportar PDF y Excel

3. Barra de Estado del Archivo

Muestra información sobre el estado de guardado:

• "Guardado automáticamente": Los cambios están guardados
• "Guardando...": Se están guardando los cambios
• Fecha de última modificación: Cuándo se guardó por última vez

4. Leyenda de Tipos de Elementos

Referencia visual de colores para cada tipo de elemento:

• Verde: CAP (Capítulos)
• Azul: PAR (Partidas)
• Morado: PEX (Partidas Exentas)
• Naranja: Insumos (MAT, MDO, REN, MAQ, SUB, OTR)

5. Controles del Presupuesto (Sticky)

Barra de herramientas que permanece visible al hacer scroll:

• Buscar: Campo de búsqueda por código o descripción
• Botón Limpiar: Elimina el filtro de búsqueda
• Agregar Elemento: Agrega CAP, PAR o insumo
• Agregar del Catálogo: Inserta elementos desde el catálogo
• Editar Seleccionado: Modifica el elemento seleccionado
• Duplicar Selección: Crea una copia del elemento seleccionado
• Eliminar Seleccionado: Borra el elemento seleccionado

6. Área de Tabla Principal

Tabla del presupuesto con las siguientes columnas:

7. Panel de Totales

Panel derecho que muestra:

• Total del Presupuesto: Suma total con impuestos
• Índice: Precio por unidad de medida ($/m², $/m³, etc.)
• Desglose por Componente:
  • Costo Directo
  • Indirectos
  • Utilidad
  • Impuestos
• Desglose por Tipo de Insumo:
  • Materiales
  • Mano de Obra
  • Maquinaria

Sistema de Pestañas Multi-Presupuesto

QOSTUM permite trabajar con múltiples presupuestos simultáneamente usando un sistema de pestañas similar al de un navegador web.

Crear Nueva Pestaña

1. Haz clic en el botón "+" en la barra de pestañas
2. Se creará una nueva pestaña vacía
3. El sistema automáticamente cambia a la nueva pestaña

Cambiar entre Pestañas

Para cambiar entre presupuestos abiertos:

• Haz clic en la pestaña del presupuesto deseado
• La pestaña activa se resalta visualmente
• El contenido cambia instantáneamente

Indicadores Visuales

• Pestaña Activa: Aparece resaltada con fondo blanco
• Nombre del Presupuesto: Se muestra en la pestaña
• Botón Cerrar (×): Permite cerrar la pestaña

Cerrar Pestañas

Para cerrar un presupuesto:

1. Haz clic en el botón "×" de la pestaña
2. Si hay cambios sin guardar, el sistema te pedirá confirmación
3. Confirma para cerrar

Gestión de Memoria

El sistema maneja la memoria automáticamente:

• Cada pestaña es independiente
• Los cambios en una pestaña no afectan las demás
• El guardado automático funciona para cada pestaña por separado
• Al cerrar una pestaña, su memoria se libera

Configuración de Parámetros del Presupuesto

Acceso a Parámetros

Para acceder a la configuración de parámetros:

1. Haz clic en el botón "Parámetros" en el panel superior
2. Se abrirá un modal con los parámetros configurables

Porcentajes Configurables

Indirectos

• Descripción: Todos los costos no directamente atribuibles al proyecto: administración de campo, supervisión, campamento, oficina central, fianzas, seguros y gastos legales.
• Rango típico: 13% - 25%
• Formato: Ingresa solo el número (ej: 15 para 15%)
• Componer: con el botón "Componer" junto a la celda puedes desglosar los indirectos en hasta 5 factores, cada uno con su descripción y %. Al activar factores, el % de Indirectos pasa a ser la suma automática de ellos.

Utilidad (UT)

• Descripción: Ganancia del contratista
• Incluye: Beneficio esperado del proyecto
• Rango típico: 10% - 20%
• Formato: Ingresa solo el número (ej: 15 para 15%)

Impuestos (IMP)

• Descripción: Impuestos aplicables (IVA, etc.)
• Varía por país:
  • Guatemala: 12% (IVA)
  • México: 16% (IVA)
  • El Salvador: 13% (IVA)
  • Costa Rica: 13% (IVA)
• Formato: Ingresa solo el número (ej: 12 para 12%)

Fórmula de Cálculo Completa

Paso 1: Costo con Indirectos
C1 = Costo Directo × (1 + IND/100)

Paso 2: Costo con Utilidad
C2 = C1 × (1 + UT/100)

Paso 3: Precio Unitario (con Impuestos)
Precio Unitario = C2 × (1 + IMP/100)

FÓRMULA COMPLETA:
Precio Unitario = Costo Directo × (1 + IND/100) × (1 + UT/100) × (1 + IMP/100)

IND = Indirectos (un solo factor; puedes componerlo en varios sub-factores
      con el botón "Componer", su suma define el %).

Ejemplo Práctico

Si un elemento tiene un Costo Directo de $100.00 y los parámetros son:

• Indirectos = 18% (p. ej. 10% nominales + 8% generales, compuestos)
• UT = 15%
• IMP = 12%

Paso 1: $100.00 × (1 + 0.18) = $100.00 × 1.18 = $118.00
Paso 2: $118.00 × (1 + 0.15) = $118.00 × 1.15 = $135.70
Paso 3: $135.70 × (1 + 0.12) = $135.70 × 1.12 = $151.98

Precio Unitario Final: $151.98

Partidas Exentas (PEX)

Las partidas tipo PEX (Partida Exenta) son una excepción importante:

• NO aplican ningún porcentaje
• Precio Unitario = Costo Directo
• Útiles para subcontratos o elementos con precio cerrado

Información del Proyecto

Además de los porcentajes, puedes configurar:

• Nombre del Proyecto: Título que aparecerá en exportaciones
• Moneda: Selecciona la moneda del presupuesto
• Área: Metros cuadrados o cúbicos (para calcular índices)
• Unidad de Área: m² o m³

Creación de Estructura Jerárquica

Agregar Elementos al Presupuesto

QOSTUM utiliza una estructura de tres niveles: Capítulos → Partidas → Insumos

Paso 1: Crear Capítulos (CAP)

1. Haz clic en "Agregar Elemento"
2. Selecciona tipo "CAP - Capítulo"
3. Ingresa:
   • Código: Identificador único (ej: CAP-01)
   • Descripción: Nombre del capítulo (ej: PROYECTOS PRELIMINARES)
4. Haz clic en "Guardar"

Paso 2: Agregar Partidas (PAR o PEX)

1. Selecciona el capítulo donde agregarás la partida (haz clic en la casilla)
2. Haz clic en "Agregar Elemento"
3. Selecciona tipo:
   • "PAR - Partida" para partidas normales
   • "PEX - Partida Exenta" para partidas sin porcentajes
4. Ingresa:
   • Código: Identificador único (ej: PAR-01-01)
   • Descripción: Nombre de la partida (ej: Limpieza y Trazo)
   • Unidad: m², m³, ml, etc.
   • Cantidad: Cantidad de unidades
5. Haz clic en "Guardar"

Paso 3: Agregar Insumos

1. Selecciona la partida donde agregarás el insumo
2. Haz clic en "Agregar Elemento"
3. Selecciona el tipo de insumo:
   • MAT - Material
   • MDO - Mano de Obra
   • REN - Renta/Alquiler
   • MAQ - Maquinaria
   • SUB - Subcontrato
   • OTR - Otro
4. Ingresa:
   • Código: Código del insumo (ej: MAT-001)
   • Descripción: Nombre del insumo (ej: Cemento gris 50kg)
   • Unidad: saco, kg, hr, etc.
   • Cantidad: Consumo por unidad de partida
   • Precio Unitario: Costo por unidad del insumo
5. Haz clic en "Guardar"

Jerarquía Completa

CAPÍTULO (CAP)
├── PARTIDA (PAR o PEX)
│   ├── Material (MAT)
│   ├── Mano de Obra (MDO)
│   ├── Renta (REN)
│   ├── Maquinaria (MAQ)
│   ├── Subcontrato (SUB)
│   └── Otro (OTR)
├── PARTIDA (PAR o PEX)
│   ├── Material (MAT)
│   └── ...
└── ...

Reglas de Jerarquía

• Los insumos solo pueden agregarse dentro de partidas
• Las partidas solo pueden agregarse dentro de capítulos
• Los capítulos se agregan al nivel raíz (sin padre)
• No se puede agregar un capítulo dentro de otro capítulo
• No se puede agregar una partida dentro de otra partida

Ejemplo Práctico

Gestión del Catálogo

El catálogo es una biblioteca reutilizable de elementos (partidas e insumos) que puedes usar en múltiples presupuestos.

Abrir el Catálogo

1. Haz clic en "Agregar del Catálogo"
2. Se abrirá un modal con tu catálogo

Agregar Elementos al Catálogo

Método 1: Desde Cero

1. En el modal del catálogo, haz clic en "Agregar Nuevo"
2. Completa el formulario (igual que agregar al presupuesto)
3. Haz clic en "Guardar"

Método 2: Desde el Presupuesto (Individual)

1. Selecciona un elemento del presupuesto
2. Haz clic en "Editar Seleccionado"
3. Activa la casilla "Guardar en Catálogo"
4. Haz clic en "Guardar"

Método 3: Selección Múltiple (Recomendado)

1. Selecciona uno o más elementos del presupuesto (usando las casillas de verificación)
2. Haz clic en "Agregar a Catálogo" en la barra de herramientas
3. Si hay conflictos de códigos, aparecerá un modal de ayuda (ver sección "Agregar Elementos al Catálogo con Conflictos")
4. Los elementos sin conflictos se agregan automáticamente

Usar Elementos del Catálogo

Existen dos formas de insertar elementos desde el catálogo. En ambas, si el elemento es una partida compuesta, se inserta con su receta completa (todos sus insumos con sus cantidades):

Desde un Elemento Existente

1. En el presupuesto, haz clic en "Agregar del Catálogo" dentro de un capítulo o elemento compuesto
2. Usa la barra de búsqueda para encontrar el elemento
3. Haz clic en "+ Agregar" junto al elemento deseado
4. El elemento se insertará como subelemento del capítulo o partida desde donde se abrió el catálogo

Desde el Nivel Raíz (+ Catálogo)

Si el presupuesto está vacío o quieres insertar un elemento en el nivel principal (no dentro de un capítulo):

1. Haz clic en el botón "+ Catálogo" en la barra de controles del presupuesto (junto a "+ Capítulo")
2. Se abrirá el catálogo en modo de inserción a nivel raíz
3. Selecciona el elemento y haz clic en "+ Agregar"
4. El elemento se agregará al final del presupuesto como elemento de primer nivel

Búsqueda en el Catálogo

Puedes buscar elementos por:

• Código: Busca coincidencias en el código
• Descripción: Busca palabras en la descripción

La búsqueda es en tiempo real y no distingue mayúsculas/minúsculas.

Exportar e Importar Catálogo

Exportar Catálogo

1. En el modal del catálogo, haz clic en "Exportar Catálogo"
2. El sistema descargará un archivo .qcat, el formato de catálogo de QOSTUM (el mismo que usa Gestión de Catálogos)
3. Nombre sugerido: catalogo-qostum-[fecha].qcat

Si tu catálogo activo provenía de un archivo .qcat, la exportación preserva la moneda y las fichas de proveedores originales.

Enviar a Gestión de Catálogos

En el mismo menú donde está "Exportar Catálogo" encuentras "Enviar a Gestión de Catálogos": envía el catálogo activo directamente al módulo de Gestión de Catálogos para limpiarlo, completarlo o fusionarlo, sin tener que exportar el archivo y volver a cargarlo a mano.

Recibir desde Gestión de Catálogos

El puente también funciona en sentido contrario: si en Gestión de Catálogos usas "Enviar a Presupuestos", el catálogo llega automáticamente al abrir este módulo y verás el aviso "Catálogo recibido…". Si ya tenías un catálogo activo, QOSTUM te pregunta si quieres Reemplazarlo o Añadir el que llega. La moneda y las fichas de proveedores viajan con el catálogo.

Cargar Catálogo (Reemplazar)

Reemplaza completamente el catálogo actual con el contenido de un archivo de catálogo:

1. Ve al menú Catálogo → Cargar Catálogo
2. Selecciona un archivo .qcat (o JSON) previamente exportado
3. El catálogo anterior será sustituido por el nuevo
4. Si existen conflictos de códigos con el presupuesto abierto, el sistema te ofrecerá resolverlos:
   • Conservar Existentes: Mantiene los elementos actuales del presupuesto
   • Reemplazar con Nuevos: Sobrescribe con los del archivo
   • Renombrar Nuevos: Agrega sufijo numérico a códigos duplicados

Añadir Catálogo (Fusionar)

Combina un archivo de catálogo con el que ya tienes cargado, sin perder los elementos existentes:

1. Ve al menú Catálogo → Añadir Catálogo
2. Selecciona un archivo .qcat (o JSON)
3. El sistema agregará los elementos nuevos al catálogo existente
4. Los elementos con códigos que ya existen en el catálogo serán ignorados (sin duplicados)
5. Si no hay catálogo cargado, se comportará igual que "Cargar Catálogo"

Vaciar Catálogo

Elimina todos los elementos del catálogo cargado:

1. Ve al menú Catálogo → Vaciar Catálogo
2. Confirma la acción en el diálogo de confirmación

Ordenar Catálogo

En el modal del catálogo, puedes ordenar los elementos por:

• Por descripción: Orden alfabético A-Z
• Por código: Orden alfanumérico por código

Convertidor de Formato

Si tienes catálogos en otros formatos (Excel, CSV), puedes convertirlos al formato JSON de QOSTUM:

1. Ve al menú Catálogo → Convertidor de Formato
2. Se abrirá una herramienta dedicada en una nueva pestaña
3. Sigue las instrucciones para mapear columnas y convertir tu archivo

Editar Elementos del Catálogo

1. En el catálogo, haz clic en el elemento a editar
2. Haz clic en "Editar"
3. Modifica los campos necesarios
4. Haz clic en "Guardar"

Eliminar del Catálogo

1. Selecciona el elemento a eliminar
2. Haz clic en "Eliminar"
3. Confirma la eliminación

Mantener Catálogo (guardar el catálogo con el archivo)

Junto al campo "Catálogo Activo" en la información del proyecto hay una casilla "Mantener Catálogo", activada por defecto. Controla si el catálogo se guarda dentro del archivo del proyecto (.qstm):

• Activada: al guardar, QOSTUM incrusta en el archivo los insumos del catálogo que el presupuesto está usando. Así el catálogo viaja con el proyecto: al reabrirlo o compartirlo, los elementos y precios del catálogo están disponibles sin tener que cargarlos aparte. Los elementos compuestos del catálogo conservan su composición (receta) completa dentro del archivo: no se aplanan a una línea de precio.
• Desactivada: el archivo se guarda sin el catálogo, por lo que queda más liviano. Útil cuando administras el catálogo por separado o es muy grande. Al reabrir el proyecto deberás cargar el catálogo manualmente.

Propagación de Precios

Si actualizas el precio de un insumo en el catálogo, puedes propagar el cambio a todos los presupuestos donde aparece:

1. Edita el insumo en el catálogo
2. Cambia el precio unitario
3. Activa "Propagar precio a presupuesto"
4. Guarda los cambios
5. El sistema actualizará automáticamente todos los presupuestos abiertos

BDD QOSTUM · Catálogo maestro de materiales

Cómo se accede a la BDD

Hay dos caminos para entrar al browser de la BDD QOSTUM, ambos desde el editor de presupuestos:

1. Catálogo vacío: al hacer clic en "+ Catálogo" con tu catálogo aún sin cargar, aparece un modal con tres opciones: Cargar desde archivo, Buscar en BDD QOSTUM, o Cancelar.
2. Catálogo ya abierto: dentro del modal "Buscar en Catálogo de Elementos", aparece un botón naranja "+ BDD QOSTUM" al lado del buscador. Te permite consultar la BDD sin perder el catálogo que ya tienes.

Cómo funciona el browser

Una vez en el browser de BDD QOSTUM puedes:

• Buscar por código, nombre o palabra clave entre los 154 insumos maestros (× 16 países) y la mano de obra.
• Filtrar por categoría (15 disponibles) o por tier (1 = crítico, 2 = común, 3 = nicho).
• Elegir país para ver los precios en la moneda local. Por defecto se selecciona el país inferido de la moneda del proyecto activo.
• Insertar uno o varios materiales en tu catálogo en uso. Cada material insertado conserva su precio del país y tipo elegidos en ese momento.

Indicadores de calidad del precio

Cada precio en la BDD lleva metadatos de actualización y verificación. En el browser verás indicadores que te ayudan a saber qué tan reciente y confiable es cada dato:

• Actualizado hace X días/meses: la frescura del dato. Verde < 90 días, amarillo 90-180 días, rojo > 180 días.
• AI · sin verificar: el precio fue generado como estimación inicial automatizada y aún no ha sido validado contra fuente real (proveedor, distribuidor, catálogo oficial). Úsalos con criterio mientras avanza la verificación.

Integración con tu catálogo personal

Los materiales que insertas desde la BDD se agregan a tu catálogo en memoria. A partir de ahí funcionan exactamente igual que cualquier otro elemento de catálogo: los puedes insertar a presupuestos, modificar, exportar, o guardar dentro de tu archivo .qstm. La BDD QOSTUM no reemplaza tu catálogo personal; es una fuente desde donde alimentar tu biblioteca propia.

Sistema de Cálculos y Fórmulas

Cálculos Automáticos

QOSTUM realiza todos los cálculos automáticamente. No necesitas calculadora ni hojas de cálculo adicionales.

Cálculo de Insumos

Para cada insumo dentro de una partida:

Consumo Total = Cantidad del Insumo × Cantidad de la Partida
Costo Total = Consumo Total × Precio Unitario del Insumo

Ejemplo:

Partida: Muro de block (100 m²)

Insumo: Block 15x20x40 cm

• Cantidad del insumo: 12.5 unidades/m²
• Cantidad de partida: 100 m²
• Precio unitario: $3.50/unidad

Consumo Total = 12.5 × 100 = 1,250 unidades
Costo Total = 1,250 × $3.50 = $4,375.00

Cálculo del Costo Directo de una Partida

Costo Directo = Suma de (Costo Total de cada Insumo)

Precio Unitario (P.U.) = Costo Directo / Cantidad de la Partida

Ejemplo:

Partida: Muro de block (100 m²)

Precio Unitario = $10,725.00 / 100 m² = $107.25/m²

Cálculo del Precio Unitario

Fórmula General (para PAR - Partidas Normales):

Paso 1: Aplicar Indirectos
C1 = Costo Directo × (1 + IND/100)

Paso 2: Aplicar Utilidad
C2 = C1 × (1 + UT/100)

Paso 3: Aplicar Impuestos
Precio Unitario = C2 × (1 + IMP/100)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FÓRMULA COMPLETA:
Precio Unitario = CD × (1 + IND/100) × (1 + UT/100) × (1 + IMP/100)

Donde:
CD  = Costo Directo
IND = Indirectos (%)
UT  = Utilidad (%)
IMP = Impuestos (%)

Ejemplo Completo:

Partida: Muro de block

• Costo Directo: $107.25/m²
• Indirectos = 18% (10% nominales + 8% generales)
• UT = 15%
• IMP = 12%

Paso 1: C1 = $107.25 × (1 + 0.18)
        C1 = $107.25 × 1.18
        C1 = $126.56

Paso 2: C2 = $126.56 × (1 + 0.15)
        C2 = $126.56 × 1.15
        C2 = $145.54

Paso 3: Precio Unitario = $145.54 × (1 + 0.12)
        Precio Unitario = $145.54 × 1.12
        Precio Unitario = $163.00/m²

Partidas Exentas (PEX)

Las partidas tipo PEX tienen un cálculo especial:

Precio Unitario (PEX) = Costo Directo

NO se aplican Indirectos, Utilidad ni Impuestos

Esto es útil para:

• Subcontratos con precio cerrado
• Equipos o servicios con precio fijo
• Elementos donde el proveedor ya incluyó sus márgenes

Cálculo del Subtotal

Subtotal = Cantidad × Precio Unitario

Ejemplo:

Partida: Muro de block

• Cantidad: 100 m²
• Precio Unitario: $163.00/m²

Subtotal = 100 × $163.00 = $16,300.00

Cálculo de Capítulos

Los capítulos NO tienen costo propio. Su subtotal es la suma de las partidas que contiene:

Subtotal Capítulo = Suma de (Subtotal de cada Partida)

Total del Presupuesto

Total Presupuesto = Suma de (Subtotal de todos los Capítulos)

Cálculo del Índice

El índice es el costo por unidad de área:

Índice = Total Presupuesto / Área

Unidad: $/m² o $/m³ (según configuración)

Ejemplo:

• Total del Presupuesto: $500,000.00
• Área: 250 m²

Índice = $500,000.00 / 250 m² = $2,000.00/m²

Edición y Gestión de Cambios

Editar Elementos

Método 1: Botón Editar

1. Selecciona el elemento haciendo clic en la casilla
2. Haz clic en "Editar Seleccionado"
3. Modifica los campos necesarios en el formulario
4. Haz clic en "Guardar"

Método 2: Doble Clic

1. Haz doble clic en el elemento en la tabla
2. Se abrirá automáticamente el formulario de edición
3. Modifica y guarda

Campos Editables

Según el tipo de elemento, puedes editar:

Duplicar Elementos

Para crear una copia de un elemento:

1. Selecciona el elemento a duplicar
2. Haz clic en "Duplicar Selección"
3. El sistema creará una copia con:
   • Mismo tipo y descripción
   • Código automáticamente único (agrega sufijo numérico)
   • Misma ubicación en la jerarquía

Eliminar Elementos

Eliminar Elemento Individual

1. Selecciona el elemento a eliminar
2. Haz clic en "Eliminar Seleccionado"
3. Confirma la eliminación

Eliminar con Subelementos

Si elimina un capítulo o partida que contiene subelementos:

• El sistema mostrará una advertencia
• Indicará cuántos subelementos se eliminarán
• Debe confirmar explícitamente
• Todos los subelementos se eliminarán en cascada

Mover Elementos

Puedes reordenar elementos dentro del mismo nivel jerárquico:

Método 1: Botones Arriba/Abajo

1. Localiza el elemento en la tabla
2. Usa los botones ↑ (subir) o ↓ (bajar)
3. El elemento se moverá una posición

Limitaciones de Movimiento

• Solo puedes mover elementos dentro del mismo nivel
• No puedes mover un elemento fuera de su padre
• No puedes mover el primer elemento hacia arriba
• No puedes mover el último elemento hacia abajo

Deshacer y Rehacer

QOSTUM incluye sistema de deshacer/rehacer:

• Deshacer: Presiona Ctrl + Z
• Rehacer: Presiona Ctrl + Y

Acciones que se pueden deshacer:

• Agregar elemento
• Editar elemento
• Eliminar elemento
• Mover elemento
• Duplicar elemento

Guardar Cambios

Los cambios se guardan automáticamente:

• Guardado automático: Cada 30 segundos
• Guardado inmediato: Al cambiar de pestaña
• Guardado al salir: Al cerrar la aplicación

La barra de estado muestra el estado de guardado:

• "Guardado automáticamente": Todo está guardado
• "Guardando...": Se está guardando
• "Error al guardar": Hubo un problema (revisar conexión)

Versionado del presupuesto

El número de versión ya no se escribe a mano: el campo Versión es de solo lectura y se gestiona con el botón "Versionar" que está a su lado.

1. Haz clic en "Versionar".
2. Elige el tipo de cambio: Nueva revisión (+0.01, para cambios menores), Nueva versión mayor (+1.00) o una versión personalizada.
3. Opcionalmente escribe una nota de qué cambió.
4. Confirma. La versión se actualiza y queda registrada en el historial.

Información del proyecto e historial de versiones

En la barra de Revisión, el botón "Ver" ahora se llama "Revisar", y junto a él está "Info. del proyecto". Ese botón abre una ventana con toda la información del proyecto (nombre, cliente, ubicación, moneda, elaborado por, fecha y versión actual) y el historial de versiones (versión, fecha y nota de cada una).

Nombre del archivo

Al guardar o exportar, el archivo se nombra con el formato nombre_del_proyecto-versión-fecha (por ejemplo, Casa_Modelo-002.00-2026-06-01.qstm).

Gestión de Cantidades con Desperdicio

En los proyectos, los insumos rara vez se aprovechan al 100%. QOSTUM permite registrar un porcentaje de desperdicio sobre cualquier cantidad, de forma que el presupuesto refleje el consumo real esperado.

Concepto

El desperdicio es un porcentaje que se suma a la cantidad bruta (teórica) de un insumo para obtener la cantidad ajustada que realmente se presupuesta. La fórmula es:

Cantidad = Cantidad Bruta × (1 + % Desperdicio / 100)

Por ejemplo, si necesitas 7 sacos de cemento y el desperdicio esperado es 5%, la cantidad presupuestada será 7 × 1.05 = 7.35 sacos.

Cómo Aplicar Desperdicio

1. Haz doble clic en la celda de cantidad de cualquier insumo (subelemento) o elemento simple
2. Se abrirá un popover con dos campos:
   • Cantidad Bruta: la cantidad teórica sin desperdicio
   • % Desperdicio: el porcentaje a aplicar
3. El resultado se calcula automáticamente en la parte inferior del popover
4. Haz clic en "Aplicar" para confirmar

Indicador Visual

Cuando un elemento tiene desperdicio aplicado, su cantidad se muestra en naranja y con fuente en negrilla. Al posicionar el cursor sobre la celda, un tooltip muestra el porcentaje de desperdicio incluido.

Limpiar Desperdicio

Para quitar el desperdicio de un elemento:

• Abre el popover de cantidad (doble clic) y haz clic en "Limpiar". La cantidad volverá al valor bruto original.
• Alternativamente, edita la cantidad directamente en la celda (sin el popover). Esto reemplaza el valor y elimina automáticamente los datos de desperdicio.

Desperdicio en el Catálogo

Los datos de desperdicio se manejan de forma inteligente al interactuar con el catálogo:

• Al guardar un elemento compuesto al catálogo: El nivel principal se establece en cantidad unitaria (1) y se limpia su desperdicio, pero los subelementos (componentes de la composición) conservan su desperdicio intacto. Esto preserva la proporción real de consumo por unidad.
• Al insertar desde el catálogo al presupuesto: El elemento principal entra con cantidad 1 sin desperdicio. Los subelementos mantienen sus cantidades y desperdicios originales.
• En la vista del catálogo: Los subelementos con desperdicio se muestran con el mismo indicador naranja y tooltip informativo.

Desperdicio en el Archivo .qstm

Los datos de desperdicio (desperdicioPct y cantidadBruto) se persisten automáticamente tanto en los elementos del presupuesto como en la información del catálogo embebido dentro del archivo .qstm.

Desperdicio en el Análisis de Composición

El Análisis de Composición de Costos incluye un apartado dedicado a desperdicio cuando detecta elementos con porcentaje de desperdicio aplicado. Muestra el impacto económico del desperdicio sobre el costo directo y el precio unitario de los elementos seleccionados.

Análisis de Composición de Costos

Esta herramienta permite desglosar y visualizar cómo se compone el costo de los elementos seleccionados del presupuesto, clasificándolos por tipo de insumo.

Cómo Acceder

1. Haz clic en "Análisis de Composición" en la barra de controles del presupuesto, o desde el menú Herramientas → Análisis de Composición
2. Se abrirá un modal con un panel de selección a la izquierda y el área de resultados a la derecha

Selección de Elementos

En el panel izquierdo se listan todos los elementos del presupuesto. Puedes:

• Seleccionar todos: Usa la casilla "Seleccionar Todo" en la parte superior
• Seleccionar capítulos completos: Marca un capítulo para incluir automáticamente todos sus subelementos
• Selección individual: Expande un capítulo (haciendo clic en la flecha ▶) y selecciona partidas específicas

Resultados del Análisis

Al seleccionar elementos, el área de resultados muestra:

• Tabla de distribución por tipo: Cada tipo de insumo (MAT, MDO, MAQ, SUB, etc.) con su costo directo total, porcentaje de participación y precio unitario
• Subtítulo informativo: Indica cuántos elementos están seleccionados y su descripción (por ejemplo, "2 capítulos: Cimentación, Estructura")
• Totales: Costo directo total y subtotal al pie de la tabla

Sección de Desperdicio

Si alguno de los elementos seleccionados tiene porcentaje de desperdicio aplicado, se mostrará una sección adicional con:

• Lista de cada elemento con desperdicio: descripción, porcentaje, incremento en costo directo y en subtotal
• Porcentaje total que el desperdicio representa respecto al subtotal seleccionado

Exportar Análisis

El análisis se puede exportar en dos formatos:

• Excel (.xlsx): Genera una hoja de cálculo con la tabla de composición, los totales y la sección de desperdicio (si aplica)
• PDF: Genera un documento profesional con formato QOSTUM, incluyendo encabezado del proyecto, la tabla de distribución por tipo, la sección de desperdicio y los totales

Factores Específicos por Capítulo

Por defecto, QOSTUM aplica los mismos porcentajes de Indirectos, Utilidad e Impuestos a todo el presupuesto. Sin embargo, en proyectos complejos puede ser necesario que cada capítulo tenga sus propios factores. Los Factores Específicos permiten esto.

Cómo Acceder

1. Haz clic en el botón "Factores Específicos" en la barra de parámetros del presupuesto
2. Se abrirá un modal con la lista de capítulos de primer nivel

Configuración

El modal muestra los factores generales actuales como referencia y, debajo, cada capítulo del presupuesto con una casilla de activación:

1. Activa la casilla del capítulo para habilitarle factores personalizados
2. Modifica los porcentajes de Indirectos (con su botón Componer si quieres desglosarlos), Utilidad e Impuestos
3. Haz clic en "Guardar"

Los capítulos que no tengan factores personalizados seguirán usando los factores generales del presupuesto.

Indicador Visual

Cuando hay al menos un capítulo con factores personalizados, el botón de "Factores Específicos" en la barra de parámetros muestra un indicador visual que señala que existen factores activos.

Impacto en los Cálculos

Los factores específicos se aplican únicamente a las partidas contenidas dentro de cada capítulo personalizado. La fórmula de cálculo es la misma (CD → +CI% → +GG% → ×(1+UT%) → ×(1+IMP%)), pero con los porcentajes del capítulo en lugar de los generales.

Herramientas Avanzadas

Búsqueda y Filtrado

Búsqueda en Presupuesto

Para encontrar elementos rápidamente:

1. Usa el campo de búsqueda en la barra de controles
2. Escribe parte del código o descripción
3. La tabla se filtrará en tiempo real
4. Solo se mostrarán los elementos que coincidan

Características de la búsqueda:

• Busca en códigos y descripciones
• No distingue mayúsculas/minúsculas
• Busca coincidencias parciales
• Actualización instantánea mientras escribe

Limpiar Filtro

Para volver a ver todos los elementos:

• Haz clic en el botón "Limpiar"
• O borre el texto del campo de búsqueda

Convertidor de Moneda

Esta herramienta permite convertir todos los precios del presupuesto de una moneda a otra, aplicando una tasa de cambio definida por el usuario.

Cómo Usar

1. Ve al menú Herramientas → Convertidor de Moneda
2. El modal muestra la moneda actual del presupuesto
3. Selecciona la moneda destino en la lista desplegable
4. Ingresa la tasa de cambio (por ejemplo, si 1 USD = 17.25 MXN, ingresa 17.25)
5. Revisa la vista previa con ejemplos de conversión
6. Haz clic en "Convertir Presupuesto"

Qué se Modifica

• Todos los precios unitarios (costos de insumos) se multiplican por la tasa de cambio
• La etiqueta de moneda se actualiza en todo el presupuesto: totales, desglose, exportaciones y demás herramientas
• Los totales se recalculan automáticamente con los nuevos precios

Ajuste de Precios

Esta herramienta actualiza los precios de los insumos en masa: inflación, cambio de cotización o puesta al día anual, sin editar fila por fila.

Cómo Usar

1. Ve al menú Herramientas → Ajuste de Precios
2. Elige el alcance: la selección actual (los elementos marcados con casillas) o todo el presupuesto, con la opción de filtrar por tipo de insumo (MAT, MDO, REN, MAQ, SUB, OTR)
3. Elige el modo: porcentaje (positivo o negativo, por ejemplo +8%) o factor (por ejemplo ×1.08)
4. Revisa la vista previa: el número de insumos afectados y el total actual → total nuevo
5. Aplica el ajuste

Verificar Presupuesto

Esta herramienta analiza el presupuesto y detecta problemas:

Cómo Usar

1. Haz clic en "Verificar Presupuesto"
2. El sistema analizará toda la estructura
3. Se mostrará un modal con los resultados

Problemas que Detecta

• Códigos duplicados con diferente descripción: Mismo código usado para elementos distintos
• Códigos duplicados con diferente precio: Mismo código y descripción pero precios inconsistentes
• Partidas sin insumos: Partidas vacías (costo cero)
• Cantidades en cero: Elementos con cantidad = 0
• Precios en cero: Insumos sin precio asignado
• Unidades faltantes: Elementos sin unidad de medida
• Descripciones vacías: Elementos sin descripción

Interpretación de Resultados

El modal muestra:

• Errores críticos: Marcados en rojo, deben corregirse
• Advertencias: Marcadas en amarillo, revisar si es intencional
• Información: Marcadas en azul, solo informativas

Prevención Automática de Conflictos de Códigos

QOSTUM incluye un sistema inteligente que previene conflictos de códigos mientras edita:

Cómo Funciona

Al editar el código de un elemento:

1. Si escribe un código que ya existe en el presupuesto, el sistema lo detecta inmediatamente
2. Si el código existe con una descripción diferente, aparece un modal de ayuda
3. El sistema te sugiere automáticamente el siguiente código disponible
4. Puedes aceptar la sugerencia o cancelar

Ejemplo de Uso

Casos Especiales

• Reutilización de catálogo: Si el código existe con la MISMA descripción, el sistema lo permite (es uso correcto de catálogo)
• Conflicto real: Si el código existe con DIFERENTE descripción, muestra el modal con sugerencia
• Código nuevo: Si el código no existe, se asigna directamente

Opciones en el Modal de Conflicto

Cuando aparece el modal de conflicto, tienes tres opciones:

• Usar código sugerido: Acepta el código alternativo generado automáticamente
• Cancelar: Mantiene el código anterior sin cambios
• Cerrar [×]: Cierra el modal y mantiene el código anterior

Agregar Elementos al Catálogo con Conflictos

Al agregar múltiples elementos seleccionados al catálogo, pueden aparecer conflictos:

Modal de Conflicto Mejorado

Cuando un elemento tiene un código que ya existe en el catálogo con diferente descripción:

• Se muestra un modal con información clara del conflicto
• Incluye un mensaje de recomendación para verificar el presupuesto primero
• Tiene un botón de cerrar [×] en la esquina superior derecha
• Permite salir del proceso en cualquier momento

Opciones Disponibles

• Reemplazar el elemento existente: Actualiza el elemento en el catálogo con la nueva versión
• Usar código alternativo: Agrega el nuevo elemento con un código diferente (sugerido automáticamente)
• Cancelar: No agrega este elemento al catálogo
• Cerrar [×]: Sale del proceso de agregar al catálogo

Estadísticas del Presupuesto

Análisis detallado de la composición del presupuesto:

Cómo Acceder

1. Haz clic en "Estadísticas" (menú o panel)
2. Se abrirá un modal con gráficos y tablas

Información que Muestra

• Distribución por tipo de insumo: Porcentaje de materiales, mano de obra, maquinaria, etc.
• Top 10 insumos más costosos: Los insumos que más impactan el presupuesto
• Distribución por capítulo: Cuánto representa cada capítulo del total
• Resumen de cantidades: Total de elementos por tipo

Gráficos Disponibles

• Gráfico de pastel: Distribución de insumos
• Gráfico de barras: Top insumos
• Tabla comparativa: Capítulos

Cuantificación de Insumos

Reporte consolidado de todos los insumos del presupuesto:

Cómo Usar

1. Haz clic en "Cuantificación"
2. Se abrirá un modal con la lista consolidada

Información que Muestra

Filtro por Alcance (Capítulos / Partidas)

El selector "Alcance" al inicio de la barra de controles te permite cuantificar solo una parte del presupuesto en lugar de todo. Útil cuando quieres saber, por ejemplo, cuánto cemento necesitas solo para la cimentación, o qué jornales corresponden a un capítulo específico.

1. Haz clic en el botón "Alcance: Todo el presupuesto ▼"
2. Se abre un panel con todos los capítulos y partidas del presupuesto, indentados según su jerarquía
3. Desmarca "Todo el presupuesto" para activar la selección manual
4. Marca los capítulos o partidas que quieras incluir. Si marcas un capítulo, todas sus partidas y sub-partidas se incluyen automáticamente
5. El botón cambia a color naranja indicando que hay un filtro activo (por ejemplo, "2 cap. seleccionados")
6. La cuantificación se actualiza al instante al marcar o desmarcar

Para regresar a cuantificar todo el presupuesto, vuelve a marcar "Todo el presupuesto".

Filtro por Tipo de Insumo

Adicionalmente puedes filtrar por tipo de insumo. Los filtros son multi-selección: puedes activar varios a la vez para ver, por ejemplo, solo Materiales y Mano de Obra simultáneamente:

• Todos: Muestra todas las categorías
• Materiales (MAT)
• Mano de Obra (MDO)
• Renta (REN)
• Maquinaria (MAQ)
• Subcontratos (SUB)
• Otros (OTR)

Cuando seleccionas múltiples filtros, cada tipo aparece en una sección separada con su propio encabezado. El filtro de Alcance y el de Tipo se combinan: ves los insumos del alcance seleccionado, restringidos a los tipos seleccionados.

Redondear hacia arriba

La casilla "Redondear hacia arriba" aplica un redondeo al entero superior en todas las cantidades. Por ejemplo, 0.75 galones se muestra como 1.00 galón. Esto es útil para cotizaciones donde no se puede comprar una fracción de unidad.

Exportar a Excel

La exportación a Excel desde la cuantificación respeta los filtros activos: solo se exportan los tipos de insumo que estén visibles en pantalla. El archivo incluye:

• Encabezado con nombre del proyecto, fecha, filtros aplicados y estado de redondeo
• Cada tipo de insumo en una sección separada con formato de colores
• Cantidades redondeadas si la casilla está activa

Utilidad

La cuantificación es útil para:

• Hacer pedidos de materiales para todo el proyecto o solo una etapa específica
• Programar mano de obra por capítulo o por partida
• Identificar insumos críticos
• Detectar duplicados o errores en códigos
• Generar listados de compras parciales (por ejemplo, solo lo que se necesita esta semana o este mes)

Lista de Compra

Genera el pedido consolidado del presupuesto en un solo paso, listo para enviar a proveedores:

1. Ve al menú Herramientas → Lista de Compra
2. QOSTUM consolida todos los insumos del presupuesto por código + descripción + unidad
3. La cantidad de cada insumo es la cantidad efectiva: su cantidad multiplicada por la cantidad de la partida que lo contiene (de forma recursiva en toda la jerarquía)
4. Los insumos se agrupan por tipo, con subtotales por grupo y un total general

Desde el modal puedes usar Exportar Excel o Imprimir.

Comentarios en Elementos

Puedes agregar una nota o comentario a cualquier línea del presupuesto (capítulo, partida o insumo). Hay dos formas, complementarias:

• Rápida (recomendada): haz doble clic sobre la descripción de la línea. Se abre un editor pequeño y enfocado donde puedes ver, escribir, editar o eliminar el comentario de esa línea, y nada más. Es la vía ágil para comentar mientras trabajas.
• Gestión completa: menú Herramientas → Comentarios, con buscador y la lista de todos los comentarios del presupuesto, para verlos, editarlos y eliminarlos en un solo lugar.

Ambas vías escriben en el mismo comentario, así que son consistentes entre sí.

Los comentarios son útiles para: notas sobre precios a verificar, recordatorios de cambios pendientes, aclaraciones sobre especificaciones y observaciones para el equipo.

Fusionar Elementos

Cuando tienes elementos duplicados (la misma descripción con códigos distintos) puedes consolidarlos:

1. Ve al menú Herramientas → Fusionar Elementos
2. El sistema agrupa los elementos por descripción y tipo. No mezcla partidas (compuestas) con insumos (simples) aunque compartan nombre, porque son cosas distintas.
3. Revisa cada grupo y pulsa Fusionar. Si los elementos del grupo tienen costos distintos, podrás elegir cuál costo conservar; luego se unifican el código y el costo en todos.

Selección Especial

Permite realizar selecciones avanzadas de múltiples elementos:

1. Haz clic en el botón "Selección Especial" en los controles del presupuesto
2. Elige el tipo de selección:
   • Seleccionar Todo: Marca todos los elementos
   • Selección Inversa: Invierte la selección actual
   • Por Nivel: Selecciona todos los elementos de un nivel jerárquico específico
   • Todos los Capítulos: Selecciona únicamente los capítulos
   • Fuera de Capítulos: Selecciona elementos que no están dentro de ningún capítulo
   • Deseleccionar Todo: Quita toda la selección

Mover Selección

Cuando tienes múltiples elementos seleccionados, puedes moverlos a un destino específico:

1. Selecciona los elementos que quieres mover (usa Selección Especial o selección manual)
2. Haz clic en "Mover Selección"
3. Elige el destino en el modal que aparece
4. Confirma el movimiento

Expandir y Contraer Todo

Para navegar más rápido en presupuestos grandes:

• Desplegar Todo: Expande todos los capítulos y partidas, mostrando toda la jerarquía
• Contraer Todo: Colapsa todos los capítulos, mostrando solo los elementos de nivel superior

Ambos botones se encuentran en los controles del presupuesto (barra sticky).

Exportación de Datos

QOSTUM permite exportar presupuestos en múltiples formatos profesionales.

Si tu navegador bloquea las ventanas emergentes, permítelas para QOSTUM: exportar e imprimir abren una ventana nueva y el bloqueo impide generar el documento.

Vista Preliminar y opciones

Antes de exportar, la Vista Preliminar te deja ajustar qué se muestra con selectores y casillas: niveles a mostrar, modo de precios (costos / lista / ambos), Detalle de Costos, Tipo, Estadísticas y Comentarios.

La casilla Comentarios está desactivada por defecto; al activarla, el comentario de cada línea aparece debajo de la descripción en letra menor y gris. Lo que ves en la Vista Preliminar es lo que se exporta: la opción afecta por igual a PDF, Word y Excel.

Exportar a PDF Profesional

Genera un documento PDF listo para presentar a clientes:

Cómo Exportar

1. Haz clic en "Exportar PDF para Cliente"
2. El sistema generará el documento
3. Se descargará automáticamente

Contenido del PDF

El PDF profesional incluye:

• Portada: Logo QOSTUM, nombre del proyecto, fecha
• Información General:
  • Nombre del proyecto
  • Fecha de elaboración
  • Moneda utilizada
  • Área e índice
• Resumen Ejecutivo:
  • Total del presupuesto
  • Desglose por componente (CI, GG, UT, IMP)
  • Desglose por tipo de insumo
• Presupuesto Detallado:
  • Estructura completa por capítulos y partidas
  • Cantidades, unidades, precios unitarios
  • Subtotales por partida y capítulo
• Totales Finales: Total general con y sin impuestos

Características del PDF

• Formato profesional con tabla de datos
• Colores corporativos de QOSTUM
• Numeración de páginas
• Totales en cada página
• Fácil de imprimir

Exportar a Excel

Genera una hoja de cálculo para análisis adicional:

Cómo Exportar

1. Haz clic en "Descargar en Excel"
2. El archivo .xlsx se descargará automáticamente

Contenido del Excel

El archivo Excel incluye múltiples hojas:

Hoja 1: Presupuesto

• Estructura jerárquica completa
• Todas las columnas del presupuesto
• Formato condicional para tipos de elementos
• Fórmulas para subtotales

Hoja 2: Resumen

• Información del proyecto
• Parámetros configurados
• Totales generales
• Desglose de componentes

Hoja 3: Cuantificación

• Lista consolidada de insumos
• Cantidades totales por insumo
• Importes calculados

Ventajas del Excel

• Compatible con Microsoft Excel y LibreOffice
• Permite análisis personalizados
• Puede importarse a otros sistemas
• Útil para presentaciones y reportes

Exportar Precios Unitarios en Word

Genera un documento Word (.docx) con los precios unitarios del presupuesto:

1. Ve al menú Archivos → Exportar en Word
2. El archivo .docx se descargará automáticamente

Este formato es ideal para compartir listados de precios editables con clientes o proveedores.

Exportar a Gantt

Genera un diagrama de Gantt interactivo basado en la estructura de tu presupuesto:

1. Ve al menú Archivos → Exportar a Gantt
2. Se abrirá una vista interactiva del diagrama de Gantt en una nueva pestaña
3. Puedes ajustar duraciones, dependencias y fechas de inicio para cada actividad

El Gantt incluye las siguientes herramientas:

• Curva S: Gráfico acumulado del avance programado vs. el tiempo, con controles de zoom (+/−) para ajustar la visualización en proyectos largos. Al posicionar el cursor sobre el gráfico, líneas de referencia (crosshair) ayudan a leer los valores exactos.
• Programación por Tipo: Tabla de distribución del presupuesto por tipo de insumo a lo largo del tiempo
• Escalas de Tiempo: Puedes alternar entre vista semanal, quincenal, mensual, bimestral, trimestral, semestral y anual
• Vista General: Resumen consolidado del proyecto (accesible desde el menú Herramientas)
• Total del Presupuesto: Visible en la barra de estado inferior (footer)

Exportar Cuantificación a Excel

Exporta la cuantificación consolidada de insumos a una hoja de cálculo:

1. Abre la Cuantificación (menú Herramientas → Cuantificación)
2. Haz clic en el botón "Descargar Excel"
3. Se generará un archivo .xlsx con la lista completa de insumos consolidados

Exportar Catálogo

Guarda tu catálogo de insumos:

1. Abre el catálogo
2. Haz clic en "Exportar Catálogo"
3. Se descargará un archivo .qcat (si el catálogo venía de un .qcat, conserva su moneda y proveedores)

Uso del Archivo .qcat

• Respaldo de tu catálogo
• Compartir con otros usuarios de QOSTUM
• Importar en otra cuenta
• Migrar entre dispositivos
• Abrirlo y depurarlo en el módulo de Gestión de Catálogos (o envíalo directo con "Enviar a Gestión de Catálogos", sin descargar nada)

Nombres de Archivo

Los archivos exportados usan nomenclatura automática:

Puedes renombrar los archivos después de descargarlos si quieres.

Vistas Especializadas

QOSTUM ofrece vistas alternativas para analizar tu presupuesto desde distintas perspectivas. Todas se encuentran en el menú Herramientas.

Explorador de Presupuesto

Visualización tipo treemap que muestra la proporción de cada elemento respecto al total:

1. Ve al menú Herramientas → Explorador de Presupuesto
2. Se abrirá una nueva pestaña con el mapa de rectángulos
3. Cada rectángulo representa un capítulo o partida, y su tamaño es proporcional a su costo
4. Haz clic en un capítulo para navegar dentro de él

Funciones disponibles en el Explorador:

• Botón $: Muestra u oculta los valores monetarios sobre cada rectángulo
• Copiar: Copia la vista actual como imagen al portapapeles
• PDF: Descarga la vista como documento PDF

Vista de Árbol

Muestra la estructura jerárquica completa del presupuesto en formato de árbol expandible:

1. Ve al menú Herramientas → Vista de Árbol
2. Se abrirá una nueva pestaña con la estructura en formato de árbol
3. Expanda o contraiga ramas para navegar la jerarquía

Funciones disponibles:

• Copiar: Copia la vista como imagen al portapapeles
• PDF: Descarga la vista como documento PDF

Gráficos

Visualización gráfica de la distribución del presupuesto:

1. Ve al menú Herramientas → Gráficos
2. Se mostrará un modal con varios tipos de gráficos

Gráficos disponibles:

• Distribución por tipo de insumo (pastel)
• Distribución por capítulo (barras)
• Top 10 insumos más costosos (barras horizontales)
• Top 10 materiales más costosos (barras horizontales)
• Composición del precio (apilado)

Cada gráfico incluye un botón para descargarlo como imagen PNG.

Gestión de Archivos

Funciones para gestionar presupuestos desde el menú Archivos.

Nuevo Presupuesto

Crea un presupuesto en blanco:

1. Ve al menú Archivos → Nuevo Presupuesto (o usa Ctrl+N)
2. Si tienes cambios sin guardar, el sistema te preguntará si quieres guardarlos
3. Se creará un presupuesto vacío listo para trabajar

Restaurar Sesión Anterior

Si perdiste tu trabajo o cerraste el navegador por accidente, puedes recuperar la última sesión guardada automáticamente:

1. Ve al menú Archivos → Restaurar Sesión Anterior
2. El sistema recuperará el presupuesto de tu última sesión activa

Administración de Cuenta y Suscripción

Acceder al Dashboard

Para gestionar tu cuenta y suscripción:

1. Haz clic en el menú de usuario (esquina superior derecha)
2. Selecciona "Ir al Dashboard"
3. O haz clic en el logo QOSTUM

Planes de Suscripción

QOSTUM ofrece dos planes de pago:

Ambos planes incluyen:

• Presupuestos ilimitados
• Catálogo sin límite de elementos
• Exportación a PDF y Excel
• Guardado automático en la nube
• Acceso desde cualquier dispositivo
• Soporte técnico
• Actualizaciones automáticas

Prueba Gratuita

Al crear una cuenta nueva:

• Obtienes 14 días de prueba gratuita
• Acceso completo a todas las funcionalidades
• No se requiere tarjeta de crédito
• Puedes cancelar en cualquier momento

Administrar Suscripción

Cambiar de Plan

1. Ve al Dashboard
2. Haz clic en "Administrar Suscripción"
3. Selecciona la pestaña "Cambiar Plan"
4. Elige el plan deseado
5. Completa el proceso de pago

Renovar Suscripción

Las suscripciones se renuevan automáticamente:

• Plan Mensual: Se renueva cada mes
• Plan Anual: Se renueva cada año
• El cobro se realiza automáticamente con el método de pago guardado
• Recibirás un correo de confirmación después de cada renovación

Cancelar Suscripción

Si quieres cancelar:

1. Ve a "Administrar Suscripción"
2. Haz clic en "Cancelar Suscripción"
3. Confirma la cancelación
4. Podrás seguir usando QOSTUM hasta el final del período pagado
5. Tus datos se conservarán por 90 días

Métodos de Pago

QOSTUM acepta los siguientes métodos de pago:

• Tarjetas de crédito (Visa, Mastercard)
• Tarjetas de débito
• Procesamiento seguro a través de Recurrente

Actualizar Método de Pago

1. Ve a "Administrar Suscripción"
2. Selecciona pestaña "Método de Pago"
3. Haz clic en "Cambiar Tarjeta"
4. Ingresa la información de la nueva tarjeta
5. Guarda los cambios

Facturación

Accede a tu historial de facturas:

1. Ve a "Administrar Suscripción"
2. Selecciona pestaña "Facturación"
3. Verás el historial completo de pagos
4. Puedes descargar facturas en PDF

Actualizar Información Personal

Para cambiar tus datos de contacto:

1. Ve al Dashboard
2. Haz clic en "Editar Perfil"
3. Actualiza:
   • Nombre
   • Correo electrónico
   • Teléfono
   • País
4. Guarda los cambios

Consejos y Mejores Prácticas

Organización del Presupuesto

Nomenclatura de Códigos

Usa un sistema consistente de códigos:

Ejemplo recomendado:
CAP-01          (Capítulo 1)
  PAR-01-01     (Partida 1 del Capítulo 1)
    MAT-001     (Material 1)
    MDO-001     (Mano de obra 1)
  PAR-01-02     (Partida 2 del Capítulo 1)
CAP-02          (Capítulo 2)
  PAR-02-01     (Partida 1 del Capítulo 2)

Beneficios:

• Fácil identificación visual
• Ordenamiento lógico
• Búsqueda más eficiente
• Profesionalismo en reportes

Estructura de Capítulos

Organice los capítulos según el flujo constructivo:

1. Proyectos Preliminares
2. Excavación y Terracería
3. Cimentación
4. Estructura
5. Muros y Divisiones
6. Instalaciones
7. Acabados
8. Proyectos Exteriores
9. Limpieza Final

Uso del Catálogo

Construye un Catálogo Robusto

• Agrega insumos comunes al catálogo
• Mantén precios actualizados
• Usa descripciones claras y completas
• Incluye especificaciones técnicas

Categorización

Agrupa insumos similares con prefijos:

• MAT-CEM-001: Cemento gris 50kg
• MAT-CEM-002: Cemento blanco 50kg
• MAT-BLO-001: Block 15x20x40 cm
• MAT-BLO-002: Block 10x20x40 cm

Actualización de Precios

Mantén tus catálogos actualizados:

• Revisa precios mensualmente
• Usa la función de propagación de precios
• Conserva versiones antiguas del catálogo como respaldo
• Documenta la fecha de última actualización

Precisión de Cálculos

Cantidades

• Usa cantidades con 2-4 decimales según la precisión requerida
• Materiales a granel: 2 decimales (12.50 m³)
• Piezas exactas: sin decimales (150 unidades)
• Rendimientos: 4 decimales (0.0125 hr/m²)

Precios

• Incluye todos los costos: transporte, mermas, desperdicios
• Actualiza precios antes de presentar presupuestos importantes
• Verifica precios de insumos críticos
• Considera variaciones estacionales

Parámetros

Configura parámetros realistas:

Trabajo Colaborativo

Compartir Presupuestos

• Exporta a PDF para clientes
• Exporta a Excel para ingenieros y estimadores
• Comparte catálogos JSON con tu equipo

Respaldos

Mantén respaldos regulares:

• Exporta presupuestos importantes cada semana
• Guarda archivos en la nube (Google Drive, Dropbox)
• Conserva versiones anteriores con fecha
• Exporta catálogos mensualmente

Optimización del Trabajo

Atajos de Teclado

Superíndices y Subíndices en Descripciones

QOSTUM soporta caracteres Unicode de superíndice y subíndice que puedes usar directamente en las descripciones, unidades y cualquier campo de texto. Estos caracteres se exportan correctamente a PDF, Word y Excel.

Superíndices — útiles para unidades de medida, fórmulas y notaciones técnicas:

Subíndices — útiles para fórmulas químicas y nomenclatura técnica:

Cómo escribirlos:

Flujo de Trabajo Recomendado

Resolución de Problemas

Problemas Comunes

No se guardan los cambios

Síntomas: La barra de estado muestra "Error al guardar"

Soluciones:

• Verifica tu conexión a Internet
• Refresca la página (F5)
• Inicia sesión nuevamente
• Si persiste, contacta a soporte

Los totales no calculan correctamente

Posibles causas:

• Cantidades o precios en cero
• Parámetros mal configurados
• Elementos tipo PEX (no aplican porcentajes)

Soluciones:

• Ejecuta "Verificar Presupuesto"
• Revisa parámetros (Indirectos, Utilidad, Impuestos)
• Verifica tipo de elemento (PAR vs PEX)
• Recarga la página

No puedo agregar elementos

Causas comunes:

• Código duplicado
• Jerarquía incorrecta (ej: agregar insumo sin seleccionar partida)
• Campos requeridos vacíos

Soluciones:

• Verifica que el código sea único
• Selecciona el elemento padre correcto
• Completa todos los campos marcados con *

El PDF o Excel no se descarga

Soluciones:

• Verifica que tu navegador permita descargas
• Revisa la carpeta de descargas
• Desactiva bloqueadores de pop-ups
• Intenta con otro navegador
• Revisa que el presupuesto no esté vacío

Perdí mi contraseña

Solución:

1. En la pantalla de login, haz clic en "¿Olvidaste tu contraseña?"
2. Ingresa tu correo electrónico
3. Revisa tu correo (también carpeta de spam)
4. Sigue el enlace para restablecer contraseña

No puedo importar catálogo

Causas:

• Archivo JSON corrupto o formato incorrecto
• Archivo demasiado grande
• Muchos conflictos de códigos

Soluciones:

• Verifica que sea un archivo JSON válido
• Abre el archivo en un editor de texto para verificar formato
• Exporta catálogo desde QOSTUM y reimporte
• Resuelva conflictos de códigos

Problemas de Rendimiento

La aplicación está lenta

Causas comunes:

• Presupuesto muy grande (>1000 elementos)
• Muchas pestañas abiertas
• Navegador con muchas extensiones
• Memoria RAM insuficiente

Soluciones:

• Cierra pestañas que no estés usando
• Divide presupuestos grandes en especialidades
• Cierra otras aplicaciones
• Usa modo incógnito (sin extensiones)
• Actualiza tu navegador

Compatibilidad de Navegadores

Navegadores Recomendados

Soporte Técnico

Antes de Contactar Soporte

Intenta estos pasos:

1. Refresca la página (F5)
2. Limpia caché del navegador
3. Intenta en modo incógnito
4. Verifica tu conexión a Internet
5. Revisa este manual

Información para Reportar Problemas

Cuando contactes a soporte, incluye:

• Descripción detallada del problema
• Pasos para reproducir el error
• Navegador y versión que usa
• Capturas de pantalla si es posible
• Mensajes de error exactos
• Hora y fecha cuando ocurrió

Canales de Soporte

• Email: hola@qostum.com

Actualizaciones del Sistema

QOSTUM se actualiza automáticamente:

• No requiere instalación manual
• Las actualizaciones se cargan al refrescar
• Siempre tendrás la versión más reciente
• Nuevas funcionalidades se agregan regularmente

Notas de Versión

Consulta las notas de versión en qostum.com/changelog para conocer:

• Nuevas funcionalidades
• Mejoras de rendimiento
• Correcciones de errores
• Cambios en la interfaz

Atajos de Teclado

Ayuda Adicional

Si necesitas más ayuda:

• Revisa los tutoriales en video: youtube.com/@qostum
• Visita la sección de preguntas frecuentes en qostum.com/faq
• Únete a la comunidad de usuarios
• Contacta al equipo de soporte

Inicio Rápido

Crea tu primera programación de proyecto en cinco pasos: importa el presupuesto, configura la jornada, ajusta duraciones, define dependencias y exporta.

Introducción y Conceptos Básicos

El módulo de Programación transforma un presupuesto de QOSTUM en un cronograma visual con tareas, dependencias y distribución de costos en el tiempo.

¿Qué es la Programación de Proyecto?

El módulo de Programación de QOSTUM permite crear diagramas de Gantt profesionales a partir de un presupuesto de proyecto. Transforma la estructura de costos en un cronograma visual que muestra cuándo se ejecutará cada actividad, sus dependencias y la distribución de costos en el tiempo.

Características Principales

• Importación desde Presupuesto: carga un archivo de presupuesto QOSTUM (.json) y conviértelo automáticamente en un diagrama de Gantt
• Diagrama de Gantt Interactivo: visualiza tareas, duraciones y dependencias en una línea de tiempo
• Estructura WBS: numeración jerárquica automática (EDT - Estructura de Desglose de Trabajo)
• Ruta Crítica (CPM): identifica las tareas que determinan la duración total del proyecto
• Programación Financiera: distribución del costo del proyecto por período (día, semana o mes)
• Hitos: marca eventos clave del proyecto con duración cero
• Vista General: panorámica completa del proyecto con navegación rápida
• Exportación: genera PDFs del diagrama y exporta la programación financiera a Excel

Estructura WBS (EDT)

La WBS (Work Breakdown Structure), conocida en español como EDT (Estructura de Desglose de Trabajo), organiza las tareas del proyecto en una jerarquía numérica. Cada tarea recibe un código único que refleja su posición dentro de la estructura:

Tipos de Tareas

Días Hábiles vs Días Calendario

La programación trabaja exclusivamente con días hábiles. Configuras qué días de la semana son laborables (lunes a viernes, lunes a sábado, etc.) y el sistema calcula automáticamente las fechas de inicio y fin excluyendo los días no laborables. Además de la jornada semanal, puedes registrar los feriados del proyecto (manuales o por país), que tampoco cuentan como días hábiles (ver "Feriados por País" en el capítulo de importación).

Relación con el Presupuesto

El módulo de Programación se alimenta del módulo de Presupuestos. Al importar un presupuesto, el sistema:

• Convierte capítulos en tareas resumen
• Convierte partidas en tareas hoja con el costo del presupuesto
• Preserva la moneda, el nombre del proyecto y la estructura jerárquica

Interfaz de Usuario

La pantalla se divide en barra de menú, barra de herramientas, panel de tareas a la izquierda, diagrama de Gantt a la derecha y barra de estado inferior.

Diseño General

La interfaz se divide en áreas funcionales diseñadas para ofrecer máxima eficiencia al programar proyectos. De arriba hacia abajo: barra de menú, barra de herramientas, panel de tareas (izquierda) + diagrama de Gantt (derecha), y barra de estado inferior.

1. Barra de Menú Superior

Contiene los menús principales del sistema:

• Archivo: importar presupuesto, abrir/guardar programaciones y exportar PDF del diagrama
• Herramientas: expandir/contraer tareas, agregar tareas manuales e hitos, eliminar tareas, ir a la fecha de hoy y acceder a la Programación del Proyecto
• Manual: acceso a esta guía de uso
• Dashboard: volver al panel principal de QOSTUM
• Botón Guardar: botón verde en la esquina derecha. Guarda la programación actual en un archivo JSON

2. Barra de Herramientas

Barra interactiva debajo del menú con los controles de uso más frecuente:

3. Panel Lateral de Tareas (Tabla)

Tabla a la izquierda que muestra la lista completa de tareas. Las columnas disponibles son:

4. Área del Diagrama de Gantt

Zona principal a la derecha que muestra la representación gráfica de la programación:

• Encabezados de tiempo: muestran las fechas según el nivel de zoom seleccionado
• Barras de tareas: representan la duración de cada actividad; su ancho es proporcional al tiempo
• Flechas de dependencia: conectan el fin de la predecesora con el inicio de la sucesora
• Línea de hoy: indicador vertical de la fecha actual (si está dentro del rango visible)
• Hitos: representados como rombos (◊) en la fecha correspondiente

5. Separador Redimensionable

Arrastra el borde derecho del encabezado "Nombre" para ajustar el ancho de la columna de nombres y, con ello, la proporción entre la tabla de tareas y el diagrama de Gantt.

6. Información Emergente (Tooltip)

Al posicionar el cursor sobre una barra de tarea en el diagrama, se muestra un tooltip con información detallada:

• Nombre y código WBS de la tarea
• Fechas de inicio y fin
• Duración en días hábiles
• Costo asignado
• Indicador de si pertenece a la ruta crítica

7. Barra de Estado Inferior

Muestra información resumida del proyecto en todo momento:

• Tareas: número total (tareas hoja + tareas resumen)
• Duración total: días hábiles del proyecto completo
• Inicio: fecha de inicio del proyecto
• Fin: fecha de finalización calculada
• Ruta Crítica: cantidad de tareas críticas (solo visible cuando la ruta crítica está activa)

Importar un Presupuesto

La forma principal de crear una programación es importando un presupuesto de QOSTUM. Esto convierte automáticamente la estructura de costos en tareas del Gantt.

Importar un presupuesto convierte automáticamente la estructura de costos en tareas del diagrama de Gantt, preservando la jerarquía, moneda y costos.

Pasos para Importar

Nombre del Proyecto

Se toma automáticamente del presupuesto. Puedes modificarlo antes de importar. Este nombre aparecerá en las exportaciones a PDF y en la barra de estado.

Fecha de Inicio

Selecciona la fecha en que iniciará el proyecto. Todas las tareas sin predecesoras se programarán a partir de esta fecha. Asegúrate de seleccionar un día hábil según la jornada configurada.

Jornada Laboral

Selecciona los días de trabajo de la semana:

Feriados por País

En la misma configuración de días laborales administras la lista de feriados del proyecto:

• Alta manual: agrega cualquier día no laborable con su fecha y una descripción
• Carga 1-clic por país: carga los feriados nacionales 2026–2027 de 16 países (Guatemala, México, Honduras, Nicaragua, Costa Rica, Panamá, República Dominicana, Colombia, Perú, Bolivia, Chile, Argentina, Paraguay, Uruguay, Ecuador y El Salvador) y quita los que no apliquen a tu proyecto

Los feriados no cuentan como días hábiles: el cronograma los sombrea igual que los fines de semana, se guardan con el proyecto y, al agregarlos o quitarlos, las fechas se recalculan automáticamente.

Profundidad de Importación

Controla hasta qué nivel de la jerarquía se importarán los elementos (1 a 5 niveles):

• Nivel 1: solo capítulos (pocas tareas, visión macro)
• Nivel 2: capítulos y partidas (recomendado para programación general)
• Nivel 3+: incluye sub-partidas e insumos (muy detallado, solo para proyectos pequeños)

Duración por Defecto

Asigna una duración inicial (en días hábiles) a todas las tareas hoja. Este valor es un punto de partida; ajusta cada tarea después según la estimación real.

Resultado de la Importación

Después de importar, el sistema automáticamente:

• Crea la estructura WBS basada en la jerarquía del presupuesto
• Asigna las duraciones por defecto configuradas
• Calcula fechas de inicio y fin para cada tarea
• Genera el diagrama de Gantt
• Muestra el costo total del proyecto en la barra de herramientas

Actualizar desde el Presupuesto sin Perder la Programación

Si llega un presupuesto (con el botón "Enviar a Programación" de Presupuestos o al importar el archivo) y ya tienes un proyecto cargado, QOSTUM te deja elegir entre dos caminos:

• Reemplazar todo: descarta la programación actual y crea el proyecto de cero, como una importación normal.
• Actualizar conservando programación: fusiona el presupuesto nuevo con tu cronograma:
  • Las partidas emparejadas conservan fechas, duración, dependencias y avance; se actualizan sus costos y descripciones
  • Las partidas nuevas entran al final de su capítulo con una insignia ámbar "Nueva", que desaparece cuando las programas
  • Las que ya no están en el presupuesto no se borran: quedan marcadas con la insignia "Ya no está en el presupuesto" para que tú decidas si conservarlas o eliminarlas

Al terminar, QOSTUM muestra un resumen del cambio (X actualizadas / Y nuevas / Z retiradas). Tus líneas base se conservan; si no tenías ninguna, se congela automáticamente una línea base 0 con el estado previo al cambio, para que siempre puedas comparar.

Ejemplo: Importar un Edificio Residencial

Supón que tienes un presupuesto con esta estructura:

Al importar con profundidad 2, fecha 03/Mar/2026 y 10 días por defecto, se obtiene:

Nota que todas las tareas inician el mismo día porque aún no se han definido dependencias. El siguiente paso es establecer la secuencia constructiva correcta.

Gestión de Tareas

Selecciona, edita nombres, duraciones y predecesoras, agrega tareas manuales e hitos, elimina tareas y controla la expansión jerárquica.

Seleccionar una Tarea

Haz clic en cualquier fila de la tabla de tareas para seleccionarla. La tarea seleccionada se resaltará visualmente tanto en la tabla como en el diagrama de Gantt, facilitando su identificación.

Editar el Nombre de una Tarea

1. Haz clic derecho sobre la tarea en la tabla
2. Selecciona "Editar nombre" en el menú contextual
3. Modifica el texto directamente en la celda
4. Pulsa Enter para confirmar o Escape para cancelar y restaurar el nombre original

Editar la Duración

1. Haz clic en la celda de Duración de una tarea hoja
2. Ingresa el nuevo valor en días hábiles
3. Pulsa Enter para confirmar

El sistema recalculará automáticamente la fecha de fin de la tarea, la duración de sus tareas resumen (padres), y las fechas de todas las tareas que dependan de ella directa o indirectamente.

Calcular la duración por rendimiento

En vez de teclear los días a mano, puedes derivar la duración de una tarea a partir de su cantidad de proyecto y el rendimiento de la cuadrilla. Haz clic derecho sobre la tarea → "Calcular duración por rendimiento" (si la tarea viene del presupuesto, la cantidad y la unidad se rellenan solas).

La fórmula es duración = cantidad ÷ rendimiento, redondeada hacia arriba a días hábiles. Por ejemplo: 180 m³ de excavación ÷ 4 m³/día = 45 días.

1. Ingresa o ajusta la Cantidad de proyecto (ahora es editable, incluso si vino del presupuesto).
2. Ingresa el rendimiento diario de la cuadrilla en la unidad de la tarea.
3. QOSTUM calcula la duración y la aplica al hacer clic en Aplicar.

Editar Predecesoras

1. Haz clic en la celda de la columna Pred.
2. Ingresa los códigos WBS de las tareas predecesoras, separados por coma
3. Pulsa Enter para confirmar

Ejemplo: 1.1, 1.2 indica que la tarea no puede iniciar hasta que las tareas 1.1 y 1.2 hayan finalizado.

Agregar Tareas Manuales

Además de las tareas importadas del presupuesto, puedes crear tareas adicionales:

1. Ve al menú Herramientas → Agregar tarea
2. Ingresa el nombre de la tarea
3. Selecciona la referencia WBS (la tarea se ubicará como hermana de esa referencia)
4. Elige si quieres agregarla antes o después de la referencia
5. Ingresa la duración en días hábiles
6. Haz clic en Agregar

Agregar Hitos

Los hitos representan eventos importantes del proyecto con duración cero:

1. Ve al menú Herramientas → Agregar hito
2. Ingresa el nombre del hito (ej: "Entrega de cimentación", "Aprobación de planos")
3. Selecciona la referencia WBS y posición
4. Haz clic en Agregar

Los hitos se representan como un rombo (◊) en el diagrama de Gantt. Puedes asignarles predecesoras para que su fecha se calcule automáticamente.

Eliminar Tareas

1. Selecciona la tarea haciendo clic sobre ella
2. Ve al menú Herramientas → Eliminar tarea
3. Si la tarea es resumen y tiene hijas, el sistema te advertirá cuántas tareas se eliminarán en cascada
4. Confirma la eliminación

Reordenar Tareas (Mover arriba / Mover abajo)

Puedes cambiar el orden de una tarea entre sus hermanos del mismo nivel jerárquico de dos formas:

• Menú contextual: clic derecho sobre la fila → "Mover arriba" o "Mover abajo".
• Atajo de teclado: selecciona la tarea (clic) y usa Alt + ↑ o Alt + ↓.

La tarea (junto con todos sus subelementos) se desplaza una posición dentro de su capítulo o partida padre. Las opciones del menú solo aparecen si existe un hermano en la dirección correspondiente.

Expandir y Contraer Tareas

Las tareas resumen pueden expandirse o contraerse para mostrar u ocultar sus tareas hijas:

• Individualmente: haz clic en el triángulo (▶ / ▼) junto al nombre de la tarea resumen
• Todas a la vez: usa los botones + Todo (expandir) o − Todo (contraer) en la barra de herramientas, o desde Herramientas → Expandir todo / Contraer todo

El Diagrama de Gantt

Tres niveles de zoom (Día / Semana / Mes), barras de distintos estilos para cada tipo de tarea y flechas que conectan las dependencias.

Niveles de Zoom

El diagrama ofrece tres niveles de zoom para visualizar el cronograma a diferentes escalas:

Representación Visual de las Tareas

• Tareas hoja: barras de color sólido cuyo ancho es proporcional a la duración. El nombre de la tarea puede aparecer dentro o junto a la barra
• Tareas resumen: barras más finas con extremos triangulares que abarcan desde la primera hasta la última tarea hija
• Hitos: rombos (◊) que marcan un evento puntual
• Tareas críticas: se resaltan en rojo cuando la ruta crítica está activada

Flechas de Dependencia

Las flechas van desde el final de la tarea predecesora hasta el inicio de la tarea sucesora. La relación es Fin-Comienzo (FC): la sucesora no puede iniciar hasta que la predecesora haya finalizado.

Navegación en el Diagrama

• Scroll horizontal: desplázate a lo largo de la línea de tiempo
• Scroll vertical: desplázate a lo largo de la lista de tareas (sincronizado entre tabla y diagrama)
• Botón "Hoy": centra el diagrama en la fecha actual

Dependencias y Predecesoras

Las dependencias definen el orden constructivo: una tarea con predecesoras no puede iniciar hasta que todas sus predecesoras hayan finalizado.

¿Qué son las Dependencias?

Las dependencias definen el orden en que deben ejecutarse las tareas. Una tarea con predecesoras no puede iniciar hasta que todas sus predecesoras hayan finalizado. Esto es fundamental para modelar correctamente la secuencia constructiva de un proyecto.

Tipo de Relación: Fin-Comienzo (FC)

QOSTUM utiliza la relación Fin-Comienzo (FC), la más utilizada en la programación de proyecto:

Fecha Inicio (sucesora) = Máximo( Fecha Fin (predecesora₁), Fecha Fin (predecesora₂), ... ) + 1 día hábil

Si una tarea tiene múltiples predecesoras, su inicio se determina por la que termine más tarde.

Cómo Definir Predecesoras

1. Localiza la tarea sucesora en la tabla
2. Haz clic en la celda de la columna Pred.
3. Ingresa los códigos WBS de las predecesoras, separados por coma
4. Pulsa Enter para confirmar

Efecto en el Cálculo

Al establecer o modificar dependencias:

• La fecha de inicio de la tarea se ajusta automáticamente
• Se dibujan flechas de dependencia en el diagrama
• Las tareas resumen se recalculan para abarcar a todas sus hijas
• La ruta crítica se actualiza (si está activa)
• La barra de estado muestra la nueva duración total del proyecto

Ejemplo Práctico: Secuencia Constructiva

Considera las primeras actividades de un edificio residencial:

Observa que las tareas 1.2 y 1.3 pueden ejecutarse en paralelo porque ambas dependen únicamente de 1.1. De igual forma, 2.2 y 2.3 son paralelas. En cambio, 2.1 depende de 1.2 y forma una cadena secuencial. Modelar correctamente estas relaciones es lo que permite obtener una ruta crítica realista.

Ruta Crítica (CPM)

La Ruta Crítica identifica las tareas que determinan la duración mínima del proyecto: si se retrasan, todo el cronograma se retrasa.

¿Qué es la Ruta Crítica?

La Ruta Crítica (Critical Path Method - CPM) identifica la secuencia más larga de tareas dependientes que determina la duración mínima del proyecto. Las tareas en la ruta crítica no pueden retrasarse sin afectar la fecha de finalización del proyecto.

Activar la Ruta Crítica

1. Haz clic en el botón "Ruta Crítica" en la barra de herramientas
2. Las tareas críticas se resaltarán en rojo en el diagrama
3. La barra de estado mostrará el número de tareas críticas
4. Para desactivar, haz clic nuevamente en el botón

Cómo Funciona el Cálculo

El algoritmo CPM realiza dos pasadas sobre la red de tareas:

Pasada hacia adelante (Forward Pass)

Recorre las tareas desde el inicio del proyecto calculando:

• ES (Early Start): la fecha más temprana en que puede iniciar la tarea
• EF (Early Finish): ES + Duración

Pasada hacia atrás (Backward Pass)

Recorre las tareas desde el fin del proyecto calculando:

• LF (Late Finish): la fecha más tardía en que puede terminar sin retrasar el proyecto
• LS (Late Start): LF − Duración

Holgura (Slack / Float)

Holgura = LS - ES = LF - EF

Si Holgura = 0 → La tarea es CRÍTICA (no admite retraso)
Si Holgura > 0 → La tarea tiene margen de días para retrasarse

Ejemplo Numérico Completo

Usando el ejemplo de la sección anterior (con fecha de inicio día 0):

Ruta crítica: 1.1 → 1.2 → 2.1 → 2.2 (35 días). La tarea "Bodega" tiene 11 días de holgura y "Cimiento corrido" tiene 5 días. Si la excavación se retrasa 1 día, todo el proyecto se retrasa 1 día. En cambio, la bodega puede retrasarse hasta 11 días sin afectar el plazo total.

Interpretación Práctica

• Tareas críticas (rojo): asigna los mejores recursos, supervisa de cerca, ten planes de contingencia
• Tareas con holgura: puedes reasignar recursos temporalmente a tareas críticas sin afectar el plazo final
• Muchas tareas críticas: revisa si hay dependencias excesivas. Un proyecto donde todo es crítico es frágil

Programación del Proyecto

Distribuye el costo del presupuesto a lo largo del tiempo. Esencial para flujos de caja, anticipos y control del avance presupuestal.

¿Qué es?

La Programación del Proyecto es una herramienta de control financiero que distribuye el costo del presupuesto a lo largo del tiempo. Muestra cuánto dinero se consumirá en cada período según la duración programada de cada tarea. Es esencial para elaborar flujos de caja, solicitar anticipos y controlar el avance presupuestal.

Acceso

Ve al menú Herramientas → Programación del Proyecto. Se abrirá un panel modal con la tabla de distribución de costos.

Vistas Disponibles

Contenido de la Tabla

• Filas de tareas: solo se muestran tareas hoja con costo > 0. Cada celda muestra el monto prorrateado para ese período
• TOTAL PERÍODO: suma de los costos de todas las tareas en cada período
• ACUMULADO: costo acumulado desde el inicio hasta cada período, con indicadores:
  • % tiempo: días hábiles consumidos / días hábiles totales del proyecto
  • % costo: costo acumulado / presupuesto total del proyecto

Cálculo de Prorrateo

Tasa diaria = Costo de la tarea / Días hábiles de duración

Costo en período = Tasa diaria × Días hábiles de la tarea en ese período

Ejemplo Numérico

Supón dos tareas con jornada Lun-Vie e inicio 02 Mar 2026:

La tarea 1.2 inicia en Sem 2 porque depende de 1.1 (que dura 10 días = 2 semanas). Se puede ver que la Sem 2 tiene la mayor concentración de costos (GTQ 29,850) porque ambas tareas están activas simultáneamente.

Interpretación de los Porcentajes

Exportar la Programación

Desde el panel puedes exportar en dos formatos:

• PDF: documento con encabezado del proyecto, tabla completa, totales, acumulados y porcentajes
• Excel: hoja de cálculo con formato numérico, ideal para análisis adicionales y gráficas de curva S

Reportar Seguimiento

Registra avance real de proyecto contra lo programado. Es la base de toda la analítica de control: Curva S, Informe de Avance y métricas EVM.

¿Qué es?

Un Gantt programado es una hipótesis. El seguimiento la convierte en información para tomar decisiones: detectar atrasos a tiempo, justificar sobrecostos al cliente, y proyectar la fecha real de entrega. QOSTUM permite registrar dos tipos de avance que se reportan independientemente:

Acceso

Botón Reportar Seguimiento en la barra superior del editor Gantt. Abre un modal con la tabla de tareas hoja del proyecto (PARs y HITs). Las tareas resumen (CAP) se calculan automáticamente como promedio ponderado por duración de sus hijos.

Pasos para reportar avance

1. Define la fecha de corte: el primer campo del modal. Por defecto trae la fecha actual; ajústala si tu corte es de otro día (típicamente el lunes anterior).
2. Captura el % Cronograma de cada tarea hoja. Tres formas: tipear el número, usar los botones ±10%, o pegar el valor desde otro reporte.
3. Captura el $ Ejecutado en la columna "Ejecutado". Si el gasto va al ritmo del cronograma, presiona "Ajustar al % Cronograma" y QOSTUM calcula Presupuesto × % Cronograma / 100.
4. Guarda el reporte. Queda registrado con la fecha del corte y se puede consultar en "Historial de Seguimiento".

Histórico

Cada reporte queda almacenado con su fecha. El botón Historial dentro del modal lista todos los reportes anteriores, expandibles para ver el detalle por tarea. Esto permite, en el Informe de Avance, navegar a fechas pasadas y ver "cómo se veía el proyecto en ese momento".

Curva S

Gráfica acumulada del avance del proyecto vs tiempo, con tres modos de visualización. Es el reporte gráfico más solicitado por clientes y financiamientos.

¿Qué es?

La Curva S muestra el avance acumulado del proyecto a lo largo del tiempo en forma de S (de ahí el nombre): arranque lento por organización inicial, aceleración en estructura, desaceleración en acabados. Compara la curva programada (referencia) contra la curva real (lo que efectivamente ha ocurrido).

Acceso

Botón Curva S en la barra superior del editor Gantt. Abre el panel de Programación con la curva activa. Tres modos seleccionables desde el toolbar de la curva:

Cómo interpretar la forma

• Real por debajo de Programada → vas atrasado. Cuanto más se separan, peor.
• Real por encima de Programada → vas adelantado. Verifica calidad y reportes.
• Real coincide con Programada → ejecutando según plan.
• Real plana mientras Programada sube → algo se trabó. Investiga ya.

Indicador "Cronograma vs Presupuesto"

Junto a la curva, un badge discreto muestra la diferencia entre cronograma real y presupuesto ejecutado a la fecha de corte. Tres lecturas:

• ✓ Alineados (verde, ±2%) — gasto y avance van al mismo ritmo. Lo deseable.
• ↑ Cronograma adelantado al gasto (ámbar) — avanzando más rápido que gastando. Generalmente favorable.
• ↓ Gasto adelantado al cronograma (rojo) — gastando más rápido que avanzando. Riesgo de sobrecosto.

Tooltip interactivo

Al pasar el cursor sobre la curva, un tooltip muestra los valores exactos de cada serie en ese período. En modo "Ambos", incluye una línea adicional con la diferencia "Crono vs Presup" para detección rápida de divergencias.

Exportar la curva

Desde el panel: Exportar PDF (gráfico + tabla de datos) o Excel (tabla con fórmulas para análisis adicionales y gráficas propias).

Informe de Avance y EVM

El reporte ejecutivo del proyecto: tarjetas de avance, indicador de salud, tablas de tareas, y métricas técnicas EVM (Earned Value Management).

Acceso

Botón Informe en la barra superior del editor Gantt. Define la fecha de corte y QOSTUM genera un reporte completo navegable. Si seleccionas una fecha pasada, el reporte se construye con el último seguimiento previo a esa fecha — ideal para análisis post-mortem.

Estructura del informe

1. Tarjetas de avance (cronograma + presupuesto)

Dos tarjetas en la parte superior, lado a lado, en este orden:

• Avance del Cronograma (primaria): Programado / Real / Desviación. Etiquetas claras como "Adelantado +X%", "A tiempo" o "Atrasado −X%".
• Presupuesto del Proyecto (secundaria): Programado / Ejecutado / Desviación, en % y monto absoluto. Etiquetas: "En presupuesto", "Debajo (ahorro)" o "Sobre (sobrecosto)".

2. Indicador de alineación

Una franja delgada bajo las tarjetas con la diferencia entre los dos avances. Es el primer diagnóstico de salud del proyecto (mismo semáforo que en la Curva S).

3. Tablas de tareas

• ▶ Tareas en curso: las activas a la fecha de corte. Costo, fechas, % cronograma teórico vs real, desviación.
• ◀ Tareas predecesoras: las que deben terminar para que las en-curso puedan progresar. Si una predecesora se trabó, aquí lo identificas.
• ▷ Tareas sucesoras: las que arrancarán después. Útil para coordinar logística aguas abajo.
• ⚡ Tag "RC": las tareas en ruta crítica llevan etiqueta roja. Foco prioritario.

4. Sección EVM — Valor Ganado

Si hay datos de seguimiento, al final del informe aparece la sección de Earned Value Management: el lenguaje técnico estándar de project management para hablar de avance financiero. Tres filas de métricas:

Para que no tengas que memorizar fórmulas, el informe colorea SPI y CPI con un semáforo (verde ≥ 1, ámbar entre 0.90 y 1, rojo < 0.90) y acompaña cada indicador con una explicación de una línea: un tooltip sobre la métrica y una leyenda al pie con los valores reales del proyecto (por ejemplo, "SPI 0.85 = avanzas al 85% del ritmo planificado").

Cálculos clave (referencia)

EV   = Σ (costo_tarea × % avance cronograma)
PV   = Σ (costo prorrateado al período de corte)
AC   = Σ (ejecutado_reportado)

SPI  = EV / PV       (1.0 = a tiempo)
CPI  = EV / AC       (1.0 = en presupuesto)
SV   = EV − PV       ($ desviación de cronograma)
CV   = EV − AC       ($ desviación de costo)

EAC  = BAC / CPI     (proyección al ritmo actual)
ETC  = EAC − AC      (lo que falta gastar)
VAC  = BAC − EAC     ($ desviación esperada al final)

Exportación

El informe se puede copiar al portapapeles (formato HTML, listo para pegar en Word, correo o Google Docs) o exportar a PDF con el branding QOSTUM. Para reuniones internas el portapapeles basta; para enviar al cliente, PDF.

Líneas Base

Una línea base congela el cronograma y el presupuesto en un momento dado. Después puedes comparar el estado actual contra esa "foto" para ver cuánto se desvió el proyecto: días de atraso o adelanto, sobrecosto y qué tareas cambiaron.

Crear una línea base

1. En la barra de herramientas haz clic en Líneas Base.
2. Pulsa + Nueva línea base, ponle un nombre (por ejemplo "Plan aprobado por cliente") y confirma.
3. Queda guardada junto con el proyecto en el archivo .qstm. Puedes tener hasta 10 líneas base.

Comparar contra el estado actual

En la lista, haz clic en Comparar con actual sobre cualquier línea base. Verás:

• Resumen en mosaicos: fecha de terminación (línea base → actual y Δ días), presupuesto (Δ en moneda), tareas afectadas y número de tareas.
• Tabla de tareas afectadas: cada tarea que cambió, con su fin según la línea base, su fin actual, la variación en días y la variación de costo. Las tareas nuevas o eliminadas se marcan con una etiqueta.
• Comparación visual (solo lectura): un mini-Gantt que monta la barra de la línea base (gris, "fantasma") debajo de la barra actual (naranja) en cada tarea, con la desviación en días a la derecha. Es solo para ver; no se edita como el cronograma de trabajo.

Ver el informe y descargarlo en PDF

El botón Ver informe abre, dentro de la aplicación, un informe de la línea base: tabla de conceptos (terminación, presupuesto, tareas), estadísticas generales (tareas atrasadas/adelantadas, con mayor/menor costo) y el detalle de tareas afectadas. Desde ese informe, el botón Descargar PDF genera la versión imprimible con el branding QOSTUM.

Eliminar una línea base

El botón Eliminar de cada línea base la borra de forma permanente (pide confirmación). Si llegaste al máximo de 10, elimina alguna para poder crear otra.

Vista General (Overview)

Una panorámica completa del proyecto en un canvas miniaturizado: ve todas las tareas y su distribución temporal de un vistazo.

¿Qué es?

La Vista General ofrece una panorámica completa del proyecto en un canvas miniaturizado. Permite ver todas las tareas y su distribución temporal de un vistazo, sin necesidad de hacer scroll. Es especialmente útil para proyectos grandes con muchas tareas.

Acceso

Haz clic en el botón "Vista General" en la barra de herramientas.

Controles de Navegación

Guardar y Abrir Programaciones

Guarda toda la programación (tareas, dependencias, configuración de jornada y estado de la interfaz) en un archivo JSON que puedes reabrir más tarde.

Guardar la Programación

Para guardar tu trabajo actual:

1. Haz clic en el botón verde "Guardar" (esquina superior derecha)
2. También disponible en Archivo → Guardar Programación
3. Se descargará un archivo .json con toda la información del proyecto

¿Qué se guarda?

El archivo incluye absolutamente todo lo necesario para restaurar el estado completo:

• Nombre del proyecto, fecha de inicio, moneda
• Configuración de jornada laboral (qué días son hábiles)
• Todas las tareas con sus propiedades: WBS, nombre, duración, predecesoras, costo, tipo
• Datos del presupuesto vinculado (si se importó)
• Estado de la interfaz: tareas expandidas/contraídas, columnas visibles/ocultas, nivel de zoom, estado de ruta crítica

Abrir una Programación Guardada

1. Ve al menú Archivos → Abrir programación existente
2. Selecciona el archivo .json guardado previamente
3. El sistema validará el archivo y restaurará todo el estado del proyecto

Validaciones al Abrir

El sistema verifica la integridad de los datos al cargar un archivo:

• Formato de archivo válido (verificación de marca _qostumGantt)
• Campos obligatorios en cada tarea (id, wbs, nombre, nivel, tipo)
• Formato de fechas correcto (ISO 8601)
• WBS duplicados (se reportan como advertencia)
• Referencias de predecesoras válidas (se eliminan las inválidas)
• Integridad de relaciones padre-hijo (se reparan las rotas)

Exportación de Datos

Genera PDFs profesionales del diagrama de Gantt y exporta la programación financiera a PDF o Excel para análisis y reportes.

Exportar Diagrama de Gantt a PDF

Genera un documento PDF profesional del diagrama:

1. Ve al menú Archivo → Exportar PDF
2. Configura las opciones de exportación en el panel
3. Haz clic en Exportar

Opciones de PDF del Diagrama

Exportar Programación Financiera a PDF

Desde el panel de Programación del Proyecto (Herramientas → Programación del Proyecto), haz clic en el botón "PDF". Se generará un documento con la tabla de distribución de costos, totales, acumulados y porcentajes de avance.

Exportar Programación Financiera a Excel

Desde el mismo panel, haz clic en el botón "Excel". La hoja de cálculo incluye:

• Encabezado con nombre del proyecto y vista seleccionada
• Tabla completa de tareas con costos por período
• Fila de TOTAL PERÍODO
• Fila de ACUMULADO
• Filas de % AVANCE TIEMPO y % AVANCE PRESUPUESTO
• Formato numérico y de porcentaje aplicado

Referencia Rápida

Tablas de consulta para atajos de teclado, menús principales y columnas de la tabla de tareas.

Atajos de Teclado

Menús Principales

Columnas de la Tabla de Tareas

Consejos y Mejores Prácticas

Recomendaciones para construir cronogramas realistas: flujo de trabajo, estimación de duraciones, dependencias mínimas y uso pragmático de la ruta crítica.

Flujo de Trabajo Recomendado

1. Prepara el presupuesto en QOSTUM Presupuestos con la estructura completa
2. Exporta el presupuesto como archivo JSON
3. Importa en Programación configurando fecha de inicio, jornada laboral y profundidad
4. Ajusta las duraciones de cada tarea según la estimación real del equipo de proyecto
5. Define las dependencias siguiendo la lógica constructiva: ¿qué debe terminar antes de que otra pueda empezar?
6. Activa la Ruta Crítica para identificar las tareas que controlan el plazo total
7. Revisa la Programación Financiera para validar el flujo de costos y detectar picos de inversión
8. Exporta el diagrama a PDF y la programación financiera a Excel
9. Guarda la programación para futuras actualizaciones durante el proyecto

Sobre las Duraciones

• Estima duraciones en días hábiles, no calendario. Si una cuadrilla tarda 2 semanas de Lun-Vie, la duración es 10, no 14
• Considera la disponibilidad real de mano de obra y maquinaria en tu región
• Incluye tiempo para curado del concreto (7-14 días según elemento), tiempos de entrega de materiales, trámites de permisos
• Sé conservador: es mejor prometer menos y entregar antes. Aplica un margen de 10-15% sobre tu estimación ideal

Sobre las Dependencias

• No todas las tareas necesitan predecesoras. Las que no tienen, inician en la fecha de inicio del proyecto
• Evita dependencias innecesarias: solo vincula tareas con restricción real. "¿Realmente B no puede iniciar hasta que A termine?"
• Identifica actividades que pueden ser paralelas (diferentes zonas, diferentes cuadrillas). Esto reduce la duración total del proyecto
• Usa la ruta crítica para verificar que la red de dependencias tiene sentido lógico

Sobre la Ruta Crítica

• Si más del 70% de las tareas son críticas, probablemente hay dependencias excesivas
• La ruta crítica cambia dinámicamente al modificar duraciones o dependencias
• Las tareas con holgura son oportunidades para optimizar recursos (mover cuadrillas a tareas críticas)
• Revisa la ruta crítica semanalmente durante la ejecución del proyecto

Sobre la Programación Financiera

• Usa la vista semanal para proyectos de 3 a 12 meses
• Usa la vista mensual para proyectos de más de un año
• Compara % costo vs % tiempo para detectar desfases: si el costo va adelante, investiga por qué
• Utiliza los datos de la programación para justificar solicitudes de anticipo o pagos parciales ante el cliente

Resolución de Problemas

Soluciones a los problemas más frecuentes al importar presupuestos, calcular fechas, activar la ruta crítica y exportar PDFs.

El archivo de presupuesto no se importa

• Verifica que el archivo sea un JSON exportado desde QOSTUM Presupuestos
• El archivo debe contener un arreglo elementos con la estructura del presupuesto
• Intenta abrir el archivo en un editor de texto para verificar que no esté corrupto (debe empezar con {)
• Verifica que el archivo no esté vacío o truncado

Las fechas no coinciden con lo esperado

• Verifica la configuración de jornada laboral: ¿estás usando 5 o 6 días por semana?
• Recuerda que las duraciones son en días hábiles, no calendario. 10 días Lun-Vie = 14 días calendario
• Revisa las predecesoras: una tarea puede retrasarse porque espera a otra
• Verifica que la fecha de inicio del proyecto sea un día hábil

Una tarea no se mueve aunque cambié la duración de otra

• Verifica que exista una dependencia (predecesora) entre ambas tareas
• Sin dependencia, las tareas son independientes y no se afectan mutuamente
• Confirma que escribiste correctamente el código WBS en la columna Pred.

La ruta crítica no muestra ninguna tarea

• Asegúrate de que existan dependencias entre las tareas
• Sin dependencias, todas las tareas son independientes y el cálculo no produce una ruta significativa
• Establece al menos una cadena de dependencias de principio a fin del proyecto

Todas las tareas aparecen como críticas

• Revisa si encadenaste todas las tareas en serie (cada una depende de la anterior)
• Identifica actividades que pueden ser paralelas y elimina dependencias innecesarias
• Un proyecto donde todo es crítico indica falta de paralelismo en la programación

La programación financiera no muestra datos

• Verifica que las tareas tengan costo asignado (columna Costo)
• Solo se incluyen tareas hoja con costo mayor a cero
• Si importaste un presupuesto, los costos se asignan automáticamente
• Las tareas manuales no tienen costo a menos que el presupuesto se los asigne

El archivo de programación guardado no se abre

• El archivo debe ser un JSON generado por QOSTUM Programación (contiene la marca _qostumGantt)
• No confundas un archivo de presupuesto (.qstm de Presupuestos) con uno de programación (.qstm-gantt de Gantt). Usa Programación desde presupuesto para el primero y Abrir programación existente para el segundo
• Si el archivo fue editado manualmente, puede haberse corrompido. El sistema intentará reparar inconsistencias

El PDF del diagrama sale cortado o ilegible

• Aumenta el número de páginas de ancho en las opciones de exportación
• Usa un tamaño de papel más grande (A3, Tabloide, A2)
• Activa la opción "Ajustar en una página" para escalado automático
• Contrae las tareas resumen antes de exportar para reducir el número de filas

Los costos de las tareas aparecen en cero

• Los costos provienen del presupuesto importado. Si no importaste presupuesto, las tareas no tendrán costo
• Verifica que la profundidad de importación sea suficiente para incluir las partidas con costo
• Las tareas resumen no muestran costo propio; sus costos se reflejan en las tareas hoja

Al cambiar la jornada laboral, las fechas cambiaron drásticamente

• Esto es el comportamiento esperado. Las duraciones están en días hábiles; cambiar los días hábiles cambia cuántos días calendario se necesitan
• Ejemplo: 10 días hábiles con Lun-Vie = 14 calendario, pero con Lun-Sáb = 12 calendario
• Si el cambio fue accidental, vuelve a la configuración anterior

No puedo editar la duración de una tarea

• Solo las tareas hoja tienen duración editable. Las tareas resumen calculan su duración automáticamente
• Los hitos tienen duración fija de 0 días
• Haz clic directamente en la celda de la columna Duración para activar la edición

Soporte

Si necesitas más ayuda:

• Revisa los tutoriales en video: youtube.com/@qostum
• Visita la sección de preguntas frecuentes en qostum.com/faq
• Únete a la comunidad de usuarios
• Contacta al equipo de soporte

Introducción

Gestión de Catálogos es el tercer módulo de QOSTUM. Sirve para reunir tus precios dispersos en un solo lugar, limpiarlos y dejarlos listos para cotizar.

El módulo trabaja sobre tu propio catálogo, no sobre la base de datos maestra de QOSTUM (esa es solo de referencia). Tú decides qué insumos guardas, con qué código y a qué precio. Toda la información se guarda en un archivo .qcat en tu computadora — zero-cloud, nada se sube a internet.

Insumos y partidas

El catálogo separa los elementos en dos tarjetas porque se comportan diferente:

• Insumos (simples): un material o recurso con un precio (cemento, acero, jornal de albañil, hora de maquinaria). Tipos: MAT, MDO, MAQ, SUB, HER, REN, OTR.
• Elementos compuestos (composición): un conjunto de insumos con sus cantidades — un análisis de precio unitario. Por ejemplo "muro de block" = block + cemento + arena + mano de obra. Tipos: PAR, PEX, CAP.

Cargar, crear y fusionar

Tres formas de empezar, según lo que ya tengas. Todas desde la barra superior.

Desde Presupuestos, sin archivos de por medio

Si estás trabajando en el módulo de Presupuestos, no necesitas exportar y volver a cargar: en el modal del catálogo, junto a "Exportar Catálogo", usa "Enviar a Gestión de Catálogos" y tu catálogo activo se abre aquí directamente, listo para limpiar o fusionar.

El menú Archivos

Todas las operaciones de archivo viven en el menú Archivos del encabezado: Nuevo vacío, Cargar, Fusionar, Importar desde Excel, Exportar a Excel, Descargar plantilla y Descargar catálogo. Además, Nuevo vacío y Cargar archivo están a la vista como botones de acceso rápido.

Importar y exportar en Excel

Tu catálogo entra y sale en Excel, en los dos sentidos. Exportar a Excel genera un libro con cuatro hojas — Insumos, Proveedores, Precios por proveedor y Composición — con el formato de la app (encabezados, filtros y dos decimales). Importar desde Excel reconstruye el catálogo completo desde esas hojas: el orden de las columnas no importa, pero los encabezados deben coincidir, y al importar se reemplaza el catálogo actual.

Para no equivocarte con el formato, usa Descargar plantilla de Excel: trae las columnas correctas y una fila de ejemplo. La llenas, borras el ejemplo y la cargas. El modal de importación te muestra el formato de cada hoja antes de seleccionar el archivo.

El import además es inteligente con proveedores: si tu Excel trae columnas "Precio <NombreProveedor>" (por ejemplo "Precio Ferretería Central"), QOSTUM crea las fichas de esos proveedores y registra sus precios con la fecha de hoy; si no indicas cuál manda, el proveedor vigente queda el de menor precio. La vista previa del import lista los proveedores detectados antes de confirmar.

Editar y organizar

Todo se edita directo en la tabla, sin abrir ventanas.

Cada fila te deja cambiar el código, el tipo, la descripción, la unidad y el precio con un clic. El indicador "Sin guardar" te recuerda que aún no descargas el archivo.

El precio se propaga por código

Al editar el precio de un insumo, QOSTUM lo actualiza en todo el catálogo donde aparezca ese mismo código — incluso dentro de las composiciones de los elementos compuestos — y te indica en cuántos lugares se aplicó.

Familias de insumos

Puedes organizar el catálogo en familias (Concretos, Aceros, Eléctrico…): junto a la descripción de cada ítem hay un chip de familia; haz clic para asignarla o editarla, con autocompletar de las familias que ya existen. El filtro "Todas las familias" (que incluye la opción (sin familia)) acota la tabla, y la acción "Asignar familia…" la aplica de una vez a todos los ítems visibles. La familia viaja dentro del .qcat y como columna "Familia" en Excel (exportación, plantilla e importación), y en Ajustar precios puedes limitar el ajuste a una familia.

Componer compuestos

Los elementos compuestos son ciudadanos de primera clase en la tabla: un chip expandible "▶ N comp. · total" muestra su receta sin salir de la fila. Con el botón "Componer" de cada fila — o "+ Compuesto" en la barra para crear uno nuevo — abres el editor de composición: una tabla de componentes editable con autocompletar contra los insumos del catálogo. Si escribes un componente libre que no existe como insumo, queda como "suelto" y el diagnóstico lo detecta para que lo incorpores. El precio del compuesto siempre es la suma derivada de sus componentes (no se edita a mano), y cambiar el precio de un insumo — incluso vía proveedores — actualiza todas las recetas que lo usan. Los compuestos nuevos entran en cuarentena, como todo lo recién creado, y la fusión de catálogos conserva las recetas aunque recodifique.

Comentarios, orden y filtros

• Activa "Mostrar comentarios" para anotar notas por insumo (origen del precio, marca, condición).
• Ordena por código, descripción, tipo, precio o fecha; agrupa por tipo con un check.
• Filtra por tipo, por "solo con problemas" o por "con comentario".

Revisar y limpiar

Tras fusionar quedan duplicados y vacíos. El diagnóstico los detecta y ofrece soluciones de un clic.

Arriba verás los contadores de Salud (% verificado), En cuarentena, Errores (rojo, hay que resolverlos) y Avisos (ámbar, conviene revisarlos). El botón Revisar y limpiar abre el diagnóstico completo:

• Códigos duplicados (con descripción distinta) → reasignar códigos. Error.
• Campos vacíos (sin código o sin descripción) → ir al elemento. Error.
• Precios en conflicto (mismo código, precios distintos — típico al fusionar) → resolver. Error.
• Descripciones duplicadas (mismo insumo, códigos distintos) → fusionar, eligiendo el precio si difieren. Aviso.
• Colisión compuesto ↔ insumo (misma descripción como compuesto y como simple) → resolver (mantener ambos diferenciados o unificar). Aviso.
• Insumos sin precio (precio 0) → filtrarlos para completarlos. Aviso.
• Información incompleta (insumo sin proveedor o sin fecha de actualización) → completar. Aviso.
• Precios obsoletos (sin actualizar hace más de N días; umbral configurable) → ir al ítem o marcar "Revisado hoy". Aviso.
• Compuestos con componentes sueltos (componentes que aún no son insumos del catálogo) → incorporar. Aviso.
• En cuarentena (recién incorporados desde un presupuesto, sin verificar) → completar y verificar. Ver capítulo siguiente.

La detección normaliza mayúsculas, acentos, espacios y comillas para reconocer que "Cemento gris" y "cemento gris " son lo mismo — pero nunca fusiona una partida con un insumo.

Recodificar todo

Desde Herramientas → Recodificar, QOSTUM reasigna códigos correlativos por tipo (MAT001, MAT002, MDO001…) según el orden actual de la tabla, y actualiza las referencias dentro de las composiciones automáticamente. Elige 3 o 4 dígitos. No se puede deshacer: descarga el catálogo antes si quieres conservar la numeración previa.

Del presupuesto al catálogo: salud y cuarentena

Cada proyecto puede alimentar tu catálogo, pero solo si lo que entra queda completo. QOSTUM cuida esa salud por ti.

El presupuesto y el catálogo se conversan: en el presupuesto creas insumos y elementos compuestos; el catálogo es tu base de datos viva y reutilizable. Cuando armas algo bueno en un presupuesto, lo lógico es guardarlo en el catálogo con "Agregar a Catálogo". El detalle: ese elemento nació en el presupuesto, donde no se captura proveedor, fecha de actualización ni la codificación propia del catálogo. Si entrara tal cual, ensuciaría tu base de datos.

1 · Entra en cuarentena

Por eso QOSTUM no lo da por "listo": al agregarlo lo marca en cuarentena (la primera vez te avisa con un mensaje claro). El elemento ya está en tu catálogo, pero señalado como sin verificar. La cuarentena es por elemento: no bloquea el resto del catálogo, solo aísla y marca lo que falta completar.

2 · Completa y verifica

Para llegar rápido, usa "Enviar a Gestión de Catálogos" en el modal del catálogo de Presupuestos: el catálogo activo se abre directamente en el módulo, sin exportar ni cargar archivos.

En Gestión de Catálogos verás el indicador de Salud (% verificado) y el contador En cuarentena, con un acceso directo. Filtra por "En cuarentena" (cada pendiente lleva la insignia ⏳), asigna proveedor, precio y fecha, ajusta el código si quieres seguir la codificación del catálogo (Herramientas → Recodificar) y pulsa el botón verde ✓ de la fila para verificarlo. "Verificar todos los listos" libera de golpe los que ya estén completos.

QOSTUM no te deja verificar a medias: si a un insumo le falta proveedor, fecha o tiene precio 0, te dice exactamente qué falta y no lo libera.

3 · Elementos compuestos: incorporar los componentes

Un elemento compuesto no tiene proveedor propio: lo tienen sus componentes. Al traerlo del presupuesto, sus componentes vienen incrustados en la composición pero no existen como insumos del catálogo, así que no se pueden enriquecer. El diagnóstico lo marca como "compuesto con componentes sueltos" y ofrece "Incorporar componentes": por cada uno, si ya existe un insumo con esa descripción lo enlaza (no duplica), y si no, crea el insumo nuevo (también en cuarentena). Luego enriqueces esos insumos como cualquier otro. Un compuesto no se puede verificar mientras tenga componentes sueltos.

Precios y moneda

Dos herramientas para mantener tus precios al día sin editar fila por fila.

Ajustar precios en lote

Desde Herramientas → Ajustar precios, aumentas o disminuyes precios por porcentaje o por monto fijo, con la opción de filtrar por tipo o por familia. La vista previa indica cuántos precios vas a afectar antes de aplicar, y registra la fecha de actualización. Si un insumo tiene varias cotizaciones de proveedores, el ajuste se aplica a todas.

Alertas de precios obsoletos

La card "Precios obsoletos" y su grupo en el diagnóstico detectan los insumos cuyo precio no se actualiza hace más de N días (90 por defecto; el umbral es configurable y se recuerda). Para cada uno puedes usar "Ir al ítem" y corregir el precio, o "Revisado hoy" si el precio sigue vigente: se marca la fecha sin cambiar el valor. "Marcar todos revisados hoy" libera la lista completa de un golpe.

Cambiar de moneda

Desde Herramientas → Cambiar moneda, eliges la moneda objetivo y un factor de conversión. Todos los precios — insumos, composiciones y cotizaciones de proveedores — se multiplican por el factor y la etiqueta de moneda cambia. Usa factor 1 si solo quieres cambiar la etiqueta sin convertir.

Proveedores

Asocia varias cotizaciones a cada insumo, compáralas y marca cuál es la vigente.

El botón Proveedores de la barra abre el panel de gestión. Ahí creas cada proveedor con su ficha (nombre obligatorio; contacto, teléfono, email, sitio, dirección y notas opcionales), y con el ícono de ojo ves los insumos asociados a cada uno, con su precio.

Precios por proveedor en cada insumo

En la tabla de insumos, la columna Proveedor muestra + Proveedor si aún no tiene, o el nombre del vigente y un número con cuántos proveedores le cotizan. Al hacer clic se abre Precios por proveedor, donde puedes:

• Agregar un proveedor con su precio.
• Editar el precio y el SKU (código del producto en ese proveedor).
• Marcar el radio para definir la cotización vigente.
• Quitar un proveedor del insumo.

El vigente manda

El proveedor vigente define el precio que se muestra en la tabla y el que viaja a Presupuestos cuando cargas el catálogo. Las demás cotizaciones quedan guardadas para comparar. Si editas el precio inline en la tabla, cambias el del vigente; si eliminas un proveedor, sus precios se quitan y, donde era el vigente, se reasigna a otro automáticamente.

Guardar y usar (.qcat)

Un archivo que cargas en cualquier proyecto, con versionado e historial.

Al terminar, pulsa Descargar catálogo: se genera el archivo .qcat con tus insumos, partidas, proveedores, moneda, versión, notas e historial. El navegador te deja elegir la carpeta donde guardarlo.

El botón Info muestra un resumen (insumos, partidas, moneda, sin precio, proveedores), te deja escribir notas del catálogo y crear una nueva versión que queda registrada en el historial.

Llevarlo a un presupuesto

La vía directa: Herramientas → Enviar a Presupuestos manda el catálogo activo al módulo de Presupuestos sin descargar ni cargar archivos. Al abrir Presupuestos el catálogo llega solo (verás el aviso "Catálogo recibido…") y, si allá ya había un catálogo activo, eliges entre Reemplazar o Añadir. La moneda y las fichas de proveedores viajan con el catálogo.

La vía clásica sigue disponible: en el módulo de Presupuestos, ve a Catálogo → Cargar Catálogo y selecciona tu .qcat. A partir de ahí insertas insumos y partidas desde tu propio banco de precios, siempre actualizado.