O que é Olist Tiny ERP v3?
O Tiny ERP é uma solução de gestão empresarial voltada para micro e pequenas empresas, desenvolvida para simplificar e otimizar processos comerciais do dia a dia. O sistema centraliza operações essenciais como vendas, controle de estoque, financeiro e emissão de notas fiscais, oferecendo uma administração mais eficiente e integrada do negócio.
Com o conector Olist Tiny ERP v3, a plataforma BIMachine permite extrair dados do Tiny de forma simples. Todo o fluxo de coleta, tratamento e atualização dessas informações é gerenciado pelo BIMachine, possibilitando transformar os dados operacionais em análises visuais, indicadores e dashboards.
Novo processo de autenticação (Olist Tiny ERP v3)
Com a evolução da API, o Olist Tiny ERP v3 passou a utilizar um novo modelo de autenticação baseado em aplicativos.
Antes de realizar a integração com o BIMachine, é necessário criar um aplicativo diretamente na plataforma da Olist. Esse aplicativo será responsável por autorizar o acesso do BIMachine aos dados do Tiny ERP.
Ao criar o aplicativo, você receberá as seguintes credenciais:
- Client ID
- Client Secret
Essas informações serão utilizadas posteriormente na configuração do conector dentro do BIMachine.
Criando o aplicativo na Olist
Para criar o aplicativo que permitirá a integração com o BIMachine, siga os passos abaixo.
1. Acesse a plataforma da Olist e navegue até:
Configurações → Geral → Aplicativos
2. Na tela de aplicativos, você poderá visualizar os aplicativos já existentes, caso haja algum.
Clique em “Novo aplicativo” para iniciar a criação de um novo.
3. Na tela de configuração do aplicativo, preencha os campos conforme orientações abaixo:
- Nome do aplicativo (1): Informe um nome para identificar o aplicativo dentro da Olist. Sugestão:
BIMachine. - URL do Redirecionamento (2): Informe a URL utilizada pelo BIMachine para o processo de autenticação. Utilize exatamente o endereço:
https://app.bimachine.com/api/origins/tinyV3/auth - Chaves de acesso (3): Após a criação, a Olist irá gerar automaticamente as credenciais: Client ID e Client Secret. Essas chaves serão exibidas nessa seção e deverão ser utilizadas posteriormente na configuração da integração no BIMachine. Atenção: essas credenciais são sensíveis e não devem ser compartilhadas publicamente.
- Permissões do aplicativo (4): Nessa seção, você define quais endpoints da API do Tiny ERP o BIMachine poderá acessar. Marque os endpoints que deseja disponibilizar e para cada endpoint selecionado, habilite ao menos a permissão de Leitura. Sugestão: para garantir o funcionamento completo da integração, marque todos os endpoints com a opção Leitura habilitada.
4. Após finalizar as configurações, clique em Salvar. O aplicativo estará pronto para uso.
Guarde o Client ID e o Client Secret, pois eles serão necessários na próxima etapa.
Para mais informações sobre a criação de aplicativos na plataforma Olist, você pode consultar a documentação oficial: Documentação Olist – Aplicativos API V3
Em caso de dúvidas relacionadas exclusivamente ao processo de criação do aplicativo ou às credenciais do Olist Tiny ERP, recomendamos entrar em contato diretamente com o suporte da própria Olist, que é responsável por esse procedimento.
Criando a integração no BIMachine
1. No BIMachine, acesse Gerenciar ambiente e clique em Dados e Integrações.
2. Clique no ícone “+” e selecione Origem de Dados.
3. No pop-up de seleção de integrações, localize e selecione TinyERP v3.
4. Você será redirecionado para a tela de criação da nova estrutura de dados. Informe: Nome da estrutura e Descrição. Em seguida, clique em Próximo.
5. Na etapa de conexão, informe:
- Client ID: gerado no aplicativo da Olist
- Client Secret: gerado no aplicativo da Olist
- Login: realize o login com sua conta da Olist
Em seguida, selecione o tipo de integração que deseja executar.
Após a conclusão, uma nova estrutura analítica será criada dentro do BIMachine, permitindo a visualização e análise dos dados provenientes do Olist Tiny ERP v3.
Caso tenha dúvidas, você pode acessar entrar em contato com o suporte Tiny ERP para mais informações.
Se mesmo assim precisar de ajuda, entre em contato conosco!