Conta Azul — conectar e sincronizar o financeiro

O que é / Para que serve

O conector do Conta Azul liga o Strice ao seu ERP financeiro Conta Azul e automatiza o ciclo financeiro das Ordens de Serviço (OS). Com a integração ativa, o Strice pode:

• Cadastrar clientes (Pessoas) no Conta Azul a partir dos clientes da OS;
• Criar vendas no Conta Azul automaticamente a partir de uma OS;
• Conciliar pagamentos, marcando a OS como paga quando a parcela é quitada no Conta Azul;
• Sincronizar serviços, contas financeiras, condições de pagamento, vendedores e categorias DRE.

O objetivo é acabar com o lançamento manual de vendas e manter Strice e Conta Azul em sincronia.

Emissão de NF-e não faz parte desta integração.

Antes de começar

• Você precisa ser administrador ou proprietário (owner) da organização. Apenas esses papéis veem e gerenciam a conexão com o Conta Azul.
• Você precisa de uma conta ativa no Conta Azul com permissão para autorizar aplicativos.
• Cada organização pode ter apenas uma conexão Conta Azul ativa por vez.

Passo a passo — conectar (autorização OAuth)

A conexão usa OAuth 2.0: você autoriza o Strice dentro do próprio Conta Azul, sem digitar sua senha no Strice.

1. Acesse Configurações da organização > Integrações.
2. No card Conta Azul, clique em Conectar Conta Azul.
3. Você será redirecionado para a tela de autorização do Conta Azul.
4. Faça login (se necessário) e conceda as permissões solicitadas.
5. O Conta Azul redireciona você de volta ao Strice, que finaliza a conexão automaticamente (mensagem "Finalizando a conexão com o Conta Azul…").
6. O card volta a exibir o selo Conectado e a data em Conectado em.

📷 Captura: card do Conta Azul com selo "Conectado", data em "Conectado em" e os botões Configurar e Desconectar.

Se a autorização for negada ou falhar: o Strice mostra uma mensagem de erro (por exemplo, "Não conseguimos concluir a conexão. Tente novamente.") e o card fica Não conectado. Basta clicar em Conectar Conta Azul de novo.

Passo a passo — configurar a integração

Depois de conectado, clique em Configurar no card do Conta Azul para abrir a tela de configuração, organizada em abas:

Aba Serviços

1. Clique em Sincronizar serviços para trazer os serviços do Conta Azul.
2. Use o Toggle da coluna Habilitado para escolher quais serviços ficam disponíveis no Strice.
3. O status Ativo/Inativo reflete o cadastro no Conta Azul. Serviços inativos ou marcados como Não vendável não podem ser habilitados.
4. Você pode buscar por nome/código e filtrar por status na própria coluna.

Aba Dados Financeiros

1. Clique em Sincronizar dados financeiros para trazer contas financeiras e vendedores.
2. Em Contas financeiras, habilite com o Toggle as contas de recebimento que ficarão disponíveis no Strice.
3. Em Vendedores, você vê a lista de vendedores importada do Conta Azul (usada na aba Vendedores).

Aba Categorias DRE

1. Clique em Sincronizar categorias para importar as categorias DRE.
2. As categorias aparecem em hierarquia (com identação por nível) e um selo indica a classificação (ex.: RECEITA).

Aba Vendedores

• Associe cada usuário do Strice a um vendedor do Conta Azul usando o menu suspenso ao lado de cada membro.
• Escolha — Não mapeado — para remover o vínculo.
• Esse mapeamento é usado ao criar a venda: o vendedor certo é preenchido automaticamente.

Aba Formas de Pagamento

• Habilite/desabilite, com Toggle, as 21 formas de pagamento suportadas (Pix, Cartão, Bancário, Digital, Vale, Crédito e Outros).
• Clique em Salvar. Apenas as formas habilitadas são oferecidas na criação de OS e usadas na sincronização.

📷 Captura: tela de Configuração do Conta Azul com as abas Serviços, Dados Financeiros, Categorias DRE, Vendedores e Formas de Pagamento.

Configuração — como a venda é criada a partir de uma OS

