← Índice de manuales
Manual funcional · Sistema Plenario v14

Gestión Importación Cuentas Corrientes

La opción Importación de Cuentas Corrientes permite cargar de forma masiva movimientos (ingresos y egresos) en las cuentas corrientes de los clientes, proveedores y proveedores financieros, evitando tener que…

Módulo: Gestión ComercialVersión: 1.1Actualizado: 2026-06-19

Detalle

Campo Valor
Manual de Usuario Importación masiva de movimientos en cuentas corrientes de Clientes, Proveedores y Proveedores Financieros a partir de una planilla Excel.

Introducción

La opción Importación de Cuentas Corrientes permite cargar de forma masiva movimientos (ingresos y egresos) en las cuentas corrientes de los clientes, proveedores y proveedores financieros, evitando tener que registrarlos uno por uno.

El proceso es simple: se descarga una plantilla modelo en formato Excel, se completa con los movimientos a importar, se vuelve a cargar al sistema y se ejecuta la importación. El sistema valida fila por fila los datos antes de registrarlos y, al finalizar, informa cuántos movimientos se procesaron correctamente y cuántos quedaron con errores, con el detalle de cada caso.

Importante: cada movimiento importado registra un cobro/pago parcial en la cuenta corriente de la entidad indicada e impacta también en la cuenta contable que se asocia en la planilla. Es una operación que modifica saldos reales; conviene revisar bien la planilla antes de aceptar.

Acceso al módulo

  1. Ingresá al Menú principal del sistema.
  2. Abrí el módulo Cuentas Corrientes.
  3. Dentro de la solapa de Gestión, abrí la opción Más (opciones adicionales).
  4. Seleccioná Importación de Cuentas Corrientes.

Importante: para abrir esta opción el usuario debe tener habilitado el permiso CuentasCorrientes.Importacion_Ctas_Ctes. Si no lo tiene, el sistema no permite ingresar a la pantalla.

Pantalla principal

Al ingresar se abre una ventana con los controles necesarios para descargar la plantilla, cargar el archivo completado y ejecutar la importación.

Elemento Descripción
Botón Descargar Plantilla Genera y guarda una plantilla modelo en formato Excel (.xls) con las columnas que el sistema espera para importar.
Botón Cargar (Archivo) Abre un cuadro de diálogo para seleccionar la planilla Excel ya completada con los movimientos a importar.
Ruta del archivo Muestra la ubicación del archivo seleccionado una vez cargado.
Botón Aceptar Inicia el proceso de importación. Permanece deshabilitado hasta que se carga un archivo.
Botón Ver Resultado Se habilita al finalizar la importación. Abre el detalle fila por fila con el estado y las observaciones de cada movimiento.

Parámetros

La importación se realiza a partir de un único archivo Excel (.xls) descargado con el botón Descargar Plantilla. La primera fila es el encabezado y cada fila siguiente representa un movimiento a registrar.

La plantilla contiene las siguientes columnas, todas obligatorias:

Columna Descripción
ID_TipoEntidad Tipo de entidad sobre la que se registra el movimiento: 1 = Cliente, 2 = Proveedor Financiero, 3 = Proveedor.
ID_Entidad Identificador (Id) de la entidad (cliente, proveedor financiero o proveedor) que debe existir en el sistema. Debe ser un número entero positivo.
ID_Especie Identificador de la especie/moneda del movimiento. Debe ser un número entero positivo correspondiente a una especie existente.
Fecha Fecha del movimiento. Debe ser una fecha válida entre el 01/01/1900 y el 31/12/2099.
Descripcion Texto descriptivo del movimiento. Máximo 80 caracteres.
Ingreso Importe que ingresa a la cuenta corriente. Número mayor o igual a 0, sin negativos.
Egreso Importe que egresa de la cuenta corriente. Número mayor o igual a 0, sin negativos.
Cuenta_Contable Número de la cuenta contable contra la que se registra el movimiento. Debe corresponder a una cuenta existente en el plan de cuentas.

Importante: en cada fila, Ingreso y Egreso no pueden ser ambos 0, ni pueden tener ambos un valor mayor a 0. Cada movimiento debe ser sólo un ingreso o sólo un egreso.

Resultado del proceso

