> For the complete documentation index, see [llms.txt](https://docs.sellermagnet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sellermagnet.com/pt-or-guia-do-sellermagnet/ferramentas-de-venda/repricer-overview/bulk-import-export.md).

# Importação e Exportação em Massa

{% hint style="info" %}
**Dificuldade:** 🔴 Avançado · **Tempo de leitura:** \~7 min
{% endhint %}

![Assistente de importação/exportação em massa do Repricer](/files/tWDr5253l5YgtvtzlUPn)

{% hint style="success" icon="rocket" %}
**Boa prática : comece a partir de um Export, não de um CSV em branco.** Antes de escrever uma única linha, clique em **Export → Products & Fees** na barra de ferramentas do Repricer. Isto baixa um **modelo pré-preenchido** com cada produto sincronizado, suas taxas reais da Amazon (referral + FBA), taxas de VAT e preços atuais já preenchidos. Você só precisa preencher **Min Price**, **Max Price** e **Strategy**, todo o resto já está feito. Este único passo economiza horas e elimina cerca de 90% dos erros de validação.
{% endhint %}

## 📋 Visão Geral

O recurso de **Importação e Exportação em Massa** permite criar, atualizar e fazer backup de configurações de reprecificador em escala usando arquivos CSV. Em vez de configurar centenas de regras de reprecificador uma por uma pelo assistente, você pode preparar uma planilha offline e enviar em uma única ação.

Isso é essencial para vendedores com catálogos grandes, operações em múltiplos marketplaces ou equipes que precisam revisar e aprovar configurações de reprecificação antes de entrarem em vigor.

***

## Acessando Operações em Massa

1. Navegue até a página do **Repricer** pelo menu lateral.
2. Na barra de ferramentas da Items Table, procure os botões **Import** e **Export**.

***

## 📤 Exportação

{% hint style="info" icon="circle-info" %}
**CSV ou Excel.** O botão **Export** é um menu dividido, após escolher o que exportar você seleciona **CSV** ou **Excel (.xlsx)**. Ambos os formatos contêm as mesmas colunas; apenas o tipo de arquivo difere. Veja [Escolhendo um formato](#escolhendo-um-formato) abaixo.
{% endhint %}

### O Que é Exportado

Clicar em **Export** abre o modal **Export options** onde você escolhe o que exportar. **Products & Fees** (estendido) é o modo padrão recomendado, você também pode escolher um *Import template* em branco ou seus *Current repricers*. A exportação de current-repricers contém todas as regras de reprecificador ativas e pausadas na sua conta:

| Coluna                                           | Descrição                                                           |
| ------------------------------------------------ | ------------------------------------------------------------------- |
| **ASIN (Amazon Standard Identification Number)** | Amazon Standard Identification Number                               |
| **SKU (Stock Keeping Unit)**                     | Seu SKU do Seller Central para o anúncio                            |
| **Marketplace**                                  | Código do marketplace Amazon (ex.: `A1PA6795UKMFR9` para Amazon.de) |
| **Condition**                                    | New ou Used                                                         |
| **Strategy**                                     | Nome da estratégia (ex.: `buybox`, `brandguard`)                    |
| **Min Price**                                    | Limite mínimo de preço                                              |
| **Max Price**                                    | Limite máximo de preço                                              |
| **Current Price**                                | O preço atual do anúncio na Amazon                                  |
| **Status**                                       | Active ou Paused                                                    |
| **FBA/FBM**                                      | Tipo de fulfillment                                                 |

{% hint style="info" icon="circle-info" %}
**Defina o escopo da exportação de current-repricers.** Quando você escolhe **Current repricers**, um menu suspenso de **scope** restringe o que você baixa: **Unsuccessful (No BuyBox)**, **Brand / Private Label**, **Successful (BuyBox Secured)** ou **All Active Repricers**. O escopo sozinho comanda a exportação - seus filtros ativos da tabela não são aplicados.
{% endhint %}

### Casos de Uso da Exportação

| Caso de Uso                     | Descrição                                                                |
| ------------------------------- | ------------------------------------------------------------------------ |
| **Backup**                      | Salvar um snapshot de todas as regras antes de fazer alterações em massa |
| **Auditoria**                   | Compartilhar o arquivo com membros da equipe para revisão e aprovação    |
| **Migração entre marketplaces** | Copiar configurações para adaptar para um marketplace diferente          |
| **Análise em planilha**         | Abrir no Excel/Google Sheets para classificar, filtrar e analisar regras |

### Escolhendo um Formato

Quando você clica em **Export**, o botão de download oferece dois formatos com **colunas idênticas**, a única diferença é o tipo de arquivo:

| Formato   | Tipo de arquivo | Melhor para                                                                                                                                                                                                  |
| --------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **CSV**   | `.csv`          | Reimportar no SellerMagnet, alimentar outra ferramenta ou qualquer pipeline de texto simples. CSV é o formato que o importador lê, então escolha sempre CSV se o arquivo for ser editado e enviado de volta. |
| **Excel** | `.xlsx`         | Ler, classificar, filtrar, compartilhar com sua equipe ou enviar a um fornecedor. Abre de forma limpa no Excel / Google Sheets com colunas adequadas e sem configuração de processamento.                    |

{% hint style="warning" icon="triangle-exclamation" %}
**Uma exceção:** o modo de **Import template** em branco sempre baixa como CSV, porque existe para ser preenchido e reimportado. Os modos *Products & Fees* e *Current repricers* respeitam ambos a sua escolha de CSV / Excel.
{% endhint %}

> **Recomendação:** Exporte para **Excel** para revisão humana e para **CSV** para qualquer ida-e-volta que termine em uma reimportação. Independentemente do que escolher, os dados são os mesmos, então um backup feito como Excel é tão completo quanto um feito como CSV.

***

## Importação

### Preparando Seu Arquivo de Importação

Use o CSV exportado como modelo. Cada linha representa uma regra de reprecificador. Modifique linhas existentes ou adicione novas.

**Colunas obrigatórias para novas regras:**

| Coluna          | Obrigatória | Formato                                                                |
| --------------- | ----------- | ---------------------------------------------------------------------- |
| **ASIN**        | Sim         | ASIN de 10 caracteres                                                  |
| **SKU**         | Sim         | Deve corresponder exatamente ao seu SKU do Seller Central              |
| **Marketplace** | Sim         | Identificador do marketplace Amazon                                    |
| **Condition**   | Sim         | `new` ou `used`                                                        |
| **Strategy**    | Sim         | Código da estratégia (veja tabela de referência de estratégias abaixo) |
| **Min Price**   | Sim         | Número decimal na moeda do marketplace (ex.: `19.99`)                  |
| **Max Price**   | Sim         | Número decimal, deve ser maior que Min Price                           |
| **Status**      | Não         | `active` ou `paused` (padrão `active` se omitido)                      |

### Referência de Códigos de Estratégia

| Código             | Categoria  | Descrição                                                                                              |
| ------------------ | ---------- | ------------------------------------------------------------------------------------------------------ |
| `lowest`           | Revendedor | Ser sempre a oferta mais barata, ficando abaixo do menor concorrente dentro dos seus limites min/max   |
| `buybox`           | Revendedor | Conquistar e manter o Buy Box pelo maior preço lucrativo                                               |
| `position`         | Revendedor | Manter uma posição-alvo de preço (ex.: 2º menor) entre todos os vendedores                             |
| `same`             | Revendedor | Espelhar o preço de um vendedor específico pelo Seller ID dele                                         |
| `brandguard`       | Marca / PL | Precificação de marca orientada por demanda, estoque e ASINs de concorrentes                           |
| `competitor_sync`  | Marca / PL | Sincronizar com o preço do Buy Box de um ASIN concorrente multiplicado por um fator de ajuste          |
| `velocity_balance` | Marca / PL | Precificação orientada pela demanda a partir da sua própria taxa de vendas, sem concorrente necessário |

### Enviando o Arquivo

{% stepper %}
{% step %}

### Clique no botão **Import** na barra de ferramentas do Repricer.

{% endstep %}

{% step %}

### Selecione seu arquivo CSV preparado (ou arraste e solte na área de upload).

{% endstep %}

{% step %}

### Uma tela de pré-visualização mostra as regras processadas com status de validação.

{% endstep %}

{% step %}

### Revise quaisquer avisos ou erros (linhas destacadas indicam problemas).

{% endstep %}

{% step %}

### Clique em **Confirm Import** para criar ou atualizar as regras.

{% endstep %}
{% endstepper %}

### Regras de Validação

O sistema de importação verifica:

| Validação                                   | Erro se Violada                                  |
| ------------------------------------------- | ------------------------------------------------ |
| Min Price > 0                               | "Minimum price must be greater than zero"        |
| Max Price > Min Price                       | "Maximum price must exceed minimum price"        |
| Formato de ASIN válido                      | "Invalid ASIN format"                            |
| SKU existe no Seller Central                | "SKU not found in your catalog"                  |
| Código de estratégia válido                 | "Unknown strategy code"                          |
| Sem duplicata de ASIN+Marketplace+Condition | "Duplicate rule detected"                        |
| Cota não excedida                           | "Import would exceed your plan's repricer limit" |

***

## Atualizando Regras Existentes via Importação

![Modal Create Repricer: estratégia, base de custos e pré-visualização de preço ao vivo](/files/SH6vMLvz7o8l64SyVJ6t)

Se o arquivo de importação contiver uma combinação de ASIN + Marketplace + Condition que já existe como regra de reprecificador, o sistema **atualiza** a regra existente em vez de criar uma duplicata. Isso permite modificar estratégias ou limites de preço em massa.

{% hint style="info" icon="circle-info" %}
**Observação:** Para atualizar apenas campos específicos, exporte primeiro, modifique as colunas que deseja alterar e reimporte. Colunas não alteradas mantêm seus valores atuais.
{% endhint %}

***

## 💾 Salvando custos importados nos seus produtos (sincronização de COGS)

O preço de compra que você coloca em um arquivo de importação fica dentro do Repricer. O SellerMagnet também pode copiá-lo para o **próprio produto** como seu custo de mercadorias (COGS), para que a aba Products e todas as telas de lucro/analytics usem o mesmo custo - sem entrada dupla.

Após uma importação bem-sucedida, se as regras que você acabou de criar tiverem um preço de compra, uma caixa de diálogo pergunta **"Save these costs to your products?"** - *"Neste momento estes preços de compra existem apenas dentro do repricer. Salve-os também nos produtos, para que a aba de produtos e suas análises de lucro os utilizem."*

{% hint style="info" icon="circle-info" %}
O mesmo aviso aparece quando você cria um repricer manualmente, ou quando edita um repricer e **altera** o seu preço de compra - ele só oferece os SKUs cujo preço realmente mudou.
{% endhint %}

### Lendo a pré-visualização

Cada SKU é listado com uma caixa de seleção, seu **custo atual → novo custo** e um emblema de status:

| Emblema                        | Significado                                                                                                                 |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| **No product cost yet**        | O produto não tem custo registrado. Estas linhas vêm **pré-marcadas** - salvar é seguro.                                    |
| **Updates existing flat cost** | Já existe um custo fixo e é diferente. Marcar o substitui.                                                                  |
| **Overrides batch costs**      | O produto usa custos de **batch** de inventário. Salvar um custo fixo sobrepõe esses batches em TODOS os cálculos de lucro. |
| **Multiple prices - pick one** | O mesmo SKU aparece com mais de um preço no arquivo - escolha qual preço salvar.                                            |
| **Already in sync**            | O custo do produto já corresponde - nada a fazer (linha desativada).                                                        |
| **Current cost unknown**       | O custo atual não pôde ser lido - deixado desmarcado para que nada seja sobrescrito por acidente.                           |

{% hint style="warning" %}
Linhas marcadas como **"Overrides batch costs"** já têm batches de inventário. Só marque essas se realmente quiser que um custo fixo substitua seus custos de batch em todos os lugares. **Linhas que alterariam ou sobreporiam um custo existente nunca são salvas a menos que você as marque você mesmo** - apenas as linhas "No product cost yet" vêm pré-selecionadas.
{% endhint %}

Marque as linhas que deseja e clique em **Save to products (N)**, ou escolha **Not now** para pular. Apenas o preço de compra é gravado; ele se torna o custo fixo do produto e é ativado automaticamente.

### Lembrando sua escolha

O menu suspenso **"Next time"** define o que acontece em futuras importações e edições para este projeto:

* **Ask me every time** (padrão) - mostrar sempre esta caixa de diálogo.
* **Save automatically (only products without any cost)** - salvar silenciosamente as linhas seguras "No product cost yet", nunca tocando em produtos que já têm um custo.
* **Never ask again** - pular o aviso inteiramente.

{% hint style="info" icon="circle-info" %}
**O custo de envio não é sincronizado.** A coluna `shipping_cost` é uma entrada do Repricer usada para o seu próprio cálculo de preço min/max e (para vendedores FBM) para os números de lucro. A ação "Save to products" grava apenas o **preço de compra** como COGS - não altera a taxa de envio do produto.
{% endhint %}

***

## 🎯 Exemplo Realista

**Cenário:** Você vende 500 produtos na Amazon.de e quer configurar reprecificadores para todos com a estratégia BuyBox.

1. **Exporte** seu catálogo atual do Seller Central (ou use a exportação de produtos do SellerMagnet).
2. Abra o arquivo no Excel / Google Sheets.
3. Adicione as colunas obrigatórias: Strategy (`buybox`), Min Price (calculado por produto), Max Price (ex.: 2x seu custo).
4. Salve como CSV.
5. Clique em **Import** na página do Repricer.
6. Revise a pré-visualização: 493 regras válidas, 7 sinalizadas (incompatibilidade de SKU).
7. Corrija os 7 problemas, reenvie.
8. Todos os 500 reprecificadores ativam simultaneamente.

**Tempo economizado:** \~8 horas de configuração manual pelo assistente reduzidas a \~30 minutos de trabalho em planilha.

***

<details>

<summary><strong>⚠️ Erros Comuns a Evitar</strong></summary>

| Erro                                          | Por Que Prejudica                                                 |
| --------------------------------------------- | ----------------------------------------------------------------- |
| Usar vírgulas em vez de pontos para decimais  | O processamento do CSV falha ou os preços ficam incorretos        |
| Esquecer de corresponder os SKUs exatamente   | Regras são rejeitadas porque o SKU não existe no seu catálogo     |
| Importar sem exportar primeiro                | Sem backup para reverter se algo der errado                       |
| Definir o mesmo preço mínimo e máximo         | O reprecificador não tem espaço para ajustar preços               |
| Não verificar a pré-visualização de validação | Erros passam despercebidos e regras não são criadas como esperado |

</details>

\## ✅ Melhores Práticas

1. **Sempre exporte antes de importar:** Isso cria um backup que você pode restaurar se a importação produzir resultados inesperados.
2. **Use o arquivo exportado como seu modelo:** Ele garante nomes de colunas e formato corretos.
3. **Valide no Excel primeiro:** Use formatação condicional para sinalizar linhas onde Min Price >= Max Price ou onde campos obrigatórios estão vazios.
4. **Comece com um lote de teste pequeno:** Importe 10-20 regras primeiro, verifique se funcionam corretamente, depois importe o lote completo.
5. **Versione seus arquivos de importação:** Nomeie arquivos com datas (ex.: `repricer-import-2026-04-12.csv`) para trilha de auditoria.

***

## ❓ FAQ

<details>

<summary><strong>Posso importar regras para múltiplos marketplaces em um único arquivo?</strong></summary>

Sim. Inclua o identificador do marketplace em cada linha. O sistema processa todos os marketplaces em uma única importação.

</details>

<details>

<summary><strong>O que acontece com regras existentes que não estão no arquivo de importação?</strong></summary>

Elas não são afetadas. A importação só cria ou atualiza regras para combinações de ASIN + Marketplace + Condition presentes no arquivo.

</details>

<details>

<summary><strong>Existe um tamanho máximo de arquivo para importação?</strong></summary>

O limite prático é de 10.000 linhas por arquivo de importação. Para catálogos maiores, divida em múltiplos lotes.

</details>

<details>

<summary><strong>Posso excluir regras via importação?</strong></summary>

Não. A exclusão é feita pela interface do painel (individual ou exclusão em massa). A importação apenas cria e atualiza.

</details>

<details>

<summary><strong>Qual codificação de arquivo devo usar?</strong></summary>

UTF-8. Isso garante que caracteres especiais em nomes de produtos e SKUs não-ASCII sejam tratados corretamente.

</details>

<details>

<summary><strong>Posso agendar importações automáticas?</strong></summary>

Não atualmente. As importações são manuais. Para configuração automatizada de reprecificação, use a API (disponível nos planos Enterprise).

</details>

***

## ➡️ O que vem a seguir?

{% content-ref url="/pages/rxbKZvLNykyjP2CEy9MS" %}
[Criar e Gerenciar Regras de Reprecificador](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/repricer-overview/create-manage-repricer.md)
{% endcontent-ref %}

{% content-ref url="/pages/wOlLjyN5SHGJsMrza9KG" %}
[Visão Geral do Repricer](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/repricer-overview.md)
{% endcontent-ref %}
