# Homologación de recursos para actualización de precios

Voy a proporcionarte un archivo XLSX (Excel) con dos hojas.

La primera hoja, "Fuente externa", contiene los recursos y precios proporcionados en una cotización de un proveedor o en una fuente externa.
La segunda hoja, "Recursos internos", contiene los recursos actualmente registrados en un presupuesto o listado en Quercusoft.

Cada hoja contiene, como mínimo, las siguientes columnas:

* **Código**
* **Descripción**
* **Unidad**
* **Precio**

## Objetivo

El objetivo es **homologar los recursos del listado de uso interno con los recursos existentes en la fuente externa**, para determinar qué recursos internos tienen una correspondencia en la fuente externa y, de esta manera, identificar qué precios pueden ser actualizados posteriormente en el programa.

La homologación debe hacerse principalmente con base en la **equivalencia técnica y funcional del recurso**, y no únicamente por similitud textual entre las descripciones.

## Reglas para la homologación

Para cada recurso del **listado de uso interno**:

1. Busca el recurso correspondiente entre los recursos de la **fuente externa**.

2. Compara principalmente:

   * Descripción y características técnicas.
   * Tipo de recurso.
   * Unidad de medida.
   * Marca, referencia, modelo o especificación, cuando exista.
   * Dimensiones, capacidad, calibre, resistencia, composición u otras características relevantes, cuando estén disponibles.
   * Cualquier otra información que permita determinar si ambos registros representan el mismo recurso.

3. No utilizar los códigos en la comparación. No debes asumir que códigos diferentes representan recursos diferentes ni que códigos iguales garantizan por sí solos una equivalencia si las demás características contradicen esa correspondencia.

4. La **unidad de medida es un criterio importante de validación**. Si las unidades son diferentes, analiza si la diferencia puede explicarse por una conversión válida o si realmente se trata de recursos diferentes. No realices conversiones de cantidades o precios si no existe información suficiente para justificarlas.

5. No consideres equivalentes dos recursos únicamente porque sus descripciones contienen palabras similares.

6. Si existen diferencias técnicas que puedan afectar el precio o el uso del recurso, considera que no son equivalentes, aunque las descripciones sean parecidas.

7. Si existen varios recursos de la fuente externa que podrían corresponder al mismo recurso interno, no elijas arbitrariamente. Identifica las alternativas y marca el caso para revisión.

8. Si no existe un recurso de la fuente externa que pueda considerarse razonablemente equivalente, indica que **no se encontró una homologación**.

9. **No inventes códigos, descripciones, unidades ni precios.** Todos los datos del resultado deben provenir de los archivos proporcionados.

10. Es preferible dejar un recurso como **"No homologado"** o **"Requiere revisión"** antes que establecer una correspondencia incorrecta.

## Nivel de confianza

Para cada homologación asigna uno de estos niveles:

* **ALTA:** existe una correspondencia clara entre el recurso interno y un único recurso de la fuente externa, sin diferencias técnicas relevantes.
* **MEDIA:** existe una correspondencia razonable, pero hay alguna característica que debería ser revisada.
* **BAJA:** existe cierta similitud, pero no hay suficiente información para afirmar que se trata del mismo recurso.
* **NO HOMOLOGADO:** no se encontró un recurso de la fuente externa razonablemente equivalente.

No consideres una homologación de confianza BAJA como una coincidencia confirmada.

## Resultado

Genera un nuevo archivo XLSX (Excel) con una fila por cada recurso del **listado de uso interno**.

El resultado debe contener las siguientes columnas:

| Columna             | Contenido                                                                         |
| ------------------- | --------------------------------------------------------------------------------- |
| Código interno      | Código del recurso en el listado de uso interno                                   |
| Descripción interna | Descripción original del recurso interno                                          |
| Unidad interna      | Unidad del recurso interno                                                        |
| Precio interno      | Precio actual del recurso interno                                                 |
| Código externo      | Código del recurso homologado en la fuente externa                                |
| Descripción externa | Descripción original del recurso externo                                          |
| Unidad externa      | Unidad del recurso externo                                                        |
| Precio externo      | Precio indicado en la fuente externa                                              |
| Estado              | Homologado / Requiere revisión / No homologado                                    |
| Confianza           | Alta / Media / Baja / No homologado                                               |
| Justificación       | Explicación breve de por qué se considera equivalente o por qué requiere revisión |

### Importante sobre el resultado

* Conserva exactamente las descripciones originales de ambos archivos.
* No modifiques ni normalices los códigos originales.
* No reemplaces el precio interno por el precio externo.
* El **precio interno debe conservarse como el precio actualmente registrado**.
* El **precio externo debe conservarse como el nuevo precio de referencia**.
* La finalidad de esta etapa es identificar correctamente la correspondencia entre recursos; la actualización de precios se realizará posteriormente mediante la herramienta correspondiente de Quercusoft.

## Criterio especial para evitar errores

No fuerces una coincidencia.

Una coincidencia debe considerarse válida únicamente cuando exista suficiente evidencia para concluir que el recurso interno y el recurso externo representan esencialmente **el mismo recurso para efectos de su identificación y actualización de precio**.

Por ejemplo, no consideres automáticamente equivalentes:

* dos materiales de la misma familia pero con diferente especificación;
* dos productos con diferente calibre, diámetro, resistencia, capacidad o dimensión;
* dos equipos con diferente capacidad o características relevantes;
* dos productos de diferentes referencias cuando la referencia tenga incidencia en el precio;
* recursos con unidades incompatibles;
* recursos que solo coinciden en algunas palabras de la descripción.

Cuando exista información insuficiente para decidir, utiliza **"Requiere revisión"** en lugar de asumir una equivalencia.

## Resumen final

Al finalizar el análisis, presenta también un resumen indicando:

* Número total de recursos internos analizados.
* Número de recursos homologados con confianza **ALTA**.
* Número de recursos homologados con confianza **MEDIA**.
* Número de recursos con confianza **BAJA**.
* Número de recursos que requieren revisión.
* Número de recursos no homologados.

Además, muestra una lista de los casos que requieren revisión, indicando brevemente cuál es el motivo de la duda.

Recuerda: **el objetivo principal es obtener una homologación confiable de los recursos internos contra la fuente externa, no maximizar el número de coincidencias.**