Cómo importar productos en Magento 2 en 2026: La guía de trabajo para 2.4.8 - ES

Adobe envió Magento 2.4.8 en abril 8, 2025, y la forma en que los grandes catálogos se mueven a través de la plataforma finalmente alcanzó 2026. Los puntos finales de importación REST nativos (/V1/importar/csv y /V1/importar/json) ahora acepta cargas útiles codificadas en base64 y compresión gzip. Eso mata a los viejos “divide tu CSV en 500 filas y orar” rutina. El importador de CSV administrativo en el que todavía se apoyan la mayoría de las tiendas? Misma herramienta, principalmente. Pero las formas en que se rompe se han movido, y también las correcciones. Esta guía cubre ambos caminos., y los errores que comen un fin de semana cuando los extrañas.

respuesta rapida: Para catálogos bajo 5,000 SKU, use el importador CSV de administrador en Sistema > Transferencia de datos > Importar. Para cualquier cosa más grande o automatizada, golpear el REST /V1/importar/csv punto final añadido en 2.4.8. Mantener archivos UTF-8 sin BOM, soltar imágenes en var/importar/imágenes, y siempre corre “Verificar datos” antes de comprometerse.

Última revisión: abril 2026. Puntos finales, números de versión, e importar comportamientos verificados con Adobe Commerce 2.4.8 notas de la versión y documentación de Experience League.

Antes de comenzar: lo que cambió en 2.4.8

Si ha importado productos en Magento 2.4.5 o antes, algunos incumplimientos se pusieron al día con la realidad. Nuevo 2.4.8 instala el barco con indexadores en Actualización por horario modo, por lo que las importaciones masivas ya no paralizan la interfaz durante la reindexación. La liberación cerró 497 errores principales (varios en el propio importador) y agregó los puntos finales de importación REST que eluden el límite máximo de carga de administrador de 2 MB.

Esto es lo que necesita antes de tocar al importador:

• Magento 2.4.8 o más tarde. Correr 2.4.5 o mayor? Actualiza primero. El importador más antiguo todavía trabaja., pero las correcciones de errores no se respaldan.
• PHP 8.3 mínimo, 8.4 recomendado. 2.4.8 Se envía con PHP nativo. 8.4 apoyo. Tiendas en PHP 8.1 importará, pero el manejo de errores es más ruidoso.
• MySQL 8.0 o MariaDB 10.6/11.4. 2.4.9-beta1 elimina MySQL 8.0 y mariadb 10.6, entonces, si estás configurando algo nuevo, ir 11.4.
• Un directorio grabable var/import/images. Permisos: 775 para directorios, 664 para archivos, propiedad de su usuario web.
• Límites PHP suficientes. Para catálogos terminados 10,000 SKU, límite_memoria 2G y tiempo_max_ejecución 1800 en php.ini. Los valores más bajos acabarán silenciosamente con las importaciones a mitad de camino.

Un aviso rápido: Adobe Commerce (el nivel pagado) y Magento Open Source comparten el código del importador. Los clientes de la nube no necesitan tocar php.ini porque la pila viene preajustada, pero las reglas y comportamientos de CSV a continuación se aplican de manera idéntica.

Lo que realmente puedes importar

Magento 2 tiene seis tipos de productos, y las reglas CSV cambian dependiendo de cuál te estés moviendo. La versión corta:

• Productos simples. Un SKU, una variación. La plantilla que utiliza cada tutorial.. Importa estos primero si estás aprendiendo.
• Productos configurables. Un SKU principal con simples secundarios adjuntos mediante variaciones_configurables. Las camisetas de tamaño y color son el ejemplo de libro de texto.. Los niños deben existir antes de la fila de importación principal., o el enlace falla.
• Productos virtuales. Servicios, suscripciones, cobertura de garantía. Sin cálculo de envío, no se necesita columna de peso.
• Productos agrupados. Un contenedor que muestra varios simples en una página. (pensar “juego de cuchillos de cocina, comprar individualmente”). Usos skus_asociados en el CSV.
• Productos empaquetados. Crea tus propios combos donde el cliente elige opciones.. El formato es complicado y utiliza valores_paquete con campos separados por tuberías.
• Productos descargables. Archivos, licencias de software, libros electrónicos. Necesidades enlaces_descargables configurado.

