Tiktok
A integração com o Tiktok 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 34 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 em Configurar parâmetros.
Categoria no catálogo do idworks: Marketplace.
Índice
Conceito
Cadastro e autenticação
Parâmetros por grupo
Erros comuns na publicação e nos pedidos
- A sincronização avisa que a atualização está desativada
- O Tiktok recusa por falta de imagem principal
- O Tiktok exige a descrição do produto
- O canal recusa com "Warehouse unavailable" ou armazém desabilitado
- O pedido pede o De-Para de transportadora
- A etiqueta gerada não é aceita na agência do Tiktok
Referência rápida
O que é a integração Tiktok?
É a conexão entre o canal Tiktok e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é Marketplace), 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 → Tiktok.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Tiktok 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 Verificar 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
2 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Código loja | Cópia | Código loja |
| Validar credenciais | Botão | Clique para validar as credenciais informadas |
Integração de Vendas
10 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Empresa Faturadora | Lista | Empresa responsável pelo faturamento dos pedidos, caso seja diferente da principal. |
| Excluir valor frete na NF para PF | Sim/Não | Ative se quiser excluir o valor do frete na Nota Fiscal quando a venda por para pessoa física (PF) |
| Importar pedidos | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no canal de vendas. |
| Incluir valor do frete | Sim/Não | Ligar/desligar inclusão de valor frete no pedido |
| Detalhar forma de pagamento | Sim/Não | Importar o detalhe da forma de pagamento utilizado pelo cliente, como cartão de crédito, boleto e etc. Exige realizar o DE/PARA de todas as formas |
| Cancelar pedido automaticamente | Sim/Não | Ative se quiser cancelar pedido automaticamente caso ele seja cancelado no canal de vendas |
| Fechar pedido automaticamente | Sim/Não | Quando marcado, o idworks fecha o pedido integrado do canal de vendas através do hub. Se desmarcado, o pedido quando integrado permanece com o status de aberto para atualização manual. |
| Incluir valor desconto Tiktok | Sim/Não | Ative se quiser que a idworks some ao pedido o valor de desconto Tiktok |
| Incluir valor taxa de processamento | Sim/Não | Ative se quiser que a idworks some ao pedido o valor da taxa de processamento. O mesmo será informado no campo de despesas acessórias |
| Distinguir pedidos amostra | Sim/Não | Ao ativar, pedidos que são amostra terão o armazém da integração incluindo o termo "_sample", onde será possível fazer um novo de/para de armazém definindo o tipo de pedido desejado |
Integração de Produtos
16 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Estoque de segurança | Inteiro | Se a quantidade de um produto estiver abaixo do valor escolhido, seu anúncio será pausado para evitar que sejam feitas vendas sem estoque. O valor de estoque mínimo é aplicado a todos os produtos. |
| Valor de ajuste no preço | Decimal | Valor em R$ fixo a ser somado ao preço por (base) para compor o preço de venda, se existir cobrança de frete |
| Valor de ajuste no preço frete grátis | Decimal | Valor em R$ fixo a ser somado ao preço por (base) para compor o preço de venda, se houver frete grátis e se o preço base for maior que a regra de frete grátis |
| Percentual de ajuste no preço | % | Valor percentual a ser somado ao preço por (base) para compor o preço de venda, se existir cobrança de frete |
| Percentual de ajuste no preço frete grátis | % | Valor percentual a ser somado ao preço por (base) para compor o preço de venda, se houver frete grátis e se o preço base for maior que a regra de frete grátis |
| Arredondamento dos centavos do preço | Decimal | Valor em centavos para arredondar o preço de venda. Preencha entre 0,01 e 0,99. |
| Atualizar saldo estoque | Sim/Não | Ative se quiser que a idworks atualize o saldo de estoque na integração. |
| Atualizar descrição | Sim/Não | Ative se quiser enviar a atualização da descrição do produto na integração |
| Atualizar Imagem | Sim/Não | Ative se quiser enviar a atualização de imagem na integração |
| Atualizar preço | Sim/Não | Ative se quiser enviar a atualização de preço na integração |
| Atualizar produto | Sim/Não | Ative se quiser enviar a atualização de produto na integração |
| Utilizar título como nome SKU | Sim/Não | Utilizar o campo título como nome do SKU ao enviar para o canal |
| 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 |
| Percentual disponibilidade de estoque | % | Valor base para utilizar do estoque em percentual. Ex. se tiver 100 unidades disponíveis e o percentual for 80% será enviado 80 para o canal |
| Atualizar status (ativo/inativo) | Sim/Não | Ative se quiser ativar/desativar o item na plataforma |
| Não enviar GTIN em KITs | Sim/Não | Ative para não enviar GTIN em variações que são KIT para o Tiktok ao sincronizar anúncio |
Importação de Anúncios
6 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 ** | Sim/Não | Só importa anúncios que ainda não estão cadastrados no sistema. |
| Incluir Imagem dentro do Anúncio | Sim/Não | Traz as imagens do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, serão utilizadas as imagens vinculadas ao cadastro do produto no momento da sincronização do anúncio e das imagens. |
| 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. |
A sincronização avisa que a atualização está desativada
Ao tentar sincronizar o anúncio aparece um aviso de que a atualização do produto está desativada nas configurações. Não é um erro do anúncio: significa que as parametrizações que autorizam o envio de dados ao canal estão desligadas.
Como resolver:
- Abra a integração em Configurações → Integrações → Minhas Integrações → Tiktok → Configurar parâmetros, grupo Integração de Produtos.
- Ative Atualizar produto e, conforme o que você quer enviar, também Atualizar preço, Atualizar Imagem, Atualizar descrição, Atualizar saldo estoque e Atualizar status (ativo/inativo).
- Salve e refaça a sincronização do anúncio.
Com a atualização desligada, o idworks até publica o anúncio, mas não envia mudanças posteriores — por isso o canal recusa a sincronização.
O Tiktok recusa por falta de imagem principal
Mensagem do tipo "precisa de uma imagem principal" ao sincronizar, mesmo com o produto tendo imagens. O Tiktok exige uma imagem principal definida no cadastro do produto — não basta haver imagens soltas dentro do anúncio. Em produtos com variações (cor, por exemplo), cada variação precisa da sua própria imagem.
Como resolver:
- Abra o produto em Produtos → Listar Produtos → editar.
- Defina a imagem principal do produto e, se houver variações, uma imagem para cada variação.
- No grupo Integração de Produtos da integração, confirme que Atualizar Imagem está ativo.
- Salve e sincronize novamente.
O Tiktok exige a descrição do produto
Mensagem "The product description is required" na sincronização, mesmo com o campo Nova Descrição preenchido na aba Anúncio. O Tiktok usa a descrição que vem do cadastro do produto, e não a da ficha do anúncio.
Como resolver:
- Abra o produto em Produtos → Listar Produtos → editar → aba Geral.
- Preencha o campo Descrição Completa.
- Salve e refaça a sincronização do anúncio.
O canal recusa com "Warehouse unavailable" ou armazém desabilitado
Mensagens como "Warehouse unavailable" ou "The warehouse ... is disabled" ao sincronizar produtos indicam que o armazém do canal (cadastrado na sua conta do Tiktok) está desativado ou ainda não foi associado a um armazém do idworks. Em alguns casos, ao montar o De-Para de armazém a opção Armazém Canal nem aparece — sinal de que a integração ainda não recebeu um armazém ativo do canal.
Como resolver:
- Na sua conta do Tiktok (painel do canal), confirme que o armazém de envio está ativo/habilitado.
- No idworks, refaça o De-Para de Armazém da integração, associando o armazém do canal ao armazém correspondente.
- Compare com uma integração da mesma conta que já funciona, para garantir que as configurações batem.
- Sincronize novamente.
O pedido pede o De-Para de transportadora
Ao integrar um pedido novo, o sistema acusa falta do De-Para de transportadora — às vezes mesmo depois de você já ter criado um. Isso acontece quando a transportadora que veio naquele pedido ainda não está mapeada: o De-Para precisa cobrir exatamente a transportadora usada pelo canal (no Tiktok, normalmente a J&T Express).
Como resolver:
- Abra o De-Para de Transportadora da integração.
- Confira se a transportadora do pedido (ex.: J&T Express) está mapeada para uma transportadora cadastrada no idworks.
- Se não estiver, crie o vínculo e reprocesse o pedido.
Cada transportadora nova que o canal passar a usar precisa do seu De-Para — por isso o erro pode voltar quando aparece uma transportadora diferente.
A etiqueta gerada não é aceita na agência do Tiktok
A etiqueta de embarque padrão do idworks não vale para postar pedidos do Tiktok: a agência não consegue bipar e o canal espera a etiqueta do próprio Tiktok (gerada pela transportadora do canal, geralmente a J&T Express). Imprimir a etiqueta padrão gera um documento diferente do que o Tiktok registrou para a coleta.
Como resolver:
- Use a etiqueta do canal: na tela Logística → Romaneio, em pedidos de canal (transportadora do tipo marketplace), clique em Etiqueta canal para gerar a etiqueta oficial em PDF.
- Em alternativa, imprima a etiqueta direto na plataforma do Tiktok.
- Não use a etiqueta de embarque padrão do idworks para a postagem na agência — ela serve apenas para conferência interna.
Se o botão Etiqueta canal avisar que a etiqueta não está disponível, confirme que o pedido já foi faturado e que a coleta foi gerada no Tiktok.
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 | Configurar parâmetros, editar nome e status, autenticar e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |