A cliente (client) in ContabilidadISV represents a Honduran business entity (empresa) on whose behalf accounting consolidations are prepared. Every consolidation record is linked to exactly one client. Client data is stored in theDocumentation 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.
clientes table in SQL Server and exposed through the clientesApi service on the frontend and the /api/clientes router on the backend.
Client Fields
The table below describes every field on the client entity:| Field | Type | Constraints | Description |
|---|---|---|---|
nombre_empresa | string | 2–255 characters, required | Legal name of the business |
rtn | string | 3–50 characters, digits and hyphens only (^[0-9\-]+$), required | Honduran tax identification number (Registro Tributario Nacional) |
rubro | string | 2–100 characters, required | Business sector (e.g., Comercio, Servicios, Industria, Hotel) |
representante | string | 2–255 characters, required | Name of the legal representative |
telefono | string | 8–20 characters, digits/dashes/parentheses/spaces/+ allowed, required | Contact phone number |
email | string | valid email format, required | Contact email address |
direccion | string | 5–500 characters, required | Full business address |
activo | boolean | default true | Whether the client is active in the system |
logo_url | string | null | optional | Relative path to the client’s uploaded logo image |
fecha_registro | datetime | auto-set on creation | Timestamp when the client was first created |
fecha_actualizacion | datetime | auto-updated | Timestamp of the last update |
Creating a Client
Navigate to Clientes → Ver y Añadir
Click Clientes in the sidebar and select Ver y Añadir to open the
ClientsViewSection.Click Agregar Cliente
Click the Agregar Cliente button in the top-right of the clients list panel. A modal dialog opens.
Fill in all required fields
Complete the form:
- Nombre de la Empresa — the company’s legal name
- R.T.N. — Honduran tax ID (numbers and hyphens only)
- Rubro — business sector
- Representante — legal representative’s full name
- Teléfono — contact telephone number
- Correo Electrónico — contact email
- Dirección — complete postal address
If the RTN you enter already exists in the database, the system shows a RTN Duplicado confirmation dialog. You can choose to proceed and register a second client with the same RTN, or cancel and review the existing record.
RTN Validation
The RTN (Registro Tributario Nacional) is Honduras’s national tax identification number for businesses and individuals. ContabilidadISV enforces the following validation rule on this field:0801-2024-00123 or 08019999999999.
The RTN is displayed alongside the company name throughout the application — in consolidation headers, export files, and report summaries.
Editing a Client
Clicking the pencil (edit) icon in the clients list opens the Edit Client modal. To protect data integrity, the following fields are not editable after creation:nombre_empresartnrubrorepresentanteemail
telefono and direccion may be changed through the edit form. The client’s active/inactive status can also be toggled from within the edit modal.
Viewing Client Consolidations
From the client list, click the eye (view) icon to open the Client Details modal, which shows all stored fields for that client. Administrators can also access the full consolidation history for a specific client via theGET /api/consolidaciones/cliente/:clienteId endpoint, which returns all GENERALES and HOTELES consolidations linked to that client, sorted by creation date descending.
Deactivating a Client
Deactivating a client by setting
activo = false (click the green Activo badge to toggle) hides them from new-consolidation client dropdowns — only active clients (activo = true) are returned by GET /api/clientes?activo=true. All historical consolidation data for the client is fully preserved and remains accessible in the history and reports views.clientesApi.delete(id) call performs a soft deactivation, not a physical row removal.
Related Pages
Consolidations
Learn how consolidations are created and linked to clients.
Reports
Filter report summaries and rankings by individual client.
Clientes API
REST endpoints for creating, reading, updating, and deactivating clients.
Audit Logs
Track cliente_created and cliente_updated events in the bitácora.