# Instructivo para pedir un nuevo pre-proceso a GPT

Este documento sirve para futuras veces que haya que crear un script `.py` para
la pantalla `Interface_Art.vbp` / `FrmSincronizar.frm`, seccion
`PRE - PROCESO`.

## Resumen corto

El pre-proceso siempre recibe un argumento: la ruta del archivo origen que esta
configurada en la lista de precios.

Debe terminar con codigo de salida `0` si salio bien y debe generar un archivo
de salida en la misma carpeta del origen con este patron:

```text
<nombre_base_del_origen>_procesado*.xls
```

Ejemplo:

```text
C:\Listas\Neopel.xls
C:\Listas\Neopel_procesado.xls
C:\Listas\Neopel_procesado (2).xls
```

El sistema no usa lo que el script imprima por pantalla para decidir el archivo
final. Despues de ejecutar el Python, `FrmSincronizar.frm` busca el archivo mas
nuevo que matchee:

```text
<carpeta_origen>\<nombre_base_origen>_procesado*.*
```

Regla importante para `.xlsx`: si la lista tiene pre-proceso y el origen es
`.xlsx`, el pre-proceso debe convertir/generar un `.xls`. No conviene dejar que
Interface_Art entre al camino viejo de conversion `.xlsx -> .txt`
(`export_xlsx_to_txt`), porque puede faltar ese ejecutable o perder estructura
de Excel. El contrato recomendado es:

```text
C:\Listas\Proveedor.xlsx
C:\Listas\Proveedor_procesado.xls
```

## Que significa la opcion marcada

La opcion de la pantalla:

```text
El nombre del archivo se genera automaticamente
```

guarda `PreProcesoGeneraArchivo = True` en `V_Ta_InterODBC`.

Con esa opcion marcada:

- El archivo origen configurado puede no existir.
- Igual debe haber una ruta cargada en el campo archivo/tabla, porque esa ruta
  se usa como ancla para saber carpeta y nombre base.
- El script recibe esa ruta como primer argumento.
- El script debe generar su salida con el patron `_procesado` basado en esa
  ruta.

Ejemplo: si la lista tiene configurado:

```text
C:\Listas\CasaAlberto.xls
```

el script puede descargar desde una web aunque `CasaAlberto.xls` no exista, pero
debe guardar algo como:

```text
C:\Listas\CasaAlberto_procesado.xls
```

Con la opcion desmarcada:

- El archivo origen debe existir antes de ejecutar.
- El script transforma ese archivo existente.
- La salida tambien debe ser `_procesado`.

## Donde deben vivir los scripts

Todos los scripts deben estar dentro de:

```text
scripts_preproceso\
```

La pantalla rechaza scripts ubicados fuera de esa carpeta.

El Python que usa la aplicacion es:

```text
python\python.exe
```

No asumir que hay Python instalado en Windows.

## Argumentos que debe aceptar el script

Minimo:

```text
python script.py "C:\Ruta\ArchivoOrigen.xls"
```

Tambien debe aceptar:

```text
--visible
```

`FrmSincronizar.frm` agrega `--visible` cuando se usa el boton `Probar`. Esto
sirve para scripts con navegador Playwright. Si el script no usa navegador,
igual debe aceptar el argumento para no fallar.

## Reglas de salida

El script debe:

1. Devolver `0` si genero bien el archivo.
2. Devolver distinto de `0` si fallo.
3. Crear el archivo `_procesado` antes de terminar.
4. No pisar salidas anteriores si se quiere conservar historial; usar
   `nombre_disponible`, agregando ` (2)`, ` (3)`, etc.
