Conta Azul

8min
Objetivo/Resumo
O conector da Conta Azul é uma solução poderosa que visa simplificar a gestão empresarial para pequenas empresas. Com esse conector, as empresas podem integrar seus sistemas e processos, aproveitando os recursos e funcionalidades abrangentes oferecidos pela plataforma.
O objetivo principal do conector da Conta Azul é fornecer uma conexão direta entre a Conta Azul e outros sistemas ou aplicativos utilizados pela empresa. Isso permite que os dados sejam compartilhados de forma automática e precisa, evitando erros e retrabalho manual.
Criando um fluxo utilizando o conector Conta Azul
Para criar um fluxo utilizando o conector Conta Azul é preciso criar uma conexão e em seguida configurar o fluxo.
Criando conexão Conta Azul
Primeiramente acesse sua aplicação na conta azul atravéz do link oficial da plataforma https://portaldevs.contaazul.com/#/aplicacoes.
Em seguida, selecione Nova aplicação se deseja criar, ou selecione uma aplicação já existente para ultilizar na Fluid.
Independente se for criar ou usar uma existe, a URI de Redirecionamento terá que ser setada com o seguinte valor: https://console.fluidapi.io. Isso forcenerá o consentimento para que a Fluid consiga ter acesso as credenciais da Conta Azul.
Após isso crie uma conexão na Fluid, fornecendo parametros requisitados
OBS: Clique aqui﻿ e acesse nosso passo a passo para saber como criar uma conexão.
Estes são os seguintes parâmetros de configuração da conexão Conta Azul que serão requisitados na criação:
Nome: parâmetro padrão em qualquer criação de uma conexão, te ajudará a identificar melhor sua conexão (campo obrigatório);
Descrição: parâmetro padrão e opcional em qualquer criação de uma conexão, aqui você pode relatar detalhadamente para que fins servirá sua conexão;
ID do Cliente: informe o client_id da aplicação (campo obrigatório);
Chave Secreta do Cliente: informe o client_secret da aplicação (campo obrigatório);
Após preencher os campos, clique no botão Login OAuth2 para autorizar o consentimento da aplicação.
Configurando fluxo Conta Azul
Crie um fluxo e arraste o conector Conta Azul para o canvas.
OBS: Clique aqui﻿ e acesse nosso passo a passo para saber como criar um fluxo.
Selecione o conector e na aba de Parametrização preencha os seguintes parâmetros de configuração: 
Recurso: entidade para qual será realizada a ação. No momento o conector dispões somente do recurso Cliente;
Operação: ação que será realizada para o recurso selecionado.
Operações disponiveis para recurso Cliente:
Criar cliente: requer um corpo com o objeto cliente, podendo ser eviado utilizando De/para﻿ ou Template﻿;
Atualizar cliente: requer o ID do cliente e um corpo com o objeto do cliente contendo as informações a serem atualizadas, podendo ser enviado utilizando De/para﻿ ou Template﻿;
Listar contatos do cliente: requer ID do cliente que será usado para busca dos contatos, sendo opcional a informação da Página e da Quantidade de Itens por página; 
Obter cliente por ID: requer o ID do cliente;
Excluir cliente: requer o ID do cliente;
Inativar cliente: requer o ID do cliente;
Na aba Propriedades selecione a conexão desejada, dê um nome ao passo e se necessário detalhe uma descrição.
Na prática
Neste tópico criaremos um exemplo de um fluxo utilizando o conector da Conta Azul. O fluxo terá apenas um passo que será responsável pela criação de um cliente no sistema da Conta Azul. Enviaremos um payload de entrada que passará por uma transformação em nosso De/para﻿, para assim enviarmos o objeto esperado pela API com os dados do cliente a ser criado.
﻿
Passo 'create'
Assim ficará a Parametrização do nosso primeiro e único passo:
﻿
Para tratar os dados recebidos do payload de entrada usamos o De/para﻿. E assim ficou nosso De/Para:
﻿
Para mais informações sobre como tratamos de/paras clique em saiba mais﻿.
Na aba Propriedades informamos o nome do passo e a conexão criada para a Conta Azul:
﻿
Conclusão
Com o passo configurado basta disparar o fluxo informando o payload de entrada:
JSON
{
  "name": "John C.",
  "company_name": "John Company",
  "email": "[email protected]",
  "business_phone": "99 99999-9999",
  "mobile_phone": "99 99999-9999",
  "person_type": "NATURAL",
  "document": "00011122233",
  "identity_document": "00011122233",
  "state_registration_number": "00011122233",
  "state_registration_type": "NO_CONTRIBUTOR",
  "city_registration_number": "00011122233",
  "date_of_birth": "1988-12-23T08:32:10.118-05",
  "notes": "Important customer, always wears a green hat",
  "contacts": [
    {
      "name": "John C.",
      "business_phone": "99 9999-9999",
      "email": "[email protected]",
      "job_title": "Developer"
    }
  ],
  "address": {
    "zip_code": "79106-330",
    "street": "Rua Parma",
    "number": "224",
    "complement": "Apartamento 2058",
    "neighborhood": "Jardim Itália"
  }
}
{
  "name": "John C.",
  "company_name": "John Company",
  "email": "john.company@johncompany.com",
  "business_phone": "99 99999-9999",
  "mobile_phone": "99 99999-9999",
  "person_type": "NATURAL",
  "document": "00011122233",
  "identity_document": "00011122233",
  "state_registration_number": "00011122233",
  "state_registration_type": "NO_CONTRIBUTOR",
  "city_registration_number": "00011122233",
  "date_of_birth": "1988-12-23T08:32:10.118-05",
  "notes": "Important customer, always wears a green hat",
  "contacts": [
    {
      "name": "John C.",
      "business_phone": "99 9999-9999",
      "email": "John.C@johncompany.com",
      "job_title": "Developer"
    }
  ],
  "address": {
    "zip_code": "79106-330",
    "street": "Rua Parma",
    "number": "224",
    "complement": "Apartamento 2058",
    "neighborhood": "Jardim Itália"
  }
}
﻿
Este é um payload teste disponibilizado pela propria API da Conta Azul. Clique aqui para mais informações sobre a API Conta Azul.
﻿
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 Conta Azul:
﻿
﻿
Updated 16 Oct 2023
Did this page help you?
Tiny
Bling