A integração entre o Base de Clientes e o Conta Azul é um passo importante para tornar a gestão financeira e operacional mais eficiente. Ao conectar as duas plataformas, é possível automatizar o compartilhamento de informações, reduzir o trabalho manual, minimizar erros de lançamento e garantir que os dados estejam sempre sincronizados.
Com essa integração, os processos ficam mais ágeis e confiáveis, permitindo que a equipe dedique mais tempo às atividades estratégicas e menos às tarefas repetitivas. Neste artigo, você verá como funciona a conexão com o Conta Azul, seus principais benefícios e como utilizá-la da melhor forma.
Mas vamos começar pelo começo: o que é a integração ?
A integração com a Conta Azul conecta a sua conta da Base de Clientes ao seu ERP financeiro na Conta Azul.
Uma vez conectadas, os lançamentos financeiros no Base de Clientes passam a ser enviados automaticamente para a Conta Azul, sem digitação manual e sem planilhas.
E por que usar?
Você concentra a operação (cobranças, clientes, contratos) na Base de Clientes e mantém o financeiro/contábil organizado na Conta Azul — automaticamente e em tempo real.
E quais os pré-requisitos?
Um plano compatível na Base de Clientes - a integração está disponível nos Planos Grow e Scale. Nos planos em que ela não está habilitada, a tela exibe um aviso para upgrade;
Uma conta ativa na Conta Azul - com permissão de autorização de aplicativos;
E na Conta Azul, possuir ao menos uma conta financeira com as categorias utilizadas — elas serão referenciadas na configuração.
E como funciona a sincronização com a Conta Azul?
Na Base de Clientes | Se torna na Conta Azul |
Cobranças (contas a receber) | Lançamentos em Contas a receber. Quando a cobrança é paga na Base, a parcela recebe baixa na Conta Azul. |
Contas a pagar | Lançamentos em Contas a pagar. |
Outras receitas | Lançamentos de receita (contas a receber avulsas). |
Clientes | Cadastro de Pessoas (cliente/fornecedor), criado ou atualizado por CPF/CNPJ ou e-mail. |
Para classificar corretamente cada lançamento, a integração usa quatro tipos de referência que já existem na Conta Azul e que você conecta aos itens da Base:
Contas financeiras;
Categorias de despesa;
Categorias de receita;
Centros de custo.
Entendeu? Agora vamos entender como conectar?
Passo 1 - Conectar
Clique sob o ícone de engrenagem e em seguida em "Configurações".
Em seguida clique sob a seção "Integrações" dentro da aba lateral das configurações.
Nesta página você verá todos aplicativos disponíveis, incluindo o card Conta Azul.
Clique então sob o card "Conta Azul".
Enquanto a conta ainda não estiver conectada, a tela mostrará a mensagem “Sua conta ainda não está conectada à Conta Azul” e o botão “Conectar com a Conta Azul”.
Dentro desta página, clique em “Conectar com a Conta Azul”.
Em seguida você será redirecionado para a Conta Azul, onde fará o login com seu usuário e irá inserir a senha para autorizar o acesso.
Após a autorização, você voltará automaticamente para esta tela com a integração já ativa.
Com a autorização efetivada, a confirmação aparecerá na tela com “Integração com a Conta Azul conectada” e a tela passará a exibir o painel completo de configuração.
Passo 2 - Configurar
Com a conta conectada, o painel mostrará as correspondências (“vínculos”) entre os itens da Base de Clientes e os itens da Conta Azul.
Para cada tipo, você definirá uma opção Padrão — usada sempre que não houver um vínculo específico — e, opcionalmente, vínculos item a item.
Painel da integração conectada — visão geral
Importante: defina pelo menos os Padrões de Conta financeira, Categoria de despesa e Categoria de receita. Sem eles, os lançamentos correspondentes não têm como ser classificados e podem ir para a área de Sincronizações com falha.
Passo 2.1 - Contas financeiras
Comece abrindo o item "Contas financeiras".
Em "Padrão", selecione a conta financeira da Conta Azul que receberá os lançamentos por padrão (ex.: BRADESCO CONTA).
Em "Vínculos", você poderá, opcionalmente, ligar cada conta bancária da Base de Clientes a uma conta financeira específica da Conta Azul.
Passo 2.2 - Categorias de despesa
São categorias utilizadas no Contas a pagar.
Defina a categoria de despesa Padrão e, se quiser, ligue cada categoria
da Base de Clientes à uma categoria de despesa da Conta Azul.
Passo 2.3 - Categorias de receita
Categorias utilizadas em "Outras receitas".
Seguindo a mesma lógica, comece definindo a categoria de receita "Padrão" e em seguida, os "Vínculos" desejados.
Passo 2.4 - Centros de custo (opcional)
Se você utiliza os centros de custo na Conta Azul, aqui poderá mapear os centros de custo no Base de Clientes para eles.
Essa etapa, entretanto, é opcional — deixe em branco se não utilizar.
Passo 2.5 - Vínculos específicos e importação de itens
Além do Padrão, cada seção permite ligar itens a itens.
Para isso, nas categorias e centros de custo, se existe algo que só está na Conta Azul, este aparecerá no bloco “Itens só no Conta Azul”: marque os itens e clique em “Importar selecionados” para criá-los na Base de Clientes já associados.
O sistema também pode oferecer sugestões de vínculo por IA — você pode aceitar ou descartar individualmente.
Passo 2.6 - Salvar
Ao alterar qualquer vínculo, opção ou chave, aparece a barra “Salvar alterações” com a contagem de alterações pendentes. Clique para persistir. Todas as configurações do painel (vínculos, criar cliente e notificações) são salvas juntas neste botão.
Passo 3 - Opções adicionais
Passo 3.1 - Criação de clientes no Conta Azul de forma automática
Quando ligado, se um cliente não for encontrado na Conta Azul (por documento ou e-mail), ele é criado automaticamente ao sincronizar faturas e ao cadastrar/editar clientes na Base. Se desligado, a fatura de um cliente inexistente vai para a área de sincronização com falha.
Passo 3.2 - Notificações de sincronização
Escolha quais avisos de sucesso você quer receber — Cobranças, Contas a pagar e Receitas. As notificações de erro são sempre enviadas, independentemente dessas opções.
Passo 3.3 - Sincronizar itens anteriores à integração
A integração sincroniza o que acontece a partir da data em que foi conectada. Cobranças e contas a pagar que já existiam antes disso (com status pendente, em aberto ou vencido) não foram enviadas.
Use “Sincronizar itens anteriores à integração” para ver quantos itens estão pendentes e clicar em “Enviar pendentes agora”.
Sincronizar itens anteriores à conexão
Passo 4 - Onde visualizar na Conta Azul
Depois que os lançamentos são enviados, você os confere no painel da Conta Azul:
O que você criou na Base | Onde ver na Conta Azul |
Cobrança (conta a receber) | Financeiro → Contas a receber categoria de receita, a conta financeira e o centro de custo conforme o mapeamento. Ao ser pago na Base, a parcela fica como recebida/baixada. |
Conta a pagar | Financeiro → Contas a pagar Com fornecedor, categoria de despesa, conta financeira e centro de custo. |
Outra receita | Financeiro → Contas a receber (lançamento de receita avulsa) Com a categoria de receita mapeada. |
Cliente | Cadastros → Clientes/Pessoas Criado/atualizado por CPF/CNPJ ou e-mail quando a opção “Criar cliente automaticamente” está ligada. |
Categorias / Centros de custo / Contas financeiras | Configurações da Conta Azul A Base não cria categorias na Conta Azul — apenas usa as que já existem lá (e pode importá-las para a Base). |
Passo 5 - A integração dentro de cada registro
Além do painel de configuração, você poderá consultar o status de sincronização de cada cobrança, conta a pagar e recorrência diretamente nos detalhes do registro.
Passo 5.1 - Cobranças e contas a pagar
Para verificar, abra:
Os detalhes da cobrança - na tela de Cobranças)
Os detalhes de uma conta a pagar - em Operação → Contas a pagar.
Em seguida, no topo do modal, clique nos três pontos “•••” (Mais opções) e selecione “Conta Azul”.
Isso abrirá o quadro do registro de sua Conta Azul, em que as seguintes informações estarão registradas:
Status — selo de sincronização: Sincronizado, Sincronizando, Pendente, Erro ou Não sincronizado.
Identificador no CA — o código do lançamento na Conta Azul, com botão para copiar.
Erro — a mensagem retornada pela Conta Azul, exibida somente quando o status é de falha.
Neste quadro, as ações disponíveis serão:
“Abrir Conta Azul” - lhe direcionará direto para lançamento na Conta Azul;
“Tentar novamente” - quando houver falha permite o reenvio da sincronização.
O quadro será o mesmo para cobranças e contas a pagar — que poderá ser aberto pelos três pontos "•••" e "Conta Azul” do respectivo detalhe.
Passo 5.2 - Recorrências
Nos detalhes de uma recorrência, o quadro Conta Azul mostrará uma tabela dos ciclos, com as colunas:
Ciclo;
Vencimento;
Valor;
Status;
Erro (quando houver) - ou seja, a situação de sincronização de cada cobrança/conta a pagar gerada pela recorrência.
Para corrigir isso, clique sob o botão “Sincronizar novamente” para reenviar os ciclos pendentes (fica desabilitado enquanto algum ciclo ainda está em sincronização) e uma ação de sincronizar por linha.
Passo 6 - Acompanhamento e erros
Quando algum lançamento não puder ser sincronizado, ele aparecerá no painel da integração, no bloco “Sincronizações com falha” (visível apenas quando há falhas).
Ali você poderá ver:
Tipo do item - cobrança, conta a pagar, receita;
Sujeito envolvido;
Valor;
Vencimento;
Mensagens de erro.
Para corrigir os envios, é possível reenviar um item individualmente ou tudo através do botão “Reenviar tudo”.
Em cada registro (cobrança, conta a pagar, recorrência) também haverá um selo de status da Conta Azul, indicando se aquele item foi sincronizado ou ainda está pendente, ou, não sincronizado.
Quais as causas comuns de falha?
Falta de um Padrão obrigatório - conta financeira/categoria;
Cliente sem documento válido com a opção de criar cliente desligada;
Dados divergentes do cadastro na Conta Azul.
Corrija a causa e reenvie.
Como desconectar?
Para encerrar a sincronização, use o botão “Desconectar” no topo do painel. Os lançamentos deixam de ser enviados, mas os vínculos já configurados são mantidos caso você reconecte no futuro.
Como solucionar dúvidas rápidas?
"Não vejo a integração no meu plano"
Ela está disponível nos planos Grow e Scale. Faça upgrade em Configurações → Meu Plano.
"Conectei, mas lançamentos antigos não apareceram"
Use a opção “Sincronizar itens anteriores à integração” (seção 5.3) para enviar itens anteriores à data de conexão.
"Um cliente não foi criado na Conta Azul"
Verifique se a opção “Criar cliente automaticamente” está ligada e se o cliente tem documento (CPF/CNPJ) ou e-mail válido.
"Recebi um aviso de falha"
Abra o bloco “Sincronizações com falha”, corrija a causa indicada e reenvie.
Entendeu? Agora basta conectar sua conta Base de Clientes à sua Conta Azul e aproveitar os benefícios!
Ainda tem dúvidas? Entre em contato conosco pelo chat ou canais abaixo:
Email: [email protected]
WhatsApp: (41) 93500‑4475