# Importar produtos

Se você deseja cadastrar produtos em lote no Alcavie, a importação via planilha é uma ferramenta poderosa e prática. No entanto, é fundamental preencher os dados corretamente para garantir que todas as informações sejam inseridas de forma organizada e sem erros no sistema.

***

## <mark style="background-color:blue;">Como preencher sua planilha</mark>

A planilha contém colunas obrigatórias e algumas regras específicas de preenchimento, principalmente no caso de produtos com variações. Vamos entender cada coluna e os cuidados no momento do preenchimento:

{% file src="<https://1685436827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzvFZFRx2WWAajjtsgulH%2Fuploads%2FzOEPOOWjhcqBzpZKLbkZ%2FModelo%20-%20Produtos.xlsx?alt=media&token=ce60413b-f403-40b0-9411-00e57609b615>" %}

***

### <mark style="background-color:purple;">**Colunas da planilha**</mark>

* **SKU**: É o código interno do produto, como se fosse o “CPF” dele. Precisa ser único para cada produto ou variação.&#x20;
  * Obrigatório quando são produtos com variação.
* **Code**: Código de barras externo, caso o produto já possua algum código de barras usado anteriormente e você queira mantê-lo no sistema. <sup>*(opcional)*</sup>
* **Name**: Nome do produto. <sup>***(obrigatório)***</sup>
  * No caso de variações, deve seguir o formato explicado abaixo.
* **Parent\_product\_sku**: SKU do produto pai. Essa coluna é usada apenas para variações e subvariações, e deve conter o SKU do produto principal ao qual estão vinculadas.&#x20;
  * Obrigatório quando são produtos com variação/subvariação.
* **Price**: Preço de venda do produto. <sup>***(obrigatório)***</sup>
* **Description:** Descrição do produto. <sup>*(opcional)*</sup>
* **Weight:** Peso do produto. <sup>*(opcional)*</sup>
* **GTIN**: Código GTIN, se houver. <sup>*(opcional)*</sup>
* **NCM:** Código NCM para fins fiscais.
  * Opcional, mas recomendamos o cadastro. Para emissão de Notas/Cupons Fiscais é obrigatório que possua NCM informado no produto.
* **NCMEX:** Código NCM Ex. <sup>*(opcional)*</sup>
* **Supplier\_cost**: Preço de custo do produto. <sup>***(obrigatório)***</sup>
* **Warranty:** Garantia do produto junto ao seu fornecedor, se aplicável. <sup>*(opcional)*</sup>
* **Brand:** Marca do produto. <sup>*(opcional)*</sup>
* **Quantity**: Quantidade em estoque. Para produtos pais com variações, utilize o valor 0. <sup>***(obrigatório)***</sup>

***

### <mark style="background-color:purple;">Cadastro de variações e subvariações</mark>

Se o seu produto possui variações (como tamanho ou cor), siga essas regras:

1. **Crie primeiro o produto pai** (linha sem `parent_product_sku`) e só depois cadastre suas variações.
   1. **A variação nunca pode aparecer antes do produto pai na planilha.** <mark style="color:red;">SEMPRE</mark> liste primeiro o produto principal (Produto-pai).
2. **As variações devem vir nas linhas abaixo** do produto pai. Nunca acima.
   1. **A variação nunca pode aparecer antes do produto pai na planilha.** <mark style="color:red;">SEMPRE</mark> liste primeiro o produto principal (Produto-pai).
3. Na coluna `parent_product_sku`, informe o `sku` do produto pai.
4. No campo `name`, deve-se seguir o padrão:
   * Para uma variação: `Nome do Produto > Variação`
   * Para subvariações: `Nome do Produto > Variação > Subvariação`
     * Exemplo:
       * Produto pai: `Camiseta Básica`
       * Variação: `Camiseta Básica > Preta`
       * Subvariação: `Camiseta Básica > Preta > P`

Desta forma o sistema entende corretamente a hierarquia entre produto, variação e subvariação.

### <mark style="background-color:purple;">**Regras para produtos com variações**</mark>

1. **Produtos com variações devem ter o estoque informado nas variações.** O produto pai deve ficar com estoque igual a 0.
2. **Todos os itens (produto pai, variações e subvariações) devem conter os campos obrigatórios preenchidos:**
   * SKU
   * Name
   * Price
   * Supplier\_cost
   * Quantity (exceto para o produto pai com variações, que deve ser 0)
   * NCM (se for emitir Nota/Cupom Fiscal)

***

## <mark style="background-color:blue;">Regras importantes para o preenchimento</mark>

