ARCAIX

Manual de Usuario

ARCAIX es una aplicación de escritorio WPF para cargar un archivo Excel, definir reglas de validación y transformación, procesar los datos, revisarlos, corregirlos, completarlos y generar una salida limpia en Excel, CSV o TXT.

Pensado como herramienta de apoyo para tareas de carga masiva, generación de archivos de intercambio entre sistemas, declaraciones juradas en sistemas gubernamentales, etc., ARCAIX permite configurar reglas de validación y transformación para cada columna de destino, mapear columnas del archivo de origen, revisar errores y advertencias, corregir valores y exportar el resultado final.

1. Preparar el archivo de origen

El archivo de entrada puede ser .xlsx o .xls.
Debe contener una fila de encabezados y una o más filas de datos.
Todas las columnas de datos deben tener encabezado.
No debe haber columnas vacías entre los datos.
Puede haber filas vacías dentro del bloque de filas de datos y configurar ARCAIX para ignorarlas si es necesario, pero no deben intercalarse subtítulos, ni comentarios ni otras filas que no correspondan a datos procesables.
Los nombres de las columnas deben ser únicos y descriptivos.
El archivo Excel puede contener los datos en una o varias hojas: ARCAIX permite seleccionar la o las hojas a procesar.
Por cada hoja de datos, debe anotar el nombre de la hoja, el número de fila de encabezados, el número de fila de la primera fila de datos y el número de fila de la última fila de datos que debe procesarse.
Todas las hojas de datos deben tener las mismas columnas y estructura. ARCAIX procesará la estructura de columnas de la primera hoja de datos y si existieran columnas diferentes en otras hojas, serán ignoradas para mantener la consistencia.

Nota: La práctica recomendable es intentar compilar todos los datos a procesar en una única hoja de Excel para facilitar el procesamiento y evitar inconsistencias. No obstante, si los datos se encuentran en varias hojas, ARCAIX permitirá seleccionar las hojas a procesar teniendo en cuenta que sólo considerará las columnas y estructura de la primera hoja de datos.

Ejemplo de archivo de origen:

1  | EMPRESA EJEMPLO S.A.
2  | REPORTE DE VENTAS POR CLIENTE - ENERO 2024
3  |
4  |Nombre | Correo           | Teléfono      | Fecha      | Monto
5  |Juan   | juan@ejemplo.com | 011-4444-5555 | 15/01/2024 | 1500,50
6  |Ana    | ana@mail.com     | 011-3333-2222 | 20/01/2024 | 2000
7  |Juana  | juana@mail.com   | 011-6666-2222 | 22/01/2024 | 6000
8  |Total  |                  |               |            | 9500,50

En este ejemplo, las filas 1 a 3 son información adicional que no debe procesarse, la fila 4 es la fila de encabezados y las filas 5 a 7 son filas de datos. La fila 8 es un total que tampoco debe procesarse.
En ARCAIX se configuraría para procesar solo las filas 5 a 7, ignorando las filas vacías y las filas que no correspondan a datos procesables, de la siguiente manera:

Nombre de Hoja: ElNombreDeLaHoja
Fila de Encabezados: 4
Primera Fila de Datos: 5
Última Fila de Datos: 7

Nota: Si luego de la última fila de datos útiles no hay textos, ni números ni fechas, sino solo filas vacías, no es necesario configurar la última fila de datos, ya que el sistema detectará automáticamente el bloque de filas de datos útiles. Sin embargo, si luego de la última fila de datos útiles hay otras filas con información que no debe procesarse (como totales, subtítulos, comentarios, etc.), entonces sí es necesario configurar la última fila de datos para que el sistema sepa hasta dónde procesar los datos útiles.

2. Abrir ARCAIX y cargar el archivo

Abra ARCAIX.exe.
En Archivo de Origen, haga clic en Examinar....
Seleccione el archivo Excel.
Se cargará el archivo y se abrirá la ventana de selección de hojas de datos. Marcar las hojas a procesar y, por cada hoja, configurar las filas de encabezados y datos.
El sistema toma por default el uso de , (coma) como separador decimal. En la celda de configuración puede cambiarse para hoja seleccionada, si es necesario.

Nota: El archivo Excel de origen debe estar cerrado en otras aplicaciones antes de cargarlo en ARCAIX.

3. Reglas de validación

Las reglas de validación permiten definir el formato de datos de cada columna y el orden y formato de los registros en archivos exportados (CSV o TXT)

Haga clic en Reglas y se abrirá la ventana de configuración de reglas de validación y tablas de datos.

Cargar reglas desde archivo