El pedido de importación importa. Lo simple primero, luego configurables que hacen referencia a ellos, luego agrupados y agrupados al final. Importar un configurable cuyos SKU secundarios aún no existen es el error autoinfligido más común, y el validador no siempre lo detectará antes de que se ejecute la importación.

Importación CSV: El tutorial del administrador

El importador CSV administrador maneja catálogos de hasta aproximadamente 5,000 SKU sin queja. Vale la pena saberlo incluso si planeas pasar a la API más adelante, porque las reglas de columna que siguen se aplican a ambas rutas.

Paso 1: Exportar un archivo de muestra (No te saltes esto)

Ir Sistema > Transferencia de datos > Importar. Colocar Tipo de entidad a Productos, luego haga clic Descargar archivo de muestra. La muestra coincide exactamente con su instalación de Magento, incluyendo cualquier atributo personalizado que su tienda haya agregado. El uso de una plantilla CSV genérica de una publicación de blog es cómo comienzan los errores de falta de coincidencia de columnas.

guardar la muestra, ábrelo en Notepad++ o VS Code. No uses Microsoft Excel. Excel agrega una marca de orden de bytes a archivos UTF-8, y el importador rechaza archivos con prefijo BOM sin un mensaje de error claro. Si Excel es tu única opción, exportar como “CSV UTF-8” y ejecute el archivo a través de un eliminador de BOM, o cambiar a Google Sheets (Expediente > Descargar > CSV, que guarda UTF-8 limpio).

Paso 2: Complete las filas de sus productos

Columnas requeridas para un producto simple: referencia, código_vista_tienda, código_conjunto_atributo, tipo_producto, categorías, sitios_web_de_productos, nombre, descripción, precio, cantidad, peso, producto_en línea, nombre_clase_impuesto, visibilidad.

Mantenga las descripciones debajo ~255 caracteres por fila si estás en el importador administrador. Las descripciones HTML más largas funcionan, pero aumentan el tamaño del archivo rápidamente y acercan el límite predeterminado de 2 MB. Las categorías utilizan barras para construir jerarquía: Categoría predeterminada/Ropa/Camisetas. El separador es una barra diagonal., no es una barra invertida. un alivio: Magento crea automáticamente rutas de categorías que aún no existen, por lo que no es necesario crear previamente cada categoría antes de importar.

Para configurables, la variaciones_configurables La columna lleva una cadena delimitada por barras verticales como:
sku=CAMISA-ROJA-S,tamaño = S,color = rojo|sku=CAMISA-ROJA-M,tamaño = M,color = rojo

complicado, si. Ahórrese el dolor exportando primero un configurable hecho a mano, luego usa esa fila como plantilla para la siguiente 5,000.

Paso 3: Configurar el comportamiento de importación

¿Qué sucede cuando un SKU en tu CSV ya existe en el catálogo?? Tres opciones de comportamiento deciden, y elegir el incorrecto puede borrar datos:

• Agregar/Actualizar. La elección predeterminada y segura. Agrega nuevos SKU, actualizaciones que coinciden, deja solos los productos no listados.
• Reemplazar. Elimina primero los SKU coincidentes, luego los recrea desde el CSV. Limpia las URL, comentarios, e historial de movimiento de stock de esos productos. Usar raramente.
• Eliminar entidades. Elimina los SKU coincidentes del catálogo.. Irreversible sin restauración de base de datos.

también establecer Separador de campo a coma, Separador de valores múltiples a coma, y comprobar Recuento de errores permitidos. El valor predeterminado es 10. Póngalo a un número más alto si espera que algunas filas fallen y desea que el importador continúe en lugar de abortar..

Paso 4: Validar antes de importar

Sube tu CSV, hacer clic Verificar datos, y espera. Esto ejecuta la misma validación que hace la importación real., pero sin escribir en la base de datos. El resultado enumera cada error de fila por número con la columna específica que falló. Arreglar el CSV, volver a subir, volver a comprobar. Enjuague hasta que esté verde.

