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
  • Para habilitar características en la nube (como validación MIME segura en la subida de archivos), instale las dependencias opcionales: pip install cacao-accounting[cloud]
  • 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.dev20260711

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

Built distribution (wheel)

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

Total release size: 32.1 MB

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

Download URL cacao_accounting-0.0.1.dev20260711.tar.gz
Size 14.6 MB
Tags Source
SHA-256 checksum
How to use checksums
43311b7b48972b020a7de75112497c4f3e748899ebdf3f7fcdbde0ba001d0432
BLAKE2b-256 checksum
How to use checksums
e5e92a84983f482de3fc29f52e2b2420eac3bdac1765ff0eb085d2d4820add8c
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 12, 2026.

Transparency log

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

Download URL cacao_accounting-0.0.1.dev20260711-py3-none-any.whl
Size 17.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
37f3a815ef8c34e2bc197ed9f9d8c042425fe98d0cb4c0dcf67970994e5199bf
BLAKE2b-256 checksum
How to use checksums
155ed41921e71c8a81dc8c2f834d792cea65e83e82eef27baac907535638982e
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 12, 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