<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[Notas técnicas de Migraciones.io]]></title><description><![CDATA[Notas técnicas de Migraciones.io]]></description><link>https://migracionesio.hashnode.dev</link><image><url>https://cdn.hashnode.com/uploads/logos/6aec852f520975999b9d535e/0eb61053-d7e1-4eb8-97a3-4d4cef29a9f0.jpg</url><title>Notas técnicas de Migraciones.io</title><link>https://migracionesio.hashnode.dev</link></image><generator>RSS for Node</generator><lastBuildDate>Wed, 18 Nov 2026 13:12:42 GMT</lastBuildDate><atom:link href="https://migracionesio.hashnode.dev/rss.xml" rel="self" type="application/rss+xml"/><language><![CDATA[en]]></language><ttl>60</ttl><item><title><![CDATA[Test a Shopify redirect map before import]]></title><description><![CDATA[A redirect CSV can pass a format check while sending visitors through a loop, pointing to an unpublished product, or asking Shopify to redirect a page that…]]></description><link>https://migracionesio.hashnode.dev/test-shopify-redirect-map-before-import</link><guid isPermaLink="true">https://migracionesio.hashnode.dev/test-shopify-redirect-map-before-import</guid><category><![CDATA[shopify]]></category><category><![CDATA[Python]]></category><dc:creator><![CDATA[Migraciones.io]]></dc:creator><pubDate>Thu, 12 Nov 2026 15:22:04 GMT</pubDate><content:encoded><![CDATA[<p>A redirect CSV can pass a format check while sending visitors through a loop, pointing to an unpublished product, or asking Shopify to redirect a page that still loads. A useful pre-launch check compares the CSV with a second input, the paths expected to be active when the new store goes live.</p>
<p>The example in this article uses synthetic data. It covers twelve independent scenarios and makes no requests to a store. Ten scenarios produce the expected finding and two control cases pass without findings.</p>
<h2>Start with a destination inventory</h2>
<p>Export or build a list of the product, collection, page and article paths that will be available at launch. Use paths such as '/products/usb-c-cable' and '/es/products/usb-c-cable'. Keep markets and language prefixes intact. Two URLs can point to equivalent product pages and still need separate rules.</p>
<p>The inventory should reflect publishing decisions. A SKU in a migration export does not establish that its product page will be reachable on the storefront. Draft products, publication settings and renamed handles can all change the result. Ask whoever owns the destination catalog to validate this list before it becomes the input for the redirect audit.</p>
<h2>Check the rule and then follow its destination</h2>
<p>First, check whether the same source appears with two different targets. A normal spreadsheet filter may catch duplicate cells while missing that one team mapped a discontinued product to a replacement and another mapped it to a collection.</p>
<p>Next, check whether the source itself remains active. Shopify only applies its native URL redirects when the source is broken. Its help documentation also lists reserved or fixed paths, limitations on collection tag URLs, and cases where query strings may behave unexpectedly. See <a href="https://help.shopify.com/en/manual/online-store/menus-and-links/url-redirect">Shopify’s URL redirect documentation</a>.</p>
<p>Finally, follow the destination as a graph. If the destination is also a source, follow its next hop. Keep the paths already visited. Seeing one again identifies a cycle. When the graph reaches a path absent from the inventory, inspect whether it is a typo, a missing publication or an intended destination outside the store. Where the intermediate hop serves no purpose, map the old URL directly to its final destination.</p>
<table>
<thead>
<tr>
<th>Synthetic example</th>
<th>What the check shows</th>
</tr>
</thead>
<tbody><tr>
<td>Old cable page to the new product page</td>
<td>Direct rule passes</td>
</tr>
<tr>
<td>Old Spanish path to its Spanish product page</td>
<td>Localized control passes</td>
</tr>
<tr>
<td>Old path to an external website</td>
<td>Check the external destination separately</td>
</tr>
<tr>
<td>A rule under '/cart/'</td>
<td>Restricted source</td>
</tr>
<tr>
<td>Old path still present in the active inventory</td>
<td>Shopify may keep serving the old page</td>
</tr>
<tr>
<td>New product path missing from the inventory</td>
<td>Verify publication and handle</td>
</tr>
<tr>
<td>Old path with a query string</td>
<td>Review on the live store</td>
</tr>
<tr>
<td>'/old.html' to '/old'</td>
<td>Review Shopify’s equivalent-path rule</td>
</tr>
<tr>
<td>One old path with two different targets</td>
<td>Resolve the conflicting decision</td>
</tr>
<tr>
<td>Old cable to intermediate path to product</td>
<td>An extra hop</td>
</tr>
<tr>
<td>Two old pages pointing to each other</td>
<td>Cycle</td>
</tr>
<tr>
<td>One path pointing to itself</td>
<td>Self redirect</td>
</tr>
</tbody></table>
<h2>What to verify after launch</h2>
<p>Run a fresh browser session or an HTTP client that lets you inspect redirects without relying on your previous cache. Sample URLs with organic traffic and inbound links first. Verify the redirect status, the final response, the canonical and whether the landing page still meets the original visitor’s intent. Include market and language paths as separate checks.</p>
<p>The offline audit cannot establish whether the inventory is accurate, whether Shopify imported the rule as intended, or whether a destination is canonical or equivalent for a shopper. It makes the handover easier by showing the specific rule and destination the team needs to inspect.</p>
<p>For a related example of how catalog and order data were handled alongside a real replatform, see <a href="https://migraciones.io/pages/migracion-de-tiendacables-com">the TiendaCables migration case study</a>. The twelve redirect scenarios above were created separately and do not describe that merchant’s results.</p>
<p>The runnable Python audit is included in 'redirect_audit.py'. Run 'python3 redirect_audit.py --demo' for the twelve assertions. To check your own plan, run 'python3 redirect_audit.py redirects.csv active-paths.txt'. The CSV uses the headers 'Redirect from' and 'Redirect to'. The inventory contains one local path per line.</p>
<h2>Runnable example</h2>
<pre><code class="language-python">"""Offline checks for a Shopify redirect plan. Demo data is synthetic."""