Si la validación dice “El archivo es válido” pero aparecen algunas advertencias, léelos de todos modos. A las advertencias a menudo les faltan rutas de categorías o vistas de tiendas que Magento omitirá silenciosamente, crear productos con árboles de categorías incompletos.

Paso 5: Ejecute la importación

Hacer clic Importar. La barra de progreso es honesta para archivos pequeños y optimista para los grandes.. No cierres la pestaña del navegador. No actualizar. El importador ejecuta un único proceso PHP largo, y en hosting más lento, cerrar la pestaña a mitad de escritura deja huérfano el proceso y deja datos parciales. Mirar var/log/import.log a través de SSH si quieres progreso en vivo, o comprobar Sistema > Historial de importación una vez que termine.

Imágenes y medios

Las imágenes confunden más importaciones que cualquier otro campo. La regla es simple una vez que la has visto una vez..

Envíe por FTP o SFTP sus archivos de imagen <raíz de magento>/var/importar/imágenes. Se permiten subcarpetas: var/import/images/2026-primavera trabajos. en el CSV, hacer referencia a cada imagen por su ruta relativa a var/importar/imágenes:

• imagen_base columna: imagen principal del producto (mostrado en la página del producto)
• pequeña_imagen columna: miniatura para páginas de categorías
• imagen_miniatura columna: miniaturas de carrito y pedido
• imágenes_adicionales columna: galería de imágenes, separados por comas

Una fila que importa un producto con cuatro fotografías de galería podría verse así: /2026-primavera/camiseta-roja-main.jpg en imagen_base, entonces /2026-primavera/camiseta-espalda-roja.jpg,/2026-primavera/camiseta-detalle-rojo.jpg,/2026-primavera/camiseta-tejido-rojo.jpg en imágenes_adicionales.

Mira el nombre del archivo. Magento trata Camisa.jpg y camisa.jpg como archivos diferentes en hosts Linux, y el importador no corrige automáticamente el caso. Comprime a WebP antes de cargarlo si puedes; Las tomas de héroe en JPEG de 300-400 KB arruinarán sus Core Web Vitals en el momento en que llegue el tráfico real.. Nuestro Libro de jugadas de velocidad de Magento cubre la conversión de WebP y AVIF para catálogos existentes.

Importación de API REST: los 2.4.8 Ruta para catálogos grandes

El importador administrativo se agota rápidamente. Una vez que hayas pasado 10,000 SKU o necesitas sincronizaciones automatizadas desde un ERP, los puntos finales REST que Adobe envió 2.4.8 son la herramienta adecuada. Dos puntos finales importan:

• ENVIAR /descanso/<código_tienda>/V1/importar/csv para cargas CSV
• ENVIAR /descanso/<código_tienda>/V1/importar/json para cargas JSON

Ambos aceptan una cadena codificada en base64 en el cuerpo de la solicitud.. Para archivos CSV, la regla es: Codifica tu archivo en UTF-8, gzip-comprimirlo (opcional pero inteligente para cualquier cosa de más de 1 MB), luego base64 el resultado. La respuesta devuelve un recuento de entidades importadas.. Masivo asincrónico vía /V1/a granel/ También funciona si quieres disparar y olvidar..

el flujo, en orden:

• Autenticarse con un token de administrador (PUBLICAR en /V1/integración/admin/token)
• Comprima sus productos.csv, codificarlo en base64, meterlo en una carga útil JSON con fuente, entidad: “catalogo_producto”, y comportamiento: “añadir”
• PUBLICAR en el punto final de importación con el token en el encabezado de Autorización
• Encuesta /V1/a granel/{a granelUuid}/estado si fuiste asíncrono

Los documentos para desarrolladores de Adobe tienen la forma exacta de la carga útil y se actualizan por versión, así que extraiga desde allí en lugar de copiar hilos antiguos de StackOverflow. los 2.4.8 saldar: la ruta asíncrona no mantiene abierta una solicitud PHP por hasta 30 minutos como lo hace el importador administrativo. Su carga de 50.000 filas se ejecuta en segundo plano, y el escaparate sigue respondiendo a los compradores reales.

