Pular para o conteúdo principal

Importação e exportação em massa por CSV

4 min read

Importação e exportação em massa por CSV

Use a importação em massa por CSV para definir limites de produto no catálogo inteiro de uma vez. Exporte as regras existentes, edite em uma planilha e importe de volta — perfeito para lojas com centenas de SKUs.

Como funciona a importação por CSV

A importação em massa por CSV permite configurar limites de produto para vários itens em uma única operação:

  1. Exporte seu modelo — baixe um modelo de CSV em branco ou exporte suas regras existentes como ponto de partida
  2. Preencha seus dados — adicione os handles de produto, valores de limite, períodos e status em uma planilha
  3. Envie o arquivo — arraste e solte ou selecione seu arquivo CSV no painel do OrderRules
  4. Revise e confirme — visualize as mudanças antes de aplicá-las à sua loja

Essa abordagem é muito mais rápida do que criar regras uma a uma pela interface, especialmente em catálogos grandes.

Formato do arquivo CSV

Seu arquivo CSV precisa incluir as colunas abaixo. A ordem não importa, mas os cabeçalhos das colunas são obrigatórios.

ColunaObrigatóriaDescriçãoExemplo
product_handleSimO handle de URL do produto na sua loja Shopifyblue-widget
variant_idNãoID de uma variante específica (deixe em branco para aplicar a todas)12345678901234
limit_typeSimTipo de limite: per_product, per_product_per_day, per_product_per_week ou per_product_per_monthper_product_per_day
limit_valueSimQuantidade máxima permitida5
periodSimPeríodo do limite: all_time, daily, weekly ou monthlydaily
statusSimAtivar ou desativar a regra: active ou inactiveactive

Exemplo de CSV

product_handle,variant_id,limit_type,limit_value,period,status
blue-widget,,per_product_per_day,5,daily,active
red-gadget,12345678901234,per_product_per_week,10,weekly,active
premium-item,,per_product,1,all_time,active
seasonal-product,,per_product_per_month,3,monthly,inactive

Exportando as regras atuais

Você pode exportar seus limites de produto existentes a qualquer momento, para backup, edição ou migração:

  1. Vá até Limites de Produto no painel do OrderRules
  2. Clique em Exportar Regras (ou Exportar como CSV, se disponível)
  3. Abra o arquivo baixado em uma planilha
  4. Edite os valores que precisar mudar
  5. Envie o arquivo de volta para aplicar as atualizações

Exportar é útil para:

  • Criar um backup da sua configuração
  • Fazer edições em massa nos limites existentes
  • Revisar todas as suas regras de uma vez
  • Migrar regras para outra loja

Casos de uso comuns

Catálogos B2B com mais de 500 produtos
Defina limites diferentes para centenas de SKUs sem tocar na interface. Exporte, edite as quantidades em massa e importe de volta.

Mudanças sazonais de limite
Antes de uma temporada de festas, exporte suas regras, baixe os limites em todos os produtos, envie as mudanças e mude as regras inativas para ativas.

Migrando de outro app
Se você está trocando de app de limite de pedidos, crie um arquivo CSV com seus limites existentes e importe tudo em massa no OrderRules.

Configuração por variante
Para produtos com várias variantes, inclua a coluna variant_id para definir limites diferentes por tamanho, cor ou opção.

Solução de problemas

Erros de formato do arquivo

  • Confirme que o arquivo está salvo como .csv (valores separados por vírgula)
  • Verifique se todas as colunas obrigatórias estão presentes, com os cabeçalhos corretos
  • Confira se os handles de produto batem exatamente com os da sua loja Shopify (diferenciam maiúsculas de minúsculas)

Handles de produto não encontrados

  • O product_handle precisa bater com o trecho da URL da página do seu produto no Shopify
  • Para um produto em minhaloja.myshopify.com/products/blue-widget, o handle é blue-widget
  • Se um handle não for encontrado, a linha é ignorada com uma mensagem de erro

Entradas duplicadas

  • Se o seu CSV tiver o mesmo handle de produto várias vezes com limites diferentes, só a última linha será aplicada
  • Remova as duplicatas antes de enviar

A importação não é aplicada

  • Confirme que a coluna status está como active nas regras que você quer ativar
  • Verifique se limit_value é um número válido (sem vírgulas nem caracteres especiais)
  • Confirme que o valor de period corresponde a uma das opções permitidas: all_time, daily, weekly, monthly

Requisitos de plano

A importação em massa por CSV exige o plano Pro ($9.99/mês). O plano Starter (gratuito) não inclui esse recurso.

Se precisar de ajuda com importações em massa ou tiver dúvidas sobre seu plano, escreva para support@orderrules.com.