Skip to main content

Conciliar pedidos al migrar a Shopify: totales iguales, registros distintos

Updated 6 min readMarkdown

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.

Una demostración con cuatro registros

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.

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.

Referencia Origen: importe de ejemplo Destino: importe de ejemplo
O-1001 100,00 100,00
O-1002 40,00 40,00 y otra fila de 30,00
O-1003 60,00 50,00
O-1004 20,00 Ausente

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.

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.

La referencia que debe sobrevivir al cambio

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.

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.

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.

El método de traslado también condiciona la prueba

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.

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.

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.

Convertir las excepciones en una condición de aceptación

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.

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.

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.

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: Migraciones.io. Contacto público: info@migraciones.io.

Fuentes oficiales y alcance:

La demostración de cuatro registros y sus conclusiones son elaboración propia; las fuentes de Shopify no validan ni avalan el ejercicio.

Código de la demostración

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.

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>1)
 amount_mismatches=[]
 for k in sorted(set(s)&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))

1 view

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.