import argparse
import csv
import json
from collections import defaultdict
from pathlib import Path
from urllib.parse import urlsplit


RESTRICTED_ROOTS = {
    "apps", "application", "cart", "carts", "orders", "services", "shop",
}
FIXED_PATHS = {"/products", "/collections", "/collections/all"}


def local_path(value):
    if not value.startswith("/") or value.startswith("//"):
        return None
    try:
        return urlsplit(value).path
    except ValueError:
        return None


def audit(rows, active_paths):
    destinations = defaultdict(set)
    origins = set()
    findings = []

    def report(line, source, kind, detail=""):
        findings.append({"line": line, "source": source, "kind": kind, "detail": detail})

    for line, (source, target) in enumerate(rows, start=2):
        source, target = source.strip(), target.strip()
        source_path = local_path(source)
        if not source_path or not target or source.startswith("/\\"):
            report(line, source, "INVALID_ROW", target)
            continue
        if "?" in source or "#" in source:
            report(line, source, "ORIGIN_PARAMETERS", target)
            continue
        origins.add(source_path)
        destinations[source_path].add(target)

    for source, targets in destinations.items():
        if len(targets) &gt; 1:
            report(None, source, "CONFLICTING_TARGETS", ", ".join(sorted(targets)))

    for line, (source, target) in enumerate(rows, start=2):
        source, target = source.strip(), target.strip()
        if source not in origins or not target:
            continue
        if source in FIXED_PATHS or source.split("/")[1] in RESTRICTED_ROOTS:
            report(line, source, "RESTRICTED_ORIGIN", target)
        if source in active_paths:
            report(line, source, "ORIGIN_STILL_ACTIVE", target)
        if len(destinations[source]) &gt; 1:
            continue
        path = local_path(target)
        if not path:
            try:
                external = urlsplit(target)
            except ValueError:
                external = None
            if external and external.scheme in {"http", "https"} and external.netloc:
                report(line, source, "EXTERNAL_TARGET_REVIEW", target)
            else:
                report(line, source, "INVALID_TARGET", target)
            continue
        if source == path:
            report(line, source, "SELF_REDIRECT", target)
            continue
        if source == f"{path}.html":
            report(line, source, "HTML_EQUIVALENT_REVIEW", target)
            continue

        seen = {source}
        chain = [source, path]
        while path in destinations and len(destinations[path]) == 1:
            if path in seen:
                report(line, source, "CYCLE", " -&gt; ".join(chain))
                break
            seen.add(path)
            next_target = next(iter(destinations[path]))
            path = local_path(next_target)
            chain.append(path or next_target)
            if not path:
                report(line, source, "CHAIN_TO_NONLOCAL_TARGET", " -&gt; ".join(chain))
                break
        else:
            if path in destinations:
                report(line, source, "CHAIN_TO_CONFLICT", " -&gt; ".join(chain))
            elif path not in active_paths:
                report(line, source, "DESTINATION_NOT_IN_INVENTORY", " -&gt; ".join(chain))
            elif len(chain) &gt; 2:
                report(line, source, "REDIRECT_CHAIN", " -&gt; ".join(chain))

    return findings


