Odoo TikTok Shop Connector: Social Commerce Integration

Integrate Odoo 19 with TikTok Shop. Set up product syncing, automate order management, manage affiliates, and run live shopping from your Odoo ERP backend.

E
ECOSIRE Research and Development Team
|19 de março de 202611 min de leitura2.5k Palavras|

Conector Odoo TikTok Shop: Integração com comércio social

A TikTok Shop emergiu como a plataforma de comércio de crescimento mais rápido na década de 2020, combinando conteúdo viral com compras diretas no aplicativo. Com 150 milhões de usuários ativos mensais somente nos EUA e uma taxa de conversão que ultrapassa o comércio eletrônico tradicional, a TikTok Shop não é mais opcional para marcas de consumo que desejam capturar os gastos da Geração Z e da Geração Millennial.

Ao contrário dos mercados tradicionais onde os compradores procuram produtos, a TikTok Shop incorpora o comércio em conteúdo de vídeo, transmissões ao vivo e promoções de criadores afiliados. Gerenciar isso junto com suas operações Odoo existentes requer integração específica.

O ECOSIRE Odoo TikTok Shop Connector sincroniza sua loja TikTok com o Odoo 19 Enterprise, gerenciando catálogo de produtos, gerenciamento de pedidos, sincronização de estoque, rastreamento de afiliados de criadores e gerenciamento de sessões de compras ao vivo.

Principais conclusões

  • Connector usa TikTok Shop API com autorização OAuth 2.0
  • O catálogo de produtos é sincronizado bidirecionalmente: produtos Odoo publicados na TikTok Shop
  • Pedidos de vídeos da TikTok Shop, transmissões ao vivo e a guia Loja, todos importados para o Odoo
  • As comissões dos criadores afiliados são rastreadas e reconciliadas no Odoo
  • Sessões de compras ao vivo podem ser coordenadas com reserva flash de inventário Odoo
  • A janela de devolução da TikTok Shop (30 dias) integra-se ao fluxo de trabalho Odoo RMA
  • Suporte multimercado: lojas dos EUA, Reino Unido, Sudeste Asiático e Oriente Médio
  • As taxas da Loja TikTok (referência, cumprimento, transação) são reconciliadas automaticamente

Visão geral da loja TikTok para vendedores

A TikTok Shop tem três superfícies de vendas principais:

  1. Guia Loja: uma seção de compras dedicada no aplicativo TikTok onde os usuários procuram produtos
  2. Vídeo In-Feed: produtos marcados em vídeos orgânicos que aparecem na página Para você
  3. Compras AO VIVO: compras em tempo real durante transmissões de vídeo ao vivo com sobreposição de carrinho de compras

Cada superfície gera pedidos que fluem através do sistema unificado de gerenciamento de pedidos da TikTok Shop e chegam ao Odoo por meio do conector.

Por que a TikTok Shop é um desafio operacional sem integração com ERP:

  • Sessões de compras ao vivo podem gerar centenas de pedidos em minutos
  • Os programas de afiliados para criadores exigem o rastreamento da responsabilidade de comissões em milhares de SKUs
  • As devoluções são comuns (categorias moda, beleza) e exigem fluxo de trabalho estruturado
  • A precisão do inventário é crítica durante eventos ao vivo para evitar vendas excessivas
  • A reconciliação financeira entre taxas da Loja TikTok, comissões de afiliados e gastos com publicidade é complexa

Configuração da API da loja TikTok

Etapa 1: inscreva-se no TikTok Shop Seller Center

  1. Vá para seller.tiktokglobalshop.com
  2. Registre sua empresa (vendedores dos EUA: EIN obrigatório)
  3. Envie aprovação de categoria de produto
  4. Aguarde aprovação (1 a 5 dias úteis para vendedores nos EUA)

Etapa 2: Crie um aplicativo TikTok Shop

  1. Vá para partner.tiktokshop.com → Desenvolver → Criar aplicativo
  2. Selecione Fornecedor de tecnologia ou Desenvolvimento próprio com base na sua situação
  3. Configure as permissões do aplicativo:
  • Leitura/gravação do produto
  • Solicitar leitura/gravação
  • Leitura/gravação de inventário
  • Leitura/gravação de logística
  • Leitura / gravação de afiliados
  • Leitura de finanças
  1. Adicione URI de redirecionamento: https://your-odoo.com/tiktokshop/oauth/callback
  2. Envie para análise do TikTok (2 a 5 dias úteis)

