Este artigo fornece um guia abrangente sobre como importar pedidos de forma eficiente usando um arquivo CSV. Otimize seu gerenciamento de pedidos importando pedidos em massa, eliminando a necessidade de inserção manual.
Preparando seu arquivo CSV para importação
Antes de iniciar o processo de importação, certifique-se de que seu arquivo CSV esteja estruturado corretamente. Baixe o modelo CSV para garantir a formatação precisa dos dados. Cada linha no arquivo CSV deve representar um único item de linha, permitindo que os pedidos se estendam por várias linhas. Utilize a coluna \"orderReferenceId\" para vincular os itens de linha aos seus pedidos correspondentes.
Nota: Se os cabeçalhos das colunas aparecerem em uma única coluna ao abrir um CSV no Excel, experimente estas soluções alternativas:
Use o Google Sheets: Abre arquivos CSV corretamente com colunas separadas.
Ajuste Manualmente no Excel: Converta o arquivo para o formato correto colocando cada cabeçalho em uma coluna separada.
Para cada linha, inclua os detalhes essenciais do pedido:
ID de referência do pedido
Detalhes de Envio
Detalhes do item
URLs para cada área de impressão
Para uma explicação detalhada dos campos obrigatórios no arquivo CSV, consulte a página \"Enviar pedido\" em nossa documentação de API.
Importando pedidos: guia passo a passo
Siga estes passos para importar seus pedidos sem complicações:
Entrar no GelatoConnect
Adicione uma loja manual.
Acesse a página de pedidos no GelatoConnect Storefronts e clique no botão "Importar".
Escolha a loja designada para seus pedidos importados. Esses pedidos serão marcados como realizados a partir da loja selecionada. Você também tem a flexibilidade de importá-los como pedidos manuais.
Faça o upload do arquivo CSV contendo os pedidos que deseja importar. Você também pode baixar um modelo de CSV atualizado a partir desta página.
Verifique novamente se você selecionou a loja de destino correta e o arquivo de importação. Quando tudo estiver em ordem, clique em \"Importar\" para iniciar o processo de importação.
Você receberá uma notificação confirmando o início do processo de importação.
Assim que o processo de importação for concluído, enviaremos uma notificação por e-mail. Este e-mail fornecerá um resumo da importação, incluindo:
O número total de pedidos no arquivo de importação.
O número de pedidos importados com sucesso.
O número de pedidos que não foram importados com sucesso.
Além disso, o e-mail incluirá um arquivo CSV contendo resultados detalhados da importação. Este arquivo terá três colunas:
ID de referência do pedido
resultado (indicando "sucesso" ou "falha" para cada pedido)
erros (informando os motivos específicos para eventuais falhas na importação)
Entendendo os Parâmetros Necessários para Arquivo CSV para Importação
Abaixo, você encontrará uma análise detalhada dos parâmetros necessários e suas referências de documentação correspondentes para ajudá-lo a preencher a planilha com precisão.
Este método é usado principalmente por aqueles que estão testando a plataforma antes de integrar com nossas APIs ou enviar pedidos ad hoc.
Informações gerais do pedido
orderReferenceId – Exibe o número do pedido no Painel de controle da Gelato. Exemplo:
G-250202201217.customerReferenceId – Referência interna do ID do cliente.
orderType – Pode ser definido como
draft, mas o padrão éorder.shipmentMethodUid – Especifica o método de envio:
normal,standardouexpress.Moeda – Moeda utilizada para o pagamento.
retailShippingPriceInclVat, retailCurrency, item.retailPriceInclVat – Usado em Análise de Dados e em várias áreas da plataforma, incluindo formulários alfandegários.
Detalhes do endereço de entrega
Esses parâmetros correspondem aos campos padrão de endereço:
shippingAddress.firstName
shippingAddress.sobrenome
shippingAddress.addressLine1
shippingAddress.addressLine2
shippingAddress.cidade
shippingAddress.postCode
shippingAddress.state
shippingAddress.country
shippingAddress.email
shippingAddress.phone
shippingAddress.companyName
Informações do produto
item.itemReferenceId – Corresponde ao
Item Reference IDno pedido. Para pedidos de plataforma de e-commerce, isso é atribuído automaticamente. Para pedidos manuais, deve ser definido.item.productUid
item.storeProductVariantId
item.quantity – Especifica a quantidade de unidades solicitadas.
item.pageCount – Obrigatório para produtos com várias páginas (por exemplo, brochuras).
Parâmetros específicos para bordado
Para designs de bordado, são necessários parâmetros adicionais.
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 o envio de pedidos baseado em CSV exige gerenciamento contínuo de planilhas e preparação de arquivos prontos para impressão, recomendamos aproveitar opções de Atendimento de Pedidos mais simplificadas por meio da integração com API. Essa abordagem otimiza a eficiência e reduz o esforço manual.