Quando uma OS é enviada ao Conta Azul (manualmente ou por automação), o Strice:

1. Encontra ou cria o cliente (Pessoa) — busca primeiro pelo CPF/CNPJ; se não achar, busca pelo nome; se ainda não achar, cria a Pessoa. O ID é guardado na OS para não duplicar depois.
2. Monta os itens da venda a partir dos serviços da OS (ou do serviço principal como fallback).
3. Mapeia a forma de pagamento e monta as parcelas com datas e valores.
4. Escolhe a conta de recebimento pela correspondência de nome com a conta configurada na OS.
5. Preenche o vendedor conforme o mapeamento da aba Vendedores.
6. Cria a venda com situação Aprovado e guarda o número e o ID da venda na OS.

Regras importantes:

• Uma OS não é sincronizada duas vezes — se ela já tem uma venda no Conta Azul, o Strice avisa e não cria outra.
• O valor total precisa ser maior que zero.
• A soma das parcelas deve bater com o total; diferenças de centavos são ajustadas na última parcela.

Configuração — conciliação de pagamentos

O Strice verifica a cada hora as OS já sincronizadas e consulta o status das parcelas no Conta Azul. Quando a parcela está Quitada (ou Recebida parcialmente), a OS é marcada como paga no Strice — sem você precisar fazer nada.

Reautenticação (quando a conexão expira)

Por segurança, o acesso ao Conta Azul é renovado automaticamente nos bastidores. Se o acesso for revogado ou expirar de forma irrecuperável, o card mostra o selo Requer reautenticação e um aviso.

1. No card Conta Azul, clique em Reautenticar.
2. Refaça a autorização no Conta Azul (mesmo fluxo do primeiro acesso).
3. A sincronização volta a funcionar.

Desconectar

1. No card Conta Azul, clique em Desconectar.
2. Confirme no aviso.

Ao desconectar, o Strice remove os tokens de acesso, mas mantém o histórico já sincronizado (vendas criadas, mapeamentos de vendedores, dados em cache).

Integrações com outros módulos

• Ordens de Serviço: é o coração desta integração — cada OS pode virar uma venda no Conta Azul e ter o pagamento conciliado de volta.
• Clientes: o cliente da OS é encontrado ou cadastrado como Pessoa no Conta Azul (por CPF/CNPJ ou nome).
• Automações: você pode criar uma automação que sincroniza a OS com o Conta Azul automaticamente quando ela atende a certas condições (por exemplo, quando um serviço específico é incluído).
• Central de Integrações: o card do Conta Azul convive com os demais conectores — veja Integrações — visão geral.

Dicas e limitações

• Só administradores/owners gerenciam esta integração.
• Uma OS já sincronizada não gera uma segunda venda.
• A conciliação considera pago apenas quando a parcela está Quitada ou Recebida parcialmente.
• Ao ressincronizar serviços, suas escolhas de "habilitado" são preservadas — a sincronização não desmarca o que você já configurou.
• Emissão de NF-e e importação de compras para o perfil do cliente não fazem parte desta integração (a importação de compras está planejada para o futuro).

Perguntas frequentes

O Strice cria a venda sozinho? Pode criar por automação (quando a OS atende às condições) ou por ação a partir da OS. Em ambos os casos, o cliente, os itens, o pagamento e o vendedor são montados automaticamente.

E se o cliente não tiver CPF/CNPJ? A busca no Conta Azul é feita apenas pelo nome. Se não existir, uma nova Pessoa é criada.

Sincronizei de novo os serviços e perdi minha seleção? Não. A ressincronização preserva os serviços que você já havia habilitado.

A OS foi paga no Conta Azul mas continua "em aberto" no Strice. A conciliação roda a cada hora. Aguarde o próximo ciclo; a OS será marcada como paga quando a parcela estiver quitada.

Desconectei sem querer. Perco os dados? Não. Desconectar remove apenas os tokens de acesso. O histórico sincronizado é mantido — basta Conectar de novo.

Vejo o selo "Requer reautenticação". O que faço? Clique em Reautenticar no card e refaça a autorização no Conta Azul.