Importador de Clientes (Excel)

El Importador de Clientes es un asistente (wizard) que permite cargar clientes de manera masiva desde un archivo Excel (.xls o .xlsx). En lugar de cargar cliente por cliente desde el ABM, este formulario lee el archivo, le permite indicar qué columna del Excel corresponde a cada campo del cliente, valida los datos y finalmente da de alta o actualiza los registros en la base de datos del sistema actual.

El asistente trabaja en cuatro pantallas: bienvenida, configuración y mapeo del archivo, verificación previa de los datos y, por último, el resultado del proceso. Permite además guardar el mapeo de columnas como una configuración reutilizable para próximas importaciones.

1. Iniciá sesión — Ingresá al sistema Plenario con tu usuario habitual.
2. Ingresá a la solapa Inicio y abrí Clientes — Desde la barra superior, accedé al formulario de Clientes.
3. Ejecutá la operación de importación desde Excel — Desde las operaciones del formulario de Clientes (botón/menú de importación), se abre la ventana Importación de Clientes.

El asistente se invoca desde el formulario de Clientes mediante la rutina ImportarClientes_Excel(), que verifica el permiso correspondiente antes de abrir la ventana.

El asistente está compuesto por las siguientes páginas (WizardControl):

El título de la ventana es "Importación de Clientes".

Página de bienvenida

• Descargar diseño de registro modelo — Genera y guarda una plantilla Excel (Plantilla_Clientes.xls) con la fila de encabezados de todos los campos importables, para que cargue sus datos sobre ese modelo.

Página "Configurar archivo"

• Ubicación del archivo a importar — Campo con botón para buscar el archivo Excel. También admite arrastrar y soltar (drag & drop) el archivo sobre el control. Filtro: *.xls;*.xlsx.
• Configuración — Combo para seleccionar un mapeo previamente guardado para la tabla Clientes. Botones asociados: agregar nueva, actualizar y eliminar configuración.
• Grilla "Tabla" — Lista los campos del cliente disponibles para importar, con su tipo de dato, valor por defecto, columna mapeada y si es obligatorio. Los campos obligatorios se muestran en negrita; los campos mapeados quedan resaltados en verde.
• Grilla "Archivo" — Lista las columnas detectadas en el Excel y un ejemplo del primer dato leído. Las columnas ya vinculadas se resaltan en verde.
• Botones de vinculación — Vincular (asocia la columna del archivo seleccionada al campo de tabla seleccionado), Desvincular (quita un mapeo puntual), Desvincular todo (limpia todos los mapeos y valores por defecto) y Reiniciar asistente.
• Actualizar existentes — Si está marcado, los clientes cuyo CUIT ya exista en la base se actualizan; si está desmarcado, se ignoran.
• Asociar automáticamente (grupo opcional) — Solo visible si el parámetro Clientes.UtilizaModuloAsociados está activo. Permite asociar automáticamente al importar e indicar la fecha de vencimiento del aporte.

Campos obligatorios para importar (lstPropsRequeridasTabla): nombre, cuit y oficial. Deben quedar mapeados a una columna o tener un valor por defecto antes de avanzar.

Página "Verificar clientes"

Antes de guardar, el asistente muestra una grilla con cada cliente leído del archivo, indicando Nombre, CUIT, si es Actualización, Estado y Observaciones. El color de cada fila informa el estado:

Validaciones aplicadas

• nombre: obligatorio.
• cuit: obligatorio; se aceptan 11 dígitos con o sin guiones (formato ##-########-#).
• oficial: obligatorio (distinto de 0).
• Persona física (Id_TipoPersona = 1): NombreFisico y ApellidoFisico obligatorios.
• Condición IVA "Consumidor Final" (condición = 2): solo aplica a persona física.

Página de finalización

Muestra un resumen con: cantidad de registros procesados con éxito (discriminando nuevos, actualizados y asociados), cantidad de ignorados, cantidad no importados con el detalle de errores, y el tiempo total del proceso.

1. En la pantalla de bienvenida, hacé clic en Descargar diseño de registro modelo y completá el Excel con tus clientes respetando los encabezados.
2. Hacé clic en Siguiente y seleccioná (o arrastrá) el archivo completado.
3. En la grilla Archivo verás las columnas detectadas; en la grilla Tabla, los campos del cliente.
4. Seleccioná una columna del archivo y el campo equivalente de la tabla y presioná Vincular. Repetí al menos para nombre, cuit y oficial.
5. Si querés actualizar clientes ya existentes, dejá marcado Actualizar existentes.
6. Presioná Siguiente: el sistema importa y valida cada fila. Revisá los colores y observaciones.
7. Presioná Siguiente nuevamente para guardar. Al finalizar, leé el resumen del proceso y hacé clic en Finalizar.

• Asegurate de que el Excel tenga una fila de encabezado con los nombres de columna; el asistente la usa para mostrar las columnas a mapear.
• Guardá el mapeo como configuración cuando vayas a repetir importaciones con el mismo formato de archivo: ahorra tiempo y evita errores.
• Revisá las filas en color salmón antes de guardar: el motivo del rechazo está en la columna Observaciones.
• El CUIT puede ir con o sin guiones, pero siempre debe tener 11 dígitos.
• Si activás "Asociar al importar", verificá la fecha de vencimiento del aporte antes de continuar.

El acceso al importador requiere el permiso Clientes.Busquedas.Operaciones_Importar (descripción "Permite Importar Clientes desde Excel", grupo Clientes.Busquedas). Si el usuario no lo tiene, la ventana no se abre.

Basada en el análisis del formulario real de la v14.

Formularios y pantallas

Managers y clases de negocio

Stored Procedures y funciones

Tablas de base de datos

Permisos reales

Este mismo string de permiso lo comparte la importación desde otra base (ver el manual Importación de Clientes desde otra Base), pero con otra descripción ("…de otra Base de datos").

Relación con otros módulos / manuales

Notas para soporte

• El gestor de negocio es ImportadorClientesManager (VPNET_DataModel); la detección de duplicados se hace por CUIT con clsClientes.Search.
• La asociación automática usa los parámetros Asociados.CantidadAccionesDefault y Asociados.CantidadAccionesIntegrarAlta, y solo se habilita con Clientes.UtilizaModuloAsociados = 1.
• Validaciones del motor (Valid): nombre, cuit (11 dígitos con o sin guiones) y oficial obligatorios; persona física (Id_TipoPersona = 1) exige NombreFisico y ApellidoFisico; "Consumidor Final" (condicion = 2) solo aplica a persona física.
• Verificar contra el binario instalado: los textos y comportamientos pueden variar según la versión desplegada.