La plataforma

El panel de Quelva es el canal para el equipo de una empresa: comercial, licitaciones y legal. Son cuatro cosas, en este orden.

1. La cuenta y la empresa

Usted crea una cuenta con su nombre, el de su empresa, su correo y una contraseña. Al registrarse, se crea la organización y su sesión queda apuntando a ella.

Cada empresa es la unidad de aislamiento. Un usuario puede pertenecer a varias organizaciones, y la sesión lleva la organización activa: usted cambia de empresa desde el encabezado y todo lo que ve —procesos, propuestas, revisiones, claves— cambia con ella.

Las claves de API pertenecen a la empresa, no a la persona. Sólo el propietario de la organización puede emitirlas y revocarlas, desde Configuración → Claves. El secreto se muestra una vez y no vuelve a mostrarse.

2. El perfil de la empresa

El perfil es lo que hace útil el panel. En Configuración → Perfil usted define:

El perfil se guarda con un identificador de versión, de modo que un cambio de perfil no reescribe los requisitos ni las revisiones ya registradas.

Un detalle que importa: el rango de valores excluye los procesos sin precio base publicado. El estado vacío de la lista lo dice, en vez de insinuar que ese proceso no existe.

3. El panel

El panel y el perfil son modos excluyentes, no se acumulan.

• Con la barra de búsqueda vacía, el panel sigue el perfil: los procesos que le corresponden.

• Con cualquier valor en la barra —texto, UNSPSC o entidad—, el panel busca en todo SECOP II y el perfil queda aparte.

Los chips de arriba le dicen siempre con qué filtros se está corriendo la vista. No hay reglas invisibles.

Cada fila lleva a la ficha del proceso: la entidad, el objeto, la modalidad, la fase, el precio base, la fecha límite de ofertas y, si existe, el contrato adjudicado.

Dos cosas que el panel le dice con claridad:

• La fecha límite de ofertas sólo aparece si SECOP la publica. En la mayoría de los procesos no está, y el panel lo dice en vez de dejar la columna vacía.

• Los precios y las fechas son los de la entidad. No se completan, no se estiman.

Pedir la extracción de un proceso

En la ficha de un proceso abierto, con fecha límite por venir, aparece el botón Estoy interesado: le pide a Quelva que extraiga los requisitos del pliego. Después del clic, la ficha le muestra en qué va la extracción:

• En cola: la extracción espera su turno.

• Extrayendo: se están leyendo el pliego y sus anexos.

• En revisión: una persona está verificando los requisitos antes de publicarlos.

• Listo: los requisitos ya están publicados.

• Sin extraer: no se pudo extraer; puede intentarlo de nuevo mientras el proceso siga abierto.

El estado lo ve la empresa que hizo el clic. Quelva no muestra a nadie cuántas empresas pidieron un proceso, y hay un límite diario de solicitudes por empresa.

4. La revisión de una propuesta

Este es el flujo central del producto, y tiene tres pasos. Se entra desde la ficha del proceso, con el botón Verificar propuesta.

Paso 1 — Cargar los archivos

Usted carga los archivos de su propuesta: el pliego no, sino los suyos —la propuesta, sus anexos, el libro de precios. Se admiten PDF, TXT y XLSX, hasta 20 archivos y 25 MB cada uno, de uno en uno.

Al cargar, Quelva lee los archivos y extrae los valores que puede: el total de la oferta, el plazo, la tarifa de IVA, los precios por ítem, los contratos de experiencia, las certificaciones. Cada valor extraído aparece con su origen —el archivo y la ubicación dentro de él— y queda sin confirmar.

Reglas que el flujo respeta, y que existen por una razón:

• El tipo de archivo lo decide el contenido, no el nombre. Un PDF con extensión .xlsx se lee como PDF.

• Un valor extraído no es una confirmación. Todo queda marcado "extraído del archivo" hasta que usted lo confirme.

