Cómo funciona
El importador de pedidos de Shopify lee un CSV estándar de pedidos de Shopify, empareja al cliente de cada pedido por email, empareja cada línea con un archivo o pack asignado primero por SKU y luego por título de producto, y crea filas de Customer y Purchase en Alva por cada coincidencia válida. No envía emails, no encola comprobaciones antifraude y no asigna claves de licencia — esos efectos secundarios se reservan para los pedidos en directo que llegan por el webhook habitual de Shopify.
Antes de empezar
Asigna a un archivo o pack de Alva todos los productos de Shopify que alguna vez hayan vendido un archivo digital antes de ejecutar la importación. Los productos sin asignar se omiten fila a fila y aparecen en un resumen, pero el enfoque más limpio es asignar primero e importar una sola vez.
- Archivos asignados a productos. Abre Archivos en Alva y confirma que cada producto digital tiene al menos un archivo o pack adjunto. Las asignaciones por variante también funcionan.
- Decide el rango de fechas. Opciones habituales: los últimos 90 días para una tienda activa, o desde el principio para una migración desde otra app de entrega.
- Ten un CSV de prueba pequeño listo. Exporta primero una sola semana reciente para validar la asignación, y luego vuelve a exportar el rango completo cuando la prueba en seco se vea bien.
Exporta el CSV de pedidos desde el admin de Shopify
Shopify expone la exportación de pedidos en Pedidos → Exportar. El importador espera los nombres de columna estándar del CSV — no renombres columnas ni edites el archivo a mano.
- Abre el admin de Shopify → Pedidos. Usa los filtros para acotar el rango de fechas que quieras rellenar.
- Haz clic en Exportar. Elige Archivo CSV plano (no Para Excel, Numbers u otras hojas de cálculo) y selecciona Pedidos, transacciones y reembolsos.
- Elige el alcance correcto. «Página actual», «Pedidos seleccionados», «Todos los pedidos» o «Pedidos que coinciden con tu búsqueda» funcionan. El importador solo actúa sobre filas cuyo estado financiero es
paid. - Descarga el email que envía Shopify. Para exportaciones grandes, Shopify envía el enlace del CSV al email del propietario de la tienda. Guárdalo localmente — no lo descomprimas y vuelvas a comprimir.
Ejecuta el importador
El importador vive en Pedidos → Importar pedidos históricos en la barra lateral del admin de Alva. Trocea CSVs grandes automáticamente — no hay un límite de filas que te tenga que preocupar.
- Abre Pedidos en Alva y haz clic en la acción secundaria Importar pedidos históricos en la cabecera de la página.
- Suelta el CSV en la zona de subida. Alva valida los encabezados de columna al instante y rechaza el archivo si falta cualquier columna obligatoria.
- Espera la vista previa. Alva resuelve clientes por email, empareja productos por SKU y luego por título, y muestra los recuentos: pedidos totales, pedidos válidos, omitidos (cancelados / no pagados / sin email), clientes encontrados frente a no encontrados, productos emparejados frente a no asignados, y pedidos ya importados en una ejecución previa.
- Revisa los productos no asignados. Si la vista previa saca a la luz títulos de producto sin asignar, cancela la importación, asígnalos en Archivos → Productos y vuelve a subir el mismo CSV. Los pedidos ya importados se omitirán automáticamente.
- Confirma e inicia. Haz clic en Iniciar importación. El progreso se va mostrando en la interfaz a medida que se completa cada lote. Cerrar la pestaña del navegador no aborta la importación — sigue hasta el final en el servidor y puedes reabrir la página para ver el resultado.
Pantalla de vista previa del importador de pedidos de Shopify de Alva con la tarjeta de resumen de resolución mostrando los recuentos de válidos / omitidos / no asignados y el botón Iniciar importación. Sin datos reales de clientes visibles.
Lo que el importador hace (y omite)
El importador es deliberadamente mínimo. Escribe el conjunto más pequeño de filas necesario para que un cliente se reenvíe sus propios enlaces de descarga, y omite cualquier efecto secundario que sorprendería a un cliente que vuelve.
Efectos secundarios del importador de pedidos de Shopify comparados con un webhook ORDERS_PAID en directo.
| Efecto secundario | Pedido en directo (webhook) | Pedido importado |
|---|---|---|
| Filas de Customer + Purchase creadas | Sí | Sí |
| Acceso de descarga habilitado | Sí | Sí |
| Email de entrega enviado | Sí (si está activado) | No — nunca |
| Comprobación antifraude encolada | Sí (si está activada) | No — nunca |
| Claves de licencia asignadas automáticamente | Sí (si están asignadas) | No — nunca |
| Disparadores de POS / Flow ejecutados | Sí | No — nunca |
Por debajo, cada fila de Purchase importada se crea con fraudCheckEnabled: false, fraudCheckPassed: false y accessEnabled: true. Eso es lo que hace que la página de cuenta de cliente muestre el archivo al instante sin disparar nunca un email de descarga ni una asignación de clave de licencia.
Limitaciones honestas
- Los clientes ya tienen que existir en Shopify. El importador empareja por email contra tu lista de clientes de Shopify. Las compras de invitado que nunca crearon una ficha de cliente no se pueden emparejar, y esas filas aparecen en el resumen de omitidos.
- Los clientes con email cambiado se omiten. El CSV contiene el email capturado en el pedido original. Si un cliente ha cambiado desde entonces su email de Shopify, la búsqueda falla y el pedido aparece como sin emparejar.
- Los productos personalizados no se importan. Los archivos hechos a medida pertenecen a una Purchase concreta a través de la tabla de archivos por compra y hay que subirlos a mano. El importador solo restaura el acceso a los archivos estándar asignados a productos.
- Los contadores de descarga arrancan en cero. Las filas de Purchase importadas no tienen historial de descargas. Si antes aplicabas un límite de descargas por compra, los clientes recuperan un cupo nuevo tras la importación.
- No hay notificación automática. El importador nunca avisa a los clientes de que su acceso está restaurado. Anúncialo con un email de marketing fuera de Alva, o espera solicitudes de reenvío individuales.
Una importación de pedidos históricos que enviase un email a cada cliente pasado dispararía, en una tienda con 50.000 pedidos, 50.000 emails de entrega en el momento que pulses Iniciar — un señalamiento garantizado como spam por los proveedores de bandeja de entrada. Alva trae el importador con los efectos secundarios de email, fraude y claves de licencia desactivados por código para que el camino seguro sea el único camino.
Preguntas frecuentes
¿El importador enviará un email a los clientes pasados al ejecutarlo?
No. El importador de pedidos de Shopify nunca envía emails. Los clientes pasados reciben enlaces de descarga nuevos solo cuando piden un reenvío o visitan la página de cuenta de cliente de Shopify.
¿El importador ejecuta una comprobación antifraude en los pedidos importados?
No. Las comprobaciones antifraude solo tienen sentido en pedidos frescos donde los datos de Shopify Risk están al día. Las filas de Purchase importadas se crean con fraudCheckEnabled en false y accessEnabled en true.
¿El importador asignará claves de licencia a los pedidos importados?
No. Las claves de licencia nunca se asignan durante una importación histórica. Si un pedido pasado necesita una clave después de importar, adjúntala manualmente desde la página de detalle del pedido en Alva.
¿Es seguro ejecutar la importación dos veces?
Sí. El importador es idempotente — al volver a ejecutarlo con el mismo CSV detecta los pedidos ya importados y los omite. El resumen indica cuántos pedidos y líneas se omitieron en la segunda pasada.
¿Qué pasa con los pedidos de productos que aún no he asignado?
El importador omite las líneas cuyo producto de Shopify no se puede emparejar con un archivo o pack en Alva. La vista previa lista cada título sin asignar con un recuento de pedidos para que los asignes y vuelvas a ejecutar.
¿Y los pedidos cancelados o no pagados del CSV?
Alva solo importa filas cuyo estado financiero de Shopify es paid y cuyo pedido no está cancelado. Los pedidos no pagados, cancelados y reembolsados se cuentan en el resumen de omitidos y no se importan.
Ver también
¿Te ha resultado útil?
Última actualización 2026-05-08