{"id":24519591,"url":"https://github.com/tyronejosee/script_contabilidad","last_synced_at":"2026-04-16T00:32:00.217Z","repository":{"id":319796964,"uuid":"1064482919","full_name":"tyronejosee/script_contabilidad","owner":"tyronejosee","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-27T17:47:52.000Z","size":156,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-20T08:44:09.589Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tyronejosee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-26T05:28:04.000Z","updated_at":"2025-09-30T21:21:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tyronejosee/script_contabilidad","commit_stats":null,"previous_names":["tyronejosee/script_contabilidad"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/tyronejosee/script_contabilidad","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tyronejosee%2Fscript_contabilidad","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tyronejosee%2Fscript_contabilidad/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tyronejosee%2Fscript_contabilidad/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tyronejosee%2Fscript_contabilidad/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tyronejosee","download_url":"https://codeload.github.com/tyronejosee/script_contabilidad/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tyronejosee%2Fscript_contabilidad/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31866287,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","excel","kame","matplotlib","os","pandas","pdf","plotting","poetry","python","re","shutil","sofland","termcolor"],"created_at":"2025-01-22T01:51:48.602Z","updated_at":"2026-04-16T00:31:59.878Z","avatar_url":"https://github.com/tyronejosee.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧰 Script Contabilidad\r\n\r\nEste repositorio es un **conjunto de herramientas automatizadas en Python** diseñadas para optimizar tareas comunes en contabilidad, análisis financiero y generación de documentos. Cada módulo es independiente y resuelve un problema específico, pero todos comparten un enfoque en la **automatización de flujos repetitivos basados en archivos Excel, Word y PDF**.\r\n\r\n## ⚙️ Instalación\r\n\r\nClona el repositorio y navega a la carpeta.\r\n\r\n```bash\r\ngit clone git@github.com:tyronejosee/script_contabilidad.git\r\ncd script_contabilidad\r\n```\r\n\r\nInstala las dependencias y crea el ambiente virtual.\r\n\r\n\u003e Recomendamos usar [uv](https://docs.astral.sh/uv/guides/install-python/#getting-started).\r\n\r\n```bash\r\nuv sync\r\n```\r\n\r\nSi necesitas crear un ejecutable, empaqueta tu script.\r\n\r\n```bash\r\ncd \u003cnombre-modulo\u003e\r\nuv run pyinstaller --onefile \u003cnombre-script\u003e.py\r\n```\r\n\r\nEsto genera.\r\n\r\n* Un ejecutable `.exe` en la carpeta `dist/` del modulo.\r\n* Carpeta `build/` con archivos temporales del modulo.\r\n* Archivo `.spec` (configurable si necesitas personalización).\r\n\r\nOpciones útiles.\r\n\r\n* `--onefile`: todo en un solo `.exe`.\r\n* `--noconsole`: para apps con GUI (no abre consola).\r\n* `--icon=icono.ico`: asigna un ícono.\r\n\r\nEjemplo completo.\r\n\r\n```bash\r\nuv run pyinstaller --onefile --icon=\u003cnombre-icono\u003e.ico \u003cnombre-script\u003e.py\r\n```\r\n\r\n## 🗂️ Estructura del Proyecto\r\n\r\nCada carpeta es un módulo ejecutable con su propio `main.py` y un `README.md` explicando su uso.\r\n\r\n```bash\r\nagrupacion_odoo/               # Divide libro mayor en múltiples archivos por cuenta\r\nanalisis_cheques/              # Analiza y filtra cheques desde archivos Excel\r\nanalitica_proveedores/         # Limpia y netea análisis de proveedores (versión Kame)\r\nanalitica_provedores_odoo/     # Variante para análisis de proveedores desde Odoo\r\ngeneracion_contratos/          # Genera documentos Word y los convierte a PDF\r\ngeneracion_pdf/                # Inserta datos en plantillas PDF desde Excel\r\ngeneracion_reportes/           # Crea reportes financieros y gráficos automáticamente\r\ntxt_softland/                  # Procesa extractos bancarios para exportar a TXT Softland\r\nunir_excels_banco_estado/      # Une y consolida múltiples archivos Excel bancarios\r\n```\r\n\r\n## 📁 Estructura Típica de un Script\r\n\r\nCada módulo sigue un patrón similar:\r\n\r\n* `constants.py` → Configuraciones y variables globales\r\n* `main.py` → Script ejecutable principal\r\n* `README.md` → Guía específica del módulo\r\n* `output/` → Carpeta donde se generan los archivos procesados (Opcional)\r\n\r\n---\r\n\r\n## 📦 Scripts Disponibles\r\n\r\n### Agrupación de Libro Mayor (`agrupacion_odoo/`)\r\n\r\nDivide un archivo Excel del libro mayor en múltiples archivos, uno por cada cuenta contable.\r\n\r\n```bash\r\ncd agrupacion_odoo\r\npython main.py\r\n```\r\n\r\n### Análisis de Cheques (`analisis_cheques/`)\r\n\r\nProcesa un Excel con datos bancarios, filtra secciones relevantes y genera un nuevo archivo limpio.\r\n\r\n```bash\r\ncd analisis_cheques\r\npython main.py\r\n```\r\n\r\n### Analítica de Proveedores (`analitica_proveedores/` y `analitica_provedores_odoo/`)\r\n\r\nLimpia informes de proveedores exportados desde sistemas contables (Kame u Odoo), netea saldos y genera un Excel consolidado.\r\n\r\n```bash\r\ncd analitica_proveedores\r\npython main.py\r\n```\r\n\r\n### Generación Automática de Contratos (`generacion_contratos/`)\r\n\r\nToma datos desde Excel y los inserta en plantillas Word para generar contratos, luego los convierte a PDF.\r\n\r\n```bash\r\ncd generacion_contratos\r\npython main.py\r\n```\r\n\r\n💡 Requiere tener instalado **LibreOffice** para la conversión automática a PDF.\r\n\r\n### Generación de PDFs Personalizados (`generacion_pdf/`)\r\n\r\nInserta datos desde Excel en posiciones específicas de una plantilla PDF y genera documentos individuales.\r\n\r\n```bash\r\ncd generacion_pdf\r\npython main.py\r\n```\r\n\r\n### Reportes Financieros Automatizados (`generacion_reportes/`)\r\n\r\nCrea un resumen financiero, genera gráficos y exporta todo en Excel, PNG y PDF.\r\n\r\n```bash\r\ncd generacion_reportes\r\npython main.py\r\n```\r\n\r\n### TXT Softland (`txt_softland/`)\r\n\r\nConvierte extractos bancarios Excel en archivos limpios y listos para ser importados en **Softland**.\r\n\r\n```bash\r\ncd txt_softland\r\npython main.py\r\n```\r\n\r\n---\r\n\r\n## ⚖️ Licencia\r\n\r\nEste proyecto está licenciado bajo la [Apache 2.0](LICENSE).\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftyronejosee%2Fscript_contabilidad","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftyronejosee%2Fscript_contabilidad","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftyronejosee%2Fscript_contabilidad/lists"}