Skip to main content

Revisión de catálogo con Python antes de migrar a Shopify

Updated 6 min readMarkdown

Antes de cambiar de plataforma, conviene saber qué representa cada fila del catálogo. Un archivo que se abre sin errores puede seguir conteniendo variantes duplicadas o referencias que necesitan una decisión comercial.

Esta guía propone una comprobación pequeña, reproducible y local con Python. La tabla del ejemplo es un formato de revisión propio: no es un CSV listo para importar en Shopify. Los productos y las direcciones de imágenes son ficticios. El código se ha probado con las muestras incluidas; no se presentan resultados de clientes.

1. Acordar qué se quiere revisar

El primer paso consiste en separar tres conceptos:

  • Producto: la ficha comercial que agrupa versiones de un mismo artículo.
  • Variante: una combinación concreta de opciones, como talla y color.
  • SKU: una referencia de negocio que puede intervenir en el almacén, un ERP o una integración.

En el ejemplo agrupamos las filas con product_key y describimos la variante con size y color. Son nombres elegidos para la tabla intermedia, no nombres de campos de la API.

Un SKU repetido se marca como aviso para investigar. El script no lo convierte en una prohibición universal de Shopify: puede ser una duplicación accidental o una decisión deliberada de la operación. Antes de cambiarlo hay que entender qué sistemas utilizan esa referencia.

2. Trabajar sobre una copia intermedia

Conserva una exportación sin tocar y prepara otra tabla para revisar. Mantén el SKU como texto para no perder ceros iniciales. Si un nombre contiene una coma, el CSV debe conservar su entrecomillado; por eso usamos un lector CSV y no separamos las líneas manualmente.

La muestra contiene cuatro filas:

product_key,sku,size,color,image
camiseta,CAM-01,M,Azul,https://example.org/camiseta.jpg
camiseta,CAM-01,L,Azul,https://example.org/camiseta.jpg
camiseta,CAM-02,M,Azul,https://example.org/camiseta.jpg
gorra,GOR-01,U,Negro,

Hay tres situaciones que revisar: dos variantes comparten CAM-01, la combinación camiseta/M/Azul aparece dos veces y la gorra no tiene ninguna referencia de imagen.

La imagen se comprueba por producto: una fila adicional sin imagen no genera un aviso si otra fila del mismo producto sí tiene una referencia. Aun así, este ejemplo no modela todo el comportamiento de las filas de imágenes o variantes del CSV de importación de Shopify.

3. Ejecutar una comprobación que solo lea

Guarda el siguiente código como catalogo-audit.py. Utiliza la biblioteca estándar de Python y no necesita instalar dependencias. Solo abre el archivo indicado, calcula los avisos y escribe el resultado en la consola.

import csv
import json
import sys
from collections import defaultdict


def revisar(path):
    avisos = []
    skus = {}
    variantes = {}
    imagenes = defaultdict(bool)
    filas = 0
    with open(path, encoding='utf-8-sig', newline='') as archivo:
        lector = csv.DictReader(archivo)
        requeridas = {'product_key', 'sku', 'size', 'color', 'image'}
        if not requeridas.issubset(lector.fieldnames or []):
            raise ValueError('Faltan columnas de la tabla de revisión')
        for numero, fila in enumerate(lector, start=2):
            filas += 1
            producto = (fila['product_key'] or '').strip()
            sku = (fila['sku'] or '').strip()
            talla = (fila['size'] or '').strip()
            color = (fila['color'] or '').strip()
            if not producto:
                avisos.append({'fila': numero, 'aviso': 'Producto sin clave'})
                continue
            clave = (producto, talla, color)
            if clave in variantes:
                avisos.append({'fila': numero, 'aviso': 'Combinación repetida', 'primera_fila': variantes[clave]})
            else:
                variantes[clave] = numero
            if sku:
                if sku in skus:
                    avisos.append({'fila': numero, 'aviso': 'SKU repetido: revisar', 'primera_fila': skus[sku]})
                else:
                    skus[sku] = numero
            imagenes[producto] = imagenes[producto] or bool((fila['image'] or '').strip())
    for producto, tiene_imagen in imagenes.items():
        if not tiene_imagen:
            avisos.append({'producto': producto, 'aviso': 'Sin referencia de imagen'})
    return {'filas': filas, 'avisos': avisos}


