Este artículo ofrece una guía completa para importar pedidos de forma eficiente mediante un archivo CSV. Agiliza la gestión de pedidos importándolos de forma masiva y evita tener que introducirlos manualmente.

Preparar tu archivo CSV para importarlo

Antes de iniciar el proceso de importación, asegúrate de que tu archivo CSV tenga la estructura correcta. Descarga la plantilla CSV para garantizar un formato de datos preciso. Cada fila del archivo CSV debe representar una única línea de artículo, permitiendo que los pedidos abarquen varias filas. Utiliza la columna "orderReferenceId" para vincular las líneas de artículo con sus pedidos correspondientes.

Nota: si, al abrir un CSV en Excel, los encabezados de columna aparecen en una sola columna, prueba estas alternativas:

Usa Google Sheets: abre archivos CSV correctamente con columnas separadas.
Ajuste manual en Excel: Convierte el archivo al formato correcto colocando cada encabezado en una columna separada.

En cada fila, incluye los datos esenciales del pedido:

ID de referencia del pedido
Detalles de envío
Detalles del artículo
URLs para cada área de impresión

Para obtener una explicación detallada de los campos obligatorios en el archivo CSV, consulta la página "Create order" en nuestra documentación de la API. Este recurso completo ofrece información útil para estructurar tus datos de importación de forma eficaz: Create order.

Importar pedidos: guía paso a paso

Sigue estos pasos para importar tus pedidos sin complicaciones:

Accede a tu página de pedidos y haz clic en el botón "Importar".
Elige la tienda designada para tus pedidos importados. Estos pedidos aparecerán como realizados desde la tienda seleccionada. También tienes la flexibilidad de importarlos como pedidos manuales.
Sube el archivo CSV que contiene los pedidos que quieres importar. También puedes descargar una plantilla CSV nueva desde esta página.
Comprueba dos veces que has seleccionado la tienda de destino correcta y el archivo de importación adecuado. Cuando esté todo listo, haz clic en "Import" para iniciar el proceso de importación.
Recibirás una notificación que confirme el inicio del proceso de importación.
Cuando termine el proceso de importación, te enviaremos una notificación por correo electrónico. Ese correo incluirá un resumen de la importación, que contiene:
- El número total de pedidos en el archivo de importación.
- El número de pedidos importados correctamente.
- El número de pedidos que no se pudieron importar.

Además, el correo incluirá un archivo CSV con los resultados detallados de la importación. Este archivo tendrá tres columnas:

orderReferenceId
resultado (indica «éxito» o «fallo» para cada pedido)
errores (proporcionando motivos específicos de cualquier fallo de importación)

Entender los parámetros obligatorios del archivo CSV para importar

A continuación encontrarás un desglose detallado de los parámetros necesarios y sus referencias de documentación correspondientes para ayudarte a completar la hoja de cálculo con precisión.

Este método lo usan sobre todo quienes prueban la plataforma antes de integrarse 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 del ID de cliente.
orderType: se puede configurar como draft, pero de forma predeterminada es order.
shipmentMethodUid – Especifica el método de envío: normal, standard o express.
currency – Moneda utilizada para el pago.
retailShippingPriceInclVat, retailCurrency, item.retailPriceInclVat – Se utiliza en análisis y en varias áreas de la plataforma, incluidos los formularios de aduanas.

Detalles de la dirección de envío

Estos parámetros corresponden a los campos estándar de dirección del proceso de pago:

shippingAddress.firstName
shippingAddress.lastName
shippingAddress.addressLine1
shippingAddress.addressLine2
shippingAddress.city
shippingAddress.postCode
shippingAddress.state
shippingAddress.country
shippingAddress.email
shippingAddress.phone
shippingAddress.companyName

Detalles fiscales y de cumplimiento

shippingAddress.federalTaxId – El número de identificación fiscal federal del destinatario. Se utiliza para proporcionar el CPF/CNPJ de un destinatario en Brasil. Obligatorio para Brasil. Para proporcionar CNPJ en lugar de CPF, establece isBusiness en true.
shippingAddress.stateTaxId – El número de identificación fiscal estatal del destinatario. Se utiliza para proporcionar IE para un destinatario de Brasil. Obligatorio en Brasil si el destinatario es una empresa. Para completar este campo, establece isBusiness en true.
shippingAddress.registrationState – El código numérico de un estado de EE. UU. o el equivalente para otros países, que define el estado donde está registrada la empresa destinataria. Obligatorio en Brasil si el destinatario es una empresa. Para proporcionar este campo, establece isBusiness en true.

Información del producto

item.itemReferenceId – Corresponde a Item Reference ID en el pedido. Para pedidos de Comercio electrónico, se asigna automáticamente. Para pedidos manuales, debe definirse.
item.productUid – Sigue nuestra guía sobre UIDs de productos y cómo mapear productos según los estándares de Gelato.
item.storeProductVariantId – Indica el ID de la variante desde la URL de la tienda, p. ej., https://dashboard.gelato.com/stores/e92a3ee9-e494-41bf-a031-ca80e2fa3558/products/edit/04076663-f5a3-4701-af66-be932c676697.
item.quantity – Especifica el número de unidades pedidas.
item.pageCount – Obligatorio para productos de varias páginas (p. ej., folletos).

Parámetros específicos de bordado

Para los diseños de bordado, se requieren parámetros adicionales. Consulta la Guía de bordado para ver todos los detalles.

item.adjustProductUidByFileTypes
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 requiere una gestión continua de hojas de cálculo y la preparación de archivos listos para imprenta, te recomendamos aprovechar opciones de Procesamiento más ágiles a través de la integración por API. Este enfoque optimiza la eficiencia y reduce el trabajo manual. Para más detalles, consulta nuestra Documentación de la API de Gelato.

¿Cómo importar pedidos mediante un archivo CSV?