Importar productos en OpenCart desde CSV sin duplicados

Planifica identificadores de productos estables, mapea columnas CSV y prueba importaciones repetidas antes de actualizar tu catálogo de OpenCart con Import Export PRO.

Una importación de productos solo es útil si ejecutarla dos veces te da el mismo catálogo, en lugar de el doble de productos. Antes de subir un CSV a OpenCart, define cómo una fila identifica un producto y qué campos ese archivo puede cambiar. Esa decisión es más importante que el tamaño de la hoja de cálculo.

Esta guía cubre un flujo de trabajo de actualización de productos repetible utilizando Import Export PRO. Su mapeo de columnas y perfiles de importación ayudan a adaptar los archivos de proveedores a tu tienda. Los campos y operaciones exactos disponibles dependen de tu versión instalada y perfil; exporta una muestra de esa instalación antes de construir tu archivo.

Elige una clave de coincidencia estable

No uses un nombre de producto como identificador. Los nombres cambian, las traducciones difieren y dos productos pueden compartir el mismo título. Elige una clave que permanezca estable, como un identificador de tienda existente o un SKU de proveedor único mapeado a tu propio catálogo. Confirma qué identificadores admite realmente tu perfil de importación.

Un SKU no es automáticamente único solo porque una columna se llame SKU. Verifica el archivo fuente y la tienda existente en busca de duplicados. Si dos proveedores venden un artículo llamado 1001, mantén un mapeo explícito o utiliza identificadores específicos del proveedor que tu proceso pueda resolver de manera consistente.

Fila ilustrativaClave de coincidenciaResultado esperado
Camisa azul existenteSHIRT-BLUEActualizar el producto existente
La misma camisa con un nuevo títuloSHIRT-BLUEMantener la identidad del producto
Nueva camiseta rojaSHIRT-REDCrear solo si el perfil permite nuevos productos

Construir un archivo pequeño antes de uno grande

Exporta primero algunos productos representativos. Incluye un producto simple, uno con opciones y uno con múltiples categorías. Mantén la exportación como referencia para los nombres de campo y formatos soportados. No trates el ejemplo a continuación como una plantilla de extensión lista para usar; mapea estos encabezados ilustrativos a los campos en tu propio perfil.

supplier_sku,name,price,quantity
SHIRT-BLUE,Blue cotton shirt,24.90,18
SHIRT-RED,Red cotton shirt,24.90,0

Guarda el archivo con la codificación y delimitador seleccionados en el importador. Inspecciónalo en un editor de texto plano así como en una hoja de cálculo. Las aplicaciones de hoja de cálculo pueden eliminar ceros a la izquierda, reformatear identificadores largos e interpretar códigos de productos como fechas. Citar también es importante cuando una descripción contiene el delimitador.

Separar la creación de productos de actualizaciones rutinarias

Utilice diferentes perfiles para la creación inicial de productos y actualizaciones diarias de stock. Un archivo de stock no debe reemplazar inesperadamente descripciones cuidadosamente editadas, asignaciones de categoría o URLs SEO. Enumere los campos que posee cada proceso: por ejemplo, el proveedor controla la disponibilidad, mientras que el equipo de merchandising controla descripciones e imágenes.

Decide cómo el perfil maneja las celdas en blanco. Un valor vacío puede significar “limpiar este campo”, “dejarlo sin cambios” o “entrada no válida”, dependiendo del campo y la configuración. Prueba ese comportamiento explícitamente en lugar de asumir que cada celda vacía será ignorada. Una fila de producto faltante también necesita una política separada; la ausencia de un archivo no es prueba de que un producto haya sido descontinuado.

Ejecutar una prueba de repetibilidad en staging

  1. Registrar la cantidad de productos y exportar los productos objetivo antes de importar.
  2. Importar una pequeña muestra que contenga un artículo existente, un nuevo artículo, cero stock y un cambio de título.
  3. Verifica identificadores, precios, stock, categorías, imágenes y opciones tanto en la administración como en la tienda.
  4. Importa el archivo idéntico nuevamente. Los artículos existentes deben mantener su identidad y el conteo de productos no debe aumentar inesperadamente.
  5. Cambiar un valor y confirmar que solo el producto y los campos deseados cambian.

También prueba una clave duplicada, un precio inválido y un valor requerido faltante. Un proceso seguro debería producir un resultado claro y revisable. Mantén el informe y tu exportación original hasta que los resultados hayan sido reconciliados. No utilices una función de recuperación automática como sustituto de un procedimiento de copia de seguridad y restauración probado.

Verifica la tienda, no solo el informe de importación

Una carga exitosa no prueba que los compradores vean la información correcta. Abre varios productos, elige sus opciones, agrégalas a un carrito de prueba y compara los totales mostrados con los valores previstos. Verifica cada tienda e idioma afectado por el perfil.

Después de importaciones que cambian precios o stock, revisa también cualquier feed publicitario programado. Una base de datos de tienda limpia aún puede ser seguida por un catálogo externo obsoleto. Nuestro guía de identificador de feed de productos explica las verificaciones de identidad, mientras que el lista de verificación de sincronización de proveedores cubre actualizaciones repetidas.

¿Cuándo debería automatizar la importación?

Automatiza después de que las pruebas de muestra y repetibilidad pasen y alguien asuma el proceso de fallo. Mantén un perfil nombrado, una fuente de archivo conocida y un registro de lo que cambió. Si el formato de origen cambia, detente y revalídalo antes de la próxima ejecución de producción. Una importación automatizada debería hacer que un proceso probado sea más fácil de repetir, en lugar de hacer que un proceso incierto se ejecute más a menudo.