# Manual de Uso — Módulo de Compras Terracota **URL del panel:** https://terracota-panel.objetiva.com.ar/ --- ## Mapa rápido de pestañas | Grupo | Pestaña | Para qué sirve | |---|---|---| | **📋 Compras** | Resumen | Estado general de OCs activas | | | Solicitud de Compra | Pedir cotizaciones a varios proveedores por WhatsApp | | | Cotizaciones | Cargar respuestas de proveedores (texto o PDF/foto — la IA extrae los datos) | | | Nueva OC | Crear orden de compra (desde cotización o manual) | | | **🛒 Plan de Compras** | Materiales del presupuesto: cuándo y dónde comprar | | **💵 Pagos** | Pagos / Pagos Pendientes / Egresos / Créditos | Programar y registrar pagos a proveedores y créditos inter-obra | | **📦 Logística** | Seguimiento / Recepción | Estado de entregas y verificación en obra | | **🔔 Alertas** | Alertas | Pagos vencidos + retrasos en entregas | | **👷 Contratistas** | Contratistas | Pagos quincenales al contratista principal + servicios externos | | **📎 Comprobantes** | Comprobantes | Subir foto/PDF de factura → IA registra el egreso automáticamente | | **⚙️ Config** | Config | Carpetas Drive por proyecto + botón reiniciar WhatsApp | --- ## Flujo típico de compra 1. **Solicitud de Compra** → cargás items y elegís proveedores → se envía cotización por WhatsApp. 2. Llegan respuestas → en **Cotizaciones** subís el texto o PDF/foto que mandó el proveedor → la IA extrae valores, plazo, banco, cuenta. 3. **Aprobar cotización** → se genera la **Orden de Compra** y los **Pagos** pendientes. 4. **Pagar** desde la pestaña Pagos → subís el comprobante → se notifica al proveedor por WhatsApp y queda registrado el egreso. 5. Cuando llega el material → **Recepción** → marcás completo / parcial / no-conforme. 6. Si la recepción es completa, la OC se **cierra**. --- ## Plan de Compras Pestaña **🛒 Plan de Compras**. Seleccionás obra → te muestra los materiales del presupuesto cargado en el sistema APU. ### Tres vistas (toggle arriba) - **📋 Lista completa** — un material por fila con cantidad, fecha límite, proveedor sugerido. Para revisar todo en detalle. - **📅 Agenda por proveedor** — agrupado por proveedor + ventana de tiempo (esta semana / 2 semanas / próximo mes / 3 meses). Una sola compra por proveedor en lugar de muchas. Botón **WhatsApp** directo y **Copiar lista** lista para mandar. - **📊 Consolidado** — un material único por fila. Materiales similares (cemento Argos + cemento Cemex + cemento Portland) se fusionan en "Cemento (todos)" con cantidad y valor agregado. ### Acciones por fila (en las tres vistas) - **✓ checkbox** — marcar como ya comprado (sale del listado activo). - **🗑️** — eliminar item del plan (no se compra, ej. agua, herramientas propias). - **✏️ Cambiar** — reasignar a otro proveedor manualmente. - **🔢 Desglosar** — para items "prorrateados" (ej. "Accesorios PVC 4"") la IA propone los items específicos con cantidades reales (codo + yee + unión, etc.). - **🛒 Verificar en Homecenter** — la IA consulta el precio actual en homecenter.com.co y compara contra el estimado del presupuesto (±10%). ### Filtros (compartidos entre vistas) - 🔍 Buscar por nombre del material, actividad o proveedor. - 🏗️ Filtrar por etapa (PRELIMINARES, CIMENTACION, ESTRUCTURA, CUBIERTA, INST. SANITARIAS, GAS, INST. ELECTRICAS, INST. HIDRAULICAS, VARIOS). - 📅 Ventana de tiempo (cuándo comprar — esta semana, 2 semanas, mes, 3 meses, todo). - 🚫 **Lista negra** — palabras que se ocultan automáticamente en TODAS las obras (ej. "agua", "herramientas propias"). Configurable desde el botón amarillo. - 🔗 **Agrupaciones** — palabras que fusionan materiales similares en la vista Consolidado (ej. "cemento", "arena", "grava", "triturado"). Configurable desde el botón rosa. ### Avisos automáticos - **⚠️ Banner amarillo** si hay actividades del presupuesto sin APU cargado (no producen materiales). Link al sistema APU para arreglarlo. - **Items marcados ya-comprados** con badge verde 🔍 Auto-detectado cuando el sistema los cruza con OCs/cotizaciones aprobadas. Si está mal, desmarcás el checkbox y queda en "no comprado" para siempre. --- ## Programación de compras (sincronizado con flujo-caja) Debajo del Plan de Compras hay una sección **📋 Programación de Compras**. Es la misma tabla del sistema de flujo de caja — cambiás estado (pendiente/pagado) o proveedor acá y se actualiza allá automáticamente. --- ## Programación de Compras (sincronizada con flujo-caja) Debajo del Plan de Compras hay una sección **📋 Programación de Compras**. Es la misma tabla del sistema de flujo de caja — cambios de estado (pendiente/pagado) o proveedor se persisten en ambos sistemas. ## Caja Menor Para registrar un pago de **caja menor**: 1. Andá a la pestaña **Egresos**. 2. En el formulario, seleccioná el concepto **"CAJA MENOR"** (ya está en la lista) y completá: - **Obra (Cliente)** — fundamental, identifica a qué obra pertenece. - **Etapa** — opcional, ayuda al detalle. - **Notas** — el **motivo** del gasto (ej. "Pasaje contratista", "Pago albañil destajo"). - Valor, fecha, número de comprobante. 3. Guardar. Arriba de la tabla de egresos vas a ver un **💼 Resumen Caja Menor** con: - **Total general** en banner naranja. - **Una card por obra**: nombre + total caja menor + nº de movimientos. - Click en la card → despliega los últimos movimientos con fecha, motivo y valor. Así de un vistazo sabés cuánto se está pagando en caja menor por obra y por qué. ## Convertir un egreso en préstamo inter-obra En el tab **Egresos** cada fila tiene botón **"💸 Marcar préstamo"**. Click → elegís la obra acreedora (la que prestó la plata) → se crea un crédito en `Creditos_Inter_Proyectos` y el egreso se reasigna al concepto "CREDITO INTER-PROYECTO". Útil cuando una obra paga algo de otra y hay que registrar la deuda. ## Atajos útiles - **Click en "📋 Compras"** (etiqueta del grupo en la nav) → te lleva directo al Resumen. - **Click en la descripción de un pago pendiente** → te lleva a Pagos con el formulario precargado. - **Click en la etiqueta de etapa** (chip azul) en cualquier fila → filtra el plan por esa etapa. - **Botón 📖 Manuales** (arriba a la derecha) → abre este mismo documento desde el panel. --- ## Cuándo pedir ayuda - WhatsApp del proveedor no llega → **Config → 🔄 Reiniciar Evolution (WhatsApp)**. Si sigue fallando, avisar al admin. - Una OC quedó sin material visible → es posible que su APU no esté cargado en el sistema APU/Presupuestos. Aparecerá un banner amarillo en el Plan de Compras. - Dato bancario incorrecto del proveedor → editás directo en la columna del Plan de Compras o en la pestaña Proveedores.