1. Fórum
  3. Integrações
  5. bling
  7. Manual Cliente Tik Tok Shop

Perguntas Manual Cliente Tik Tok Shop

Mais
2 semanas 5 dias atrás #166 por igornunes
Manual Cliente Tik Tok Shop foi criado por igornunes
Manual do Cliente — Integração Panza, Bling e TikTok Shop1. Visão geral da integraçãoO Panza não se conecta diretamente ao TikTok Shop. O Bling atua como intermediário entre os sistemas.
SFI/Panza → Bling → TikTok Shop
TikTok Shop → Bling → SFI/Panza
O fluxo funciona da seguinte forma:
  • O Panza envia categorias, produtos e estoque para o Bling.
  • O Bling, de acordo com as integrações e regras configuradas, publica ou atualiza essas informações no TikTok Shop.
  • Os pedidos realizados no TikTok Shop precisam chegar primeiro ao Bling.
  • Depois disso, o Panza consulta os pedidos no Bling e realiza a inclusão no SFI.
2. Pré-requisitosAntes de iniciar a configuração, confirme que você possui:
  • Acesso à conta correta do Bling e à loja correta no TikTok Shop;
  • Integração com o TikTok Shop já conectada dentro do Bling;
  • Produtos cadastrados no SFI, com seus respectivos códigos;
  • Depósito e regras de estoque configurados no Bling para a loja TikTok;
  • Credenciais do aplicativo Bling (
    client_id
    e
    client_secret
    ) fornecidas pela implantação do Panza;
  • Acesso ao computador onde o Panza está instalado;
  • Acesso à conta Bling que será utilizada na autorização.

Importante: nunca envie ao suporte senhas,

client_secret
,
access_token
,
refresh_token
ou códigos de autorização.

3. Configurar o TikTok Shop no Bling
  1. Acesse o Bling utilizando a conta da empresa.
  2. Conecte a integração com o TikTok Shop disponível no Bling.
  3. Quando solicitado, entre na loja TikTok correta.
  4. Configure e salve as regras necessárias para:
    • Produtos;
    • Pedidos;
    • Estoque;
    • Depósito;
    • Publicação.
O Panza não cria a integração com o TikTok Shop e não envia credenciais do TikTok.Requisitos relacionados a:
  • Categorias;
  • Publicação;
  • Logística;
  • Aprovações;
  • Configurações do canal;
devem ser tratados diretamente no TikTok Shop e no Bling.4. Configurar o Bling no PanzaNa configuração do Panza, selecione a integração Bling e informe as credenciais fornecidas pela implantação.As duas URLs utilizadas pela integração devem apontar para:
https://api.bling.com.br/Api/v3
Também devem ser configurados, juntamente com a implantação:
  • Tabela de preço;
  • Conta de estoque;
  • Regra de saldo;
  • Transação;
  • Condição de pagamento;
  • Vendedor;
  • Demais regras necessárias no SFI;
  • Grupo de pagamento para novos clientes, quando utilizado;
  • Formas de pagamento em
    Panza.OpFinanceiras
    .
Ordem de envioQuando existirem categorias novas ou alteradas, envie as categorias antes dos produtos.Isso é necessário para que o produto possa ser corretamente associado à categoria correspondente no Bling.5. Autorizar o Panza na conta BlingApós salvar a configuração, o Panza disponibilizará a autorização OAuth do Bling.Siga os passos abaixo:
  1. No Panza, escolha a opção para executar a autorização.
  2. O navegador será aberto na página de autorização do Bling.
  3. Entre na conta correta.
  4. Aprove o acesso solicitado pelo aplicativo.
  5. Ao concluir, o Bling abrirá a página de retorno configurada e apresentará um código.
  6. Copie o código ou a URL completa de retorno.
  7. Cole essa informação no Panza logo em seguida.
  8. Aguarde a mensagem indicando a conclusão da autorização.
Após a autorização inicial, o Panza passa a renovar o acesso automaticamente.Quando é necessário autorizar novamente?Uma nova autorização será necessária caso:
  • O aplicativo seja removido da conta Bling;
  • A renovação automática falhe;
  • O acesso seja revogado;
  • Os escopos ou permissões do aplicativo sejam alterados.

