---
title: "Importação e exportação em massa por CSV"
description: "Importe e exporte limites de produto em massa via CSV. Configure limites para centenas de produtos de uma vez."
contentType: "docs"
locale: "pt-br"
localized: true
source: "https://orderrules.com/pt-br/docs/guides/csv-bulk-import"
slug: "guides/csv-bulk-import"
---
## 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.

| Coluna | Obrigatória | Descrição | Exemplo |
|--------|----------|-------------|---------|
| product_handle | Sim | O handle de URL do produto na sua loja Shopify | `blue-widget` |
| variant_id | Não | ID de uma variante específica (deixe em branco para aplicar a todas) | `12345678901234` |
| limit_type | Sim | Tipo de limite: `per_product`, `per_product_per_day`, `per_product_per_week` ou `per_product_per_month` | `per_product_per_day` |
| limit_value | Sim | Quantidade máxima permitida | `5` |
| period | Sim | Período do limite: `all_time`, `daily`, `weekly` ou `monthly` | `daily` |
| status | Sim | Ativar ou desativar a regra: `active` ou `inactive` | `active` |

### 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**.