# Integração com o Tiny ERP (Olist): como importar produtos

A tela **Configurações > Integrações** do painel do lojista permite trazer seus produtos do **Tiny ERP (Olist)** direto pro marketplace, e manter estoque e preço sincronizados automaticamente depois disso.

Existem duas formas de usar: **conectar via token** (recomendado, sincronização automática) ou **importar via planilha CSV** (mais simples, mas sem sincronização depois).

## Opção 1 — Conectar via token (recomendado)

Clique em **"Conectar via token"**.

<table id="bkmrk-token-da-api-do-tiny"><tbody><tr><td>**Token da API do Tiny**</td><td>Gerado dentro do Tiny em Configurações &gt; API. Esse token dá acesso total à conta do Tiny (não dá pra restringir permissões) — se preferir não compartilhar, use a importação via planilha em vez disso.</td></tr><tr><td>**ID da lista de preço** (opcional)</td><td>Se você usa listas de preço diferentes no Tiny (ex.: atacado, varejo), pode fixar aqui qual lista usar como preço padrão dos produtos importados.</td></tr><tr><td>**Descrição da lista de preço** (opcional)</td><td>Só um rótulo pra você lembrar qual lista escolheu (ex.: "Atacado", "Padrão").</td></tr></tbody></table>

Depois de conectar, o sistema já busca as listas de preço e categorias reais cadastradas no seu Tiny, e você pode escolher entre elas na hora de importar.

### Configurar o webhook (sincronização automática)

Assim que a conexão é feita, aparece um botão **"Copiar webhook"**. Copie essa URL e cole em **todos** os campos de "URLs de notificações" dentro do Tiny, em:

*Configurações → E-commerce → Integrações → Webhook*

Cole a mesma URL nos campos de estoque, preço, produto, situação de pedido, rastreio e nota fiscal. Hoje, só **estoque** e **preço** são realmente processados — os outros eventos são recebidos e ignorados com segurança até serem implementados, então não tem problema colar em todos.

Com o webhook configurado, toda vez que você mudar o preço ou o estoque de um produto no Tiny, o marketplace atualiza sozinho, sem precisar reimportar nada.

## Opção 2 — Importar via planilha (CSV)

Clique em **"Importar via planilha"** se preferir não compartilhar o token do Tiny. Exporte do Tiny um CSV com as colunas:

`codigo, nome, preco, categoria, estoque, imagem_url`

Cole o conteúdo do CSV na caixa de texto e clique em **"Ver preview"**.

**Limitação importante:** como o CSV não tem colunas de peso, altura, largura, comprimento, descrição nem foto, todo produto importado por planilha entra como **rascunho** até você completar esses dados manualmente depois, dentro do marketplace. Além disso, essa via não sincroniza — pra atualizar preço/estoque depois, é preciso reimportar.

## Antes de importar: filtros e preview

Se conectado via token, antes de ver os produtos você pode escolher a **lista de preço** a usar. Depois de clicar em **"Ver produtos para importar"**, é aberto um preview com filtros adicionais:

- **Filtrar por categoria** — pelas categorias que vieram nos próprios produtos carregados.
- **Estoque acima de** — esconde produtos com estoque baixo/zerado.
- **Filtrar por SKU** — busca por código do produto ou de uma variação específica.

## Selecionando o que importar

Cada linha do preview é um produto. Produtos com variações (grade — tamanho, cor etc.) aparecem com os filhos logo abaixo, cada um com sua própria caixinha de seleção — dá pra desmarcar só uma variação específica (ex.: um tamanho sem estoque) sem tirar o produto inteiro da importação. Marcar o produto "pai" marca todas as variações de uma vez.

Produtos que já foram importados antes aparecem com a etiqueta **"importado"** — selecioná-los de novo **atualiza** o produto já existente no marketplace em vez de criar um duplicado.

### Categoria sem mapeamento

Se a categoria de um produto no Tiny ainda não tem correspondente no marketplace, aparece um seletor de categoria na própria linha pra você escolher a categoria certa do marketplace. Dá pra fazer isso produto por produto, ou usar o bloco **"Mapear categoria em massa"** no topo do preview: escolha a categoria do Tiny de um lado e a categoria do marketplace do outro, e clique em **"Aplicar a todos dessa categoria"** — todos os produtos daquela categoria do Tiny recebem o mapeamento de uma vez.

### Produtos incompletos (vão como rascunho)

Quando um produto já tem todas as informações necessárias (peso, altura, comprimento, largura, descrição e foto), aparece uma chave **"Importar como ativo/rascunho"** — você escolhe se ele já entra publicado ou como rascunho.

Quando falta alguma dessas informações, o produto **sempre entra como rascunho**, e aparecem etiquetas laranjas indicando o que falta completar (ex.: peso, foto, descrição) — depois é só editar o produto no marketplace e preencher o que faltou pra poder publicar.

## Confirmando a importação

Marque os produtos desejados e clique em **"Confirmar importação"**. O botão mostra quantos produtos estão selecionados. Ao final, o sistema informa quantos foram **importados** (novos) e quantos foram **atualizados** (já existiam e foram sobrescritos com os dados atuais do Tiny).

## Desconectando

Se quiser parar de sincronizar com o Tiny, clique em **"Desconectar"** no topo do card. Isso não apaga os produtos já importados, só encerra a conexão/token e para a sincronização automática via webhook.