def demo():
    product = "/products/usb-c-cable"
    cases = [
        ("Direct product redirect", [("/old-cable", product)], {product}, set()),
        ("Independent localized path", [("/es/viejo", "/es/products/cable")],
         {"/es/products/cable"}, set()),
        ("External destination", [("/old", "https://example.org/new")], set(),
         {"EXTERNAL_TARGET_REVIEW"}),
        ("Restricted source", [("/cart/old", product)], {product}, {"RESTRICTED_ORIGIN"}),
        ("Source still active", [("/old", product)], {"/old", product}, {"ORIGIN_STILL_ACTIVE"}),
        ("Missing final destination", [("/old", product)], set(),
         {"DESTINATION_NOT_IN_INVENTORY"}),
        ("Query string on source", [("/old?color=black", product)], {product},
         {"ORIGIN_PARAMETERS"}),
        ("Equivalent HTML path", [("/old.html", "/old")], {"/old"}, {"HTML_EQUIVALENT_REVIEW"}),
        ("Conflicting duplicate source", [("/old", product), ("/old", "/products/other")],
         {product, "/products/other"}, {"CONFLICTING_TARGETS"}),
        ("Chain", [("/old", "/interim"), ("/interim", product)], {product}, {"REDIRECT_CHAIN"}),
        ("Cycle", [("/one", "/two"), ("/two", "/one")], set(), {"CYCLE"}),
        ("Self redirect", [("/old", "/old")], set(), {"SELF_REDIRECT"}),
    ]
    results = []
    for name, rows, paths, expected in cases:
        actual = {item["kind"] for item in audit(rows, paths)}
        if actual != expected:
            raise AssertionError(f"{name}: expected {expected}, got {actual}")
        results.append({"case": name, "findings": sorted(actual)})
    return results


def main():
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("redirects", type=Path, nargs="?")
    parser.add_argument("active_paths", type=Path, nargs="?")
    parser.add_argument("--demo", action="store_true")
    args = parser.parse_args()
    if args.demo:
        print(json.dumps(demo(), indent=2))
        return
    if not args.redirects or not args.active_paths:
        parser.error("Provide a redirect CSV and a file with one active path per line, or use --demo.")
    with args.redirects.open(encoding="utf-8-sig", newline="") as handle:
        reader = csv.DictReader(handle)
        if not {"Redirect from", "Redirect to"}.issubset(reader.fieldnames or []):
            parser.error("Expected CSV headers: Redirect from, Redirect to")
        rows = [(row.get("Redirect from") or "", row.get("Redirect to") or "") for row in reader]
    paths = {line.strip() for line in args.active_paths.read_text(encoding="utf-8-sig").splitlines()}
    print(json.dumps(audit(rows, paths), indent=2))


if __name__ == "__main__":
    main()