Errores de importación comunes y lo que realmente los soluciona

Estos son los fallos que más tiempo queman. Cada uno tiene una causa raíz específica que no siempre es obvia en el texto del error..

“Tamaño de memoria permitido de X bytes agotado”

PHP se quedó sin memoria a mitad de la importación. Aumentar límite_memoria en php.ini a 2G, reiniciar PHP-FPM, rever. Si no puedes tocar php.ini (alojamiento compartido), dividir el CSV en archivos de 1,000-5,000 filas cada una e importar secuencialmente. Extensiones de terceros como Firebear y Amasty añaden una “Importar sin límite de memoria” palanca, pero esa es una característica de extensión, Magento no nativo.

“Tiempo máximo de ejecución de 30 segundos superados”

Tu PHP tiempo_max_ejecución es demasiado bajo. Chocar con 1800 segundos. En Nginx, también necesitarás aumentar fastcgi_read_timeout para igualar, de lo contrario, Nginx mata el flujo ascendente antes de que finalice PHP.

“Secuencia de columnas incorrecta” o “El encabezado tiene columnas no válidas”

Marca de orden de bytes. Su CSV fue guardado desde Excel, que antepone una lista de materiales a los archivos UTF-8 que el importador lee como una primera columna confusa. Vuelva a exportar desde Google Sheets o vuelva a guardar a través de Notepad ++ como UTF-8 sin BOM. Si solo marca una cosa antes de presionar importar, mira esto.

“Conjunto de atributos no válido” o “Valor de atributo no válido para X”

Su CSV hace referencia a un conjunto de atributos o valor desplegable que no existe en esta instalación de Magento. Controlar Víveres > Atributos. Los valores desplegables distinguen entre mayúsculas y minúsculas y los espacios en blanco.. “Rojo ” con un espacio final no es “Rojo”.

Importar “completa” pero los productos no aparecen en la interfaz

Reindex no se ejecutó, o el caché está obsoleto. SSH en y ejecutar indexador bin/magento:reindexar seguido por caché bin/magento:enjuagar. En 2.4.8 con los indexadores de Actualización por programación esto es más raro, pero todavía sucede con la URL del producto y los indexadores de acciones..

“La clave URL para la tienda especificada ya existe”

Estás importando un producto cuyo clave_url choca con uno existente. Cambie la clave URL en su CSV o establezca el comportamiento en “Agregar/Actualizar” en lugar de un fresco “Agregar datos complejos” correr.

Requisitos de alojamiento para grandes importaciones

El alojamiento compartido acaba con más importaciones de Magento que los malos CSV. Si estás ejecutando una producción 2.4.8 Tienda, el piso honesto es 4 GB de RAM y 2-4 vCPU; catálogos reales (10k+ SKU, reimportaciones frecuentes) necesidad 8-16 GB. El disco debe ser NVMe SSD, unidades que no giran ni unidades SSD SATA antiguas, porque las operaciones de reindexación y cambio de tamaño de imagen generan E/S aleatorias.

Cosas específicas que un host preparado para Magento debería permitirle hacer:

• Editar php.ini (o equivalente por dominio) para aumentar el límite de memoria y el tiempo de ejecución
• Instalar y ejecutar cron (La importación masiva asíncrona de Magento utiliza la cola de consumidores)
• Acceso SSH para papelera/magento Comandos CLI
• Suficiente espacio libre en disco para var/importar/imágenes puede contener el lote más grande dos veces (Copias de Magento, no se mueve)

Si su anfitrión actual no puede entregarlos, el importador no es tu verdadero problema. Nuestro Resumen de alojamiento Magento VPS desglosa qué proveedores envían una pila lista para 2.4.8 sin recargos, y el herramienta de búsqueda de alojamiento filtros por versión de PHP, RAM, y panel de control si desea comparar planes uno al lado del otro. Para comerciantes que ejecutan WooCommerce junto con Magento (sucede más de lo que piensas), la Guía de alojamiento de comercio electrónico de WordPress cubre la pila cruzada.

Preguntas frecuentes