Etapa 3: autorize sua conta de vendedor

Após a aprovação do aplicativo:

  1. Nas configurações do conector Odoo, clique em Conectar Loja TikTok
  2. Conclua o fluxo OAuth no pop-up da TikTok Shop
  3. Token de acesso e token de atualização armazenados automaticamente

Configuração do conector

Navegue até Vendas → Loja TikTok ou Inventário → Loja TikTok após a instalação.

Configuração da loja:

CampoDescrição
Nome da lojaNome de exibição da sua loja TikTok
RegiãoEUA, GB, ID, TH, etc.
Chave do aplicativoDo Portal de Parceiros
Segredo do aplicativoDo Portal de Parceiros
Token de acessoPreenchido automaticamente
Atualizar tokenPreenchido automaticamente
ArmazémArmazém de atendimento padrão
Diário de pagamentosPagamentos da Loja TikTok
Diário de afiliadosComissões de afiliados a pagar
Prefixo do pedidopor exemplo, "TT-"
Frequência de sincronização5-30 minutos

Configurações de eventos ao vivo:

CampoDescrição
Buffer de reserva ao vivoEstoque extra reservado durante sessões ao vivo (%)
Bloqueio de estoque de venda relâmpagoImpedir que outros canais utilizem estoque durante a live
Atraso de lançamento pós-ao vivoMinutos antes da liberação do estoque reservado

Gerenciamento de catálogo de produtos

Publicação de produtos na Loja TikTok:

A TikTok Shop usa sua própria taxonomia de produtos. O conector mapeia os atributos do produto Odoo para os campos obrigatórios da TikTok Shop:

Campo OdooCampo da loja TikTok
Nome do produtoTítulo (máximo 255 caracteres)
Descrição de VendasDescrição
Imagens do produtoImagem principal + até 8 imagens adicionais
Vídeo (campo)Vídeo do produto (até 60 segundos)
Preço de tabelaPreço de varejo
Preço de vendaPreço de venda
PesoPeso do pacote
Código de barras (EAN/UPC)Identificador do Produto
Categoria de produtoCategoria TikTok
MarcaMarca
Quantidade de estoqueQuantidade disponível

Conformidade com a categoria:

A TikTok Shop restringiu categorias que exigem documentação adicional:

  • Alimentos e Bebidas: registro FDA
  • Saúde e Beleza: divulgação de ingredientes Eletrônicos: certificação FCC
  • Produtos infantis: documentos de conformidade CPSC

O conector inclui uma lista de verificação de conformidade por categoria.

Integração de vídeo do produto:

A TikTok Shop favorece fortemente produtos com conteúdo de vídeo nativo. O conector suporta:

  • Vincular um produto Odoo a um URL de vídeo TikTok existente
  • Upload de vídeos de produtos diretamente do Odoo (até 60 MB, MP4/MOV)
  • Acompanhamento de visualizações de vídeo e estatísticas de engajamento em registros de produtos Odoo

Produtos variantes:

A TikTok Shop suporta até 3 dimensões de variação (por exemplo, Cor, Tamanho, Material). O conector mapeia os atributos do produto Odoo diretamente:

  • Atributo Odoo "Cor" → Variação 1 do TikTok
  • Atributo Odoo "Tamanho" → Variação 2 do TikTok
  • Cada variante tem seu próprio preço e estoque em ambos os sistemas

Gerenciamento de pedidos

Ordem de origem e importação:

O conector importa pedidos de todas as superfícies da TikTok Shop com marcação de origem:

Etiqueta de origemOrigem
CÓDIGO0Comprado na guia Loja
CÓDIGO0Comprado via vídeo marcado
CÓDIGO0Comprado durante transmissão AO VIVO
CÓDIGO0Comprado através do link do criador afiliado

SLA de processamento de pedidos:

