# Importar e exportar Grupos de sincronização de inventário

Este guia explica como **exportar** os seus Grupos de sincronização de inventário para um ficheiro CSV e **importá-los** novamente quando quiser configurar grupos mais depressa, copiar definições para outra loja ou fazer edições em massa numa folha de cálculo.

### ✅ O que esta funcionalidade faz

* **Exporta** os seus Grupos de sincronização de inventário existentes para um ficheiro CSV
* Edita grupos em massa com Excel/Google Sheets
* **Importa** o CSV para criar ou atualizar grupos na aplicação
* Configura rapidamente muitos grupos (em vez de criar grupos um a um)

***

### 📥 **Como importar**

1. Abra a aplicação > clique em **Grupos de inventário (Inventory Groups)** > clique em **Importar (Import)**

<figure><img src="/media/4b0b82736ea8d7ea742c.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

2. Transfira o **modelo CSV de exemplo** para perceber o formato correto
3. Clique em **Adicionar ficheiro (Add file)** e carregue o seu ficheiro CSV

<figure><img src="/media/b6cd8e655eae4fd59fd7.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

4. Escolha um **Tipo de importação (Import Type)**:

* **Criar novos grupos (Create new groups):** adiciona apenas novos grupos de inventário.
* **Substituir grupos existentes (Overwrite existing groups)**: substitui os grupos existentes com o mesmo nome.
* **Criar novos grupos se não existirem e substituir grupos existentes (Create new groups if not exist and overwrite existing groups):** combina ambas as ações.

5. Clique em **Importar** para concluir.

**Exemplo**

Se o seu CSV contiver:

| id | title                  | status | location\_id | location\_name      | quantity | variant\_id    | variant\_title                        |
| -- | ---------------------- | ------ | ------------ | ------------------- | -------- | -------------- | ------------------------------------- |
| 1  | Inventory Sync Group 1 | active | 81987633427  | My Custom Location  | 54       | 44866231861523 | The Minimal Snowboard - Default Title |
| 1  |                        |        | 81987600659  | Shop location       | 21       |                |                                       |
| 1  |                        |        | 81987666195  | Snow City Warehouse | 40       |                |                                       |
| 2  | Inventory Sync Group 2 | active | 81987633427  | My Custom Location  | 32       | 44866231894291 | The Hidden Snowboard - Default Title  |
| 2  |                        |        | 81987600659  | Shop location       | 45       |                |                                       |
| 2  |                        |        | 81987666195  | Snow City Warehouse | 43       |                |                                       |

Depois de importar este CSV: a aplicação criará dois grupos:

* **Inventory Sync Group 1** → inclui *The Minimal Snowboard* sincronizado em três localizações.
* **Inventory Sync Group 2** → inclui *The Hidden Snowboard* sincronizado em três localizações.

***

### 📤 Exportar Grupos de inventário

A exportação permite-lhe transferir os dados de sincronização de inventário para um ficheiro CSV. É ideal para cópias de segurança ou para edição offline.

1. Abra a aplicação > clique em **Grupos de inventário** > clique em **Exportar (Export)**

<figure><img src="/media/1b00c74a01479af15669.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

2. Escolha uma opção:

* **Página atual (Current page):** exporta apenas os grupos que vê no ecrã.
* **Todas as páginas (All pages)**: exporta todos os grupos de sincronização de inventário.

<figure><img src="/media/cfac9070bf2ab10cc459.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

3. Clique em **Exportar** e o ficheiro CSV será transferido automaticamente.

***

#### 🛠️ Gerir Grupos de inventário

Depois de importar, pode gerir e rever os detalhes de cada grupo:

* **Nome do grupo (Group Name):** utilizado para identificar o grupo de sincronização.
* **Localizações e inventário inicial (Locations & Initial Inventory)**: defina os níveis de stock sincronizados para cada localização.
* **Adicionar variantes (Add Variants)**: adicione produtos manualmente ou por condição (p. ex., com base em etiquetas ou coleções).
* **Pré-visualizar variantes (Preview Variants):** veja todos os produtos incluídos no grupo e os respetivos níveis de inventário atuais.

**Exemplo**

Importou um grupo com o nome **"T-Shirts"**.\
Sincroniza o stock em 3 localizações:

* Armazém principal (50 unidades)
* Loja física (20 unidades)
* Armazém online (30 unidades)

Quando se vendem 2 artigos, a aplicação atualiza automaticamente todas as localizações para manter o stock consistente.

***

**Notas:**

* Transfira sempre o CSV de exemplo antes de importar para garantir que o seu ficheiro respeita o formato.
* Utilize **Exportar** regularmente para fazer cópia de segurança dos seus dados de sincronização.
* Se importar ficheiros grandes, certifique-se de que o seu CSV está limpo, sem colunas vazias nem cabeçalhos duplicados.

**🙋 Ainda precisa de ajuda?**

Se ainda precisar de ajuda, não hesite em contactar-nos através de <hi@tipo.io>. Teremos todo o gosto em ajudá-lo(a).
