Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Logo

Cacao Accounting

CI Quality Gate Status Coverage Status PyPI - License PyPI - Python Version PyPI - Wheel Docker Repository on Quay Code style: black Code style: Prettier Ruff Gitter

Aplicación contable web y de escritorio para PYMEs que centraliza tesorería, compras, ventas, inventario y contabilidad general.

Estado actual

  • En desarrollo activo en la rama main con base en Python 3.12, Flask y SQLAlchemy.
  • Arquitectura basada en blueprints por módulo: auth, bancos, compras, ventas, inventario, contabilidad, document_flow, imports y más.
  • Soporte inicial de AR/AP, pagos/cobros, conciliación, inventario con valuación, impuestos y reglas fiscales, documentos operativos, importaciones masivas y trazabilidad documental.
  • UI con Alpine.js, smart-select y diseño de formularios transaccionales compartidos.
  • Internacionalización preparada para es y en.
  • Calidad integrada con black, ruff, flake8, mypy, pydocstyle y pytest.

Nota: el proyecto sigue siendo de desarrollo y no está listo para uso en producción.

Características principales implementadas

  • Cuentas por cobrar y cuentas por pagar.
  • Gestión de inventario con Stock Reconciliation y valuación de ajustes.
  • Payment entry con impuestos y cargos visibles, reglas fiscales y aplicación de referencias.
  • Matriz de flujo documental (document_flow) para crear documentos derivados y mantener trazabilidad.
  • Administración de clientes/proveedores con contactos, direcciones, grupos y cuentas por compañía.
  • Motor fiscal unificado para preview y persistencia de reglas fiscales.
  • Proceso de importación masiva de datos y documentos operativos.
  • Revalorización cambiaria auditada y soporte para múltiples libros/ledgers.

Uso recomendado para desarrolladores

  • Crear un entorno virtual: python -m venv .venv
  • Activar el entorno: source .venv/bin/activate
  • Instalar dependencias: pip install -r requirements.txt
  • Ejecutar pruebas: CACAO_TEST=True LOGURU_LEVEL=WARNING SECRET_KEY=ASD123kljaAddS python -m pytest -v -s --exitfirst --slow=True

Demo online

Live demo at:
URL: https://cacao-accounting.onrender.com/login
User: cacao
Password: cacao

Wait to the free render instance to wake up.

Participar en el proyecto

Todos los aportes son bienvenidos. Consulta el archivo CONTRIBUTING para más detalles.

Licencia

Derechos de autor 2024 - 2026 William José Moreno Reyes

Autorizado en virtud de la Licencia de Apache, Versión 2.0 (la "Licencia"); se prohíbe utilizar este archivo excepto en cumplimiento de la Licencia. Podrá obtener una copia de la Licencia en:

http://www.apache.org/licenses/LICENSE-2.0

A menos que lo exijan las leyes pertinentes o se haya establecido por escrito, el software distribuido en virtud de la Licencia se distribuye “TAL CUAL”, SIN GARANTÍAS NI CONDICIONES DE NINGÚN TIPO, ya sean expresas o implícitas. Véase la Licencia para consultar el texto específico relativo a los permisos y limitaciones establecidos en la Licencia.

Release files for cacao-accounting 0.0.1.dev20250703

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cacao-accounting 0.0.1.dev20250703
File Size Uploaded
cacao_accounting-0.0.1.dev20250703.tar.gz 14.6 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for cacao-accounting 0.0.1.dev20250703
File Interpreter ABI Platform
cacao_accounting-0.0.1.dev20250703-py3-none-any.whl Python 3 none any Details

Total release size: 32.0 MB

Release files / cacao_accounting-0.0.1.dev20250703.tar.gz

Download URL cacao_accounting-0.0.1.dev20250703.tar.gz
Size 14.6 MB
Tags Source
SHA-256 checksum
How to use checksums
bb83f9511bba11e138d2d8ee71b8e4de664376a378436f7482f2c538f22ab5df
BLAKE2b-256 checksum
How to use checksums
0674450b6356558f030087b0ca25319d4b98333dea0361b1790d1c22447c2b36
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.

Transparency log

Release files / cacao_accounting-0.0.1.dev20250703-py3-none-any.whl

Download URL cacao_accounting-0.0.1.dev20250703-py3-none-any.whl
Size 17.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
0ef958913a92ec66ecb78bb03ee34ac6ac4046b13f0cfce9c90cd0f7521455aa
BLAKE2b-256 checksum
How to use checksums
28dac19ac73085a0d2602361346a8ee1f46156dbbb2521a961bb2d47449f68ff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.

Transparency log

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page