A Loja TikTok requer:

  • Início do processamento do pedido: dentro de 24 horas
  • Envio: dentro do prazo de manuseio definido (1-3 dias)
  • Atraso na remessa penaliza a pontuação do vendedor

O conector confirma automaticamente os pedidos imediatamente na importação para atender aos requisitos de processamento do SLA.

Tratamento de pedidos ao vivo em alta velocidade:

Durante eventos de compras ao vivo, o volume de pedidos pode aumentar drasticamente. O conector lida com isso por meio de:

  • Importação de pedidos em lote (processa mais de 100 pedidos por ciclo de sincronização)
  • Atribuição automática a filas de picking no Odoo WMS
  • Modo de evento ao vivo: suspende alocações de inventário não ao vivo durante o evento
  • Reconciliação pós-evento: libera reservas e sincroniza o inventário final

Mapeamento de dados do pedido:

Campo TikTokCampo Odoo
Nome do compradorNome do cliente
Endereço de entregaEndereço de entrega
ID do pacoteReferência do pacote
SKU do criadorProduto e variante
QuantidadeQuantidade da linha do pedido
Preço unitárioPreço de venda
Desconto na plataformaLinha de desconto
Cupom de vendedorLinha de desconto
Taxa de envioLinha de taxa de entrega
ID do pedido TikTokReferência (com prefixo)

Gerenciamento de criadores afiliados

O programa de afiliados da TikTok Shop é um fator central de crescimento. Os criadores divulgam seus produtos em vídeos e lives; você paga comissão quando as vendas são feitas por meio de seus links.

Acompanhamento de comissões de afiliados no Odoo:

  1. O conector importa atribuição de venda de afiliado da TikTok Shop
  2. Cada pedido marcado com um afiliado inclui o ID do criador
  3. A responsabilidade da comissão é calculada: Comissão = Valor da Venda × Taxa de Comissão
  4. As comissões acumuladas aparecem no livro Comissões de afiliados a pagar
  5. Quando o TikTok deduz comissões do seu pagamento, o conector reconcilia isso

Painel de desempenho do criador:

Navegue até TikTok Shop → Afiliados → Desempenho:

  • Principais criadores por GMV gerados
  • Responsabilidade da comissão pelo criador (período atual)
  • Comparação de vídeo vs. desempenho ao vivo
  • Taxa de retorno por criador (altos retornos podem indicar promoções enganosas)

Definindo taxas de comissão:

Configure taxas de comissão por produto ou categoria de produto:

  • Taxa básica de comissão: 5-20% típica para TikTok Shop
  • Taxa aumentada para criadores específicos (gerenciar via TikTok Affiliate Manager)
  • O conector lê as taxas de comissão da API TikTok Shop e as armazena por produto

Gerenciamento de estoque para eventos ao vivo

As compras ao vivo exigem muito dos sistemas de estoque. Uma sessão ao vivo de 15 minutos pode vender 500 unidades de um único SKU.

Configuração de inventário pré-ativação:

  1. No Odoo, crie um registro de Evento ao vivo com data, hora e SKUs planejados
  2. Defina Quantidade em destaque por SKU (a quantidade que você planeja vender durante a transmissão ao vivo)
  3. O conector cria uma reserva ativa no inventário Odoo para essas quantidades
  4. Isso evita que outros canais (site, outros marketplaces) vendam o estoque reservado
  5. Informe sua equipe de armazém sobre como priorizar a coleta pós-produção

Durante a live:

  • O conector pesquisa os pedidos da TikTok Shop a cada 2 minutos durante eventos ao vivo (reduzido do padrão de 10 a 15 minutos)
  • Contagem regressiva de inventário em tempo real visível no painel de eventos ao vivo do Odoo
  • O alerta é acionado quando o estoque restante cai abaixo do limite configurado (por exemplo, últimas 20 unidades)

Pós-live:

  • Reserva liberada para estoque restante não vendido
  • Todos os pedidos em tempo real atribuídos em lote às ondas de seleção
  • Relatório de venda flash gerado: unidades vendidas, receita, obrigação de comissão, margem líquida

Reconciliação Financeira

