TagPlus no Konektor: conectar passo a passo

Guia feliz para conectar o TagPlus à loja Interago pelo Konektor: onde pegar as credenciais no lado TagPlus, como preencher o modal e o que fazer depois de autorizar. Sem API técnica: só o que o operador precisa no painel.

Para quem é

Operador ou dono de loja que já usa (ou vai usar) TagPlus como ERP e quer alinhar a loja Interago pelo Konektor.

Em uma frase

No TagPlus você cria/abre um aplicativo no portal de desenvolvedores, copia Client ID e Client Secret, cola na aba Acesso do Konektor, autoriza, escolhe o que sincronizar e Salva.

Antes de começar

1. Conta TagPlus ativa e com permissão para gerenciar aplicativos / API.
2. Loja Interago com o Konektor disponível em Extensões.
3. Card TagPlus visível em Extensões → Konektor → Integrações.
4. Ter lido o ritual de segurança: Konektor: pegar token e preencher Acesso com segurança.

Mapa geral: Konektor: mapa e quando usar (TagPlus, Olist, iTools Hub e API).

Fluxo oficial Interago: Como conectar um sistema no Konektor.

Parte 1: onde pegar Client ID e Client Secret no TagPlus

A integração TagPlus usa OAuth2 (não é “só uma chave fixa”). A ajuda pública do TagPlus orienta cadastrar um aplicativo no portal de desenvolvedores.

Caminho público conhecido

1. Acesse o portal developers.tagplus.com.br (documentação / área de aplicativos do TagPlus).
2. Entre com o usuário TagPlus.
3. Vá em Aplicativos (no menu do usuário / área de aplicativos).
4. Cadastre um novo aplicativo ou abra o existente da Interago:
   * Nome do aplicativo: algo claro, por exemplo “Interago loja”.
   * URL de retorno (callback): a URL que o Interago indicar para o Konektor. fale com a equipe Interago o valor exato do redirect URI do Interago (não invente URL).
5. Depois de salvar, copie Client ID e Client Secret.

Fontes públicas: artigos da Ajuda TagPlus sobre requisição de tokens e portal developers.tagplus.com.br / apidoc.tagplus.com.br.

Se você não achar o menu exato

No painel TagPlus, procure a área de API / Integrações / Aplicativos / Desenvolvedores. O nome do menu pode variar conforme o plano ou a versão da tela. Se não aparecer, peça ao administrador da conta TagPlus ou ao suporte TagPlus a liberação do portal de aplicativos. fale com a equipe Interago se a Interago tiver um aplicativo já homologado (nesse caso, o Client ID pode vir da equipe, e você só autoriza a conta).

O que saber sobre tokens (sem virar técnico)

• Depois da autorização, o TagPlus emite access token (cerca de 24 horas) e refresh token (cerca de 15 dias), conforme a ajuda pública.
• No dia a dia do Konektor, você não precisa renovar token na mão a cada hora: o importante é a autorização estar válida. Se a aba Situação mostrar erro de acesso, volte em Acesso e Autorizar de novo.

Parte 2: preencher o modal no Interago

1. No painel Interago: Extensões → Konektor → Integrações.
2. Localize TagPlus e clique em Conectar (primeira vez) ou Configurar (já existe).
3. Abra a aba Acesso.
4. Cole Client ID e Client Secret nos campos correspondentes.
   * Se o modal pedir Chave de API, Usuário/Senha ou outro campo, preencha só o que a tela mostrar. fale com a equipe Interago se a tela do seu site divergir deste guia.
5. Clique em Autorizar acesso (ou equivalente na tela).
6. Na janela do TagPlus, faça login se pedido e aprove a conexão do aplicativo com a conta.
7. Volte ao modal do Konektor e confira se o acesso ficou autorizado.

Aba Configurações

Abra Configurações e ajuste o que a tela oferecer para o TagPlus (depósito, comportamento padrão, etc.). Só preencha o que você entende; se um campo for obscuro, anote e fale com a equipe Interago antes de inventar valor.

Aba O que sincronizar