¿Cuál es el tamaño máximo de archivo CSV que puedo importar en Magento? 2.4.8?

El importador administrador limita las cargas en 2MB por defecto, controlado por PHP subir_max_filesize y post_max_size. Eleve ambos a 64M en php.ini para archivos más grandes. Para cualquier cosa que supere los 50 MB comprimidos, cambiar al DESCANSO /V1/importar/csv punto final, que maneja cargas útiles gzip y no obstaculiza la carga del navegador.

¿Puedo importar productos en Magento? 2 sin usar CSV?

si. La API REST de Magento 2.4.8 acepta tanto CSV como JSON a través de /V1/importar/json. Extensiones de terceros (oso de fuego, Amasty, Magmi para instalaciones antiguas) soporte XML, Sincronización de Hojas de cálculo de Google, y conectores ERP directos. El administrador nativo todavía requiere CSV, así que elija su camino según las necesidades de automatización.

¿Cuánto tiempo lleva importar 10.000 productos??

en una sintonizada 2.4.8 pila (8 GB de RAM, NVMe, PHP 8.4, MariaDB 11.4), esperar 15-25 minutos para una importación de 10k filas con imágenes. El alojamiento compartido impulsa esto a 60+ minutos si se completa. La ruta masiva REST asíncrona se ejecuta en segundo plano, para que las páginas orientadas al comprador sigan respondiendo durante la importación.

¿Por qué mi importación se realiza correctamente pero muestra precios o stock incorrectos??

Dos causas habituales. primero, su CSV tiene espacios en blanco al final o formato decimal de coma europeo (1,99 en lugar de 1.99) en la columna de precio; Magento los analiza como no válidos y mantiene el valor anterior. Segundo, inventario de múltiples fuentes (MSI) en 2.4.8 almacena cantidad por fuente, no por producto a nivel mundial, entonces necesitas el código_fuente columna o la importación actualiza solo la fuente predeterminada.

¿Necesito desactivar el catálogo plano de Magento antes de importar??

El catálogo plano quedó obsoleto en 2.3 y eliminado de los flujos de trabajo predeterminados mediante 2.4.5. Si tu tienda de alguna manera todavía lo tiene habilitado, deshabilítelo en Víveres > Configuración > Catalogar > Escaparate antes de las grandes importaciones. Siempre fue una responsabilidad de desempeño y 2.4.8 hace esto explícito en el administrador.

¿Puedo automatizar las importaciones de productos desde un ERP o PIM??

Eso es exactamente lo que 2.4.8 Los puntos finales REST son para. Herramientas como Akeneo, pimcore, y Salsify tienen Magento nativo 2 conectores. Para construcciones personalizadas, cron un script que extrae tu feed de ERP, se transforma a CSV, gzips, y PUBLICACIONES a /V1/importar/csv. Horario para horas valle si la importación es pesada.

Notas finales

Dos reglas deciden si tu próxima importación funciona. Uno: guarde el CSV como UTF-8 sin BOM. Siempre. Dos: aumentar PHP límite_memoria y tiempo_max_ejecución antes de que empieces, no después del primer accidente. Todo lo demás es detalle.

Camino sabio, la llamada es sencilla. Debajo 5,000 SKU y ejecución de importaciones ocasionalmente? Utilice la herramienta CSV de administración. Pasado 10,000 SKU o sincronización desde un ERP todas las noches? Utilice el DESCANSO /V1/importar/csv punto final agregado en 2.4.8 y deja de cuidar el proceso. Haga una copia de seguridad de la base de datos antes de cualquier ejecución de Reemplazar o Eliminar. Nunca cierres la pestaña del navegador a mitad de la importación. Y si la pila de abajo no puede aguantar, ninguna táctica de importador lo rescata. Primero arregla el host.

Para lectura relacionada: la Resumen del tema de Magento cubre el rendimiento del frontend después de cargar su catálogo, el libro de estrategias de velocidad vinculado anteriormente maneja la pila de almacenamiento en caché, y las guías de alojamiento cubren en qué ejecutarlo todo.. Las aburridas opciones de infraestructura se acumulan más rápido que cualquier indicador de característica individual.