Estrutura de taxas da Loja TikTok:

Tipo de taxaTaxaQuando carregado
Taxa de referência2-8% (dependendo da categoria)Por venda
Taxa de transação2%Por transação
Subsídio de plataformaNegativo (subsídios do TikTok)Durante as promoções da plataforma
Comissão de Afiliados5-20%Quando a venda do afiliado foi feita
Taxa de cumprimento (envio TikTok)Dependente da operadoraSe estiver usando o envio TikTok

Fluxo de trabalho de reconciliação:

  1. Importe o relatório de liquidação da Loja TikTok (semanalmente)
  2. O Connector cria lançamentos contábeis manuais por categoria de taxa
  3. Pagamento líquido reconciliado com o diário do banco TikTok Shop da Odoo
  4. Comissões de afiliados lançadas na conta de passivo (já acumuladas por pedido)

Perguntas frequentes

O conector pode gerenciar sessões de compras do TikTok Shop LIVE no Odoo?

O conector oferece suporte à reserva de inventário pré-ativa e à importação de lotes de pedidos pós-ativação. O gerenciamento da transmissão ao vivo (transmitir ao vivo, interagir com os espectadores, gerenciar a vitrine do produto durante a transmissão) acontece no Estúdio de Criação ou na Central do Vendedor do TikTok. O conector lida com o back-end operacional, não com a interface de streaming.

Como o conector lida com as promoções e descontos frequentes da plataforma TikTok Shop?

A TikTok Shop realiza regularmente promoções em toda a plataforma onde a TikTok subsidia descontos (por exemplo, eventos "Double 11"). O conector importa esses pedidos subsidiados ao preço de finalização da compra do comprador e registra o subsídio da TikTok como um item de linha separado. Sua receita é o preço total; o crédito de subsídio aparece na reconciliação.

Qual é a taxa de retorno da Loja TikTok e como o conector ajuda a gerenciá-la?

Os produtos de moda e beleza na TikTok Shop têm taxas de retorno de 15-30% (maiores do que os mercados tradicionais devido à compra por impulso). O fluxo de trabalho de RMA do conector, o rastreamento do motivo da devolução e os relatórios de taxa de devolução no nível do criador ajudam a identificar quais criadores ou produtos geram retornos desproporcionais, permitindo que você ajuste os acordos de afiliados ou as descrições dos produtos de acordo.

O conector suporta a TikTok Shop nos mercados do Sudeste Asiático (Indonésia, Tailândia, Vietnã)?

Sim. O conector oferece suporte à API TikTok Shop em todos os mercados disponíveis: EUA, Reino Unido, Indonésia, Tailândia, Vietnã, Filipinas, Malásia e Cingapura. Cada mercado exige uma conta de vendedor separada e credenciais de API regionais. Odoo lida automaticamente com pedidos em várias moedas de cada mercado.

Posso definir preços diferentes para a Loja TikTok e para meus outros canais de vendas?

Sim. O conector oferece suporte a preços específicos da TikTok Shop, separados da lista de preços padrão do Odoo. Configure uma "Lista de preços da loja TikTok" no Odoo e atribua-a ao conector. Isso é comumente usado para oferecer descontos exclusivos ao vivo (por exemplo, 15% de desconto durante o AO VIVO), mantendo preços regulares em outros canais.


Próximas etapas

A velocidade da TikTok Shop exige sistemas operacionais que possam escalar sem quebrar. O ECOSIRE TikTok Shop Connector traz a disciplina operacional do Odoo 19 Enterprise para a plataforma de comércio mais dinâmica desta década.

Obtenha o conector ECOSIRE TikTok Shop para Odoo 19 →

Nossa equipe de implementação é especializada em operações de comércio ao vivo e ajudará você a configurar buffers de estoque, fluxos de trabalho de eventos ao vivo e reconciliação de afiliados para que sua loja TikTok funcione perfeitamente em escala.

E

Escrito por

ECOSIRE Research and Development Team

Construindo produtos digitais de nível empresarial na ECOSIRE. Compartilhando insights sobre integrações Odoo, automação de e-commerce e soluções de negócios com IA.

Converse no WhatsApp