Importacion de datos desde Excel y CSV

QuoteNode incluye un asistente guiado de importacion para cargar datos del catalogo de productos desde archivos Excel (.xlsx) o CSV (.csv). El sistema tambien ofrece plantillas descargables con datos de ejemplo e instrucciones.

Descargar la plantilla de importacion

Antes de preparar tus datos, descarga la plantilla oficial:

1. Navega a Products > Import
2. Haz clic en Download Template
3. Elige Template with examples o Empty template

La plantilla incluye:

• una fila de cabecera con todos los nombres de columna soportados
• una hoja de instrucciones que explica cada campo
• filas de ejemplo con el formato correcto
• campos obligatorios marcados con un asterisco (*)

Columnas de la plantilla

Columna	Obligatoria	Descripcion
SKU		Identificador del producto. Se genera automaticamente si lo dejas vacio.
NAME	*	Nombre del producto, mostrado en ofertas y PDF.
UNIT_PRICE	*	Precio unitario neto. Usa punto como separador decimal, por ejemplo 149.99.
UNIT_PRICE_GROSS		Precio unitario bruto. Si se proporciona, tiene prioridad en calculos gross-first.
VAT_RATE		Porcentaje de IVA, como 0, 5, 8 o 23. Si falta, se usa el IVA por defecto del tenant.
UNIT		Unidad de medida: pcs, kg, h, m, m2, m3, l, set. Si falta, se usa pcs.
GROUP_NAME		Nombre del grupo o categoria. Los grupos se crean automaticamente si no existen.
DESCRIPTION_SHORT		Descripcion breve para lineas de oferta.
DESCRIPTION_LONG		Descripcion detallada para vistas de detalle del producto.
WEIGHT_KG		Peso del producto en kilogramos, usado para calculos de envio.
MIN_QUANTITY		Restriccion de cantidad minima de pedido.
QUANTITY_STEP		Paso de incremento de cantidad, por ejemplo 0.5.
STATUS		active o inactive; tambien acepta 1/0 y yes/no.
REFERENCE_URL		Enlace externo a especificaciones del producto, con http o https.
IMAGE_URL		URL de imagen del producto. Formatos soportados: jpg, png, webp, gif, svg. Maximo 10 MB.
NOTES		Notas internas no visibles para el cliente.

Las columnas adicionales de tu archivo se ignoran. No hace falta eliminarlas.

Flujo de importacion

Paso 1 - Subir el archivo

Arrastra y suelta tu archivo Excel o CSV, o haz clic para buscarlo. Tamano maximo: 10 MB. Maximo de filas: 5.000.

En archivos CSV, el sistema detecta automaticamente el separador y la codificacion.

Paso 2 - Mapeo de columnas

El sistema analiza las cabeceras y mapea automaticamente las columnas a campos de QuoteNode. Revisa el mapeo y ajústalo si hace falta:

• cada columna de origen puede mapearse a un unico campo de destino
• las columnas no mapeadas se ignoran
• los campos obligatorios deben estar mapeados antes de continuar

Puedes guardar el mapeo como una plantilla con nombre para futuras importaciones si usas el mismo formato de ERP o proveedor.

Paso 3 - Dry run

Antes de confirmar, el sistema valida tus datos:

• comprobacion de campos obligatorios, como NAME y UNIT_PRICE
• validacion de formato para precios numericos, URLs y unidades
• deteccion de duplicados por SKU frente al catalogo existente
• vista previa de las primeras 20 filas con incidencias destacadas

El dry run no escribe nada en la base de datos. Revisa el informe de validacion y corrige el archivo fuente si es necesario.

Paso 4 - Ejecutar la importacion

Haz clic en Import para confirmar los datos validados:

• se crean nuevos productos para SKU no coincidentes
• los productos existentes se actualizan cuando el SKU coincide
• los grupos de productos se crean automaticamente cuando aparecen en GROUP_NAME
• las imagenes se descargan desde las URLs y se almacenan localmente

Un indicador de progreso muestra el estado. Al terminar, aparece un resumen con filas importadas, filas actualizadas, filas omitidas y errores.

Importar imagenes de producto

Las imagenes se pueden importar de dos formas:

Mediante URL en la plantilla

Incluye una columna IMAGE_URL con enlaces HTTP o HTTPS a las imagenes. El sistema descargara cada imagen durante la importacion.

Mediante ZIP

Para catalogos grandes, sube un ZIP con imagenes:

1. Navega a Products > Import > Media Import
2. Sube un archivo ZIP, maximo 500 ficheros
3. Nombra cada archivo con el SKU del producto, por ejemplo PRD-001.jpg
4. El sistema empareja archivos y productos por SKU

Una vista previa de dry run muestra coincidencias, ficheros omitidos y errores.

Plantillas de mapeo

Si importas con frecuencia desde el mismo formato:

1. Durante el paso 2, haz clic en Save Mapping Template
2. Asignale un nombre, como ERP Export o Supplier X Format
3. En futuras importaciones, selecciona esa plantilla para aplicar el mismo mapeo automaticamente

Las plantillas de mapeo se guardan por tenant y pueden marcarse como predeterminadas.

Consejos

• Empieza por la plantilla para garantizar nombres de columnas y formato correctos.
• Usa siempre el dry run antes de confirmar, sobre todo en importaciones grandes.
• Deduplica por SKU; si reimportas un archivo, los productos existentes se actualizan en lugar de duplicarse.
• Usa nombres de grupo coherentes para mantener una categorizacion limpia.
• Cuida la codificacion UTF-8 cuando el CSV contenga caracteres especiales.