Al finalizar, el sistema procesa cada fila de la planilla y muestra un resumen con la cantidad de movimientos procesados correctamente y la cantidad de movimientos con errores.

Resultado Significado
Movimientos procesados con éxito Filas cuyos datos pasaron todas las validaciones y se registraron en la cuenta corriente y en la cuenta contable.
Movimientos con errores Filas que no cumplieron alguna validación (datos faltantes, formato inválido, entidad/especie/cuenta inexistente, etc.). No se registran y se informa el motivo.
Detalle por movimiento Para cada fila queda una observación: si fue exitosa, indica entidad, fecha e importe; si falló, indica el motivo del rechazo. Se consulta con el botón Ver Resultado.

Importante: las filas con error no detienen el proceso; el sistema continúa con las demás filas y deja registrado el motivo de cada rechazo para que puedas corregir la planilla y volver a importar sólo lo que falló.

Acciones disponibles

Acción Cómo se realiza
Descargar la plantilla modelo Botón Descargar Plantilla, se elige dónde guardar el archivo .xls.
Cargar el archivo a importar Botón Cargar, se selecciona la planilla Excel completada.
Ejecutar la importación Botón Aceptar (se habilita recién al cargar un archivo).
Ver el detalle del resultado Botón Ver Resultado, disponible al terminar la importación.

Ejemplo práctico

Una financiera necesita cargar 50 ajustes de saldo en las cuentas corrientes de varios clientes:

  1. Abre Cuentas Corrientes → Más → Importación de Cuentas Corrientes.
  2. Presiona Descargar Plantilla y guarda el archivo Plantilla para Movimiento CtaCte.xls.
  3. Completa la planilla: en cada fila pone ID_TipoEntidad = 1 (Cliente), el Id del cliente, la especie, la fecha, una descripción, el importe en Ingreso o en Egreso (sólo uno), y la cuenta contable.
  4. Guarda el Excel, vuelve a la pantalla y presiona Cargar para seleccionar el archivo.
  5. Presiona Aceptar. El sistema valida y registra los movimientos.
  6. Lee el resumen (por ejemplo: 48 con éxito, 2 con errores) y presiona Ver Resultado para identificar las 2 filas con problemas, corregirlas y volver a importar sólo esas.

Consejos útiles

  • Descargá siempre la plantilla desde la pantalla y no modifiques el nombre ni el orden de las columnas del encabezado.
  • Verificá que los Id de entidad, especie y cuenta contable existan en el sistema antes de importar; son las validaciones que más rechazos generan.
  • Recordá que cada fila debe tener importe sólo en Ingreso o sólo en Egreso, nunca en ambos ni ambos en cero.
  • La descripción admite hasta 80 caracteres; textos más largos se rechazan.
  • Después de importar, usá Ver Resultado y guardá/corregí las filas con error para reprocesarlas en un nuevo archivo.

Preguntas frecuentes

¿Qué número va en la columna ID_TipoEntidad? 1 para Cliente, 2 para Proveedor Financiero y 3 para Proveedor. Cualquier otro valor hace que la fila se rechace.
¿Puedo poner importe en Ingreso y en Egreso a la vez? No. Cada movimiento debe ser sólo un ingreso o sólo un egreso. Si ambos están en 0 o ambos tienen valor, la fila se rechaza.
Importé el archivo y algunas filas dieron error, ¿qué hago? Presioná **Ver Resultado** para ver el motivo de cada rechazo (por ejemplo, entidad inexistente, fecha inválida, cuenta contable que no existe). Corregí esas filas en la planilla y volvé a importar sólo las que fallaron. Las filas correctas ya quedaron registradas.
¿Por qué el botón Aceptar está deshabilitado? Porque todavía no se cargó un archivo. Primero usá el botón **Cargar** para seleccionar la planilla Excel; al hacerlo se habilita Aceptar.
¿Qué formato de fecha y de archivo debo usar? El archivo debe ser una planilla Excel .xls (la que se descarga con Descargar Plantilla). La fecha debe ser una fecha válida dentro del rango 01/01/1900 a 31/12/2099.

Permisos

Permiso Función
CuentasCorrientes.Importacion_Ctas_Ctes Permite abrir y utilizar la opción de Importación de Cuentas Corrientes para importar movimientos en cuentas corrientes de Clientes, Proveedores y Proveedores Financieros.