Ligue conforme a regra da loja:

Opção	Quando ligar (ideia prática)
Catálogo / produtos	Você quer coletar do ERP e/ou enviar da loja
Estoque	O saldo deve acompanhar entre ERP e loja (só em produtos vinculados)
Pedidos	Pedidos da loja devem ir ao TagPlus (ou o fluxo inverso que a tela descrever)
Clientes	Cadastro de clientes deve fluir conforme a opção

Lembrete crítico: estoque e pedidos só em produtos vinculados. Cadastrar só no TagPlus não sincroniza sozinho para a vitrine.

Aba Webhook (se existir)

Alguns sistemas mostram Webhook. Só altere se a equipe Interago ou o guia do sistema pedir. Em dúvida, deixe como está e fale com a equipe Interago.

Aba Situação

Use para ver se a conexão está saudável depois de salvar. Detalhe de diagnóstico: Konektor: checklist e problemas comuns.

Parte 2b: pedidos, fila, desconto em R$ e SKU na coleta

Com Pedidos ligados:

• Ao marcar o pedido como pago, ele entra na fila do Konektor.
• Na lista de pedidos da integração, você vê quais já estão no ERP.
• Se a sincronização falhar, use o reenviar pontual depois de corrigir a causa.

Desconto no TagPlus: o Konektor envia ao TagPlus o desconto do pedido em reais (R$). Na prática do operador, trate o desconto em valor (R$), não em percentual, quando a tela ou o ERP esperarem esse formato. Se a loja trabalha com cupom em %, confira o valor em reais que o pedido carrega antes de cobrar o ERP.

Na coleta (Coletar produtos do ERP), a tela pode avisar se o SKU já existe na loja. Leia o aviso antes de seguir, confirme o vínculo e evite duplicar cadastro.

Parte 3: Salvar e primeiras ações

1. Clique em Salvar.
2. Use Sincronizar agora para disparar o ciclo conforme as opções ligadas.
3. Se o objetivo for trazer o catálogo do TagPlus: Coletar produtos do ERP.
4. Se o objetivo for mandar produtos da loja para o TagPlus: Enviar produtos, no bloco Ações manuais. Abre uma lista para você escolher os itens; a coluna No TagPlus? mostra se o envio vai criar o produto ou atualizar um já vinculado. O botão funciona mesmo com Sincronizar produtos desligado, e o SKU no TagPlus pode ter até 15 caracteres.
5. Confira vínculos e estoque depois (artigos 05 e 06).

Salvar no Konektor não exige Atualizar a loja (páginas/blocos). Atualize o catálogo da loja quando produto/estoque da vitrine mudarem de fato.

Checklist TagPlus (primeira conexão)

1. Aplicativo criado/aberto no portal TagPlus (developers / Aplicativos).
2. URL de callback conferida com a equipe. fale com a equipe Interago
3. Client ID e Client Secret copiados com cuidado.
4. Konektor → TagPlus → aba Acesso preenchida.
5. Autorizar acesso concluído no TagPlus.
6. O que sincronizar alinhado à regra (estoque/pedidos/catálogo/clientes).
7. Salvar.
8. Sincronizar agora e Coletar ou Enviar conforme o objetivo.
9. Conferir Situação e um produto de teste vinculado.
10. Se pedidos estiverem ligados: pedido pago na fila; desconto em R$; reenvio só se falhar.
11. Na coleta: ler aviso se o SKU já existe na loja.

O que este artigo não cobre

• Postman, escopos técnicos ou código.
• Diferença detalhada Coletar × Enviar (veja artigo 05).
• Ritual diário de estoque/pedidos (artigo 06).
• iTools Hub / Bling (outros caminhos).

Artigos relacionados

• Como conectar um sistema no Konektor
• Konektor: pegar token e preencher Acesso com segurança
• Konektor: sincronizar produtos (coletar do ERP e enviar da loja)
• Konektor: estoque e pedidos no dia a dia
• Konektor: checklist e problemas comuns
• Olist no Konektor: conectar passo a passo (se a loja também usar Olist)