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
- No painel Kanglu, vá em Integrações
- Na seção de ERPs, clique em Tiny
- 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
- A Kanglu mostrará uma URL de Redirecionamento — copie e configure no painel do Tiny
- 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:
| Credencial | Onde obter |
|---|---|
| Client ID | Painel Tiny > Aplicações / Integrações |
| Client Secret | Painel Tiny > Aplicações / Integrações |
| Link de Convite | Fornecido 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:
- Busca pedidos naquele status no Tiny
- Importa os dados do pedido (cliente, NF, transportadora, rastreio)
- Cria o cliente no sistema se ainda não existir
- Identifica a transportadora pelo serviço de envio
- 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.