</code></pre>
<p>This article and example were prepared with AI assistance. The assertions were run locally against the synthetic fixtures.</p>
]]></content:encoded></item><item><title><![CDATA[Cómo comprobar redirecciones de Shopify antes y después de importar el CSV]]></title><description><![CDATA[Prueba reproducible con un CSV sintético y comandos curl para detectar cadenas y verificar el destino de las redirecciones en Shopify.]]></description><link>https://migracionesio.hashnode.dev/comprobar-redirecciones-shopify-csv-http</link><guid isPermaLink="true">https://migracionesio.hashnode.dev/comprobar-redirecciones-shopify-csv-http</guid><category><![CDATA[shopify]]></category><dc:creator><![CDATA[Migraciones.io]]></dc:creator><pubDate>Mon, 09 Nov 2026 12:00:49 GMT</pubDate><content:encoded><![CDATA[<p>Una migración puede tener un CSV sin duplicados y aun así enviar visitas al lugar equivocado. El mapa describe lo que quieres que ocurra. La respuesta HTTP de la URL anterior, el destino final y lo que ve el comprador son tres comprobaciones distintas.</p>
<h3>Antes de importar, prueba la lógica del mapa</h3>
<p>Usa un CSV con las columnas <code>Redirect from</code> y <code>Redirect to</code>. Este ejemplo sintético es pequeño a propósito.</p>
<pre><code class="language-csv">Redirect from,Redirect to
/producto-antiguo,/products/producto
/categoria-antigua,/categoria-intermedia
/categoria-intermedia,/collections/categoria
/bucle-a,/bucle-b
/bucle-b,/bucle-a
/sin-destino,
/producto-antiguo,/products/otro
</code></pre>
<p>Ejecutamos este ejemplo en el <a href="https://jsfiddle.net/migracionesio/e25Lwg9h/">validador de redirecciones en el navegador</a>. Da <strong>siete registros y cinco avisos</strong>. El origen repetido y el destino vacío producen un aviso cada uno. La cadena de la categoría produce otro. Cada entrada al bucle se marca por separado, porque desde cualquiera de esas dos rutas un visitante acabaría dentro del mismo ciclo.</p>
<p>Para resolverlo, decide qué ficha sustituye al producto antes de conservar una sola fila para ese origen. Apunta las categorías antiguas al destino final cuando sea la misma colección para el comprador. Si una ruta no tiene equivalente, aparta esa fila del lote hasta decidir qué hacer con ella. Revisa el mapa de nuevo antes de importar.</p>
<h3>Después de importar, verifica desde el origen</h3>
<p>Elige primero URLs que hayan recibido visitas o que sigan en campañas, newsletters o enlaces de otros sitios. Añade una muestra de productos, colecciones y rutas de cada mercado que vendas. Para cada una, registra la URL original, el destino esperado y el motivo de ese destino.</p>
<p>En una tienda de pruebas autorizada, usa un GET para ver la primera respuesta y luego sigue la cadena. En estos comandos, <code>tienda.example</code> es un dominio de ejemplo que debes sustituir.</p>
<pre><code class="language-bash">url='https://tienda.example/categoria-antigua'

# Primera respuesta, sin seguir la redirección.
curl -sS --max-time 15 -o /dev/null -D - "$url"

# Destino final y número de saltos.
curl -sS -L --max-redirs 8 --max-time 20 -o /dev/null \
  -w 'Estado final %{http_code}\nDestino %{url_effective}\nSaltos %{num_redirects}\n' \
  "$url"