ARCAIX permite cargar reglas de validación desde un archivo existente en la librería del sistema. De esta manera, puede utilizar y reutilizar reglas previamente definidas sin necesidad de crearlas manualmente.
ARCAIX incluye su propia librería de reglas y se van incluyendo nuevas con cada actualización, pero también permite crear nuevas reglas de validación desde cero. Usando el botón Agregar regla puede ir definiendo nuevas reglas. Una vez creadas todas las reglas necesarias para el proceso, se pueden guardar en la librería de ARCAIX con el botón Guardar en archivo y quedará disponible para usos futuros.
Tambien pueden crearse por fuera de ARCAIX en una planilla Ecel con el siguiente formato:

 Orden  | Nombre de columna | Tipo de Dato  | Longitud      | Decimales      | Formato | Valores Permitidos                 | Requerido
   1    |CUIT               | Numérico      | 11            | 0              |         |                                    | Sí
   2    |Fecha              | Fecha DDMMAAA | 8             | 0              | DDMMAAA |                                    | Sí
   3    |Razón Social       | Texto         | 25            | 0              |         |                                    | Sí
   4    |Monto              | Numérico      | 15            | 2              |         |                                    | Sí
   5    |Medio de Pago      | Numérico      | 2             | 0              |         | Según tabla: Medios_ de_ Pago.xlsx | Sí

Orden: Orden de los datos. Sólo para información, no afecta el procesamiento ni se incluye en los archivos de salida.
Nombre de Columna: nombre final del dato en el archivo de destino.
Tipo de Dato: Texto, números, fecha, e-mail, etc
Longitud: longitud del dato, en caracteres. Imprescindible para generar archivos TXT de ancho fijo.
Decimales: número de decimales para datos numéricos. Para texto, fechas u otros datos no numéricos, se ignora.
Formato: formato específico del dato, si aplica.
Valores Permitidos: lista de valores permitidos para el dato. Se detallla su uso más adelante.
Campo Requerido: obligatorio o no.

Los archivos creados con este formato pueden cargarse en la librería de ARCAIX con el botón Agregar archivo de reglas y quedarán disponibles para su uso inmediato. De esta manera, se pueden crear archivos de reglas de validación por fuera de ARCAIX, compartirlos entre usuarios, almacenarlos como plantillas para usos futuros, etc.

Los datos para crear las reglas pueden obtenerse de la documentación de ARCA referida a los formatos de registro necesarios para crear archivos de importación de los diferentes aplicativos e impuestos, del proveedor del software sobre el que necesite trabajar o de cualquier otra fuente, ya que ARCAIX es una herramienta de apoyo para la creación de archivos de intercambio entre sistemas y no está limitada a un formato específico.

Valores Permitidos

Cuando un dato sólo acepta ciertos valores de una lista de valores predefinidos deben indicarse siempre con el formato `valor: descripción`, siendo 'valor' el valor que se almacenará y 'descripción' la descripción que se mostrará. Por ejemplo para un campo de medio de pago, los valores permitidos podrían ser:

1: Efectivo
2: Tarjeta
3: Transferencia

Hay varias formas de cargar los valores permitidos para un campo:
Cuando esté editando una regla ya existente, tipearlos en la celda Valores permitidos separando con coma cada 'valor: descripción'. Por ejemplo:

1: Efectivo, 2: Tarjeta, 3: Transferencia

Cuando esté creando una nueva regla desde ARCAIX, tipearlos en la celda Valores permitidos de a un 'valor: descripción' por línea. Por ejemplo:

1: Efectivo
2: Tarjeta
3: Transferencia

Cargar desde Archivo: Puede crear un archivo de texto con los valores permitidos, con un valor por línea, y cargarlo con el botón Cargar desde Archivo. El formato del archivo de texto debe ser un valor por línea, con el formato `valor: descripción` para cada valor.

Cargar desde Excel: Puede crear un archivo de Excel con los valores permitidos, guardarlo y luego cargarlo en ARCAIX con el botón Cargar desde Excel. El formato de la planilla será de un valor por línea con valor en la columna A y descripción en la columna B. Por ejemplo:

Valor | Descripción
1     | Efectivo
2     | Tarjeta
3     | Transferencia

Según Tabla de Valores: Si los valores permitidos para un campo corresponden a una tabla de datos que ya existe en la librería de Tablas de ARCAIX, puede cargarlos directamente desde esa tabla sin necesidad de tipearlos manualmente ni crear un archivo de texto o Excel con esos valores. Para esto:

Use el botón **Según Tabla de Valores**.
Seleccione un archivo Excel de `Resources\TABLAS`.
El sistema guardará en el campo el texto: `Según tabla: nombre_archivo.xlsx`

Al leer la regla, ARCAIX interpreta ese texto y carga los valores desde la tabla correspondiente.

Esta opción es útil para listas largas y reutilizables como provincias, medios de pago o tipos de documento.

Nota: Las planillas Excel de Valores Permitidos que haya creado, puede incorporarlos a la librería de Tablas de ARCAIX usando el botón Agregar archivo de Tablas y estará disponible para su uso en futuras reglas.

4. Mapear columnas

ARCAIX debe saber qué columna del archivo de origen corresponde a cada columna del archivo de destino.

Mapeo automático

ARCAIX intenta hacer un mapeo automático entre las columnas de origen y destino, buscando coincidencias entre los nombres de las columnas del archivo de origen y los nombres de las columnas de destino definidos en las reglas de validación.
El mapeo automático es una función de apoyo que puede ahorrar tiempo, pero no siempre es perfecto, por lo que es importante revisar el resultado y ajustarlo manualmente si es necesario.