Atenção: ao alterar o escopo do aplicativo Bling, os tokens existentes são revogados. Nesse caso, uma nova autorização é obrigatória antes de utilizar novamente a integração.

6. Configurar formas de pagamentoCada forma de pagamento que pode aparecer nos pedidos do Bling deve possuir um mapeamento em:
Panza.OpFinanceiras
O formato utilizado é:
Boleto=BO
Cartão de Crédito=CC
Regras do mapeamentoO texto à esquerda deve ser exatamente igual ao texto retornado pelo Bling, incluindo:
  • Acentos;
  • Espaços;
  • Palavras;
  • Capitalização, quando aplicável.
Por exemplo, se o Bling retornar:
Boleto Bancário
o cadastro deverá ser:
Boleto Bancário=BO
e não:
Boleto=BO
Forma de pagamento não reconhecidaSe um pedido apresentar erro por forma de pagamento não mapeada:
  1. Realize um pedido de teste.
  2. Consulte o log da integração.
  3. Localize uma mensagem semelhante a:
Bling: forma de pagamento não mapeada em OpFinanceiras
(id: ...; descrição: ...)
  1. Copie exatamente a descrição informada no log.
  2. Cadastre essa descrição em
    OpFinanceiras
    .
  3. Salve a configuração.
  4. Repita o teste.

O código interno informado à direita do

=
possui no máximo dois caracteres.

A condição de pagamento utilizada no pedido é aquela configurada no Panza. Ela não é recalculada automaticamente com base nas parcelas retornadas pelo Bling.7. Produtos — sequência obrigatóriaApós configurar a integração com o Bling, utilize a seguinte sequência para os produtos:
Cadastrar produto no SFI
        ↓
Enviar categoria ao Bling, quando necessário
        ↓
Enviar produto ao Bling
        ↓
Cadastrar imagem no Bling
        ↓
Concluir configuração/publicação no TikTok Shop
Procedimento
  1. Cadastre o produto no SFI, informando:
    • Código;
    • Descrição;
    • Preço;
    • Peso;
    • Categoria.
  2. Caso a categoria ainda não exista no Bling, envie-a primeiro.
  3. Envie o produto do SFI para o Bling.
  4. Abra o produto no Bling e confira:
    • Código/SKU;
    • Preço;
    • Categoria;
    • Estoque.
  5. Cadastre a imagem do produto diretamente no Bling.
  6. Dentro do Bling, conclua:
    • Vínculos necessários;
    • Informações obrigatórias da integração com TikTok Shop;
    • Publicação ou sincronização do produto no canal.
Limitação atual de imagens

Limitação atual: a imagem do produto não está sendo enviada corretamente do SFI para o Bling.

Por esse motivo, atualmente o cliente precisa cadastrar a imagem diretamente no Bling antes de continuar o processo de publicação no TikTok Shop.Cuidados com SKU e variaçõesNão altere SKUs sem antes planejar a alteração nos três sistemas:
  • SFI;
  • Bling;
  • TikTok Shop.
O fluxo atual do Panza trabalha com produtos simples. O envio de variações de produtos não é suportado atualmente.8. EstoqueApós enviar ou atualizar um produto, o Panza envia um balanço de estoque para o Bling.Isso significa que o Panza informa o saldo absoluto calculado no SFI, e não uma movimentação incremental de entrada ou saída.Antes de realizar transmissões em massa, confira:
  • A conta de estoque configurada;
  • A tabela de preços;
  • O depósito utilizado;
  • As regras de estoque do canal.
No Bling, confirme também que:
  • O depósito utilizado está corretamente vinculado ao TikTok Shop;
  • A atualização de estoque para o canal está habilitada.
Atenção para múltiplos depósitosAtualmente, o Panza utiliza o primeiro depósito retornado pela conta Bling.Caso a empresa possua mais de um depósito, faça um teste controlado com um produto antes de liberar a operação para todos os produtos.9. Pedidos e clientesO fluxo dos pedidos ocorre da seguinte forma:
  1. O TikTok Shop envia o pedido para o Bling, conforme as regras configuradas no Bling.
  2. O Panza consulta os pedidos de venda alterados no Bling.
  3. Para cada pedido encontrado, o Panza:
    • Consulta os detalhes do pedido;
    • Localiza o cliente no SFI ou realiza seu cadastro;
    • Tenta incluir o pedido no SFI.
  4. Os itens do pedido precisam possuir códigos correspondentes a produtos existentes no SFI.
  5. As parcelas precisam utilizar formas de pagamento previamente mapeadas em
    OpFinanceiras
    .
