Tiny
A integração com o Tiny conecta a sua conta ao idworks e sincroniza os fluxos correspondentes ao canal — credenciais, regras de sincronização de produtos, importação de pedidos, conciliação financeira e demais ações específicas dele. A configuração reúne 15 parâmetros distribuídos em 4 grupo(s).
Antes de configurar, ative a integração em Configurações → Integrações (aba Integrações Disponíveis), preencha o nome interno e (quando o tipo exigir) passe pelo fluxo de autenticação. A partir daí, os parâmetros abaixo ficam disponíveis na Configuração (ícone de engrenagem) da integração.
Categoria no catálogo do idworks: Canal de Venda.
Índice
Conceito
Cadastro e autenticação
Parâmetros por grupo
Produtos
Pedidos
- Como fazer o DE-PARA de transportadora dos pedidos da Tiny?
- Por que os pedidos da Tiny pararam de ser importados?
Referência rápida
O que é a integração Tiny?
É a conexão entre o canal Tiny e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é Canal de Venda), mas em geral cobre uma combinação de credenciais, regras de sincronização, gatilhos automáticos e parâmetros de conciliação.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → Tiny.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Tiny e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir várias instâncias do mesmo tipo.
- Clique em Salvar.
A integração aparece imediatamente em Minhas Integrações. Dependendo do tipo, o status inicial é Ativo (quando só requer credencial fixa) ou Não Autenticado (quando depende de autenticação externa).
Pré-requisito: privilégio Criar parametrizações empresa.
Como autenticar e validar as credenciais?
Preencha o grupo Credenciais de Acesso (ver tabela abaixo). Quando a integração pede uma autorização externa (o canal abre a tela de login dele para você liberar o acesso), clique em Autenticar Integração na linha da integração (ícone de cadeado) — uma nova aba abre o login do canal e, ao confirmar, a conexão fica liberada. Para integrações com credencial fixa (usuário/senha/chave), basta preencher os campos e salvar.
Depois de salvar, use a ação Validar credenciais (quando disponível) para confirmar que o canal responde. O status na listagem reflete o resultado: Ativo = OK, Erro = credencial inválida ou revogada, Não Autenticado = falta concluir o fluxo de autorização.
Pré-requisito: privilégio Editar parametrizações empresa.
Credenciais de Acesso
1 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Token | Senha | Token de acesso à integração |
Integração de Vendas
3 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Incluir somente pedidos com NF | Sim/Não | Ative se quiser integrar somente pedidos com NF |
| Importar pedidos | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no canal de vendas. |
| ID pedido iniciar importação | Texto | A partir de qual número de pedido a idworks deve iniciar a integração? |
Integração de Produtos
4 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Atualizar saldo estoque | Sim/Não | Ative se quiser que a idworks atualize o saldo de estoque na integração. |
| Criar oferta | Sim/Não | Ative se quiser criar a oferta automaticamente, se cadastro do SKU existir no marketplace |
| Criar sku | Sim/Não | Ative se quiser criar o sku caso não seja encontrado na base |
| Armazéns para somar quantidade | Lista múltipla | Selecionar os armazéns que deve somar a quantidade para enviar aos canais de venda. Caso não seja preenchido, será enviado a quantidade do armazém que esta no de/para |
Para enviar o produto e o saldo à Tiny na hora, pela tela de anúncios, veja Como sincronizar produto e saldo de estoque com a Tiny?. A ação Sincronizar Saldo Estoque só funciona com Atualizar saldo estoque ligado.
Importação de Produtos
7 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Incluir Preços na ficha do Anúncio | Sim/Não | Traz o preço do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado preço definido pela política comercial do cadastro do produto no momento da sincronização do anúncio. |
| Incluir Título na ficha do Anúncio | Sim/Não | Traz o título do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado o campo Nome do cadastro do produto no momento da sincronização do anúncio. |
| Incluir Descrição na Ficha do Anúncio. | Sim/Não | Traz o descrição do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado o campo Descrição do cadastro do produto no momento da sincronização do anúncio. |
| Importar somente anúncios inexistente dentro da idworks | Sim/Não | Só importa anúncios que ainda não estão cadastrados no sistema. |
| Incluir Imagem dentro do Produto | Sim/Não | Traz as imagens do anúncio publicado para dentro do cadastro do produto no sistema. Caso a opção de trazer imagens para dentro do anúncio esteja habilitada, esta funcionalidade será desconsiderada. |
| Não Realizar o vínculo do Anúncio ao Produto/SKU | Sim/Não | Ignora o vínculo automático do anúncio com o produto/SKU, permitindo que o vínculo seja realizado posteriormente. |
| Criar Produto/SKU, com base no Anúncio Importado. | Sim/Não | Cria o Produto/SKU com base no anúncio importado... |
Como sincronizar produto e saldo de estoque com a Tiny?
📍 Onde: menu lateral → Integrações (HUB) → Anúncios → marque os anúncios da Tiny → botão Sincronizar (canto superior direito). Para um anúncio só, use o ícone de recarregar (título Sincronizar) na coluna Ações da linha. Na ficha do anúncio, as mesmas ações ficam no painel ao lado da ficha.
A janela Sincronizar mostra uma aba por integração e, na coluna à direita, os botões das ações da integração da aba. Para a Tiny aparecem duas ações: Sincronizar Produto e Sincronizar Saldo Estoque. Ao clicar em uma delas, o sistema pede a confirmação ("Confirma Sincronizar Produto") e processa os anúncios um a um. Cada linha mostra o resultado; quando a Tiny recusa, a linha traz a mensagem dela. Cada ação vale para o anúncio inteiro, com todas as suas variações. O passo a passo da janela está em Como sincronizo anúncios com o canal?.
Sincronizar Produto
Cria o produto na Tiny. Se o anúncio já tem o código da Tiny, atualiza o produto que já existe lá. A ação envia:
- o código do SKU e o nome do produto, com os valores das variações separados por
|(no produto pai, o nome vai sem os valores e o código ganha o sufixo-Pquando o produto do anúncio é o próprio SKU da primeira variação); - o preço e o preço promocional;
- o GTIN, a marca e as imagens;
- o Cód. CST do SKU, no campo de origem da Tiny;
- o produto como ativo, em unidade UN.
Quando o anúncio tem variações, a Tiny recebe o produto pai e cada variação, com a grade dela (por exemplo, cor e tamanho). O código que a Tiny devolve fica gravado no anúncio e em cada variação, e é ele que as próximas sincronizações usam para atualizar em vez de criar de novo. Esta ação também funciona em anúncio inativo.
Sincronizar Saldo Estoque
Envia à Tiny o saldo atual de cada variação do anúncio, o mesmo envio que a rotina automática faz. A quantidade é o saldo disponível menos o Estoque de segurança do SKU, nunca abaixo de 0; SKU com Estoque infinito vai com no mínimo 400. Os armazéns que entram na conta seguem o parâmetro Armazéns para somar quantidade (ver Integração de Produtos). Se a integração tem armazéns no DE-PARA de Hub Estoque, o saldo vai uma vez para cada armazém; com Armazéns para somar quantidade preenchido, todos os depósitos recebem a mesma soma. O Armazém canal é o depósito da Tiny que recebe a quantidade.
Para esta ação funcionar:
- Atualizar saldo estoque precisa estar ligado em Integração de Produtos. Desligado, a linha volta com "configuração de saldo estoque não está ativa".
- O anúncio precisa já ter o código da Tiny, que a ação Sincronizar Produto grava (anúncio importado da Tiny já vem com ele). Variação sem esse código não recebe saldo. Se nenhuma variação tem o código, a linha volta com "Anúncio não encontrado ...", mesmo com Atualizar saldo estoque desligado; nesse caso rode Sincronizar Produto primeiro.
- O anúncio precisa estar ativo. Anúncio inativo volta com o aviso Anúncio INATIVO.
Pré-requisito: privilégio Sincronizar Anúncio.
Como fazer o DE-PARA de transportadora dos pedidos da Tiny?
Quando o pedido importado da Tiny traz uma transportadora do canal, é ela que o idworks procura em Integrações (HUB) → DE-PARA Transportadora para saber qual transportadora sua usar. O que chega depende do pedido na Tiny:
- Pedido com nome do transportador — chega o nome do transportador, do jeito que está na Tiny.
- Pedido sem nome do transportador — chega o código da forma de envio do pedido (por exemplo,
Cpara Correios ouJpara Jadlog). - Pedido sem nenhum dos dois — chega sem transportadora do canal.
Para ver o que chegou em um pedido, confira a coluna Código transportadora na tela Pedidos Integrados.
Escolhendo na lista
No DE-PARA, ao escolher a integração Tiny, o campo Transportadora canal lista as formas de envio da Tiny, no formato código - nome (ex.: C - Tiny Correios). Se a lista aparecer vazia (Não há dados), digite o código (ex.: C) no campo Digite... do rodapé da lista e clique em Adicionar — o efeito é o mesmo de escolher na lista:
| Código | Aparece como |
|---|---|
C | Tiny Correios |
T | Tiny Transportadora |
M | Tiny Mercado Envios |
E | Tiny Correios E-fulfillment |
B | Tiny B2W Entrega |
X | Tiny Customizada |
D | Tiny ConectaLá Etiquetas |
J | Tiny Jadlog |
S | Tiny Sem Frete |
TOTALEXPRESS | Tiny Total Express |
OLIST | Tiny Olist |
GATEWAY | Tiny Gateway logístico |
MAGALU_ENTREGAS | Tiny Magalu Entregas |
MAGALU_FULFILLMENT | Tiny Magalu Fulfillment |
SHOPEE_ENVIOS | Tiny Shopee Envios |
NS_ENTREGAS | Tiny Netshoes Entregas |
VIAVAREJO_ENVVIAS | Tiny Via Varejo Envvias |
ALI_ENVIOS | Tiny AliExpress Envios |
MADEIRA_ENVIOS | Tiny Madeira Envios |
LOGGI | Tiny Loggi |
AMAZON_DBA | Tiny Amazon DBA |
NS_MAGALU_ENTREGAS | Tiny Magalu Entregas por Netshoes |
⚠️ Essas opções só valem para pedidos que chegaram sem nome do transportador. Quando a Tiny informa o nome, o pedido chega com o nome — e um DE-PARA feito pela forma de envio (ex.: T - Tiny Transportadora) não é usado para ele.
Cadastrando pelo nome do transportador
Para os pedidos que chegam com o nome, abra o campo Transportadora canal, digite o nome no campo Digite... do rodapé da lista e clique em Adicionar. Use o nome exatamente como ele chegou no pedido (veja na coluna Código transportadora). Cada nome diferente usado na Tiny precisa do seu próprio DE-PARA.
Quando falta o DE-PARA
Se a parametrização Validar se pedido integrado possui de/para antes de criar (Configurações → Parametrizações → Integração de Vendas) estiver ligada e o pedido tiver chegado com transportadora do canal, a criação do pedido para com a mensagem "Pedido não tem de/para de transportadora. No canal: '…'" — o texto entre aspas é exatamente o que você deve cadastrar em Transportadora canal. O pedido que chegou sem transportadora do canal não é barrado por essa validação.
Com essa validação desligada, o pedido é criado sem a transportadora do DE-PARA, a não ser que a parametrização Validar se pedido integrado possui armazém no de/para de transportadora esteja ligada. Nesse caso, sem DE-PARA (ou com um DE-PARA sem armazém), a criação para com "Pedido não tem armazém definido no de/para de transportadora. No canal: '…'". Veja como o sistema decide o armazém, tipo de pedido e tipo de pagamento e os demais campos do DE-PARA em DE-PARA Transportadora.
Por que os pedidos da Tiny pararam de ser importados?
A importação automática busca na Tiny os pedidos atualizados nos últimos 5 dias, respeitando os parâmetros do grupo Integração de Vendas (Importar pedidos ligado, ID pedido iniciar importação e Incluir somente pedidos com NF). Se os pedidos pararam de entrar, os casos mais comuns são:
- A Tiny recusou a conta inteira. Quando a Tiny responde com um erro que vale para a conta — como token não informado ou inválido, API ou empresa bloqueada, espaço esgotado, limite de acessos ou manutenção —, a importação daquela integração é interrompida naquela rodada. Nessa rodada também ficam de fora os pedidos que estavam pendentes de completar e a busca das notas fiscais da Tiny. Tudo é tentado de novo na rodada seguinte, sem ação sua — mas, se o problema for o Token (ver Credenciais de Acesso) ou um bloqueio na Tiny, os pedidos só voltam a entrar depois que isso for resolvido na Tiny ou na integração. Esse aviso não aparece em tela. Como cada rodada só alcança os pedidos atualizados nos últimos 5 dias, se a conta ficou parada por mais tempo que isso, os pedidos sem atualização na Tiny dentro dessa janela não entram sozinhos depois da correção.
- Um pedido específico deu erro na Tiny. Quando só um pedido não é encontrado (por exemplo, foi excluído na Tiny), ele é pulado e os demais pedidos continuam sendo importados normalmente. Já se a Tiny não responder à consulta de um pedido (falha de comunicação), os pedidos seguintes daquela página da busca ficam para a rodada seguinte.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Abrir a Configuração (engrenagem), editar nome e status e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |
As ações Sincronizar Produto e Sincronizar Saldo Estoque ficam em Integrações (HUB) → Anúncios e dependem do privilégio Sincronizar Anúncio.