Tutorial

Adicionar Itens de Linha em Massa aos Pedidos

November 29, 2025

Adicionar novos itens de linha a muitos pedidos existentes manualmente pode consumir muito tempo. DataEase facilita: exporte pedidos, prepare linhas de itens com itemCommand=CREATE e importe-os de volta para o Shopify—tudo com validação.

🎯 Objetivo

Adicionar novos itens de linha a muitos pedidos existentes do Shopify de uma vez usando CSV/Excel e DataEase.

📋 Instruções Passo a Passo

1. Exportar Pedidos (Opcional, para IDs)

No DataEase, vá para Nova Exportação → Pedidos. Inclua pelo menos:

  • id (ID do pedido)
  • Se útil: name (número do pedido), campos do cliente e itens de linha atuais para referência

Aplique filtros (intervalo de datas, status financeiro/fulfillment) para direcionar apenas pedidos editáveis.

2. Prepare o Arquivo para Adicionar Itens

Abra o arquivo exportado no Excel ou Google Sheets. Para cada pedido que você está editando, crie uma ou mais linhas de itens:

  • Defina topRow = TRUE na linha principal do pedido (você pode deixar os campos do pedido inalterados ou definir command=UPDATE)
  • Adicione linhas com topRow = FALSE e itemCommand = CREATE para adicionar novos itens
  • Forneça um dos seguintes: variantId (preferido) ou variantSKU
  • Defina itemQuantity (inteiro)
  • (Opcional) itemPrice para substituir o preço na linha do pedido; caso contrário, o Shopify usa o preço do variant
  • (Opcional) itemProperties (por exemplo, key=value; color=red)
  • Mantenha os nomes das colunas exatamente como no seu modelo de exportação

Quando terminar, salve o arquivo como .xlsx ou .csv.

3. Importar e Validar

  1. No DataEase, inicie Nova Importação → Pedidos
  2. Carregue seu arquivo editado
  3. Mapeie as colunas (ID do Pedido, campos de itens de linha)
  4. Execute a Validação

Abra o relatório de validação e corrija quaisquer problemas (falta de variantId/SKU, quantidades inválidas, pedidos não editáveis).

4. Execute a Importação e Baixe os Resultados

Após a validação ser aprovada, clique em Executar Importação para adicionar os itens de linha ao Shopify.

Uma vez concluído, baixe o arquivo de resultados e verifique os pedidos editados no Shopify Admin: os novos itens de linha devem aparecer, totais/subtotais atualizados conforme necessário.

📝 Notas Importantes

  • Apenas pedidos editáveis: Pedidos cancelados/totalmente reembolsados/bloqueados não podem ser editados. Desarquive ou reverta o status antes de editar, se necessário
  • Estoque & fulfillment: Adicionar itens aumenta os itens a serem cumpridos; certifique-se de que o inventário existe e ajuste os fulfillments posteriormente
  • Preços & impostos: Se você definir itemPrice, impostos/descontos serão recalculados a partir desse valor. Se não definido, o Shopify usa o preço atual do variant
  • Identificadores: Use variantId para correspondência confiável; use variantSKU apenas se for único em todo o seu catálogo

💡 Exemplos Mínimos de CSV

Adicionar um item a um pedido (por ID do Variant):

id,topRow,command,itemCommand,variantId,itemQuantity,itemPrice
gid://shopify/Order/123,TRUE,UPDATE,,,,
gid://shopify/Order/123,FALSE,,CREATE,gid://shopify/ProductVariant/111,2,24.99

Adicionar dois itens diferentes ao mesmo pedido (use linhas de itens separadas):

id,topRow,command,itemCommand,variantId,itemQuantity
gid://shopify/Order/456,TRUE,UPDATE,,,
gid://shopify/Order/456,FALSE,,CREATE,gid://shopify/ProductVariant/222,1
gid://shopify/Order/456,FALSE,,CREATE,gid://shopify/ProductVariant/333,3

Adicionar um item por SKU (preço do variant):

id,topRow,command,itemCommand,variantSKU,itemQuantity
gid://shopify/Order/789,TRUE,UPDATE,,,
gid://shopify/Order/789,FALSE,,CREATE,SKU-RED-M,2

🎉 É isso!

Seus itens de linha agora estão adicionados aos pedidos em massa.
Se você encontrar algum problema ou tiver dúvidas, sinta-se à vontade para entrar em contato com nossa equipe de suporte.