Detalle
| Campo |
Valor |
| Manual de Usuario |
Importador de Comprobantes de Compra: asistente paso a paso para registrar de forma masiva, desde un archivo Excel, los comprobantes de compra descargados de ARCA/AFIP (Mis Comprobantes Recibidos) u otra fuente. |
| Módulo |
Gestión Comercial |
| Pantalla |
Importador de comprobantes de compras (asistente / wizard) |
| Permiso |
Gestion.Operaciones.Importar.Comprobantes.Compras |
Introducción
El Importador de Comprobantes de Compra agiliza el registro contable y de gestión al permitir la carga masiva de comprobantes desde un archivo Excel, evitando la carga manual individual de cada comprobante.
La herramienta funciona como un asistente (wizard) que guía al usuario en cuatro pasos: descarga del diseño de registro, selección y mapeo del archivo, definición de valores por defecto, y verificación/importación final. Soporta tanto comprobantes de Proveedores como de Proveedores Financieros (Inversores), y permite enriquecer cada comprobante con conceptos detallados y percepciones.
Cada comprobante importado genera la carga del comprobante de compra, el movimiento en la cuenta corriente de la entidad y el asiento contable correspondiente.
Acceso al módulo
Para acceder a la herramienta:
- Ingrese a la pestaña GESTIÓN.
- Despliegue la opción MÁS.
- Seleccione el botón Importador de comprobantes de compras.
Se abrirá el asistente de importación dentro del panel principal del Back Office.
Importante: El acceso requiere el permiso Gestion.Operaciones.Importar.Comprobantes.Compras y la licencia del módulo Importador de Comprobantes de Compras. Ambos deben solicitarse al administrador del sistema.
Pantalla principal
El asistente se compone de una secuencia de pantallas (páginas del wizard) que se recorren con los botones Siguiente y Anterior:
| Pantalla |
Contenido |
| Bienvenida |
Presentación del asistente y botón Descargar diseño de registro modelo (plantilla Excel). |
| Paso 1 – Configurar archivo |
Selección del archivo a importar, mapeo de las columnas del archivo contra los campos de la tabla y administración de configuraciones de mapeo guardadas. |
| Paso 2 – Datos por defecto |
Definición de valores por defecto para los campos obligatorios y elección del tipo de entidad para nuevas altas. |
| Paso 3 – Verificación |
Grilla de vista previa con todos los comprobantes a importar, validados y coloreados según su estado. |
En el Paso 1, la grilla Tabla muestra los campos de destino (con su descripción, tipo y si son requeridos) y la grilla Archivo muestra las columnas detectadas en el Excel junto al dato leído de la primera fila.
Parámetros
Los siguientes parámetros se configuran durante el recorrido del asistente:
| Parámetro |
Descripción |
| Archivo a importar |
Ruta del archivo Excel (.xls / .xlsx) con los comprobantes. Puede seleccionarse con el botón de búsqueda o arrastrando el archivo a la grilla. |
| Configuración de mapeo |
Permite guardar, actualizar, seleccionar o eliminar configuraciones de mapeo de columnas reutilizables (por tabla). |
| Mapeo de columnas |
Vinculación de cada columna del archivo con el campo correspondiente de la tabla (botones Vincular / Desvincular / Desvincular todo). |
| Fecha |
Fecha por defecto para los comprobantes que no la traigan en el archivo. |
| Sucursal |
Sucursal por defecto (campo obligatorio). |
| Especie |
Especie/moneda por defecto. |
| Centro de Costo |
Centro de costo por defecto. |
| Letra |
Letra por defecto del comprobante. |
| Pto.Vta. |
Punto de venta por defecto. |
| Ingresar nuevas entidades como |
Tipo de entidad con que se darán de alta las entidades inexistentes: Proveedor o Prov. Financ. (Inversor). |
Cada valor por defecto se activa con su casilla correspondiente. Si una columna está mapeada en el archivo, el valor del archivo tiene prioridad sobre el valor por defecto.
Importante: El campo TipoEmisor del archivo (P = Proveedor, PF = Proveedor Financiero) determina contra qué base se busca la entidad por CUIT. Si el archivo no lo trae, se usa el tipo elegido en Ingresar nuevas entidades como.
Resultado del proceso
Al confirmar la importación en el Paso 3, el asistente procesa cada comprobante y, al finalizar, muestra un resumen con:
| Resultado |
Descripción |
| Comprobantes importados |
Cantidad de registros importados con éxito y el detalle de cada comprobante generado (tipo, letra, punto de venta, número, razón social, Id de cuenta corriente e Id de asiento). |
| Comprobantes no importados |
Cantidad de registros descartados por contener errores, con el detalle del motivo de cada uno. |
| Nuevas entidades |
Listado de proveedores o inversores creados automáticamente durante la importación. |
| Tiempo de importación |
Duración total del proceso. |
Por cada comprobante importado correctamente, el sistema genera:
- La carga del comprobante de compra (visible en Gestión > Compras).
- El movimiento en la cuenta corriente del proveedor o inversor.
- El asiento contable correspondiente.
Acciones disponibles
| Acción |
Descripción |
| Descargar diseño de registro modelo |
Genera la plantilla Excel con todas las columnas esperadas (datos del comprobante, hasta 7 conceptos y percepciones). |
| Seleccionar / Arrastrar archivo |
Carga el archivo Excel a importar. |
| Vincular / Desvincular columnas |
Mapea o desvincula una columna del archivo con un campo de la tabla. |
| Desvincular todo |
Limpia todos los mapeos y valores por defecto cargados. |
| Guardar / Actualizar / Eliminar configuración |
Administra configuraciones de mapeo reutilizables. |
| Modificar registros |
Edita los datos de un comprobante en la grilla de verificación (Paso 3); con la opción Modificar registros en una ventana individual se edita en formulario. |
| Eliminar registro |
Quita un comprobante de la lista antes de la importación final. |
| Restaurar columnas |
Restaura las columnas de la grilla a sus valores originales. |
| Ver Log de Importación |
Muestra la vista previa de impresión del log de comprobantes. |
| Reiniciar asistente |
Vuelve el asistente a su estado inicial para una nueva importación. |
Ejemplo práctico
Caso: registrar las facturas de compra de un mes descargadas de ARCA/AFIP.
- En la pantalla de bienvenida, pulse Descargar diseño de registro modelo y guarde la plantilla.
- Acceda a ARCA/AFIP y descargue Mis Comprobantes Recibidos.
- Copie los datos relevantes del archivo de ARCA/AFIP y péguelos en la plantilla de Plenario (o prepare su propio Excel para mapearlo).
- En el Paso 1, seleccione el archivo. Vincule cada columna del archivo con el campo de la tabla, o cargue una configuración de mapeo guardada. Opcionalmente, guarde el mapeo para reutilizarlo.
- En el Paso 2, defina los valores por defecto necesarios (por ejemplo Fecha, Sucursal, Especie) y elija si las entidades nuevas se crearán como Proveedor o Prov. Financ..
- En el Paso 3, revise la grilla. Las filas en rojo (salmón) tienen errores: corrija los datos directamente o consulte el motivo en la columna de observaciones de estado.
- Cuando todos los registros estén en estado OK, pulse Siguiente y confirme la importación.
- Verifique el resumen final con los comprobantes generados, las entidades nuevas y los errores, si los hubiera.
Consejos útiles
- Use el botón Descargar diseño de registro modelo para conocer la estructura exacta esperada; la plantilla incluye una fila de ejemplo con datos válidos.
- El CUIT debe informarse con el formato correcto del emisor; un CUIT inválido o vacío detiene la validación de ese comprobante.
- La cuenta contable de imputación (CtaCbleImputacionPerdida) debe tener 8 dígitos numéricos y existir en el plan de cuentas.
- Si un proveedor ya existe pero no tiene cuenta de imputación asignada (Inicio > Proveedores > Imputaciones Contables), indíquela en la grilla o en el campo correspondiente.
- Puede enriquecer cada comprobante con hasta 7 conceptos (descripción, importe, alícuota de IVA y cuenta contable) y con percepciones (tipo de impuesto, provincia, importe y cuenta).
- Guarde una configuración de mapeo por cada formato de archivo recurrente para no repetir el mapeo en cada importación.
- Revise siempre la grilla del Paso 3 antes de confirmar: el color blanco indica registro correcto y el rojo (salmón) indica error.
Preguntas frecuentes
¿Puedo importar directamente el archivo descargado de ARCA/AFIP?
Sí. Puede copiar los datos de Mis Comprobantes Recibidos a la plantilla de Plenario, o mapear directamente las columnas de su archivo en el Paso 1. El asistente valida cada registro antes de importarlo.
¿Qué significa que una fila aparezca en rojo?
Indica que el comprobante tiene algún dato incorrecto o incompleto. El motivo se detalla en la columna de observaciones de estado. No se podrá avanzar a la importación final hasta que todos los registros estén en estado OK.
¿Qué pasa si el proveedor no existe en el sistema?
El asistente puede dar de alta la entidad automáticamente según el tipo elegido en "Ingresar nuevas entidades como" (Proveedor o Prov. Financ.), siempre que se informe la razón social y la cuenta contable de imputación. Las nuevas entidades se listan en el resumen final.
¿Puedo reutilizar el mapeo de columnas?
Sí. En el Paso 1 puede guardar la configuración de mapeo y luego seleccionarla desde el desplegable de configuraciones para futuras importaciones del mismo formato de archivo.
¿Cómo distingue el sistema un Proveedor de un Proveedor Financiero?
Por el campo TipoEmisor del archivo (P = Proveedor, PF = Proveedor Financiero). Si el archivo no trae ese dato, se usa el tipo de entidad elegido en el Paso 2. La búsqueda de la entidad se realiza por CUIT contra la base correspondiente.
Permisos
| Concepto |
Valor |
| Permiso requerido |
Gestion.Operaciones.Importar.Comprobantes.Compras |
| Grupo de permisos |
Factoring.Operaciones.ImportarComprobantesCompras |
| Licencia de módulo |
Importador de Comprobantes de Compras (Gestión) |
El permiso y la licencia se gestionan desde el administrador del sistema. Sin ellos, el botón del menú no permite abrir el asistente.
Información técnica
Sección de referencia para soporte/desarrollo. Basada en el análisis del formulario real de la v14 (proyectos VPNET_WinForms y VPNET_DataModel; el menú VB frmNewMain.vb).
Formularios principales
| Componente |
Detalle |
| Formulario (UI) |
FormWizardImportadorComprobantesCompras.cs (VPNET_WinForms\VPNET_WinForms\Gestion\) — asistente DevExpress (WizardControl) |
| Manager |
ImportadorComprobantesComprasManager.cs (VPNET_DataModel\Manager\Gestion\Gestion\); la entidad de fila ImportadorComprobantesCompras extiende GestionComprobantesCompras |
| Registración del comprobante |
GestionComprobantesComprasManager.Save() por cada fila válida (asigna Id_Asiento e Id_CtaCTe) |
| Configuraciones de mapeo |
Importaciones_Wizard_Configuracion_Manager → GetConfigsByTabla(TABLA_TARGET) (mapeo guardado por tabla) |
| Acceso (menú) |
frmNewMain.vb → btnGestion_ImportarComprobantesCompras_ItemClick → KeyLicences.Instance.Access(Area.Intranet, Modulo.Gestion, SubModulo.Importador_Comprobantes_Compras, 2) + clsSeguridad.IsAllowedObject(..., "Gestion.Operaciones.Importar.Comprobantes.Compras", ...) → ShowFrmInDockPanel(New FormWizardImportadorComprobantesCompras()) |
| Páginas del wizard |
welcomeWizardPage, wizardPageConfigurarArchivo (Paso 1), wizardPageDatosObligatorios (Paso 2), wizardPageVerificaComprobantesCompra (Paso 3) y completionWizardPage |
Permisos reales
| Permiso |
Habilita |
Gestion.Operaciones.Importar.Comprobantes.Compras |
Abrir el asistente. Objeto padre / grupo: Factoring.Operaciones.ImportarComprobantesCompras |
Licencia SubModulo.Importador_Comprobantes_Compras (=16) |
Habilita el módulo (validada con KeyLicences.Instance.Access(2, ..., 16, 2)) |
Tablas de base de datos principales
| Tabla |
Detalle |
Gestion_Comprobantes_Compras |
Tabla destino (constante TABLA_TARGET = "Gestion_Comprobantes_Compras"). Cada importación genera el comprobante de compra + movimiento de cuenta corriente (Id_CtaCTe) + asiento contable (Id_Asiento) |
Relación con otros módulos / manuales
| Manual relacionado |
Vínculo operativo |
| Gestión Compras |
Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
Notas para soporte (comportamiento real del código)
- Conceptos / percepciones: la entidad
ImportadorComprobantesCompras soporta hasta 7 conceptos y 25 percepciones por comprobante (Concepto_1..7, IdTipoPercepcion_1..25). La plantilla descargable (descargarPlantillaModel) genera columnas para 7 conceptos y 3 percepciones de ejemplo.
- Validaciones (
ValidaOperacion / ValidaDatosImportados): Fecha, Sucursal, Especie, CUIT/entidad, duplicados, punto de venta. La cuenta CtaCbleImputacionPerdida debe tener exactamente 8 dígitos numéricos (si es nula/vacía, distinta de 8 o con caracteres no numéricos, marca error en ObservacionesStatus).
- Estado de filas en
gvComprobantesCompras: la columna Status usa HttpStatusCode; HttpStatusCode.BadRequest colorea la fila en salmón (error) y HttpStatusCode.OK en blanco. El motivo aparece en ObservacionesStatus.
- TipoEmisor:
P = Proveedor, PF = Proveedor Financiero; determina contra qué base se busca la entidad por CUIT. Si el archivo no lo trae se usa el tipo elegido en el Paso 2 (IdTipoEntidadDefault).
- Existe un formulario previo
FormImportadorComprobantesCompras.cs (plantilla con diseño AFIP fijo, sin mapeo configurable). El acceso vigente desde el menú Gestión utiliza el asistente FormWizardImportadorComprobantesCompras.
Ver también