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".

Token da API do Tiny	Gerado dentro do Tiny em Configurações > 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.
ID da lista de preço (opcional)	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.
Descrição da lista de preço (opcional)	Só um rótulo pra você lembrar qual lista escolheu (ex.: "Atacado", "Padrão").

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.