1. **Ordem dos produtos**: Sempre insira primeiro o produto pai e só depois as variações. As variações não podem vir antes do pai na planilha.
2. **Nome das variações**: Deve seguir o padrão:
   * Para uma variação: `Nome do Produto > Variação`
   * Para subvariações: `Nome do Produto > Variação > Subvariação`
   * Exemplo:
     * Produto pai: `Camiseta Básica`
     * Variação: `Camiseta Básica > Preta`
     * Subvariação: `Camiseta Básica > Preta > P`
3. **Preço, custo e estoque**: Todos os itens devem conter valores. No caso de produtos pai com variações, informe estoque 0.
4. **SKU único**: Cada produto ou variação precisa ter um SKU diferente, mesmo que seja variação de outro produto.
5. **Variações devem ser vinculadas corretamente**: Sempre preencha o campo `parent_product_sku` com o SKU do produto pai.

***

## <mark style="background-color:blue;">Exemplo de preenchimento</mark>

### <mark style="background-color:purple;">Produto com variação e subvariação</mark>

Verifique abaixo um exemplo de preenchimento para o produto:&#x20;

* "Camiseta Básica Preto P" e "Camiseta Básica Branco P" com 5 unidades em estoque cada.
  * **Produto-pai:** Camiseta Básica
    * **SKU:** CAMBAS
  * **Variações:** Preto e Branco
    * **SKU:** CAMBASPRE e CAMBASBRA
  * **Subvariação:** P
    * **SKU:** CAMBASPREP e CAMBASBRAP

<figure><img src="https://1685436827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzvFZFRx2WWAajjtsgulH%2Fuploads%2FBXfiHXw8Su8W6u7Oauv7%2Fimage.png?alt=media&#x26;token=076a12bf-e4aa-4df3-ab35-efdb2025ee5b" alt=""><figcaption><p>Clique na imagem para uma melhor visualização</p></figcaption></figure>

***

### <mark style="background-color:purple;">Produto com variação</mark>

Verifique abaixo um exemplo de preenchimento para o produto:&#x20;

* "Camiseta Básica" com variações "P" e "M" com 5 unidades em estoque.
  * **Produto-pai:** Camiseta Básica
    * **SKU:** CAMBAS
  * **Variação:** P e M
    * **SKU:** CAMBASP e CAMBASM

<figure><img src="https://1685436827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzvFZFRx2WWAajjtsgulH%2Fuploads%2FG3W10nW8MUy0nQiBDC25%2Fimage.png?alt=media&#x26;token=3357606f-dd2b-413d-b389-ef04a7399dcf" alt=""><figcaption><p>Clique na imagem para uma melhor visualização</p></figcaption></figure>

***

### <mark style="background-color:purple;">Produto sem variação</mark>

Verifique abaixo um exemplo de preenchimento para o produto:&#x20;

* "Camiseta Básica" com 5 unidades em estoque.
  * **Produto:** Camiseta Básica
    * **SKU:** CAMBAS

<figure><img src="https://1685436827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzvFZFRx2WWAajjtsgulH%2Fuploads%2F46DuDWWlCSkmZ3s3AmPo%2Fimage.png?alt=media&#x26;token=39e1307e-8be9-446d-9a03-722797041ef5" alt=""><figcaption><p>Clique na imagem para uma melhor visualização</p></figcaption></figure>

***

### <mark style="background-color:purple;">Exemplo completo</mark>

<figure><img src="https://1685436827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzvFZFRx2WWAajjtsgulH%2Fuploads%2Fn8PBCTYMo0UQKvDhE9Js%2Fimage.png?alt=media&#x26;token=53e730d6-1a74-48f6-86ed-211a695031f7" alt=""><figcaption><p>Clique na imagem para uma melhor visualização</p></figcaption></figure>

{% file src="<https://1685436827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzvFZFRx2WWAajjtsgulH%2Fuploads%2FCvYD3C06CMsAa359f3HT%2FExemplo%20-%20Importa%C3%A7%C3%A3o%20de%20Produtos.xlsx?alt=media&token=d795c335-7e7f-4f4f-b85f-c6c403a0c41e>" %}

***

## <mark style="background-color:blue;">Importar planilha pronta</mark>

A **importação é feita pelo nosso time de suporte**, então após preencher a planilha corretamente, envie para a gente pelo WhatsApp.

{% hint style="warning" %}
**Atenção**:&#x20;

A importação **só será feita se a planilha estiver devidamente preenchida**, conforme as instruções acima.
{% endhint %}