Gestión Importación de Ventas

El asistente de Importación de Comprobantes de Ventas permite cargar de forma masiva comprobantes de ventas desde un archivo Excel, evitando el ingreso manual uno por uno. Es ideal para volúmenes grandes (cientos o miles de comprobantes) o para migrar datos provenientes de otros sistemas.

El proceso es guiado y se divide en cuatro pasos: se sube el archivo y se mapean sus columnas con los campos del sistema, se definen los valores por defecto, se previsualizan y corrigen los registros, y finalmente se confirma la generación de los comprobantes.

Por cada comprobante importado correctamente, el sistema genera el comprobante de venta, el movimiento en la cuenta corriente de la entidad y el asiento contable, tal como si se hubiera cargado manualmente. Además, si la entidad (cliente, inversor o proveedor) no existe en la base, el asistente puede darla de alta automáticamente.

1. Ingresá al sistema con tu usuario.
2. Dirigite a la pestaña Gestión.
3. Abrí la opción Más y seleccioná Importador de Comprobantes de Ventas.
4. Se abrirá el asistente en una nueva pestaña, posicionado en la pantalla de bienvenida.

Importante: El acceso requiere el permiso correspondiente, que debe solicitarse al administrador del sistema. Sin ese permiso la opción no abrirá.

El asistente se presenta como una secuencia de pasos. Cada paso se recorre con los botones Siguiente y Anterior, y se cierra con Finalizar.

En el Paso 1 conviven dos grillas: la grilla Archivo (columnas detectadas en el Excel) y la grilla Tabla (campos del sistema). El vínculo entre ambas es el mapeo.

En el Paso 3, los registros también se pintan por color:

Plantilla de Excel (botón Descargar plantilla)

La plantilla descargada (Plantilla para importación de comprobantes de ventas.xls) trae los encabezados esperados. Las columnas principales son:

Importante: No modifiques los encabezados de la plantilla. Si tus columnas tienen otros nombres, no hace falta renombrarlas: se resuelve con el mapeo del Paso 1.

Mapeo de columnas (Paso 1)

El mapeo indica al sistema cómo interpretar cada columna del Excel.

Valores por defecto (Paso 2)

Para los campos obligatorios que no figuran en el archivo, se puede fijar un valor único aplicado a todos los comprobantes. Tildá la casilla del campo y elegí el valor.

Importante: Si un comprobante no trae fecha, el sistema intenta completarla con la fecha de entrega y, si tampoco existe, con la fecha por defecto. El campo Tipo de Comprobante puede informarse por su código AFIP, en cuyo caso el sistema deduce automáticamente la letra y, si falta, el punto de venta del talonario.

Al confirmar la importación en el Paso 3, el sistema recorre los registros y, por cada uno válido, genera:

El Paso 4 muestra un resumen con: cantidad de comprobantes importados con éxito, el detalle de cada comprobante creado (Id, abreviatura, letra/punto de venta/número, razón social, asiento y movimiento de cuenta corriente), los comprobantes no importados por error, las nuevas entidades dadas de alta y el tiempo total que demoró el proceso.

Importante: No se puede avanzar a la confirmación final si quedan registros en rojo. Hay que corregirlos o eliminarlos primero.

Una empresa necesita cargar 500 facturas de venta del mes que tiene en una planilla Excel propia.

1. Abre el asistente desde Gestión > Más > Importador de Comprobantes de Ventas.
2. En el Paso 1 descarga la plantilla para conocer los campos esperados, luego carga su propio Excel con Cargar archivo.
3. Mapea sus columnas: "Fecha" → FechaEmision, "Cliente" → Denominación Comprador, "CUIT" → Nro. Doc. Comprador, "Total" → Importe Total, etc. Guarda el mapeo como "Ventas mensuales" para reutilizarlo el mes siguiente.
4. En el Paso 2 marca Sucursal = "Sucursal Central" y Vendedor = "Mostrador", porque esos datos no están en su Excel. Deja el resto sin tildar.
5. Pulsa Siguiente: el sistema importa y valida los 500 registros. En el Paso 3, 12 quedan en rojo por un CUIT mal escrito. Los corrige en la grilla hasta que todos quedan en blanco.
6. Confirma la importación. El Paso 4 informa que se crearon 500 comprobantes, se dieron de alta 3 clientes nuevos y el proceso demoró 4 minutos.

• Verificá que el Excel no tenga filas en blanco ni caracteres extraños; el asistente descarta las filas totalmente vacías, pero los datos sucios generan errores.
• Respetá los formatos: fechas en dd/mm/aaaa e importes numéricos.
• Guardá tus diseños de registro para no volver a mapear en cada importación.
• Usá el código AFIP en "Tipo de Comprobante" para que el sistema deduzca solo la letra y el punto de venta.
• Antes de confirmar, revisá la columna Observaciones de los registros en rojo: indica exactamente qué falta.
• Si vas a dar de alta entidades nuevas, asegurate de que el CUIT venga sin guiones y que el plan de cuentas tenga la cuenta contable correspondiente (Clientes / Inversores / Proveedores).

Los usuarios sin este permiso no verán resultado al intentar abrir la opción.

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 Gestión).

Formularios principales

Permisos reales

Tablas de base de datos principales

Acceso a datos: Entity Framework 6 (VisualPlenarioNetContext), con transacción + rollback por comprobante.

Relación con otros módulos / manuales

Notas para soporte (comportamiento real del código)

• Genera registros reales e (casi) irreversibles: por cada comprobante válido crea comprobante + asiento contable + movimiento de cta. cte.; deshacer requiere anulación manual posterior.
• Transacción por comprobante: cada comprobante se guarda con BeginTransaction / SetCommit / Rollback; si una fila falla se revierte esa fila, pero las anteriores ya quedaron grabadas.
• No avanza con filas en rojo: las filas con HttpStatusCode.BadRequest se pintan en Color.Salmon y se saltean (continue) en GuardarComprobantes; hay que corregirlas o eliminarlas.
• Validación paralelizada: ValidaDatosImportados usa Parallel.ForEach con MaxDegreeOfParallelism = ProcessorCount - 1, un GestionComprobantesManager por hilo y cachés ConcurrentDictionary (entidades por CUIT, abreviaturas, duplicados en HashSet). Volúmenes muy grandes elevan uso de CPU/memoria.
• Alta automática de entidades por CUIT: si no encuentra la entidad por CUIT la da de alta con datos mínimos (CUIT, razón social, observación "Generado desde el asistente..."). Si el CUIT de la base difiere en formato (con/sin guiones), puede no matchear y crear un duplicado.
• Valores hardcodeados en el alta del comprobante: Id_Direccion_Entrega/Id_DomicilioEntrega = 0 y Id_FormaDePago = 1.
• Tipos de entidad: 1 = Cliente, 2 = Inversor, 3 = Proveedor (IdTipoEntidadDefault); valor >3 o 0 sin default → BadRequest.