> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brindehub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Importando produtos de fornecedores

> Sincronize catálogos de fornecedores com a sua loja.

# Importando produtos de fornecedores

A plataforma permite importar automaticamente catálogos de fornecedores através de sincronização. Os produtos importados recebem a origem **Fornecedor** e ficam visíveis junto dos produtos manuais.

> **Importante:** A importação é feita a partir da tela **Fornecedores** (`/fornecedores`), não da lista de produtos. A sincronização ocorre de forma assíncrona via fila de processamento.

## Pré-requisitos

* Permissão `suppliers` com ação `edit`.
* Um fornecedor habilitado (ex.: XBZ Brindes).
* Credenciais de acesso válidas para o fornecedor.

## Passo a passo

1. Vá para **Fornecedores** (`/fornecedores`).
2. Localize o fornecedor desejado e clique em **Conectar**.
3. Preencha os campos de credenciais solicitados e salve.
4. Após conectado, clique em **Sincronizar**.
5. O status mudará para **Sincronizando...** e o painel passará a consultar o progresso a cada 2 segundos.
6. Quando concluído, os produtos e variações aparecerão em `/produtos` com o selo **Fornecedor**.

> **Dica:** Configure a sincronização automática para manter o catálogo atualizado sem precisar clicar em "Sincronizar" manualmente.

## Opções

* **Sincronização manual**: clique no botão **Sincronizar** quando quiser atualizar o catálogo.
* **Auto sincronização**: agende intervalos (diário, semanal, mensal) para atualizações automáticas.
* **Markup do fornecedor**: defina faixas de markup por fornecedor, usadas para precificação.

## Categorias e produtos importados

* Categorias podem ser criadas automaticamente durante a sincronização, dependendo do fornecedor.
* Produtos importados possuem variações de cor/prazo já carregadas.
* Imagens são obtidas do fornecedor, mas você pode substituí-las na galeria do produto.

## Erros comuns

* Clicar em **Sincronizar** sem conectar o fornecedor.
* Iniciar uma sincronização enquanto outra ainda está em andamento.
* Usar credenciais inválidas ou expiradas.

## Solução de problemas

| Problema                                    | Causa provável                           | Solução                                            |
| ------------------------------------------- | ---------------------------------------- | -------------------------------------------------- |
| "Conecte o fornecedor antes de sincronizar" | Configuração inexistente ou desconectada | Acesse as credenciais e conecte novamente.         |
| "Sincronização já em andamento"             | Já existe um job ativo                   | Aguarde a conclusão.                               |
| Status **Erro** com mensagem                | Falha na comunicação com o fornecedor    | Verifique as credenciais e o status do fornecedor. |
| Produto não apareceu                        | Sincronização ainda em progresso         | Aguarde a finalização e atualize a lista.          |

## Artigos relacionados

* [Criando produtos manualmente](./creating-products)
* [Editando produtos](./editing-products)
* [Variações e estoque](./variants-and-stock)
* [Criando categorias](../categories/creating-categories)