Cotizar Convenio Marco
Sistema de cotización especializado para Convenios Marco de ChileCompra.
Descripción
Herramienta para crear cotizaciones específicas para licitaciones bajo modalidad de "Convenio Marco" en ChileCompra. Incluye carga dinámica de convenios activos, gestión de datos del cliente y selección de productos del catálogo del convenio.
Características Principales
📑 Gestión de Convenios Marco
- Carga dinámica de convenios marco activos
- Selección de convenio específico
- Validación de productos según convenio
- Precios limitados por catálogo del convenio
- Notificaciones al usuario sobre restricciones
🧭 Flujo multi-paso
El formulario está organizado como asistente en cuatro pasos:
- Buscar Unidad — busca la unidad por ID, nombre o RUT; si no existe en la base, se ingresan manualmente sus datos (nombre, RUT, dirección, comuna, contacto, email, teléfono, celular).
- Agregar Productos — selección de región y convenio marco (solo los adjudicados a la empresa), búsqueda de productos del catálogo del convenio y carga de productos manuales.
- Calcular Costos — calculadora de costos por producto y selección del modo de IVA.
- Finalizar Cotización — estado, forma de pago, observaciones y descuentos.
Un panel lateral de resumen (visible en los pasos 1, 2 y 4) muestra la unidad, los productos y los totales (neto, costo, margen, descuento, IVA y total).
🔍 Filtros de producto
En el paso de productos se filtra el catálogo del convenio por Marca, Tipo y Modelo, además de una búsqueda libre (busca en ID, tipo, marca, modelo y descripción). También es posible agregar un producto manual (con nombre, marca, modelo, cantidad, precio y foto opcional).
💸 Descuento configurable
El descuento se puede ingresar de dos formas equivalentes (se sincronizan entre sí):
- Por porcentaje (%).
- Por monto fijo ($), validado para no superar el neto.
🧾 Modo de IVA
- Más IVA (
mas_iva): los precios son netos y se agrega 19% al final. - IVA incluido (
iva_incluido): los precios ya incluyen IVA; se calcula el neto dividiendo por 1,19.
📌 Estados y forma de pago
- Estado de la cotización: Pendiente, Aprobada o Rechazada.
- Forma de pago: tomada de las formas de pago configuradas en la empresa.
👥 Gestión de Cliente
- Búsqueda de la unidad por ID, nombre o RUT
- Ingreso manual de datos institucionales si la unidad no está registrada
- Datos de contacto (nombre, email, teléfono, celular)
Casos de Uso
- Cotización para institución pública: Ejecutivo selecciona convenio marco y crea cotización con productos autorizados
- Renovación de contrato: Actualizar cotización existente bajo mismo convenio
- Múltiples convenios: Cliente solicita productos de diferentes convenios marco
Interfaz y Componentes
Selector de Convenio Marco
[Pendiente: Screenshot del selector de convenios]
Formulario de Cliente
- RUT de institución
- Nombre de institución
- Contacto responsable
- Email y teléfono
- Dirección de despacho
Selector de Productos del Convenio
[Pendiente: Screenshot de catálogo de productos]
Integraciones
- ChileCompra API - Lista de convenios marco activos
- BigQuery - Catálogo de productos por convenio
- Firebase Firestore - Almacenamiento de cotización
- Cloud Functions - Validaciones y generación de PDF
Configuración Requerida
Convenios Marco Activos
[Pendiente: Configuración de convenios suscritos por la empresa]
Plantilla de Cotización
[Pendiente: Template específico para convenios marco]
Restricciones del Convenio Marco
Precios
- Precio máximo definido por convenio
- No se puede exceder precio catálogo
- Descuentos permitidos según convenio
Productos
- Solo productos autorizados en el convenio
- Cantidades mínimas/máximas según convenio
- Combinaciones permitidas
Condiciones Comerciales
- Plazo de entrega establecido
- Garantías específicas
- Términos de pago predefinidos
Flujo de Trabajo
Seleccionar Convenio → Ingresar Cliente → Buscar Productos → Validar Precios → Generar Cotización → Enviar
↓
Validación automática
vs catálogo convenio
Diferencias con Compra Ágil
| Característica | Convenio Marco | Compra Ágil |
|---|---|---|
| Catálogo | Restringido | Abierto |
| Precio | Máximo definido | Libre |
| Productos | Solo autorizados | Cualquiera |
| Validación | Estricta | Flexible |
| Cliente | Solo instituciones | Cualquiera |
Datos Técnicos
Modelo de Convenio Marco
interface ConvenioMarco {
id: string;
codigo: string;
nombre: string;
fechaInicio: Date;
fechaTermino: Date;
productos: ConvenioProducto[];
condiciones: ConvenioCondiciones;
}
[Pendiente: Modelo completo de datos]
Validaciones
[Pendiente: Reglas de validación implementadas]
Mejores Prácticas
- Verificar vigencia del convenio marco antes de cotizar
- Validar que el cliente es institución pública
- Respetar precios máximos del catálogo
- Confirmar disponibilidad de productos autorizados
- Revisar condiciones específicas de cada convenio