Controle de duplicidadeO mesmo pedido não deve ser incluído duas vezes.A identificação é realizada no SFI utilizando o ID do pedido no Bling.Limitações atuais da busca de pedidosAtualmente:
  • A busca do Panza está limitada aos pedidos alterados no dia corrente;
  • A busca não filtra uma loja TikTok específica.
Por isso, nos primeiros ciclos de utilização, é recomendado acompanhar os pedidos importados para confirmar que somente os registros esperados estão entrando no SFI.Situações que impedem a inclusão do pedidoSerá necessária intervenção quando:
  • O produto informado no pedido não existir no SFI;
  • O pedido não possuir parcelas;
  • A forma de pagamento não estiver mapeada.
Nesses casos:
  1. Corrija o cadastro ou a configuração;
  2. Salve a alteração;
  3. Realize novamente o teste.
10. Checklist de teste inicialAntes de liberar a integração para operação normal, valide os itens abaixo:
  • TikTok Shop conectado e configurado no Bling;
  • Panza autorizado na conta Bling correta;
  • URLs do Bling configuradas nos dois campos do Panza;
  • Categoria enviada antes do produto, quando aplicável;
  • Produto cadastrado no SFI;
  • Produto enviado corretamente ao Bling;
  • Imagem cadastrada manualmente no Bling;
  • SKU conferido no Bling;
  • Categoria conferida no Bling;
  • Preço conferido no Bling;
  • Estoque conferido no Bling;
  • Vínculo/publicação com TikTok Shop concluído no Bling;
  • Depósito testado com pelo menos um produto;
  • Atualização de estoque no canal validada;
  • Formas de pagamento configuradas em
    OpFinanceiras
    ;
  • Pedido de teste recebido pelo Bling;
  • Pedido importado corretamente para o SFI;
  • Pedido não foi incluído em duplicidade.
11. Situações que exigem ação manualSituaçãoAção necessáriaAlteração de escopo ou permissão do aplicativo BlingAutorizar novamente o Panza, pois os tokens anteriores são revogados.Falha na renovação ou acesso revogadoExecutar novamente a autorização do Bling no Panza.Imagem do SFI não aparece no BlingCadastrar a imagem diretamente no Bling.Forma de pagamento não mapeadaCopiar a descrição exata apresentada no log e cadastrar em
OpFinanceiras
.Produto do pedido não existe no SFICadastrar ou corrigir o produto e seu código antes de reprocessar.Estoque não chega ao TikTok ShopConferir depósito, vínculo do produto e regra de atualização dentro do Bling.Pedido não chega ao SFIConferir se o pedido chegou ao Bling, se foi alterado no dia corrente e consultar os logs da integração.12. Limitações atuaisA integração possui atualmente as seguintes limitações:
  • O Panza não se comunica diretamente com o TikTok Shop;
  • As imagens não são enviadas corretamente do SFI para o Bling;
  • O envio de produtos não suporta variações;
  • A busca de pedidos considera temporariamente apenas pedidos alterados no dia corrente;
  • A busca de pedidos não separa os pedidos por loja TikTok;
  • Contas Bling que recebam pedidos de vários canais exigem atenção adicional;
  • O depósito utilizado para atualização do saldo é selecionado automaticamente como o primeiro depósito retornado pelo Bling.
13. Recomendações para operaçãoMantenha sempre ativos e corretamente configurados:
  • A integração do TikTok Shop dentro do Bling;
  • Os vínculos dos produtos;
  • As regras de estoque;
  • Os depósitos;
  • As formas de pagamento;
  • As permissões do aplicativo Bling.
Sempre que houver alteração de:
  • Conta;
  • Loja;
  • Depósito;
  • SKU;
  • Permissões;
  • Escopos do aplicativo;
  • Regras de estoque;
realize um novo teste controlado antes de retomar a operação normal.

Por favor Acessar ou Registrar para participar da conversa.

  1. Fórum
  3. Integrações
  5. bling
  7. Manual Cliente Tik Tok Shop
Tempo para a criação da página:0.033 segundos
Topo