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.dev20260703

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.dev20260703
File Size Uploaded
cacao_accounting-0.0.1.dev20260703.tar.gz 14.6 MB Details

Built distribution (wheel)

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

Total release size: 32.0 MB

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

Download URL cacao_accounting-0.0.1.dev20260703.tar.gz
Size 14.6 MB
Tags Source
SHA-256 checksum
How to use checksums
c8f1c819aa1465d0c984e9d3f4125fa6ad9edb5b2345753bd4f3df3ece82a962
BLAKE2b-256 checksum
How to use checksums
b950062490124ebeee610d489245d32d43ce2d51ac577f5381811a2bf4b8ab98
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 4, 2026.

Transparency log

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

Download URL cacao_accounting-0.0.1.dev20260703-py3-none-any.whl
Size 17.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
58e8c5b009126c7543b3ead03655a5d9378a5d4ef6c017622894b187232c47f7
BLAKE2b-256 checksum
How to use checksums
3b470d7cd239a0b4259f2807426767ebaa4a255d6d02d20f735904eacd8882e2
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 4, 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