</code></pre>
<p>Anota por separado un 200 sin redirección, un destino final incorrecto y una cadena de más de un salto. Si la URL de origen todavía corresponde a una página válida en Shopify, el mapa puede estar importado y la regla no aplicarse. Las rutas reservadas y las subcarpetas de los mercados también tienen condiciones propias. <a href="https://help.shopify.com/en/manual/online-store/menus-and-links/url-redirect">Documentación de redirecciones de Shopify</a></p>
<h3>Abre el destino como comprador</h3>
<p>Un 200 final es insuficiente si una ficha antigua de calzado lleva a una colección genérica, si la versión en francés acaba en español o si una variante enlazada en una campaña ya no se puede comprar. Abre el resultado en el mercado y dispositivo que importan. Revisa el contenido, la variante y el siguiente paso esperado. Si la intención era comprar, comprueba que el producto equivalente se puede añadir al carrito.</p>
<p>Para las páginas importantes, apunta también si la URL final presenta una canonical coherente con el destino que quieres conservar. Esto es una comprobación distinta de que funcione el 301. Guarda unas cuantas URLs representativas y repítelas después del cambio de dominio o de activar la tienda.</p>
<p>Este validador y la muestra sintética son de <a href="https://migraciones.io/pages/servicios-migracion-a-shopify-y-shopify-plus-experts">Migraciones.io</a>. El análisis del CSV se ejecuta en el navegador y sirve para revisar el mapa antes de importar. Los comandos y la comprobación del recorrido se aplican después, sobre una tienda que puedas probar.</p>
]]></content:encoded></item><item><title><![CDATA[Conciliar pedidos al migrar a Shopify: totales iguales, registros distintos]]></title><description><![CDATA[Prueba reproducible con Python: dos totales de 220,00 pueden ocultar pedidos ausentes, duplicados e importes distintos al migrar un ecommerce.]]></description><link>https://migracionesio.hashnode.dev/conciliar-pedidos-python-migrar-shopify</link><guid isPermaLink="true">https://migracionesio.hashnode.dev/conciliar-pedidos-python-migrar-shopify</guid><category><![CDATA[Python]]></category><dc:creator><![CDATA[Migraciones.io]]></dc:creator><pubDate>Thu, 05 Nov 2026 19:05:04 GMT</pubDate><content:encoded><![CDATA[<p>Una migración puede conservar el número de registros y la suma de sus importes y, aun así, perder un pedido. La diferencia no es académica: el equipo de atención al cliente necesita localizar una operación concreta, no solo comprobar que una cifra global coincide. Antes de dar por terminado un cambio de plataforma, conviene acordar qué se conciliará por referencia, qué diferencias se admitirán y quién resolverá las excepciones.</p>
<h2>Una demostración con cuatro registros</h2>
<p>Para ilustrar el problema hemos construido dos pequeños conjuntos sintéticos. No contienen datos de clientes, no pertenecen a una tienda y no son archivos preparados para importar en Shopify. Representan un formato normalizado con una referencia externa y un importe decimal, todos en una única moneda de ejemplo.</p>
<p>El origen contiene O-1001 por 100,00; O-1002 por 40,00; O-1003 por 60,00 y O-1004 por 20,00. El destino contiene O-1001 por 100,00; O-1002 por 40,00; O-1003 por 50,00 y una segunda fila O-1002 por 30,00.</p>
<table>
<thead>
<tr>
<th>Referencia</th>
<th align="right">Origen: importe de ejemplo</th>
<th align="right">Destino: importe de ejemplo</th>
</tr>
</thead>
<tbody><tr>
<td>O-1001</td>
<td align="right">100,00</td>
<td align="right">100,00</td>
</tr>
<tr>
<td>O-1002</td>
<td align="right">40,00</td>
<td align="right">40,00 y otra fila de 30,00</td>
</tr>
<tr>
<td>O-1003</td>
<td align="right">60,00</td>
<td align="right">50,00</td>
</tr>
<tr>
<td>O-1004</td>
<td align="right">20,00</td>
<td align="right">Ausente</td>
</tr>
</tbody></table>
<p>En ambos lados hay cuatro filas y el total es 220,00. Sin embargo, el destino no contiene O-1004, duplica la referencia O-1002 y presenta un importe diferente para O-1003. El agregado oculta las tres discrepancias.</p>
<p>Hemos ejecutado la comparación localmente con Python y aritmética Decimal. La revisión identifica la referencia ausente, la referencia duplicada y la diferencia del único pedido comparable cuyo importe cambia: O-1003, de 60,00 a 50,00. Una segunda ejecución con el conjunto corregido no devuelve esas discrepancias. El ejercicio prueba una condición de la conciliación; no mide la frecuencia de errores en migraciones reales ni permite estimar pérdidas económicas.</p>
<h2>La referencia que debe sobrevivir al cambio</h2>
<p>El identificador interno de un pedido puede cambiar al pasar de una plataforma a otra. Por eso el proyecto necesita decidir cómo conservar o mapear la referencia de origen. Esa decisión permite que una persona busque un pedido antiguo y que una comprobación automatizada relacione ambos lados sin depender de la posición de una fila en una hoja de cálculo.</p>
<p>Antes de comparar importes hay que delimitar la población: mismo periodo de corte, misma moneda, mismos estados incluidos y misma definición del campo. No tiene sentido confrontar un total con envío incluido con otro que solo contiene productos, ni interpretar una devolución como un error de copia porque se compararon conceptos diferentes. Las exclusiones deliberadas también deben quedar registradas.</p>
<p>El ejemplo considera que cada fila representa un pedido ya normalizado. Un archivo real puede incluir varias líneas por pedido. En ese caso, una referencia repetida no demuestra por sí sola que se haya duplicado un pedido: primero hay que interpretar la estructura de la exportación y construir la unidad de comparación correcta. Saltarse esa preparación generaría falsas alarmas.</p>
<h2>El método de traslado también condiciona la prueba</h2>
<p>Shopify distingue los mecanismos de migración según el tipo de dato. Su documentación no presenta el CSV nativo como una vía universal para importar cualquier contenido: los pedidos históricos requieren aplicaciones de migración o APIs. La guía también recomienda respetar el orden entre productos, clientes y pedidos históricos para mantener sus relaciones.</p>
<p>Eso obliga a revisar algo más que la presencia de una referencia. El resultado debe conservar las relaciones necesarias para el uso previsto del historial. Una operación que aparece en el destino pero no puede relacionarse correctamente con el cliente o con los elementos que necesita el negocio todavía requiere revisión.</p>
<p>Tampoco conviene confundir una exportación de pedidos con un informe de pagos. La documentación de exportación de Shopify señala que el historial de transacciones exportado contiene pagos capturados y no incluye autorizaciones. Cada comprobación necesita, por tanto, una fuente y una definición explícitas.</p>
<h2>Convertir las excepciones en una condición de aceptación</h2>
<p>Una entrega revisable puede incluir cuatro evidencias: las poblaciones de origen y destino utilizadas, el mapa de referencias, el listado de discrepancias y la decisión sobre cada excepción. No basta con una captura del importador indicando que el proceso terminó. La pregunta operativa es qué registros se han verificado y qué queda pendiente.</p>
<p>El trabajo tampoco termina al cuadrar el historial. Conviene reservar una prueba independiente para los pedidos nuevos y sus estados. Shopify incluye entre sus comprobaciones de puesta en marcha las transacciones satisfactorias y fallidas, las devoluciones y la gestión posterior del pedido. El alcance concreto dependerá de la tienda y del entorno de pruebas disponible.</p>
<p>Al presupuestar una migración, esta conciliación debe tener un responsable, un momento y un criterio de aceptación. La automatización puede comparar registros y separar excepciones; el negocio debe decidir cómo resolver las diferencias que representan cambios deliberados o información que no tiene una correspondencia directa. Cuadrar una suma es una comprobación útil, pero no sustituye ese proceso.</p>
<p>Autoría y transparencia: Equipo Migraciones.io, agencia especializada en Shopify en España. Este artículo se ha preparado con asistencia de IA y una demostración sintética ejecutada localmente. No incluye resultados de clientes. Afiliación: <a href="https://migraciones.io/pages/servicios-migracion-a-shopify-y-shopify-plus-experts">Migraciones.io</a>. Contacto público: <a href="mailto:info@migraciones.io">info@migraciones.io</a>.</p>
<p><strong>Fuentes oficiales y alcance:</strong></p>
<ul>
<li>Shopify, opciones y orden de migración: <a href="https://help.shopify.com/en/manual/migrating-to-shopify">https://help.shopify.com/en/manual/migrating-to-shopify</a></li>
<li>Shopify, estructura y alcance de la exportación de pedidos: <a href="https://help.shopify.com/en/manual/fulfillment/managing-orders/exporting-orders">https://help.shopify.com/en/manual/fulfillment/managing-orders/exporting-orders</a></li>
<li>Shopify, usos de archivos CSV y pedidos solo para exportación: <a href="https://help.shopify.com/en/manual/shopify-admin/productivity-tools/csv-files">https://help.shopify.com/en/manual/shopify-admin/productivity-tools/csv-files</a></li>
</ul>
<p>La demostración de cuatro registros y sus conclusiones son elaboración propia; las fuentes de Shopify no validan ni avalan el ejercicio.</p>
<h2>Código de la demostración</h2>
<p>Los registros siguientes están normalizados a una fila por pedido. No se deben aplicar directamente a una exportación con varias líneas por pedido sin adaptar antes su estructura. La comparación utiliza la biblioteca estándar de Python y no hace peticiones de red.</p>
<pre><code class="language-python">from decimal import Decimal
from collections import Counter
import json
source=[{'reference':'O-1001','amount':'100.00'},{'reference':'O-1002','amount':'40.00'},{'reference':'O-1003','amount':'60.00'},{'reference':'O-1004','amount':'20.00'}]
target=[{'reference':'O-1001','amount':'100.00'},{'reference':'O-1002','amount':'40.00'},{'reference':'O-1003','amount':'50.00'},{'reference':'O-1002','amount':'30.00'}]
def compare(src,dst):
 s=Counter(x['reference'] for x in src);t=Counter(x['reference'] for x in dst)
 missing=sorted(set(s)-set(t));duplicates=sorted(k for k,v in t.items() if v&gt;1)
 amount_mismatches=[]
 for k in sorted(set(s)&amp;set(t)):
  if s[k]==t[k]==1:
   a=next(x['amount'] for x in src if x['reference']==k);b=next(x['amount'] for x in dst if x['reference']==k)
   if Decimal(a)!=Decimal(b):amount_mismatches.append({'reference':k,'source':a,'target':b})
 return {'source_rows':len(src),'target_rows':len(dst),'source_total':str(sum((Decimal(x['amount']) for x in src),Decimal('0.00'))),'target_total':str(sum((Decimal(x['amount']) for x in dst),Decimal('0.00'))),'missing':missing,'target_duplicates':duplicates,'amount_mismatches':amount_mismatches}
