Tiny
O conector Tiny facilita a comunicação eficaz entre a plataforma Fluid e o sistema Tiny ERP. Este conector tem como objetivo principal integrar o Tiny ERP com outros sistemas que você utiliza para gerenciar seu negócio online. Ele permite uma troca de informações suave e automatizada, possibilitando o gerenciamento eficiente de produtos, pedidos, clientes e fornecedores.
Com a integração entre a plataforma Fluid e o Tiny ERP, você pode aproveitar ao máximo todas as funcionalidades oferecidas pelo Tiny ERP, garantindo que seu negócio funcione de maneira eficiente e organizada. Este conector é uma ferramenta essencial para micro e pequenas empresas que desejam simplificar seus processos de negócios e alcançar um alto nível de eficiência operacional.
Para a integração com o conector Tiny, é fundamental possuir uma chave API (API key) válida. Esta chave permite que nossa plataforma se comunique de maneira segura e eficiente com o sistema Tiny.
Passos para obter sua API key do Tiny:
- Acesse a plataforma Tiny ERP: Faça login em sua conta no sistema Tiny ERP. Se você ainda não possui uma conta, crie uma seguindo as instruções fornecidas no site oficial.
- Consulte a documentação oficial: Recomendamos fortemente que consulte a documentação oficial do Tiny ERP para obter informações detalhadas sobre a criação e gestão de chaves API.
- Navegue até a seção de API: Uma vez logado, localize o menu de configurações e procure pela seção dedicada à API ou integrações. Esta seção geralmente contém as opções para gerar, visualizar e gerenciar suas chaves API.
- Crie uma nova chave API: Siga as instruções fornecidas para criar uma nova chave API. Certifique-se de salvar essa chave em um local seguro, pois ela será necessária para a configuração do conector em nossa plataforma.
- Permissões da chave API: Ao criar sua chave API, assegure-se de conceder as permissões adequadas para os recursos que você deseja integrar (Produtos, Pedidos, Clientes e Fornecedores).
Após obter sua chave API, insira-a no campo apropriado em nossa plataforma para estabelecer a conexão com o Tiny ERP.
Para criar um Fluxo utilizando o conector Tiny é preciso criar uma ou mais Conexões e em seguida configurar o fluxo.
- Acessar o Painel Principal:
- Faça login na plataforma Fluid.
- No painel à esquerda, navegue até a opção "Conexões" e clique nela.
- Iniciar Nova Conexão:
- No canto superior direito, clique em "Nova Conexão".
- Seleção do Tipo de Conexão:
- Na tela de configuração, localize "Configure uma nova conexão" e selecione "Tiny" da lista suspensa.
- Nome da Conexão:
- Forneça um nome descritivo para a conexão no campo "Nome*".
- Descrição da Conexão:
- No campo "Descrição*", forneça uma breve descrição da conexão.
- Token de Acesso:
- Insira o token de acesso ou chave API no campo "Token*".
- Testar a Conexão:
- Clique no botão "Testar" para verificar a conexão.
- Salvar Conexão:
- Após a verificação, clique em "Salvar conexão" para finalizar.
Para configurar o conector Tiny na plataforma Fluid, siga os passos abaixo:
- Crie um fluxo e arraste o conector Tiny para o canvas.
- Selecione o conector Tiny. Na aba de "Parametrizações", você encontrará os campos de configuração. Mais detalhes no próximo tópico “Na Prática"
- Escolha o Recurso desejado. Os recursos disponíveis são:
- Produtos
- Pedidos
- Clientes e Fornecedores
- Defina a Operação para o recurso escolhido:
- Produtos:
- Incluir Produto
- Alterar Produto
- Pedidos:
- Incluir Pedido
- Clientes e Fornecedores:
- Incluir Contato
- Alterar Contato
- Pesquisar Contato: Para essa operação, preencha os campos:
- Pesquisa: Informe o nome ou código desejado.
- CPF/CNPJ
- Situação: Escolha entre "ativo" ou "inativo".
- Data de Criação
- Corpo da Requisição: Todas as operações possuem um corpo a ser inserido. Certifique-se de preenchê-lo de acordo com a operação escolhida.
- Finalize acessando a aba "Propriedades". Selecione a conexão desejada, nomeie o passo e, se necessário, inclua uma descrição detalhada.
Para mais informações sobre payloads trafegados pela tiny clique aqui e acesse a documentação
Neste tópico criaremos um exemplo de um fluxo utilizando o conector da Tiny. O fluxo terá apenas um passo que será responsável pela consulta de um contato no sistema da Tiny.
Assim ficará a Parametrização do nosso primeiro e único passo:
Nota: o único campo obrigátorio é o 'Pesquisa', porém para uma melhor performace na consulta é indicado informar os outros campos.
Na aba Propriedades informamos o nome do passo e a conexão criada para a Tiny:
Com o passo configurado basta disparar o fluxo sem a necessidade de informar um payload de entrada:
Após o disparo, o resultado do fluxo aparecerá em realtime no canvas:
Ao clicar em detalhes, temos a requisição e a resposta retornada pela Tiny:
