# Conector TikTok Shop e Catálogo Pinterest: instalação e configuração > Apresentação O módulo liga a sua loja PrestaShop 8 ou 9 a dois canais: TikTok Shop: criação e atualização de anúncios pela API Partner, envio de stock e preços, importação… - Página: - Idioma: pt - Atualizado em: 2026-09-24 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dftiktokpinterest/index.md), [en](https://www.datafirefly.com/en/documentation/dftiktokpinterest/index.md), [es](https://www.datafirefly.com/es/documentation/dftiktokpinterest/index.md), [de](https://www.datafirefly.com/de/documentation/dftiktokpinterest/index.md), [it](https://www.datafirefly.com/it/documentation/dftiktokpinterest/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftiktokpinterest/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftiktokpinterest/index.md) - Índice: ## Apresentação O módulo liga a sua loja PrestaShop 8 ou 9 a dois canais: - **TikTok Shop**: criação e atualização de anúncios pela API Partner, envio de stock e preços, importação de encomendas e envio dos números de seguimento. - **Pinterest**: feed de catálogo TSV e, opcionalmente, atualizações em tempo real pela API Catalogs. Inclui também um feed CSV para catálogos TikTok Ads. O módulo está em **Catálogo > TikTok & Pinterest**. O separador _Visão geral_ mostra uma lista de arranque com os passos em falta. ## Instalação 1. Em **Módulos > Gestor de módulos**, clique em _Carregar um módulo_ e escolha o ficheiro ZIP. 2. Abra **Catálogo > TikTok & Pinterest**. 3. No separador _Definições_, verifique o idioma, a moeda e o país usados para os preços (enviados com IVA desse país) e o tamanho de imagem. O TikTok Shop exige pelo menos 600 x 600 píxeis. Em multiloja, selecione uma loja no seletor de contexto: as definições dos canais são guardadas por loja. ## Pinterest ### Só o feed, sem app 1. Separador _Pinterest_: ative o Pinterest e copie o URL do feed. 2. No Pinterest Business Hub, abra **Catálogos > Origens de dados**, adicione uma origem e cole o URL. O Pinterest importa o feed a cada 24 horas. ### Atualizações em tempo real pela API 1. Em [developers.pinterest.com](https://developers.pinterest.com/), crie uma app e adicione o URI de redirecionamento mostrado no separador Pinterest do módulo. 2. Introduza o App ID e o App secret, deixe _Atualizações em tempo real_ em Sim e clique em _Guardar e ligar o Pinterest_. 3. Depois de ligado, clique em _Criar a origem de dados no Pinterest_: o módulo regista o feed com a moeda e o país das definições. As alterações de stock, preço e remoções seguem então em poucos minutos. Dois minutos após cada envio, o módulo lê o resultado do Pinterest. Um artigo rejeitado fica com erro no separador _Produtos_ com a mensagem do Pinterest. ## TikTok Shop ### Criar a app TikTok Shop 1. Em [partner.tiktokshop.com](https://partner.tiktokshop.com/), crie uma app de vendedor personalizada ou de serviço de terceiros. 2. Ative os scopes **Product**, **Order**, **Fulfillment** e **Logistics**. 3. Defina como URL de redirecionamento o que aparece no separador _TikTok Shop_ do módulo. 4. Copie o App key, o App secret e, se a app o tiver, o Service ID. ### Ligar a loja 1. Separador _TikTok Shop_: ative o TikTok, escolha a região (Europa e resto do mundo, ou Estados Unidos), introduza as credenciais e clique em _Guardar e ligar o TikTok Shop_. 2. Autorize a app na página do TikTok. O módulo obtém a loja e o armazém predefinido. 3. Escolha o armazém, se tiver vários, e depois o fabricante e a pessoa responsável para a UE. Se as listas estiverem vazias, crie-os primeiro no Seller Center e clique em _Atualizar listas_. 4. Clique em _Carregar categorias_ para obter a árvore de categorias TikTok. ### Definições dos anúncios - **Preço enviado**: após os descontos PrestaShop, ou preço normal se gerir as promoções no TikTok. - **Encomenda predefinida**: peso e dimensões para os produtos que não os têm. - **Criar novos anúncios**: desativado, o módulo só atualiza o stock e o preço dos anúncios já publicados. ## Anúncios já existentes no TikTok Shop Se já vende no TikTok Shop, execute _Ligar os anúncios existentes_ no separador TikTok Shop **antes da primeira sincronização**. O módulo liga os anúncios aos seus produtos pelo SKU de vendedor: - referência da combinação; - referência do produto, para um produto sem combinações; - formato PS12 ou PS12-34 usado pelo módulo. Um anúncio ligado mantém o título, as imagens e a descrição do TikTok: o módulo só gere o stock e o preço. Para lhe aplicar o conteúdo PrestaShop, abra a pré-visualização do produto no separador Produtos e clique em _Substituir o conteúdo pelos dados do PrestaShop_. Um anúncio cujos SKU apontam para vários produtos é assinalado como conflito e não é ligado. ## Associação de categorias O separador _Categorias_ associa cada categoria PrestaShop a: - uma **categoria Google**, usada pelo Pinterest e pelo feed TikTok Ads: escreva algumas palavras e escolha na taxonomia Google integrada; - uma **categoria TikTok Shop**: escreva para pesquisar, ou clique em _Sugerir_ para o TikTok propor uma com base nos seus produtos. Uma subcategoria sem associação própria herda a da categoria-mãe, mostrada a cinzento. Os produtos usam a sua categoria predefinida. As alterações guardam-se em conjunto com _Guardar alterações_. O botão _Atributos_ abre os atributos da categoria TikTok. Os marcados com asterisco são obrigatórios e aplicam-se a todos os produtos da categoria. A associação exporta-se e importa-se em CSV (separador ponto e vírgula). ## Encomendas TikTok O separador _Encomendas TikTok_ evita vender em excesso: sem importação, uma venda no TikTok só baixa o stock no TikTok. Há três modos: - **Criar encomendas PrestaShop**: cada venda torna-se uma encomenda ao preço pago no TikTok (desconto do vendedor deduzido) e com os portes do TikTok. O IVA é calculado pelo PrestaShop e o stock baixa. O pagamento aparece como «TikTok Shop», com o número da encomenda TikTok como transação. - **Apenas descontar stock**: para encomendas enviadas a partir do Seller Center ou pelo TikTok. - **Desativado**. As encomendas são importadas pela tarefa cron. Ao ativar, são recuperadas as das últimas 24 horas. Escolha o estado das novas encomendas e a transportadora. Os portes continuam a ser os pagos no TikTok, seja qual for a transportadora. - **Cancelamentos**: um cancelamento no TikTok passa a encomenda a «Cancelada», ou repõe o stock no modo só stock. - **Erros**: uma encomenda com erro (SKU não ligado, moeda não ativa) aparece com o motivo e é repetida a cada 15 minutos. O botão _Repetir_ tenta novamente na próxima importação. - **Compradores**: são criados como clientes convidados com uma morada @tiktokshop.invalid. O TikTok proíbe contactá-los fora da plataforma, por isso o módulo bloqueia qualquer e-mail dirigido a eles. A ficha da encomenda PrestaShop mostra um bloco TikTok Shop com o número TikTok, o estado e o seguimento. ## Números de seguimento Quando um número de seguimento é adicionado a uma encomenda importada, à mão ou por um módulo de transportadora, é enviado ao TikTok em 5 minutos e a encomenda TikTok fica marcada como enviada. As encomendas processadas pelo TikTok são ignoradas. O TikTok exige um fornecedor de envio. No separador TikTok Shop, secção _Transportadoras e fornecedores de envio TikTok_, associe cada transportadora a um fornecedor TikTok. Sem associação, o módulo procura um fornecedor com o mesmo nome. Se não encontrar, o erro lista os fornecedores disponíveis. ## Separador Produtos Cada linha mostra miniatura, preço, stock, estado em cada canal e uma pontuação de qualidade sobre 100 com o principal problema. As causas possíveis são: - imagem em falta, preço zero ou descrição curta; - EAN inválido; - categoria não associada; - mais de 3 grupos de atributos para o TikTok. Os filtros mostram produtos com erro, excluídos, sem categoria Google ou TikTok, ou ligados a partir do Seller Center. Selecione produtos para os exportar ou excluir em massa, ou para colocar uma sincronização completa na fila. A pré-visualização mostra as variantes tal como serão enviadas e permite um título por canal. _Sincronizar agora_ envia o produto de imediato. ## Definições avançadas - **Parâmetros UTM**: adicionados às ligações dos feeds e dos pins do Pinterest para a atribuição no Google Analytics. Deixe vazio para desativar. - **Etiquetas personalizadas**: custom_label_0 = categoria, custom_label_1 = escalão de preço, custom_label_2 = promoção ou normal. - **Regras de exclusão**: categorias (com subcategorias), marcas, preço mínimo com IVA, e variantes sem stock retiradas dos feeds e do Pinterest. Um produto excluído sai dos feeds, é eliminado do Pinterest e desativado no TikTok Shop. Alterar uma regra volta a pôr todo o catálogo na fila. - **Momento do envio**: logo após cada alteração (alojamento PHP-FPM ou LiteSpeed), ou apenas por cron. ## Tarefa cron Copie as duas linhas do separador _Visão geral_ para a crontab do seu alojamento: - a cada 5 minutos, `task=sync`: fila, novas tentativas, encomendas TikTok, seguimento, resultados Pinterest; - a cada hora, `task=feeds`: regeneração dos feeds. A visão geral indica se o cron foi visto nos últimos 20 minutos. Um erro da API é repetido ao fim de 2, 4, 8, 16 e 32 minutos. O token de segurança protege os URL dos feeds e do cron. Se o regenerar, atualize a crontab e os URL de feed registados no Pinterest e no TikTok. ## Registos e resolução de problemas O separador _Registos_ guarda 30 dias de eventos, filtráveis por canal: Pinterest, TikTok, encomendas TikTok. Os erros da API ficam guardados com a resposta completa. - **Um produto não segue para o TikTok**: verifique a pontuação no separador Produtos. Uma categoria TikTok em falta ou um produto virtual bloqueiam o envio. - **Uma encomenda TikTok continua com erro**: o SKU de vendedor tem de corresponder a uma referência PrestaShop, ou o anúncio tem de ter sido criado pelo módulo. Corrija e clique em _Repetir_. - **As alterações de um funcionário não seguem**: o PrestaShop não executa os hooks de um módulo para um perfil sem permissão «Ver» nesse módulo. Dê essa permissão, ou use _Sincronizar agora_ no separador Produtos.