Detalle
| Tipo | Manual de Usuario |
| Módulo | Contabilidad |
| Formulario | FormContabilidad_Importador_Asientos |
| Versión | 1.0 |
Introducción
El importador de asientos permite cargar masivamente asientos contables a partir de un archivo Excel (.xls / .xlsx), evitando la carga manual uno por uno. El proceso es guiado por un asistente (wizard) de varios pasos: parte de una plantilla modelo, mapea las columnas del archivo contra los campos de la tabla de asientos, valida cada asiento (cuentas existentes, balance Debe = Haber, fecha dentro del ejercicio) y, recién entonces, genera los asientos en la contabilidad.
El asistente agrupa automáticamente las filas del Excel por Concepto + Fecha: cada grupo se convierte en un asiento con su cabecera y un detalle por cada renglón (cuenta, debe, haber).
Esta función se distribuye como complemento (plugin
Class_PlugIn_Asientos_Importacion.dll). Si el archivo no está presente en la instalación, la opción avisa que no se encuentra el complemento. Verificar contra el binario instalado.
Acceso al módulo
Menú Contabilidad → Importar Asientos desde Excel (opción "Importar Excel" en la cinta de Contabilidad).
Al ingresar, el sistema verifica que exista el complemento Class_PlugIn_Asientos_Importacion.dll y que el usuario tenga el permiso correspondiente; en caso contrario la ventana no se abre.
Pantalla principal
La ventana es un asistente paso a paso con las siguientes páginas:
- Bienvenida — "Bienvenido al asistente de importación de asientos contables". Incluye el botón Descargar diseño de registro modelo para obtener la plantilla Excel.
- Configurar archivo (Paso 1) — selección del archivo, mapeo de columnas y administración de configuraciones de mapeo.
- Verificar asientos — grilla con los asientos armados (cabecera y detalle expandible) para revisión y corrección.
- Finalización — resumen del resultado de la importación.
Parámetros
En el Paso 1 se trabajan dos grillas y un combo:
- Tabla (grilla izquierda): campos de destino del asiento. Columnas: Campo, Descripción, Mapeo y Valor por Defecto. Los campos obligatorios se muestran en negrita.
- Archivo (grilla derecha): columnas leídas del Excel. Columnas: Columna, Dato Leído y Es Parámetro.
- Configuración (combo): permite guardar/recuperar un mapeo ya armado para reutilizarlo en futuras importaciones.
Campos obligatorios del asiento (deben quedar mapeados o tener valor por defecto): Fecha, Concepto, Nro_Cta, Debe, Haber, Id_CentroDeCosto, Id_Especie_DetalleItem.
Columnas sugeridas en la plantilla modelo: Fecha, Concepto, Cuenta, Debe, Haber, Id_Centro_Costo, Descripcion_Detalle, Id_Especie_DetalleItem.
Resultado del proceso
Al avanzar desde el Paso 1, el sistema importa el archivo, agrupa por Concepto+Fecha y valida cada asiento. En la página de verificación los asientos con error se resaltan en color salmón y su columna Observaciones indica el motivo.
Validaciones aplicadas por asiento:
- El asiento debe tener al menos un renglón de detalle.
- Cada cuenta (Nro_Cta) debe existir en el Plan de Cuentas y no ser cuenta Rubro.
- La especie (Id_Especie_DetalleItem) debe existir.
- El asiento debe balancear: total Debe = total Haber (con posible ajuste por redondeo según parámetros).
- Debe y Haber no pueden ser ambos 0.
- La fecha debe caer dentro de un ejercicio abierto (no congelado).
En el paso final se muestra un resumen: cantidad de asientos importados con éxito, lista de asientos generados, cantidad y detalle de asientos no importados por errores, y el tiempo total demorado.
Acciones disponibles
- Descargar diseño de registro modelo: genera la plantilla Excel "Plantilla_Asientos.xls" con las columnas esperadas.
- Vincular / Desvincular / Desvincular todo: asocian o quitan la relación entre una columna del archivo y un campo de la tabla.
- Agregar configuración: guarda el mapeo actual con un nombre para reutilizarlo.
- Actualizar configuración: sobrescribe la configuración seleccionada con el mapeo actual.
- Eliminar configuración: borra la configuración seleccionada en el combo.
- Reiniciar asistente: limpia el archivo, los mapeos y vuelve al estado inicial.
- Editar en grilla de verificación: se pueden corregir valores de cabecera y de detalle; al cambiar un valor se revalida el asiento.
- Eliminar renglón/asiento (botón papelera): quita un asiento de la lista a importar.
- Importación (Siguiente sobre la verificación): guarda los asientos válidos en la contabilidad mostrando progreso.
- Arrastrar y soltar (drag & drop): se puede soltar el archivo Excel directamente sobre el cuadro de ruta o la grilla de archivo.
Ejemplo práctico
- Abrir Contabilidad → Importar Asientos desde Excel.
- En la bienvenida, pulsar Descargar diseño de registro modelo y completar el Excel: una fila por renglón, repitiendo Fecha y Concepto para los renglones del mismo asiento.
- Avanzar al Paso 1 y seleccionar (o arrastrar) el archivo.
- Mapear cada columna del archivo con su campo de la tabla (o cargar una configuración guardada). Verificar que los campos en negrita queden mapeados.
- Opcional: pulsar Agregar configuración para guardar el mapeo.
- Pulsar Siguiente: el sistema arma los asientos y muestra la grilla de verificación.
- Revisar las filas en salmón, corregir lo indicado en Observaciones.
- Pulsar Siguiente para importar y, al finalizar, leer el resumen y pulsar Finalizar.
Consejos útiles
- Guarde una configuración de mapeo por cada formato de archivo recurrente: la próxima vez solo selecciona la configuración y evita re-mapear.
- Use valores por defecto (por ejemplo, Id_Centro_Costo o Id_Especie) para columnas que no vienen en el Excel pero son obligatorias.
- Mantenga idénticos la Fecha y el Concepto entre los renglones de un mismo asiento; así el sistema los agrupa correctamente.
- Si un asiento desbalancea por centavos, revise los parámetros de ajuste por redondeo de contabilidad antes de corregir manualmente.
Preguntas frecuentes
¿Qué formatos de archivo acepta?
Libros de Excel .xls y .xlsx.¿Cómo decide el sistema qué filas forman un asiento?
Agrupa las filas por la combinación de Concepto y Fecha; cada grupo es un asiento y cada fila del grupo es un renglón de detalle.¿Por qué un asiento aparece en rojo/salmón?
Porque la validación detectó un problema: cuenta inexistente o Rubro, especie inválida, asiento desbalanceado, Debe y Haber en cero, o fecha fuera del ejercicio. El detalle figura en la columna Observaciones.¿Puedo reutilizar el mapeo de columnas?
Sí. Guárdelo con "Agregar configuración" y luego selecciónelo desde el combo Configuración en futuras importaciones.No aparece la opción de importar, ¿por qué?
La función depende del complemento Class_PlugIn_Asientos_Importacion.dll. Si no está instalado, el sistema avisa que no se encuentra. Verificar la instalación con Sistemas.Permisos
| Permiso | Acción |
|---|---|
Contabilidad.Asientos_Importacion |
Permite el ingreso al formulario de importación de asientos desde Excel |
Sin este permiso, la opción de menú no abre la ventana.
Información técnica
Basada en el análisis del formulario real de la v14
Formularios principales
| Form | Rol |
|---|---|
| FormContabilidad_Importador_Asientos | Asistente (wizard) de importación de asientos desde Excel |
| FrmObservaciones | Captura el nombre al guardar una configuración de mapeo |
Permisos reales
| Permiso | Acción |
|---|---|
Contabilidad.Asientos_Importacion |
Habilita la opción de menú y la apertura del asistente (verificado en FormTile.vb / cinta de Contabilidad) |
Tablas de base de datos principales
| Tabla | Uso |
|---|---|
| Asientos (ContabilidadAsientos) | Cabecera del asiento contable generado |
| (detalle de asiento) ContabilidadAsientosDetalle | Renglones del asiento: cuenta, debe, haber, centro de costo, especie |
| Cuentas | Validación de la cuenta contable (Nro_Cta, no Rubro) |
| Especies | Validación de la especie (Id_Especie_DetalleItem) |
| Importaciones_Wizard_Configuracion | Configuraciones de mapeo guardadas (campo Tabla = "Asientos") |
Relación con otros módulos / manuales
| Manual relacionado | Vínculo operativo |
|---|---|
| "Marcas de Conciliación" | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
| "Cuentas de Servicios" | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
Notas para soporte
- El caption del formulario en código es "Importación de Asientos"; la opción de menú y el texto del permiso usan "Importar Asientos desde Excel". Verificar contra el binario instalado.
- La función se entrega como plugin externo (
Class_PlugIn_Asientos_Importacion.dll), cargado dinámicamente desde FormTile.vb. Si el DLL falta, la opción no funciona. - El guardado de asientos usa
Asientos_Manager(EF Core / contexto VPNET) e incluye lógica de ajuste por redondeo gobernada por los parámetrosContabilidad.Asientos.AjustePorRedondeoyContabilidad.Asientos.ToleranciaDeAjustePorRedondeo. - Form legacy/híbrido (WinForms C# sobre arquitectura antigua de plugin). Verificar contra el binario instalado.