Este artículo es una guía completa para importar pedidos de forma eficiente usando un archivo CSV. Simplifica la gestión de tus pedidos importándolos en bloque y olvídate de introducirlos uno a uno.
Preparar tu archivo CSV para importar
Antes de empezar el proceso de importación, asegúrate de que tu archivo CSV esté bien estructurado. Descarga la plantilla CSV para garantizar que el formato de los datos sea correcto. Cada fila del archivo CSV debe representar una línea de pedido, lo que permite que los pedidos ocupen varias filas. Usa la columna "orderReferenceId" para vincular las líneas de pedido con sus pedidos correspondientes.
Nota: Si al abrir un archivo CSV en Excel los encabezados de columna aparecen todos en una sola columna, prueba estas soluciones:
Usa Google Sheets: Abre archivos CSV y muestra las columnas separadas correctamente.
Ajusta manualmente en Excel: Convierte el archivo al formato correcto colocando cada encabezado en una columna diferente.
En cada fila, añade los detalles esenciales del pedido:
ID de referencia del pedido
Detalles de envío
Detalles del artículo
Enlaces para cada área de impresión
Para una explicación detallada de los campos obligatorios en el archivo CSV, consulta la página "Enviar pedido" en nuestra documentación de la API.
Importar pedidos: guía paso a paso
Sigue estos pasos para importar tus pedidos sin complicaciones:
Inicia sesión en Gelato Connect
Añade una tienda manualmente.
Accede a la página de pedidos en GelatoConnect Storefronts y haz clic en el botón "Importar".
Elige la tienda que prefieras para tus pedidos importados. Estos pedidos aparecerán como realizados desde la tienda seleccionada. También tienes la flexibilidad de importarlos como pedidos manuales si lo prefieres.
Sube el archivo CSV con los pedidos que quieres importar. También puedes descargar una plantilla CSV nueva desde esta página.
Asegúrate de haber elegido la tienda de destino correcta y el archivo de importación adecuado. Cuando todo esté listo, haz clic en "Importar" para empezar el proceso de importación.
Recibirás una notificación que confirma que el proceso de importación ha comenzado.
Cuando termine el proceso de importación, te enviaremos un correo electrónico. En ese correo encontrarás un resumen de la importación, que incluye:
El número total de pedidos en el archivo de importación.
El número de pedidos que se han importado correctamente.
El número de pedidos que no se pudieron importar.
Además, el correo electrónico incluirá un archivo CSV con los resultados detallados de la importación. Este archivo tendrá tres columnas:
ID de referencia de pedido
resultado (indica si cada pedido ha sido un "éxito" o un "fracaso")
errores (explicando de forma clara los motivos concretos de cualquier fallo en la importación)
Entender los parámetros necesarios para importar un archivo CSV
A continuación, encontrarás un desglose detallado de los parámetros necesarios y sus referencias de documentación para que puedas completar la hoja de cálculo con precisión.
Este método lo suelen usar quienes quieren probar la plataforma antes de integrarla con nuestras API o de enviar pedidos puntuales.
Información general del pedido
orderReferenceId – Muestra el número de pedido en el Panel de Gelato. Ejemplo:
G-250202201217.customerReferenceId – Referencia interna de ID de cliente.
orderType – Puedes configurarlo como
draft, pero por defecto esorder.shipmentMethodUid – Especifica el método de envío:
normal,estándaroexprés.Moneda – Moneda que se utiliza para el pago.
retailShippingPriceInclVat, retailCurrency, item.retailPriceInclVat – Se utiliza en análisis y en diferentes áreas de la plataforma, incluidos los formularios de aduanas.
Detalles de la dirección de envío
Estos parámetros corresponden a los campos habituales de una dirección:
shippingAddress.firstName
shippingAddress.apellido
Dirección de envío. Calle y número
Dirección de envío. Línea 2
shippingAddress.city
shippingAddress.postCode
shippingAddress.state
shippingAddress.país
shippingAddress.email
Teléfono de la dirección de envío
shippingAddress.companyName
Información del producto
item.itemReferenceId – Corresponde al
Item Reference IDen el pedido. Para los pedidos de plataformas de Comercio electrónico, se asigna automáticamente. En los pedidos manuales, debe definirse.item.productUid
item.storeProductVariantId
item.quantity – Indica cuántas unidades se han pedido.
item.pageCount – Obligatorio para productos con varias páginas (por ejemplo, folletos).
Parámetros específicos de bordado
Para los diseños de bordado, se necesitan algunos parámetros adicionales.
item.ajustaUidDelProductoPorTiposDeArchivo
item.file1.id, item.file1.type, item.file1.url, item.file1.threadColors, item.file1.fitMethod, item.file1.fillMethod
item.file2.id, item.file2.type, item.file2.url, item.file2.threadColors, item.file2.fitMethod, item.file2.fillMethod
Como el envío de pedidos mediante CSV implica gestionar hojas de cálculo constantemente y preparar archivos listos para imprimir, te recomendamos aprovechar opciones de procesamiento más ágiles a través de la integración por API. Así, optimizas la eficiencia y reduces el trabajo manual.