• La evidencia es el contenido, no el número de la carga. Si vuelve a subir el mismo archivo con los mismos bytes, la cita del campo no se mueve.

• Lo que el archivo trae y ningún campo recoge no se pierde. Aparece aparte, como referencia, sin campos de formulario.

Paso 2 — Revisar y confirmar, campo por campo

Aquí está el corazón del producto. Los campos no son los que la extracción encontró: son todos los que el proceso exige, derivados del conjunto de requisitos publicado. Un campo que nadie encontró aparece igual, vacío, esperando su respuesta.

Los campos vienen agrupados en cuatro bloques, en el orden en que se revisan:

1. Oferta — el total, el plazo, el IVA y los precios por ítem.

2. Experiencia — los contratos que acreditan la experiencia.

3. Inhabilidades — la consulta a los registros de inhabilitación.

4. Documentos — los nombres de los archivos que el proceso exige.

Cada campo muestra: el valor actual, de dónde salió, quién lo puso, si está confirmado, y qué requisitos lo leen.

Y hay exactamente dos acciones por campo:

• Confirmar este campo — el valor queda con sello de confirmado, con su fecha y con el nombre de quien lo confirmó.

• Dejar sin confirmar — si se había confirmado antes, se revierte.

No hay un botón de "confirmar todo". A propósito: cada campo tiene una consecuencia distinta, y un botón masivo escondería cuáles se revisaron de verdad.

Un detalle de la regla: si usted acepta el valor tal como aparece, queda marcado como "extraído del archivo"; si escribe algo distinto, queda marcado como "ingresado por su empresa". Esa es toda la diferencia que el registro guarda, y es la que después distingue una cifra que el sistema encontró de una que usted certificó.

Al final del paso hay un botón de revisar que corre el motor sobre lo confirmado.

Paso 3 — El informe

El informe tiene cuatro partes:

1. La banda de identificación. Los dos registros de la revisión, con su folio, la versión del conjunto de requisitos, la versión del motor, la fecha y el identificador de la corrida. El folio completo se puede copiar.

2. La banda de bloqueantes. Aparece sólo si hay bloqueantes, y el número que muestra es exactamente el número de filas de la lista.

3. La matriz de requisitos. Agrupada por capa —habilitante, formal, técnico, económico, inhabilidad— con seis columnas: código, requisito, resultado, evidencia, nota y folio.

4. El resumen por registro. Los contadores de cada revisión: cuántos cumplen, cuántos no, cuántos no se pueden verificar, cuántos requieren criterio humano.

Se puede imprimir (Versión para imprimir, que quita el cromo de la página) y se puede descargar el JSON con la revisión completa, folio íntegro incluido.

El informe no dice "verificado" en ninguna parte, y esa es una decisión de diseño, no un descuido. El sello de una revisión que usted confirmó dice "Confirmado por su empresa"; el de una cifra que el sistema encontró dice "Sin confirmar". La revisión formal por nombre de documento dice "cumple por nombre del archivo — evidencia de nombre, no de contenido".

Cómo se aísla

Cada organización ve únicamente lo suyo, y no por cortesía de la aplicación:

• La base de datos lo impone. Seis tablas con datos de empresas están bajo row-level security: la sesión de la base de datos lleva el identificador de la organización dentro de la transacción, y las políticas filtran por él. Una consulta sin ese identificador no devuelve nada, no "todo".

• Los archivos no se mezclan. Cada archivo vive bajo la clave de su organización, en un contenedor separado del de los documentos públicos.

• El identificador de la empresa nunca se lee de la petición. Sale de la sesión, siempre.

Lo que el flujo de revisión guarda

Y lo que no guarda: el texto completo de su propuesta en el registro de la revisión. Se guarda un resumen del contenido y un número de versión, no una copia de su documento.

Continúe

• Qué no hacemos — los límites del producto.

• Datos y privacidad — la licencia de los datos y el aislamiento.