Integração com Conta Azul

Conta Azul é uma plataforma para gestão financeira de pequenas empresas.

Neste artigo você encontra:

• Quais dados podem ser integrados do Conta Azul?

• Quais as informações necessárias para realizar a integração?

Quais dados podem ser integrados do Conta Azul?

Devido a ausência de rotas para demais informações, apenas duplicatas do financeiro (vendas) podem ser importado. Os dados importados ficam disponíveis no menu “Financeiro” no CustomerX.

Importante: devido a ausência de rotas para contratos, não é possível importar contratos do Conta Azul.

A atualização dos dados ocorre diariamente, sempre buscando os dados atualizados até o dia anterior.

Quais as informações necessárias para realizar a integração?

Para integrar o Conta Azul com o CustomerX você precisará:

• Definir o campo de vínculo entre plataformas (ID do cliente, CNPJ, e-mail do contato…).

• Client_Id e Client_Secret: Para ter acesso a estas chaves é necessário seguir o passo a passo abaixo.

Acessando o Client_Id e Client_Secret:

Para ter acesso a estes dados você precisará criar uma aplicação.

1. Primeiro passo acesse o link: https://portaldevs.contaazul.com/#/aplicacoes. Se nunca tiver acessado essa tela, ele irá pedir o Nome da empresa e Site.

2. Nesse passo basta o cliente preencher com o nome e site da sua empresa.

3. Ao gravar irá aparecer a opção para criar nova aplicação. Crie uma aplicação com os dados abaixo:

• Nome Aplicação: CustomerX

• Descrição: Integração CustomerX

• URI de Redirecionamento:

  • Produção: https://api.customerx.com.br/v1/apps/conta_azul/authorize

  • Sandbox: https://sandbox.api.customerx.com.br/v1/apps/conta_azul/authorize

• Tipo de Software: Online/Nuvem

• Segmento de Software: Outro

• Descreva o Segmento: Customer Success

• Clique em Salvar e finalizar

• Envie as chaves de acesso client_id e client_secret para o time da CustomerX

Procedimento realizado pela equipe da CustomerX

Após recebido os dados do passo anterior, nosso time (CustomerX) irá criar a integração utilizando o client_id e client_secret gerados no Conta Azul. Com ela iremos gerar a URL para Autorização (autenticação 2 fatores) com base nesses dados e enviaremos um link a você para dar andamento na configuração.

Ao acessarem essa URL no navegador irá abir uma página semelhante a esta para realizar o login

Na sequência realize a autorização clicando em Autorizar:

Se tudo estiver configurado corretamente irá retornar uma mensagem que a autorização foi realizada com sucesso. Em caso de falha reportar ao time da CustomerX.