if __name__ == '__main__':
    print(json.dumps(revisar(sys.argv[1]), ensure_ascii=False, indent=2))

Para probarlo, guarda la muestra como catalogo-ejemplo.csv y ejecuta:

python3 catalogo-audit.py catalogo-ejemplo.csv

No se conecta a Shopify, no descarga las imágenes, no necesita credenciales y no modifica el archivo de entrada.

4. Interpretar el resultado antes de corregir

La muestra devuelve cuatro filas y tres avisos. No son tres instrucciones automáticas de borrado.

Aviso Comprobación humana
SKU repetido Contrastar la referencia con el almacén o ERP. Decidir si debe ser única en esta operación.
Combinación repetida Revisar si sobra una fila o si una opción de la variante se ha perdido en la exportación.
Sin referencia de imagen Buscar el material del producto y confirmar qué archivos se deben trasladar.

El número de fila que muestra el script incluye la cabecera: la primera fila de datos es la 2. Cuando hay una repetición, también indica dónde apareció por primera vez.

La comparación distingue mayúsculas, minúsculas y acentos, aunque retira espacios externos de las claves. Por ejemplo, Azul y azul son valores distintos. Si tu negocio los considera equivalentes, acuerda esa normalización y conserva un registro de los cambios; no conviertas todo a minúsculas sin revisar las consecuencias.

5. Repetir con una muestra corregida

Para comprobar el comportamiento, hicimos tres cambios sintéticos: asignamos CAM-03 a la talla L, cambiamos la tercera camiseta a talla S y añadimos una referencia de imagen a la gorra.

product_key,sku,size,color,image
camiseta,CAM-01,M,Azul,https://example.org/camiseta.jpg
camiseta,CAM-03,L,Azul,https://example.org/camiseta.jpg
camiseta,CAM-02,S,Azul,https://example.org/camiseta.jpg
gorra,GOR-01,U,Negro,https://example.org/gorra.jpg

La salida de esta segunda prueba contiene cuatro filas y una lista de avisos vacía. También probamos una fila con un nombre entrecomillado que contiene una coma y un SKU con ceros iniciales.

Cero avisos solo significa que estas comprobaciones no han encontrado incidencias. No certifica el catálogo ni demuestra que una importación vaya a funcionar.

6. Lo que queda fuera de esta herramienta

La revisión de un catálogo también puede necesitar precios, impuestos, inventario por ubicación, unidades, traducciones, metacampos y publicación por canal. Este script no comprueba esos datos. Tampoco verifica que una URL de imagen responda o que tengamos permiso para usar la imagen.

Para preparar el archivo de carga, usa la plantilla vigente y la documentación oficial del CSV de productos de Shopify. No renombres sin más las columnas de este ejemplo y lo subas a producción.

La organización de productos y opciones debe contrastarse con la documentación de variantes. Antes de una carga extensa, prueba una selección representativa en el entorno de destino y compara los datos y el resultado visible con el origen.

Una revisión trazable

Guarda la exportación inicial, la tabla revisada y las decisiones tomadas. Para cada cambio, anota el producto afectado, la causa, quién lo valida y la comprobación posterior. Así puedes explicar por qué cambió una referencia sin depender de la memoria de quien preparó el archivo.

Guía del equipo de Migraciones.io, agencia de diseño, desarrollo y migraciones a Shopify. Contacto público: info@migraciones.io.

Contenido preparado con asistencia de IA y comprobación ejecutada del código y de las muestras sintéticas. Publicado con fines educativos; el alcance de una migración debe revisarse para cada tienda.

About the author

  • Somos Migraciones.io, una agencia Shopify. Trabajamos en diseño y desarrollo de tiendas online, auditorías ecommerce, CRO, migraciones y email marketing con Klaviyo. Compartimos recursos técnicos y criterios para mejorar una tienda Shopify. https://migraciones.io/

No comments yet. Be the first to comment.