{"id":11424,"date":"2026-09-23T19:37:30","date_gmt":"2026-09-23T22:37:30","guid":{"rendered":"https:\/\/www.alfagestion.com.ar\/ag\/?p=11424"},"modified":"2026-09-23T19:37:33","modified_gmt":"2026-09-23T22:37:33","slug":"automatizaciones-de-listas-de-precios-con-ia-instructivo-tecnico-para-generar-preprocesos-python","status":"publish","type":"post","link":"https:\/\/www.alfagestion.com.ar\/ag\/automatizaciones-de-listas-de-precios-con-ia-instructivo-tecnico-para-generar-preprocesos-python\/","title":{"rendered":"Automatizaciones de listas de precios con IA: instructivo tecnico para generar preprocesos Python"},"content":{"rendered":"\n

# Automatizaciones de listas de precios con IA: instructivo tecnico para generar preprocesos Python<\/strong><\/p>\n\n\n\n

**Slug sugerido:**<\/strong> `instructivo-ia-preprocesos-listas-de-precios`<\/p>\n\n\n\n

**Categoria sugerida:**<\/strong> Automatizaciones<\/p>\n\n\n\n

**Etiquetas sugeridas:**<\/strong> Alfa Gestion, Inteligencia Artificial, Listas de Precios, Python, Playwright, Excel, Integraciones<\/p>\n\n\n\n

**Resumen:**<\/strong> Guia tecnica para que un asistente de inteligencia artificial pueda crear o corregir scripts Python compatibles con el preproceso de listas de precios de Alfa Gestion.<\/p>\n\n\n\n

—<\/p>\n\n\n\n

## Objetivo<\/strong><\/p>\n\n\n\n

Este documento define el contrato que debe cumplir cualquier script Python generado para descargar, transformar o preparar una lista de precios antes de importarla en Alfa Gestion.<\/p>\n\n\n\n

Esta guia esta dirigida tanto a usuarios y tecnicos como a asistentes de inteligencia artificial. El resultado esperado es siempre un archivo `.py` completo, verificable y compatible con el entorno portable incluido en Alfa Gestion.<\/p>\n\n\n\n

## Instrucciones obligatorias para el asistente de IA<\/strong><\/p>\n\n\n\n

Cuando un usuario solicite crear o corregir una automatizacion de listas de precios:<\/p>\n\n\n\n

1. Analizar primero la necesidad real y la informacion disponible.<\/p>\n\n\n\n

2. No inventar URLs de descarga, selectores, nombres de archivos, usuarios ni contrasenas.<\/p>\n\n\n\n

3. Si solo se conoce la pagina principal del proveedor, navegar esa pagina y localizar el enlace real de descarga.<\/p>\n\n\n\n

4. Si el sitio requiere botones, formularios, autenticacion o JavaScript, utilizar Playwright.<\/p>\n\n\n\n

5. Devolver el archivo Python completo, no fragmentos ni diferencias.<\/p>\n\n\n\n

6. No incluir explicaciones ni bloques Markdown cuando el usuario solicite el `.py` final.<\/p>\n\n\n\n

7. Conservar el comportamiento existente cuando se trate de una correccion.<\/p>\n\n\n\n

## Contrato de ejecucion<\/strong><\/p>\n\n\n\n

El script sera ejecutado de esta forma:<\/p>\n\n\n\n

“`text<\/p>\n\n\n\n

python.exe script.py “C:\\Ruta\\archivo_origen.xls” [–visible]\n\n\n\n

“`<\/p>\n\n\n\n

Debe cumplir estas condiciones:<\/p>\n\n\n\n

– El primer argumento es siempre la ruta de archivo configurada en Alfa Gestion.<\/p>\n\n\n\n

– Debe aceptar el argumento opcional `–visible`.<\/p>\n\n\n\n

– Si usa navegador, `–visible` debe ejecutar Playwright con `headless=False`.<\/p>\n\n\n\n

– Sin `–visible`, el proceso debe poder ejecutarse sin intervencion del operador.<\/p>\n\n\n\n

– Debe devolver codigo de salida `0` solamente cuando el resultado fue generado y validado.<\/p>\n\n\n\n

– Ante cualquier error debe devolver un codigo distinto de `0`.<\/p>\n\n\n\n

– Debe imprimir en `stdout` informacion util sobre el avance y el resultado.<\/p>\n\n\n\n

– Debe imprimir o registrar el detalle completo de los errores.<\/p>\n\n\n\n

## Ruta origen como ancla<\/strong><\/p>\n\n\n\n

Cuando esta activa la opcion **El nombre del archivo se genera automaticamente**<\/strong>, el archivo origen puede no existir. En ese caso la ruta recibida se utiliza como ancla para determinar:<\/p>\n\n\n\n

– La carpeta de salida.<\/p>\n\n\n\n

– El nombre base de la lista.<\/p>\n\n\n\n

– El nombre del archivo procesado.<\/p>\n\n\n\n

El script no debe exigir que el archivo ancla exista cuando su trabajo consiste precisamente en descargar o generar la lista.<\/p>\n\n\n\n

## Archivo de salida<\/strong><\/p>\n\n\n\n

La salida debe generarse en la misma carpeta de la ruta ancla y respetar este patron:<\/p>\n\n\n\n

“`text<\/p>\n\n\n\n

<nombre_base>_procesado.xls<\/p>\n\n\n\n

<nombre_base>_procesado (2).xls<\/p>\n\n\n\n

<nombre_base>_procesado (3).xls<\/p>\n\n\n\n

“`<\/p>\n\n\n\n

Reglas:<\/p>\n\n\n\n

– No sobrescribir archivos procesados anteriores.<\/p>\n\n\n\n

– Si el proveedor entrega `.xlsx`, convertir la salida a `.xls` cuando la interfaz configurada lo requiera.<\/p>\n\n\n\n

– No cambiar la extension de un archivo sin convertir realmente su formato.<\/p>\n\n\n\n

– No guardar HTML, JSON o una pagina de error con extension `.xls`.<\/p>\n\n\n\n

– Antes de devolver codigo `0`, comprobar que el `_procesado` existe y no esta vacio.<\/p>\n\n\n\n

– Validar que el contenido corresponde al formato esperado.<\/p>\n\n\n\n

## Descargas desde sitios web<\/strong><\/p>\n\n\n\n

### Descarga directa<\/strong><\/p>\n\n\n\n

Puede utilizarse `urllib.request` solamente cuando existe una URL directa, estable y comprobada al archivo.<\/p>\n\n\n\n

La respuesta debe validarse antes de guardarla:<\/p>\n\n\n\n

– Estado HTTP correcto.<\/p>\n\n\n\n

– Tamano mayor que cero.<\/p>\n\n\n\n

– Tipo de contenido coherente.<\/p>\n\n\n\n

– El contenido no debe comenzar con HTML de error o pagina de acceso.<\/p>\n\n\n\n

### Sitios con interaccion<\/strong><\/p>\n\n\n\n

Utilizar Playwright cuando sea necesario:<\/p>\n\n\n\n

– Abrir una pagina.<\/p>\n\n\n\n

– Iniciar sesion.<\/p>\n\n\n\n

– Completar formularios.<\/p>\n\n\n\n

– Resolver navegacion JavaScript.<\/p>\n\n\n\n

– Presionar un boton o enlace.<\/p>\n\n\n\n

– Esperar una descarga.<\/p>\n\n\n\n

Antes de importar Playwright debe configurarse:<\/p>\n\n\n\n

“`python<\/p>\n\n\n\n

import os<\/p>\n\n\n\n

os.environ[“PLAYWRIGHT_BROWSERS_PATH”] = “0”<\/p>\n\n\n\n

“`<\/p>\n\n\n\n

La descarga debe capturarse con `expect_download()` y guardarse mediante `save_as()`.<\/p>\n\n\n\n

No utilizar Selenium, ChromeDriver ni instalar paquetes durante la ejecucion.<\/p>\n\n\n\n

## Entorno Python disponible<\/strong><\/p>\n\n\n\n

El script debe funcionar con el Python portable distribuido junto con Alfa Gestion. Puede apoyarse en:<\/p>\n\n\n\n

– Biblioteca estandar de Python.<\/p>\n\n\n\n

– Playwright.<\/p>\n\n\n\n

– pandas.<\/p>\n\n\n\n

– openpyxl.<\/p>\n\n\n\n

– pywin32 y Excel COM cuando esten disponibles en la instalacion.<\/p>\n\n\n\n

No debe depender de `requests`, Selenium, ChromeDriver ni paquetes descargados durante la ejecucion.<\/p>\n\n\n\n

## Procesamiento de Excel<\/strong><\/p>\n\n\n\n

Si utiliza Excel COM:<\/p>\n\n\n\n

– Crear una instancia separada con `DispatchEx`.<\/p>\n\n\n\n

– Desactivar alertas y actualizacion de pantalla.<\/p>\n\n\n\n

– Cerrar el libro en un bloque `finally`.<\/p>\n\n\n\n

– Ejecutar `Excel.Quit()` siempre, incluso si ocurre un error.<\/p>\n\n\n\n

– No dejar procesos `EXCEL.EXE` abiertos.<\/p>\n\n\n\n

Si utiliza openpyxl:<\/p>\n\n\n\n

– Recordar que no genera archivos binarios Excel 97-2003 reales.<\/p>\n\n\n\n

– No guardar un libro OOXML con extension `.xls`.<\/p>\n\n\n\n

– Utilizar una conversion real cuando la salida obligatoria sea `.xls`.<\/p>\n\n\n\n

## Registros y errores<\/strong><\/p>\n\n\n\n

Todo archivo de log debe escribirse en UTF-8:<\/p>\n\n\n\n

“`python<\/p>\n\n\n\n

with ruta_log.open(“a”, encoding=”utf-8″) as archivo:<\/p>\n\n\n\n

    archivo.write(mensaje + “\\n”)<\/p>\n\n\n\n

“`<\/p>\n\n\n\n

La escritura del log debe tener su propio manejo de errores. Un problema al escribir el log nunca debe ocultar la excepcion original.<\/p>\n\n\n\n

El error informado debe incluir:<\/p>\n\n\n\n

– Paso que estaba ejecutando.<\/p>\n\n\n\n

– URL o archivo involucrado, sin credenciales.<\/p>\n\n\n\n

– Excepcion completa o traceback.<\/p>\n\n\n\n

– Codigo de salida distinto de cero.<\/p>\n\n\n\n

## Seguridad<\/strong><\/p>\n\n\n\n

– No escribir contrasenas, tokens ni API keys en logs.<\/p>\n\n\n\n

– No publicar credenciales dentro del script.<\/p>\n\n\n\n

– No desactivar validaciones TLS.<\/p>\n\n\n\n

– No ejecutar codigo descargado desde el sitio del proveedor.<\/p>\n\n\n\n

– No borrar archivos ajenos al proceso.<\/p>\n\n\n\n

– Limitar las operaciones a la ruta ancla, temporales propios y archivo de salida.<\/p>\n\n\n\n

## Prueba obligatoria<\/strong><\/p>\n\n\n\n

Antes de entregar el script:<\/p>\n\n\n\n

1. Ejecutar `python -m py_compile script.py`.<\/p>\n\n\n\n

2. Ejecutarlo con una ruta ancla de prueba y `–visible` si usa navegador.<\/p>\n\n\n\n

3. Confirmar que el navegador se muestra cuando corresponde.<\/p>\n\n\n\n

4. Confirmar que se descarga el archivo real, no HTML.<\/p>\n\n\n\n

5. Confirmar que se genera un `_procesado` nuevo.<\/p>\n\n\n\n

6. Abrir o validar el archivo generado.<\/p>\n\n\n\n

7. Confirmar codigo de salida `0` en caso correcto.<\/p>\n\n\n\n

8. Simular un error y confirmar codigo distinto de `0`.<\/p>\n\n\n\n

9. Verificar que no quedan procesos de navegador o Excel abiertos.<\/p>\n\n\n\n

## Informacion que debe proporcionar el usuario<\/strong><\/p>\n\n\n\n

Para obtener un buen resultado, el pedido debe incluir:<\/p>\n\n\n\n

– Nombre del proveedor o lista.<\/p>\n\n\n\n

– Pagina web inicial.<\/p>\n\n\n\n

– Ruta ancla configurada.<\/p>\n\n\n\n

– Si la opcion de nombre automatico esta marcada.<\/p>\n\n\n\n

– Usuario y clave solamente cuando sean indispensables, preferentemente como parametros separados.<\/p>\n\n\n\n

– Pasos manuales actuales para obtener la lista.<\/p>\n\n\n\n

– Formato del archivo descargado.<\/p>\n\n\n\n

– Hoja, encabezados y columnas importantes.<\/p>\n\n\n\n

– Transformaciones necesarias antes de importar.<\/p>\n\n\n\n

– Mensaje completo del ultimo error.<\/p>\n\n\n\n

– Script actual, si se solicita una correccion.<\/p>\n\n\n\n

– Capturas, PDF o Excel de ejemplo cuando ayuden a comprender el proceso.<\/p>\n\n\n\n

## Prompt recomendado<\/strong><\/p>\n\n\n\n

“`text<\/p>\n\n\n\n

Lee y cumple el instructivo tecnico de preprocesos Python de Alfa Gestion.<\/p>\n\n\n\n

Necesito crear o corregir una automatizacion de lista de precios.<\/p>\n\n\n\n

Proveedor\/lista:<\/p>\n\n\n\n

[nombre]\n\n\n\n

Pagina inicial:<\/p>\n\n\n\n

[URL]\n\n\n\n

Ruta ancla:<\/p>\n\n\n\n

[ruta]\n\n\n\n

El nombre se genera automaticamente:<\/p>\n\n\n\n

[SI\/NO]\n\n\n\n

Pasos que hoy realiza el usuario:<\/p>\n\n\n\n

[detalle]\n\n\n\n

Resultado esperado:<\/p>\n\n\n\n

[detalle]\n\n\n\n

Error actual:<\/p>\n\n\n\n

[error completo]\n\n\n\n

Devuelve unicamente el archivo Python completo. No inventes URLs de descarga.<\/p>\n\n\n\n

El script debe comprobar que genero un archivo _procesado valido antes de<\/p>\n\n\n\n

devolver codigo de salida 0.<\/p>\n\n\n\n

“`<\/p>\n\n\n\n

## Checklist final para la IA<\/strong><\/p>\n\n\n\n

– Devuelve un `.py` completo.<\/p>\n\n\n\n

– Usa solamente librerias disponibles.<\/p>\n\n\n\n

– Acepta ruta ancla y `–visible`.<\/p>\n\n\n\n

– Respeta modo visible y silencioso.<\/p>\n\n\n\n

– No inventa URLs ni selectores.<\/p>\n\n\n\n

– No guarda HTML como Excel.<\/p>\n\n\n\n

– Genera `_procesado*.xls` en la carpeta correcta.<\/p>\n\n\n\n

– No sobrescribe salidas anteriores.<\/p>\n\n\n\n

– Valida el resultado antes de devolver `0`.<\/p>\n\n\n\n

– Registra errores en UTF-8.<\/p>\n\n\n\n

– No expone credenciales.<\/p>\n\n\n\n

– Cierra navegador, archivos y Excel en todos los casos.<\/p>\n\n\n\n

—<\/p>\n\n\n\n

Este documento complementa el manual de sincronizacion automatica de listas de precios de Alfa Gestion y debe utilizarse como contrato tecnico para cualquier automatizacion generada o corregida con inteligencia artificial.<\/p>\n

Compartir:<\/h3>