🤖 Bot Pagos de VEPs (AFIP ARCA)

---

📌 Descripción del proyecto

Este proyecto automatiza la generación de VEPs (Volantes Electrónicos de Pago) en el módulo de “Contribuciones de Obras Sociales” del portal ARCA de AFIP.

Fue desarrollado en Python + Playwright para agilizar la carga masiva de datos provenientes de un archivo Excel, generar los comprobantes de pago y descargar los VEPs de forma automática, reduciendo el trabajo manual y los errores de ingreso.

💡 El proceso completo:

1. Lee los datos desde empleados.xlsx (CUIL, código de obra social e importe).
2. Ingresa al portal AFIP/ARCA (Contribuciones de Obras Sociales).
3. Genera los VEPs de forma automatizada.
4. Descarga los comprobantes y guarda registros, logs y capturas organizadas por ejecución.

---

⚙️ Tecnologías y librerías

Tecnología	Uso principal
🐍 Python 3.13	Lenguaje base
🎭 Playwright	Automatización de interfaz web
📊 openpyxl	Lectura de datos desde Excel
🧾 logging	Registro de eventos y errores
📦 PyInstaller	Creación del ejecutable (.exe)
💻 Windows 10 / 11 / Server	Entorno compatible

---

📁 Estructura del proyecto

BotVepArca/ │ ├── automation/ │ ├── credenciales.py │ ├── excel_reader.py │ ├── login_flow.py │ ├── portal_flow.py │ ├── run_logger.py │ └── vep_flow.py │ ├── data/ │ └── empleados.xlsx │ ├── dist/ │ └── BotVepArca.exe │ ├── logs/ │ ├── runs.csv │ └── screenshot_error_YYYY-MM-DD_HHMMSS.txt │ ├── screenshots/ │ ├── [capturas generadas por el bot] │ ├── vep_pdfs/ │ ├── [archivos PDF generados] │ ├── main.py ├── requirements.txt ├── README.md └── icon.ico

---

🚀 Instalación y ejecución

1️⃣ Crear entorno virtual (opcional pero recomendado)

python -m venv .venv
.venv\Scripts\activate

2️⃣ Instalar dependencias
pip install -r requirements.txt
python -m playwright install

3️⃣ Ejecutar el bot
python main.py


📘 Asegurate de que el archivo empleados.xlsx esté dentro de la carpeta /data/.

💾 Versión compilada (.exe)

Podés descargar la versión ejecutable lista para usar en Windows desde Google Drive:
👉 Descargar versión (.exe)

(Reemplazá el enlace con el tuyo real.)

📸 Resultados
Carpeta	Contenido
/logs/	Registros de ejecución y errores
/screenshots/	Capturas automáticas de cada ejecución
/vep_pdfs/	Comprobantes VEP descargados
/dist/	Versión compilada del bot
🧭 Roadmap de mejoras

 Integración con APIs oficiales de AFIP (WSAA / WSVEP)

 Validación automática de estados de VEP

 Envío de resultados por correo

 Dashboard visual de ejecuciones

 Integración CI/CD con GitHub Actions

👨‍💻 Autor

Mauricio Hladij
📍 Buenos Aires, Argentina
💼 QA | Automation | Business Analysis
🔗 LinkedIn

🪪 Licencia

Este proyecto se distribuye bajo la licencia MIT.
Consulta el archivo LICENSE
 para más información.

⭐ Si este proyecto te resulta útil, no olvides darle una estrella en GitHub.