5. Escribir logs de error en `scripts_preproceso\` o en la carpeta del script.
6. No depender de rutas absolutas fuera de `NMC_CONT_DEV`, salvo que sean datos
   propios de la lista configurada.

## Formato recomendado del Excel generado

Para mayor compatibilidad con VB6/ODBC:

- Preferir `.xls` cuando sea una lista de precios clasica.
- Si el origen es `.xlsx`, convertirlo a `_procesado.xls` dentro del
  pre-proceso.
- Dejar encabezados en la fila 1 siempre que sea posible.
- Evitar celdas combinadas.
- Evitar imagenes, botones, shapes y filtros complejos.
- Usar una sola hoja si la configuracion de la lista espera una sola hoja.
- Mantener nombres de columnas simples y estables.
- Si se agregan columnas calculadas, documentar cual es la columna nueva.

## Casos tipicos

### Transformar un archivo existente

Usar este modelo cuando el proveedor deja un Excel en una carpeta y hay que
limpiarlo, cambiar columnas o calcular precios.

Condiciones:

- Opcion `El nombre del archivo se genera automaticamente`: desmarcada.
- El archivo origen debe existir.
- El script abre ese archivo y genera `<origen>_procesado.xls`.

Si el archivo existente es `.xlsx`, el script debe guardar la salida como
`.xls`, no como `.xlsx`, para que Interface_Art lo pueda leer con el driver
Excel viejo.

Ejemplos del proyecto:

- `scripts_preproceso\procesar_lista_precios_Yuyu.py`
- `scripts_preproceso\procesar_lista_precios_Georgalos.py`

### Solo convertir XLSX a XLS

Usar este modelo cuando la lista no necesita cambios de contenido, solamente
pasar de `.xlsx` a `.xls`.

Condiciones:

- Opcion `El nombre del archivo se genera automaticamente`: desmarcada.
- El archivo origen `.xlsx` debe existir.
- Configurar como pre-proceso:

```text
scripts_preproceso\convertir_xlsx_a_xls.py
```

Comportamiento:

- Con el boton `Probar`, el script recibe `--visible` y pregunta si se quiere
  generar el `.xls`.
- En sincronizacion normal o tarea programada, no pregunta y convierte directo,
  para no dejar el proceso esperando una respuesta.
- La salida queda como `<nombre_base>_procesado.xls`.

### Descargar una lista desde una web

Usar este modelo cuando el script entra a una pagina, se loguea o descarga un
archivo.

Condiciones:

- Opcion `El nombre del archivo se genera automaticamente`: marcada.
- La ruta origen puede ser una ruta "placeholder", pero debe estar cargada.
- El script usa esa ruta para decidir donde guardar la descarga.
- Debe usar `PLAYWRIGHT_BROWSERS_PATH=0` antes de importar Playwright.

Ejemplos del proyecto:

- `scripts_preproceso\procesar_lista_precios_CasaAlberto.py`
- `scripts_preproceso\procesar_lista_precios_Neopel.py`
- `scripts_preproceso\arca_comprobantes.py` usa otro esquema por parametros
  propios y BAT de prueba; tomarlo como referencia de Playwright/logs, no como
  contrato basico de lista de precios.

## Prompt modelo para pedirle a GPT

Copiar y completar:

```text
Estoy trabajando en C:\NETSISTEMAS\SISTEMAS\NwSistemas\NMC_CONT_DEV.

Antes de hacer cambios, lee agents.md.
Proyecto: Interface_Art.vbp.
Necesito crear un nuevo script de pre-proceso Python para FrmSincronizar.frm.

Condiciones del sistema:
- El script debe quedar en scripts_preproceso\.
- Debe ejecutarse con python\python.exe portable del proyecto.
- Debe aceptar como primer argumento la ruta del archivo origen configurado en
  la lista.
- Debe aceptar --visible aunque no lo use.
- Debe devolver exit code 0 si genero correctamente el archivo, y distinto de 0
  si fallo.
- Debe generar el archivo de salida en la misma carpeta del origen con patron:
  <nombre_base>_procesado*.xls
- Si el origen es .xlsx, el pre-proceso debe convertir/generar .xls. No usar
  .txt como salida salvo que la configuracion de la lista este pensada para TXT.
- No debe pisar salidas anteriores; si existe, usar (2), (3), etc.
- Si usa Playwright, setear PLAYWRIGHT_BROWSERS_PATH=0 antes de importar
  playwright.
- Si usa Excel COM, cerrar siempre el libro y Excel en finally.
- Agregar logs claros ante errores.

Opcion "El nombre del archivo se genera automaticamente":
[MARCAR / NO MARCAR]

Si va marcada:
- El archivo origen puede no existir.
- La ruta origen se usa como ancla para carpeta y nombre base.
- El script debe descargar/generar el archivo por su cuenta.

Si no va marcada:
- El archivo origen debe existir.
- El script debe transformar ese archivo existente.

Proveedor/lista:
[nombre exacto de la lista/proveedor]

Archivo origen configurado:
[ruta completa esperada]

Que debe hacer el pre-proceso:
[explicar reglas de negocio: descargar de web, limpiar columnas, calcular
precios, quitar IVA, aplicar descuento, elegir hoja, etc.]

Datos de acceso si aplica:
[URL, usuario, clave, pasos de descarga]

Estructura esperada para Interface_Art:
[hoja, encabezados, columnas que se usaran en Asignar Campos, tipo .xls/.xlsx]

Ejemplos a mirar:
[nombrar scripts existentes parecidos en scripts_preproceso]

Despues de crear el script:
- Ejecutar py_compile.
- Probarlo con python\python.exe.
- Verificar que se genero el archivo _procesado.
- Informar ruta del script, ruta de salida y como configurar la opcion marcada.
```

## Checklist antes de darlo por listo

- El archivo `.py` esta en `scripts_preproceso\`.
- `python\python.exe -m py_compile scripts_preproceso\nuevo_script.py` pasa.
- El script acepta `--visible`.
- El script crea un `_procesado`.
- El `_procesado` queda en la carpeta del archivo origen configurado.
- El nombre base del `_procesado` coincide con el nombre base del origen.
- Si el origen era `.xlsx`, la salida es `.xls`.
- El script devuelve `0` cuando esta OK.
- Si falla, devuelve distinto de `0` y deja log entendible.
- Si usa navegador, probado con `--visible`.
- Si usa Excel COM, no quedan procesos `EXCEL.EXE` abiertos.

## Referencias de codigo

- `FrmSincronizar.frm`: `EjecutarPreProceso`, `CmdProcesarScript_Click`,
  `SincronizarListaSilenciosa`.
- `docs\preproceso_listas_precios.md`: documentacion general del sistema de
  pre-proceso y modo silencioso.
- `scripts_preproceso\procesar_lista_precios_*.py`: ejemplos reales.