Información técnica

Sección de referencia para soporte/desarrollo. Basada en el análisis del formulario real de la v14 (proyecto C# VPNET_WinForms / VPNET_DataModel, módulo Cuentas Corrientes / Gestión).

Formularios principales

Componente Detalle
Formulario FormImportacion_CtaCte (hereda de FrmProcesar)
Ubicación UI VPNET_WinForms/VPNET_WinForms/Common/FormImportacion_CtaCte.cs
Punto de acceso VisualPlenarioNET/frmMainParts/frmNewMain.vbbtn_ImportacionCtasCtes_ItemClick (abre el form con ShowDialog)
Detalle de resultados FormImportacionArchivosDetalle (botón Ver Resultado / btnDescargar); pinta en rojo las filas con Status = false
Lectura del Excel Excel_Manager<ImportFichero>.Get_ExcelTable (OleDb Microsoft.Jet.OLEDB.4.0) → lista de CtaCte_Manager.ImportFichero
Modelo de fila CtaCte_Manager.ImportFichero (campos string: ID_TipoEntidad, ID_Entidad, ID_Especie, Fecha, Descripcion, Ingreso, Egreso, Cuenta_Contable + Status bool y Observaciones string)
Manager de registración CtaCte_ManagerRegistrarCobroParcialCliente (tipo 1), RegistrarCobroParcialInversor (tipo 2), RegistrarCobroParcialProveedor (tipo 3)
Generación de plantilla GenerarPlantilla() usa RTF_LibraryNCG.DocumentFormat; archivo por defecto Plantilla para Movimiento CtaCte.xls

Permisos reales

Permiso Habilita
CuentasCorrientes.Importacion_Ctas_Ctes Abrir y usar la importación; validado con clsSeguridad.IsAllowedObject en el launcher (btn_ImportacionCtasCtes_ItemClick), no dentro del form.

Tablas de base de datos principales

Entidad / tabla Detalle
Clientes / Inversores / Proveedores Entidad destino según ID_TipoEntidad (1/2/3); debe existir
Especies La especie del movimiento debe existir
Cuentas La cuenta contable se busca por Numero; debe existir en el plan
Cta. corriente (CuentaCorrientes_Manager.GenerarMovCtaCte) Movimiento generado por cada fila
Asientos (Asientos_Manager) Un asiento contable por cada movimiento importado

Acceso a datos: Entity Framework (vpnetContext).

Relación con otros módulos / manuales

Manual relacionado Vínculo operativo
Cuenta Corriente (Clientes, Proveedores y Prov. Financieros) Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad.

Notas para soporte (comportamiento real del código)

  • Modifica saldos reales: cada fila genera un movimiento de cuenta corriente y un asiento contable independiente. 100 filas = 100 asientos.
  • Sin transacción global: las filas se procesan en un loop fila por fila; si el proceso falla a mitad, las filas ya registradas quedan grabadas (importación parcial, sin rollback automático).
  • chk_Validaciones oculto (Visible = false): por defecto se pasa false, lo que saltea las validaciones de ejercicio contable disponible/no congelado (clsContabilidad_ejercicios.IsDateAvailable) y de saldo suficiente (GetSaldo). Es decir, en condiciones normales se registra sin controlar ejercicio ni saldo. Esas validaciones solo corren si alguien hace visible y tilda el checkbox.
  • Validaciones por fila siempre activas: ID_TipoEntidad ∈ {1,2,3}; ID_Entidad/ID_Especie/Cuenta_Contable enteros >0 y existentes; Fecha válida 01/01/1900–31/12/2099; Descripcion ≤80; regla XOR Ingreso/Egreso (uno y solo uno >0). Las filas con error no detienen el proceso.
  • Permiso solo en el launcher: instanciar FormImportacion_CtaCte por otra vía no revalida el permiso.
  • Descripción de asiento con literal "Clientes": el texto del asiento usa "...Clientes Nro: ..." incluso para Inversores/Proveedores (hardcodeo cosmético).
  • bt_Aceptar deshabilitado hasta cargar un archivo (bt_Aceptar.Enabled = false en el constructor).
¿Te resultó útil este manual?