---
title: Tiny
slug: tiny
docTags: 
createdAt: 2023-10-24T02:46:37.537Z
---

## Objetivo/Resumo

O conector [Tiny](https://tiny.com.br/) 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.

### Gerando API Key para configuração do seu conector Tiny

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:**

1. **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.
2. **Consulte a documentação oficial:** Recomendamos fortemente que consulte a [documentação oficial do Tiny ERP](https://ajuda.tiny.com.br/hc/pt-br/articles/4416655291668-Token-para-a-API) para obter informações detalhadas sobre a criação e gestão de chaves API.
3. **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.
4. **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.
5. **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.

## Criando um fluxo utilizando o conector Tiny

Para criar um [Fluxo](docId\:WTZWYEZQPk5bX-oJ0t938) utilizando o conector Tiny é preciso criar uma ou mais [Conexões](docId\:fDR1Y5sRGt0DnLVqkUekJ) e em seguida configurar o fluxo.

### Criando conexão Tiny

- **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.

### Configurando fluxo Tiny 

Para configurar o conector Tiny na plataforma Fluid, siga os passos abaixo:

1. **Crie um fluxo e arraste o conector Tiny para o canvas.**
2. **Selecione o conector Tiny**. Na aba de "[Parametrizações](docId\:VpiLZuEnyPyCbjPp4YAND)", você encontrará os campos de configuração. Mais detalhes no próximo tópico “Na Prática"
3. **Escolha o Recurso desejado**. Os recursos disponíveis são:
   - Produtos
   - Pedidos
   - Clientes e Fornecedores
   - asdasd
4. **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
5. **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.
6. 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](https://tiny.com.br/api-docs/api)* e acesse a documentação *

## Na prática

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.

![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/8PobK96wcQBq1d0gmRl7T_image.png)

### Passo 'consulta-contato'

Assim ficará a `Parametrização` do nosso primeiro e único passo:

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/eehUrM9VTjUXKdDVnVpLc_image.png" size="50" width="422" height="807" position="center" darkWidth="422" darkHeight="807" showCaption="false"}

*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:

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/3ZEurF39i6UBJ87WpLHUs_image.png" size="50" width="424" height="566" position="center" darkWidth="424" darkHeight="566" showCaption="false"}

### Conclusão

Com o passo configurado basta disparar o fluxo sem a necessidade de informar um payload de entrada:

![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/m91d2zcIMzb0w1UngQYrq_image.png)

Após o disparo, o resultado do fluxo aparecerá em realtime no canvas:

![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/5xSlGd64VAC3SQVCLzMFO_image.png)

Ao clicar em detalhes, temos a requisição e a resposta retornada pela Tiny:

![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/XQz0goCbN6n-jXcR25M6m_image.png)