Importar Productos y Descargar Reportes

Qué permite hacer esta función

La importación masiva crea productos nuevos a partir de un archivo CSV o XLSX. Permite elegir la hoja, relacionar las columnas del archivo con los campos de AdoqIA, revisar y corregir los datos, y consultar el resultado de cada fila.

La importación no actualiza productos existentes. Si una fila coincide con un producto existente o repite un identificador dentro del archivo, se informa como duplicada.

La descarga de productos es una función separada. Actualmente AdoqIA genera un reporte de productos en PDF; no ofrece una exportación general de productos, clientes, ventas o compras en CSV o Excel.

Ruta rápida

1. Abre Inventario → Productos y selecciona Importar productos. Se abrirá la pantalla Importaciones.
2. En la tarjeta Subir archivo, selecciona Elegir archivo y carga un CSV o XLSX de hasta 10 MB.
3. En Elegir hoja y mapear columnas, elige la hoja y asigna al menos Nombre del producto y Precio de venta.
4. Selecciona Continuar con la vista previa.
5. Revisa las filas, corrige los valores necesarios y, si aparecen categorías o marcas, confirma cómo se resolverán.
6. Selecciona Importar {cantidad} productos.
7. AdoqIA pondrá la importación en cola y abrirá automáticamente la pantalla Reporte de importación, donde podrás seguir el progreso y revisar los resultados.

Preparar el archivo

Formatos y límites actuales

El formato antiguo .xls no es compatible. Guarda o convierte el archivo a .xlsx o CSV antes de cargarlo.

Estructura recomendada

• Usa una fila por producto.
• Incluye una fila de encabezados clara, con un nombre distinto para cada columna.
• Mantén un tipo de dato consistente en cada columna: texto, importe, cantidad o porcentaje.
• Conserva únicamente las columnas que contengan datos útiles para crear productos.
• Elimina títulos decorativos, notas, subtítulos, totales, fórmulas y pies de página.
• Elimina especialmente las columnas que no deseas importar.
• Evita encabezados duplicados, vacíos o ambiguos.

No es necesario que los encabezados se llamen igual que los campos de AdoqIA. El mapeo es dinámico: por ejemplo, una columna llamada Artículo puede asignarse a Nombre del producto y una llamada PVP a Precio de venta.

Eliminar columnas innecesarias reduce las opciones que debes revisar y evita confusiones durante el mapeo y la vista previa. No modifica los datos útiles del archivo.

Cómo se detectan los encabezados en XLSX

AdoqIA analiza cada hoja y puede detectar una fila de encabezados aunque no sea la primera. Para que una fila pueda reconocerse como encabezado debe contener entre 2 y 64 textos no vacíos, sin nombres duplicados, y debe tener filas de datos tabulares debajo.

Después de la carga, el control Hoja aparece en la parte superior de la tarjeta Elegir hoja y mapear columnas. Selecciona allí la hoja que contiene los productos.

Para obtener una detección clara:

• deja una sola tabla principal por hoja;
• elimina bloques decorativos que parezcan encabezados;
• elimina fórmulas: las hojas XLSX que contienen fórmulas no son aceptadas;
• evita totales y notas debajo de la tabla.

En CSV, la primera fila siempre se interpreta como encabezado.

Campos y mapeo

Campos obligatorios

El SKU es opcional, pero se recomienda para identificar el producto con precisión. La dirección web o slug se genera automáticamente y no se mapea manualmente.

Campos opcionales disponibles

• SKU
• Código de barras
• Descripción
• Descripción breve
• Precio de costo
• Stock inicial
• Tasa de impuesto
• Unidad
• Categoría
• Marca

El código de barras puede contener letras y números. No tiene que ser un EAN o UPC.

La pantalla actual no permite mapear manualmente el estado, la visibilidad, el control de stock ni la condición tributaria. Esos campos usan los valores predeterminados del proceso.

Valores predeterminados

Los campos opcionales que no se asignen usan estos valores:

Las columnas del archivo que no se asignen a ningún campo se ignoran. Los valores predeterminados aplicados se muestran encima de la tabla de vista previa.

