KangluKanglu Docs
ERP

Tiny

Como configurar a integração com o Tiny ERP

Tiny

O Tiny é um ERP para e-commerce integrado à Kanglu. A conexão é feita via OAuth2 — você autoriza a Kanglu a acessar seus dados do Tiny com alguns cliques.

Como conectar

  1. No painel Kanglu, vá em Integrações
  2. Na seção de ERPs, clique em Tiny
  3. Preencha os campos solicitados:
    • Client ID — Identificador da aplicação no Tiny
    • Client Secret — Chave secreta da aplicação
    • Link de Convite — Link fornecido pelo Tiny para autorizar a aplicação
  4. A Kanglu mostrará uma URL de Redirecionamento — copie e configure no painel do Tiny
  5. Após autorizar, a conexão é estabelecida automaticamente

Onde obter as credenciais?

As credenciais do Tiny são geradas no painel de desenvolvedor do Tiny:

CredencialOnde obter
Client IDPainel Tiny > Aplicações / Integrações
Client SecretPainel Tiny > Aplicações / Integrações
Link de ConviteFornecido pelo Tiny ao criar a aplicação

A URL de Redirecionamento exibida na Kanglu deve ser copiada e cadastrada no painel do Tiny para que a autorização funcione corretamente.

O que a Kanglu acessa no Tiny?

  • Pedidos — Para importar os dados do pedido (número, cliente, valor, transportadora)
  • Notas Fiscais — Para buscar número da NF e chave de acesso
  • Situações — Para mapear os status do Tiny para ações na Kanglu

Como os pedidos chegam?

A Kanglu consulta a API do Tiny periodicamente buscando pedidos por status. Para cada status mapeado no ERP, a Kanglu:

  1. Busca pedidos naquele status no Tiny
  2. Importa os dados do pedido (cliente, NF, transportadora, rastreio)
  3. Cria o cliente no sistema se ainda não existir
  4. Identifica a transportadora pelo serviço de envio
  5. Inicia o rastreamento automaticamente

Dados importados

Quando um pedido chega do Tiny, a Kanglu extrai:

  • Número do pedido e número do e-commerce
  • Dados do cliente (nome, CPF/CNPJ, telefone, e-mail, endereço)
  • Nota fiscal (número e chave de acesso)
  • Transportadora e código de rastreio
  • Valor total do pedido
  • Data de criação

Renovação automática de tokens

O token do Tiny expira periodicamente. A Kanglu renova automaticamente antes da expiração — você não precisa reconectar manualmente.

Se por algum motivo a renovação falhar, a Kanglu mostrará o status "desconectado" na página de Integrações. Basta clicar em "Conectar" novamente para reautorizar.

On this page