result=compare(source,target)
assert result['source_rows']==result['target_rows']==4
assert result['source_total']==result['target_total']=='220.00'
assert result['missing']==['O-1004']
assert result['target_duplicates']==['O-1002']
assert result['amount_mismatches']==[{'reference':'O-1003','source':'60.00','target':'50.00'}]
fixed=compare(source,source)
assert not fixed['missing'] and not fixed['target_duplicates'] and not fixed['amount_mismatches']
print(json.dumps(result, indent=2))
</code></pre>
]]></content:encoded></item><item><title><![CDATA[Revisión de catálogo con Python antes de migrar a Shopify]]></title><description><![CDATA[Detecta SKU repetidos, combinaciones duplicadas e imágenes pendientes con un script Python local y ejemplos reproducibles para revisar tu catálogo.]]></description><link>https://migracionesio.hashnode.dev/revision-catalogo-python-migrar-shopify</link><guid isPermaLink="true">https://migracionesio.hashnode.dev/revision-catalogo-python-migrar-shopify</guid><category><![CDATA[Python]]></category><dc:creator><![CDATA[Migraciones.io]]></dc:creator><pubDate>Thu, 05 Nov 2026 17:07:41 GMT</pubDate><content:encoded><![CDATA[<p>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.</p>
<p>Esta guía propone una comprobación pequeña, reproducible y local con Python. <strong>La tabla del ejemplo es un formato de revisión propio: no es un CSV listo para importar en Shopify.</strong> 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.</p>
<h2>1. Acordar qué se quiere revisar</h2>
<p>El primer paso consiste en separar tres conceptos:</p>
<ul>
<li><strong>Producto:</strong> la ficha comercial que agrupa versiones de un mismo artículo.</li>
<li><strong>Variante:</strong> una combinación concreta de opciones, como talla y color.</li>
<li><strong>SKU:</strong> una referencia de negocio que puede intervenir en el almacén, un ERP o una integración.</li>
</ul>
<p>En el ejemplo agrupamos las filas con <code>product_key</code> y describimos la variante con <code>size</code> y <code>color</code>. Son nombres elegidos para la tabla intermedia, no nombres de campos de la API.</p>
<p>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.</p>
<h2>2. Trabajar sobre una copia intermedia</h2>
<p>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.</p>
<p>La muestra contiene cuatro filas:</p>
<pre><code class="language-csv">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,
</code></pre>
<p>Hay tres situaciones que revisar: dos variantes comparten <code>CAM-01</code>, la combinación camiseta/M/Azul aparece dos veces y la gorra no tiene ninguna referencia de imagen.</p>
<p>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.</p>
<h2>3. Ejecutar una comprobación que solo lea</h2>
<p>Guarda el siguiente código como <code>catalogo-audit.py</code>. 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.</p>
<pre><code class="language-python">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))
</code></pre>
<p>Para probarlo, guarda la muestra como <code>catalogo-ejemplo.csv</code> y ejecuta:</p>
<pre><code class="language-bash">python3 catalogo-audit.py catalogo-ejemplo.csv
</code></pre>
<p>No se conecta a Shopify, no descarga las imágenes, no necesita credenciales y no modifica el archivo de entrada.</p>
<h2>4. Interpretar el resultado antes de corregir</h2>
<p>La muestra devuelve <strong>cuatro filas y tres avisos</strong>. No son tres instrucciones automáticas de borrado.</p>
<table>
<thead>
<tr>
<th>Aviso</th>
<th>Comprobación humana</th>
</tr>
</thead>
<tbody><tr>
<td>SKU repetido</td>
<td>Contrastar la referencia con el almacén o ERP. Decidir si debe ser única en esta operación.</td>
</tr>
<tr>
<td>Combinación repetida</td>
<td>Revisar si sobra una fila o si una opción de la variante se ha perdido en la exportación.</td>
</tr>
<tr>
<td>Sin referencia de imagen</td>
<td>Buscar el material del producto y confirmar qué archivos se deben trasladar.</td>
</tr>
</tbody></table>
<p>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.</p>
<p>La comparación distingue mayúsculas, minúsculas y acentos, aunque retira espacios externos de las claves. Por ejemplo, <code>Azul</code> y <code>azul</code> 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.</p>
<h2>5. Repetir con una muestra corregida</h2>
<p>Para comprobar el comportamiento, hicimos tres cambios sintéticos: asignamos <code>CAM-03</code> a la talla L, cambiamos la tercera camiseta a talla S y añadimos una referencia de imagen a la gorra.</p>
<pre><code class="language-csv">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
</code></pre>
<p>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.</p>
<p><strong>Cero avisos solo significa que estas comprobaciones no han encontrado incidencias.</strong> No certifica el catálogo ni demuestra que una importación vaya a funcionar.</p>
<h2>6. Lo que queda fuera de esta herramienta</h2>
<p>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.</p>
<p>Para preparar el archivo de carga, usa la plantilla vigente y la <a href="https://help.shopify.com/es/manual/products/import-export/using-csv">documentación oficial del CSV de productos de Shopify</a>. No renombres sin más las columnas de este ejemplo y lo subas a producción.</p>
<p>La organización de productos y opciones debe contrastarse con la <a href="https://help.shopify.com/es/manual/products/variants">documentación de variantes</a>. 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.</p>
<h2>Una revisión trazable</h2>
<p>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.</p>
<p>Guía del equipo de <a href="https://migraciones.io/">Migraciones.io</a>, agencia de diseño, desarrollo y migraciones a Shopify. Contacto público: <a href="mailto:info@migraciones.io">info@migraciones.io</a>.</p>
<p><em>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.</em></p>
]]></content:encoded></item></channel></rss>