Conectar o TikTok Shop: receber pedidos e enviar fulfillment
Copie sua App Key e App Secret do TikTok Shop Partner Center, autorize sua loja para obter um token de acesso, cole tudo no Integration, teste, mapeie e ative.
O conector do TikTok Shop traz pedidos da sua loja do TikTok Shop para o OMS e devolve fulfillment ao TikTok Shop. Também pode enviar produtos e estoque, para que anúncios, estoque e envios fiquem sincronizados nos dois lados. Uma conexão cobre uma loja autorizada.
Pré-requisitos#
- Uma conta de vendedor do TikTok Shop com uma loja que você possa autorizar para esta conexão.
- Acesso ao TikTok Shop Partner Center, com permissão para abrir a gestão de aplicativos e copiar a App Key e o App Secret.
- Se for sincronizar estoque, o ID do armazém do TikTok Shop que deve receber os envios de estoque: você o copia em Partner Center → Logística → Armazéns. Sem ele, os envios de estoque são rejeitados.
Obter credenciais#
- Vá ao TikTok Shop Partner Center → Gestão de aplicativos e copie a App Key.
- Na mesma página, copie o App Secret. Guarde-o em local seguro de imediato: não cole a App Key no campo App Secret, nem o contrário.
- Autorize a loja que você quer conectar e obtenha o token de acesso dessa loja. O token pertence à loja autorizada: se depois autorizar outra loja, obtenha um token novo para essa loja.
- Somente se for sincronizar estoque: vá a Partner Center → Logística → Armazéns e copie o ID do armazém que deve receber os envios de estoque.
Preencher no Integration#
- Abra Integration → Marketplace → TikTok Shop → Nova conexão.
- App Key, obrigatório: cole a App Key copiada do TikTok Shop Partner Center → Gestão de aplicativos.
- App Secret, obrigatório: cole o App Secret da mesma página. É um campo secreto: criptografado em repouso e nunca exibido.
- Token de acesso: cole o token de acesso obtido após autorizar a loja. É um campo secreto: criptografado em repouso e nunca exibido. Se o token expirar, autorize a loja novamente e cole o novo token aqui.
- ID do armazém, opcional para pedidos e obrigatório para sincronizar estoque: cole o ID copiado de Partner Center → Logística → Armazéns. Os envios de estoque vão para este armazém; sem ele, são rejeitados para não gravar o estoque no armazém errado.
Testar a conexão#
Clique em Testar a conexão. O teste verifica a App Key, o App Secret e o token de acesso no TikTok Shop para a loja autorizada: se passar, as credenciais e a autorização coincidem. Se falhar, anote o erro e veja a FAQ antes de mudar outra coisa.
Mapping / escolher modelo#
Escolha o modelo padrão do TikTok Shop. Ele mapeia número do pedido, SKUs das linhas, quantidades, endereço de entrega e status de fulfillment entre o TikTok Shop e o pedido padrão. Revise a prévia com um pedido real antes de ativar, sobretudo se cada SKU do TikTok Shop está vinculado ao produto OMS correto, porque produtos e estoque voltam pelo mesmo vínculo.
Ativar#
Após ativar, o Integration traz pedidos novos na frequência definida e devolve fulfillment com códigos de rastreio, além de atualizações de produto e estoque, ao TikTok Shop. Acompanhe os primeiros pedidos em Runs / Logs.
Perguntas frequentes#
O teste falha: App Key ou App Secret incorretos
O TikTok Shop rejeitou as credenciais do app. As causas mais comuns são App Key e App Secret trocados, ou um deles copiado incompleto ou com espaço extra, e o par não coincidir com o app do Partner Center.
Volte ao TikTok Shop Partner Center → Gestão de aplicativos, copie a App Key no campo App Key e o App Secret no campo App Secret exatamente como exibidos, salve e teste de novo.
Funcionava antes e agora o teste falha ou a sincronização para
O token de acesso expirou. O token é emitido quando você autoriza a loja e não fica válido para sempre, então as chamadas dessa loja são rejeitadas quando ele vence.
Autorize a mesma loja novamente para obter um novo token de acesso, cole o novo token no campo Token de acesso, salve e teste de novo. Não reutilize o token antigo.
Pedidos ou estoque vão para a loja ou armazém errado
Um identificador de loja ou armazém não coincide com a loja autorizada: o token de acesso foi obtido autorizando outra loja, ou o ID do armazém foi copiado de outro armazém, e o TikTok Shop não consegue associar os dados à loja ou armazém correto; os envios de estoque podem ser rejeitados.
Verifique o par em conjunto: autorize novamente a loja que você realmente quer conectar e cole o novo token dela, e copie de novo o ID do armazém em Partner Center → Logística → Armazéns para essa mesma loja. Salve e teste de novo, depois execute uma extração ou um envio de estoque e confirme que cai na loja e no armazém corretos.
Conectado, mas nenhum pedido é importado
A conexão está bem — o teste passa — mas a loja autorizada do TikTok Shop ainda não tem pedidos novos, então não há nada para trazer.
Faça um pedido de teste nessa loja do TikTok Shop (ou aguarde o próximo pedido de cliente), depois execute uma extração manual e veja Runs / Logs. Pedidos novos aparecem assim que o TikTok Shop os emite.