Stock inicial y almacén predeterminado

Si asignas Stock inicial y una fila tiene una cantidad mayor que cero, AdoqIA registra esa existencia en el almacén predeterminado activo. De esta forma, el producto queda integrado con las operaciones de stock, como ventas, transferencias y conteos.

Debe existir un almacén predeterminado activo. Si no existe, la importación falla de forma segura y no deja productos con existencias inconsistentes. Configura el almacén y vuelve a realizar la importación.

Flujo completo de importación

1. Cargar el archivo

En Importaciones, la tarjeta Subir archivo muestra el botón Elegir archivo. Al seleccionar un archivo válido, AdoqIA lo carga y abre el paso de mapeo.

Solo puede haber una importación activa. Si existe un borrador o una importación en proceso, la pantalla bloquea una nueva carga hasta que se continúe, se descarte o finalice la anterior.

2. Continuar o descartar un borrador

La sección Borradores aparece debajo del área de carga y contiene importaciones todavía no confirmadas:

• Continuar reabre el flujo disponible del borrador.
• Descartar cancela el borrador, elimina su archivo fuente y lo mueve al historial con estado Cancelada, después de solicitar confirmación.

Carga interrumpida o incompleta: si la carga se interrumpió y Continuar no permite recuperar correctamente el archivo, selecciona Descartar y vuelve a elegir el archivo. La recuperación automática de una carga incompleta no está disponible actualmente.

3. Elegir la hoja y mapear columnas

En la tarjeta Elegir hoja y mapear columnas:

1. Selecciona la hoja en el control Hoja.
2. Asigna las columnas correspondientes a Nombre del producto y Precio de venta.
3. Asigna el SKU si está disponible.
4. Expande Campos opcionales para asignar los demás datos.
5. Selecciona Continuar con la vista previa, al final de la tarjeta.

Cada columna de origen puede asignarse una sola vez. Si dos campos usan la misma columna, AdoqIA solicitará corregir el mapeo.

4. Revisar y corregir la vista previa

La tarjeta Revisar importación muestra el resultado esperado de cada fila:

• Listo para importar: la fila cumple las validaciones actuales.
• Duplicado: el identificador ya existe o se repite dentro del archivo.
• Requiere corrección: falta un valor obligatorio o un valor numérico no es válido.

La tabla tiene desplazamiento vertical y horizontal propio. Los encabezados permanecen visibles al desplazarse verticalmente y el número de fila permanece visible al desplazarse horizontalmente.

Se muestran hasta 50 filas por página. Los botones Anterior y Siguiente están debajo de la tabla, junto al rango de filas visible.

Solo son editables los campos que fueron mapeados. Para guardar un cambio en un campo de texto:

• cambia el valor y sal del campo; o
• presiona Enter.

Los selectores se guardan al cambiar la opción. Cuando el servidor acepta el valor, aparece Cambio guardado y se vuelve a calcular el resultado de la fila. Si no puede guardarse, se restaura el valor anterior. Presiona Escape antes de salir de un campo de texto para descartar la edición local.

5. Usar perfiles de importación, si resulta útil

Perfiles de importación es una tarjeta plegada y opcional, ubicada debajo de la vista previa. No es necesaria para completar la importación.

Un perfil guarda el mapeo y los valores predeterminados para reutilizarlos en futuros archivos con la misma estructura de encabezados. Si la estructura o la versión no coincide, AdoqIA informa que el perfil es incompatible y no lo aplica.

6. Confirmar categorías y marcas

Si el archivo mapea categorías o marcas, aparece la sección Categorías y marcas. Para cada valor, AdoqIA indica si usará un registro existente o si puede crear uno nuevo. Selecciona Confirmar en cada relación.

Una colisión o un valor no válido debe corregirse antes de importar. La acción final permanece deshabilitada mientras haya relaciones sin confirmar.

7. Poner la importación en cola

La tarjeta Importación lista para confirmar contiene una sola acción principal: Importar {cantidad} productos.

Esta acción confirma la configuración revisada y pone en cola el proceso. Las filas válidas y no duplicadas intentan crear productos; las demás quedan registradas con su resultado. Después de confirmar, AdoqIA abre automáticamente el reporte de esa importación.

Progreso, resultados e historial

Seguir una importación en proceso

En Reporte de importación, la tarjeta Progreso de importación muestra:

• estado actual;
• porcentaje de filas contabilizadas;
• total contabilizado y filas pendientes.

Mientras el proceso no haya terminado, la pantalla actualiza el reporte automáticamente durante un período limitado. También puedes seleccionar Actualizar en la esquina superior derecha de la tarjeta.

El resumen muestra los totales de filas, productos creados, filas inválidas y filas pendientes.

Revisar las filas procesadas

La tabla Filas procesadas permite filtrar por Resultado y Motivo. Cada página carga un grupo de resultados; selecciona Cargar más, debajo de la tabla, para ver el siguiente grupo.

La columna Producto muestra el nombre y, cuando existe, el SKU. Si la fila creó un producto, ese texto enlaza a su ficha. Las filas sin producto creado se muestran sin enlace.

Selecciona Descargar resultados, junto a la tarjeta de progreso, para descargar el detalle en CSV.

Secciones de la pantalla Importaciones

Al volver a Importaciones, los procesos se agrupan así:

• Borradores: cargas pendientes de preparación o confirmación, con Continuar y Descartar.
• En proceso: importaciones en cola, procesándose o deshaciéndose.
• Historial: importaciones finalizadas, con fecha, cantidad de filas y estado.

Selecciona una importación del Historial para abrir su reporte. La lista carga 20 registros por solicitud; si hay más, Cargar más aparece al final.

Deshacer una importación

La opción Deshacer importación solo aparece en el historial para importaciones Completadas, Parciales o con Deshacer parcial.

1. Selecciona Revisar deshacer.
2. Revisa cuántos productos son elegibles y no elegibles.
3. Selecciona Confirmar deshacer.

Solo se eliminan los productos que continúan siendo elegibles. Un producto modificado o utilizado por otra operación puede quedar excluido para proteger la información relacionada.

Solución de problemas

Recomendaciones

• Realiza primero una prueba con unas pocas filas.
• Revisa los valores predeterminados antes de confirmar.
• Usa SKU únicos y estables cuando estén disponibles.
• Conserva una copia del archivo original y del CSV descargado desde Descargar resultados.
• Para archivos recurrentes con la misma estructura, guarda un perfil después de comprobar el mapeo.

Descargar un reporte de productos

Esta función está separada de la importación y genera un PDF, no un CSV ni un archivo de Excel.

1. Abre Inventario → Productos.
2. En la parte superior derecha, selecciona Generar reporte.
3. En la pantalla del reporte, filtra por búsqueda, estado, categorías, marcas o listas de precios.
4. Elige las columnas y el diseño Tabla o Catálogo. También puedes incluir imágenes.
5. Selecciona Generar reporte.
6. Cuando aparezca la vista previa, selecciona Descargar PDF. También están disponibles las acciones de impresión y uso compartido compatibles con el dispositivo.

El reporte puede incluir nombre, SKU, código de barras, precio, costo, stock, categoría, marca y precios de las listas seleccionadas. La exportación de clientes, ventas o compras y la descarga en Excel no están disponibles desde este flujo.

Preguntas frecuentes

¿La importación actualiza productos existentes?

No. Crea productos nuevos. Los identificadores ya existentes o repetidos se informan como duplicados.

¿Puedo importar clientes o proveedores?

No. Este flujo de importación masiva está disponible para productos.

¿Puedo usar códigos de barras con letras?

Sí. El código de barras admite texto alfanumérico y no exige un formato EAN.

¿Puedo importar un archivo .xls?

No. Convierte el archivo a .xlsx o CSV.

¿Puedo deshacer cualquier importación?

No. La revisión para deshacer solo está disponible para los estados admitidos y elimina únicamente productos que sigan siendo elegibles.

Artículos relacionados

• Productos e Inventario
• Categorías
• Marcas
• Almacenes
• Reportes y Análisis