Haga clic en **Mapeo Automático**.
Revise el resultado.
Ajuste manualmente si algo no quedó bien, eligiendo la columna correcta para cada destino.

Mapeo manual

En la grilla de columnas, seleccione la columna de origen para cada dato de destino.
Si el archivo de origen no tiene una columna que corresponda a un dato de destino, deje vacía la columna de origen para ese dato de destino y no se importarán datos para esa columna pero podrá continuar con el proceso y completarlos más tarde en la planilla de revisión de datos.

5. Procesar los datos

Especifique el archivo de salida y haga clic en Procesar. El sistema valida, transforma y genera el archivo Excel.

6. Ventana de Revisión de Datos

Después de procesar el archivo, ARCAIX abre la ventana Revisión de Datos Procesados. Esta ventana permite revisar cada fila, corregir valores, filtrar registros con problemas y exportar el resultado final.

6.1. Qué muestra la ventana

La parte superior presenta un resumen con estas cantidades:

Total de filas: cantidad general de registros cargados.
Válidas: filas sin errores ni advertencias.
Con advertencias: filas que requieren atención, pero pueden exportarse.
Con errores: filas que deben corregirse antes de generar el archivo final.

La grilla central muestra las filas procesadas. Cada fila incluye un número visual (#) que no se exporta, la hoja de origen y las columnas definidas por las reglas.

Los colores ayudan a identificar el estado de cada fila:

Rojo suave: fila con errores.
Amarillo suave: fila con advertencias.
❌ con errores, ⚠ con advertencias, 🔴 cuando la fila fue marcada para revisión manual y ✓ cuando no presenta incidencias.

6.2. Edición de datos

Puede editar las celdas directamente en la grilla.

Las columnas con valores permitidos se muestran como listas desplegables.
Las demás columnas se editan como texto.
Al confirmar una edición, ARCAIX vuelve a validar el valor de esa celda.
Si el sistema transforma automáticamente un dato, puede mostrar una advertencia informativa.
Si la celda queda inválida, se registra un error para esa fila y columna.

6.3. Detalles de la fila seleccionada

La parte inferior muestra un panel con los detalles de la fila seleccionada. Allí puede ver un resumen del estado de la fila y las observaciones asociadas a sus columnas.

6.4. Filtros y búsqueda

En la barra superior puede filtrar o buscar registros:

Mostrar solo errores: deja visibles únicamente las filas con errores.
Mostrar solo advertencias: deja visibles únicamente las filas con advertencias.
Buscar: filtra en tiempo real por el contenido de todas las columnas.

Si activa un filtro, la vista se actualiza automáticamente.

6.5. Botones y funciones principales

Guardar Sesión: guarda el estado actual de la revisión en un archivo .json para continuar más tarde.
Cargar Sesión: abre una sesión guardada previamente. Si hay cambios sin guardar, ARCAIX avisa antes de continuar.
Aplicar a Columna: copia el valor de la celda seleccionada a todas las filas de esa misma columna. Permite elegir si se aplica sólo a celdas vacías o a todas las celdas, sobreescribiendo datos anteriores. No se aplica a columnas visuales como el número de fila.
Revalidar: vuelve a validar los datos con las reglas actuales.
Limpiar Errores: elimina las marcas de error en todas las filas. No corrige los datos, solo borra el estado de error.
Exportar a CSV/TXT: abre la exportación a formato de texto.
Generar Excel: genera el archivo final en formato .xlsx. Si existen errores, el sistema pide confirmación.
Cancelar: cierra la ventana sin generar el archivo final.

En TXT, los textos se completan con espacios y los numéricos con ceros, según las reglas definidas.

6.6. Menú contextual de columnas

Algunas columnas de domicilio muestran un menú contextual en su encabezado con la opción Separar domicilio en detalles. Esta función intenta dividir un domicilio completo en componentes más específicos, como calle, número, piso, departamento y otros datos relacionados, siempre que existan columnas compatibles en las reglas.

6.7. Recomendaciones de uso

Revise primero las filas con errores.
Utilice las advertencias para detectar transformaciones automáticas.
Guarde una sesión antes de hacer cambios masivos.
Antes de exportar, confirme que los datos estén completos y coherentes.

7. Exportar a CSV o TXT

CSV: delimitado por coma, punto y coma, tabulador o pipe.
TXT: ancho fijo por columna, con espacios o ceros según el tipo de dato.

8. Guardar y retomar trabajo

ARCAIX permite guardar sesiones con configuración y reglas.

9. Ver el log

Puede abrir el log completo para revisar errores y advertencias.

Consejos rápidos

Verifique nombres claros en columnas de destino.
Use valores permitidos para listas cerradas.
Revise el mapeo antes de procesar archivos grandes.
Cierre el archivo Excel en otras aplicaciones antes de cargarlo.

Soporte

JADM Asistencia Informática Integral