Resolución de problemas de la aplicación Transporter

La aplicación Transporter puede encontrar errores cuando procesa tus registros y los importa como objetos.

Cómo funciona el proceso de importación

Cuando estás solucionando problemas con la aplicación Transporter, puede ser útil entender cómo la aplicación carga e importa tus datos y los errores comunes que pueden ocurrir durante estos procesos, y por qué pueden ocurrir. El estado de tus importaciones puede encontrarse en tu panel de control de Shopify utilizando las aplicaciones > Transporter.

Al importar objetos en tu tienda Shopify, la aplicación Transporter realiza las siguientes acciones:

  1. Carga el archivo en una ubicación de almacenamiento segura, alojada en Shopify. Para leer más sobre cómo Shopify protege la información que cargas, consulta la Política de privacidad de Shopify.

  2. Verifica el archivo de errores estructurales y de formato de contenido. Si la aplicación Transporter encuentra algún error, tu importación fallará y su estado cambiará a Fallido.

  3. Importa los objetos. La cantidad de tiempo para la importación depende de la cantidad de objetos que se procesen (la tasa de procesamiento promedio es de 40 objetos/segundo). Cuando la importación termina, el estado aparece como Completado. Si hubo registros que la aplicación Transporter no pudo importar, aparecerá un enlace Exportar errores en la tabla.

Puedes detener la importación de otros objetos en todo momento haciendo clic en Detener importación. Los objetos que se importaron antes de que detuvieras la importación permanecerán en tu tienda Shopify. Cuando detienes una importación, su estado aparece como*Detenido*.

Exportar y corregir errores

Si tu importación tiene problemas, puedes hacer clic en Exportar errores para obtener más información sobre cómo corregirlos. Para obtener más información sobre estos códigos de error, consulta la lista de códigos de error comunes a continuación.

Tabla de la app Transporter que muestra el enlace Exportar errores

El proceso para corregir los errores es levemente diferente, según si el estado de tu importación es Fallido o Completado.

Fallido

Cuando el estado de una importación es Fallido, significa que hay un problema con el archivo CSV en sí, y no con el contenido del archivo. Después de que hayas revisado el archivo de texto de errores, corrige los errores en tu archivo original y luego intenta subirlo nuevamente.

Completado

Si una importación Completada tiene errores, significa que hay errores en los registros individuales, en lugar de problemas con la estructura de tu archivo CSV. En este caso, solo se crean registros sin errores en Shopify. Los registros que tienen errores no se crean, sino que se agregan a un archivo CSV de errores de exportación. No verás el archivo de errores de exportación CSV hasta después de que finalice la importación y el estado sea Completado. Cuando se completa la importación, aparece un enlace Exportar errores en la tabla.

La última columna en cada fila del archivo CSV de errores describe el error del registro. Después de que hayas descargado el archivo, corrige los errores en este archivo y luego súbelo. No necesitas eliminar la columna de error antes de cargar este archivo.

En el siguiente ejemplo, no se pudieron importar tres clientes porque ya existían en la tienda.

First Name,Last Name,Email,Error(s)
 Jane,Doe,jane.doe01520022060@example.com,...,Email has already been taken
 Jane,Doe,jane.doe11520022060@example.com,...,Email has already been taken
 Jane,Doe,jane.doe21520022060@example.com,...,Email has already been taken

Los clientes de Shopify se identifican por sus direcciones de correo electrónico únicas, por ende no se pudieron importar estos clientes porque ya había registros para sus direcciones de correo electrónico en Shopify.

Códigos de errores frecuentes

Los errores frecuentes de archivo incluyen:

  • Se encontró un error en la API de Shopify; no se pudo guardar

    Este error puede aparecer por diferentes razones. La causa más común de este error es un solo meta campo que aparece más de una vez para un registro. La aplicación Transporter no admite registros con meta campos duplicados. Si eliminar meta campos duplicados no resuelve el problema, ponte en contacto con el equipo de servicio técnico de Shopify.

  • Fallida. Código de respuesta = 400. Mensaje de respuesta = Solicitud incorrecta

    La aplicación Transporter no puede crear el objeto en Shopify porque hay errores en los datos. A menudo, esto ocurre porque los datos se formatearon de forma incorrecta. Asegúrate de que tus datos cumplan con estos requisitos:

    • Los valores de moneda deben especificarse en formato ISO 4217 (por ejemplo: USD)
    • Los códigos de país, provincia/estado y los códigos zonas/postales deben ser válidos
    • Los números de teléfono deben ser formatos válidos, códigos de país y códigos de área.
    • Las direcciones de correo electrónico deben tener dominios válidos.
    • Uno de los valores permitidos debe ser Financial status (Estado financiero).
    • Uno de los valores permitidos debe ser Fulfillment Status (Estado de preparación del pedido).
    • Los valores booleanos deben especificarse como true o false.
    • Cualquier columna que requiera un número entero (como, Cantidad de inventario de variante de producto en el CSV de producto o Lineitem Quantity en el CSV de pedido) no se importará si introduces un valor decimal. Por ejemplo, introduce 5 en lugar de 5,0. Algunos programas de hoja de cálculo (como Numbers) pueden mostrar valores decimales o de coma flotante como números enteros. Comprueba tus valores en un editor de texto.
    • Cualquier columna que requiera un número entero (como Peso total o Identificación de la sucursal de la transacción en el CSV de pedido), no se importará si introduces valores no numéricos (como letras).
  • El tipo de valor no está incluido en la lista

    Verifica los valores en las columnas del metacampo. Para importar los meta campos, debes incluir valores en las siguientes columnas: Metafield Namespace, Metafield Key, Metafield Value y Metafield Value Type. Este error ocurre a menudo porque hay un valor vacío o no válido en una o más de estas columnas.

  • Column-name no es válido

    Este error puede aparecer por diferentes razones. Por ejemplo, este error puede ocurrir porque una columna distingue entre mayúsculas y minúsculas. Para las columnas que aceptan una lista de valores, debes seguir el caso que se utiliza en las descripciones de las columnas. Por ejemplo, en el CSV de pedidos, los valores en la columna Financial Status (Estado financiero) distinguen entre mayúsculas y minúsculas. Esto significa que si colocaste Paid (Pagado) en lugar de paid (pagado), aparecerá el error Financial Status is invalid (Estado financiero inválido). Revisa el resto de tus columnas para asegurarte de que los valores introducidos siguen el formato correcto.

  • Estado del pedido inválido: No se puede preparar y cancelar a la vez

    Shopify no puede crear pedidos que se hayan preparado y cancelado a la vez. Este error ocurrirá si las siguientes condiciones son ambas ciertas:

    • El pedido tiene configurada una marca de tiempo cancelled_at.
    • El pedido tiene el fulfillment_status configurado como fulfilled (preparado) o partial (parcial).

    Un pedido con una marca de tiempo cancelled_at y un fulfillment_status establecido como fulfilled o partial puede crearse con éxito si el financial_status se establece como refunded (reembolsado).

Si encuentras un código de error que no figura aquí, comunícate con el equipo de servicio técnico de Shopify.

Enlaces relacionados

¿Estas listo(a) para comenzar a vender con Shopify?

Pruébala gratis