ContabilidadISV is a full-stack web application built for Honduran accountants to manage ISV (Impuesto Sobre Ventas) and IST (Impuesto Sobre Turismo) tax consolidations. It provides a React-based dashboard backed by an Express/SQL Server API, with support for two consolidation types (Generales and Hoteles), automated tax formula calculations, and optional Electron desktop packaging for offline use.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Medinaallan/ContabilidadISV/llms.txt
Use this file to discover all available pages before exploring further.
Quick Start
Install dependencies, configure the database, and run the system locally in minutes.
Architecture
Understand how the React frontend, Express backend, SQL Server, and Electron wrapper fit together.
Core Features
Explore consolidations, client management, reports, exports, and audit logs.
API Reference
Full REST API documentation for every endpoint — auth, consolidaciones, clientes, reports, and more.
What ContabilidadISV Does
ContabilidadISV centralizes the monthly accounting consolidation workflow for Honduran businesses. Accountants enter debit (Debe) and credit (Haber) amounts across a 55-account chart of accounts. The system automatically computes ISV 15%, ISV 18%, and (for hotel clients) IST 4% tax figures, then stores each consolidation against a client record in SQL Server.Double-Entry Ledger
55 chart-of-accounts entries per consolidation with automatic tax formula calculations.
Two Consolidation Types
Generales (54 accounts) and Hoteles (55 accounts, includes IST 4%).
Excel & PDF Export
Download any consolidation as a formatted Excel spreadsheet or PDF document.
Client Management
Maintain a directory of companies with RTN validation, contact details, and activity history.
Role-Based Access
JWT authentication with admin and user roles to control access to sensitive operations.
Electron Desktop App
Package the full stack as a Windows installer for offline deployment without a server.
Getting Started
Install dependencies
Clone the repository and install all frontend and backend packages with a single command.
Configure the database
Set your SQL Server connection details in
backend/.env and run the database initialization script.Start the application
Launch both the backend API (port 3002) and the Vite frontend dev server simultaneously.
See the Quickstart guide for full step-by-step instructions including database schema setup and environment variable configuration.