Pular para o conteúdo principal

Qonto

Disponível

Esta integração está disponível no Frihet. Configure-a em Settings → Integrações → Qonto.

Conecte sua conta Qonto ao Frihet para importar automaticamente as transações do seu banco empresarial como despesas. Se você usa Qonto como seu banco principal, esta integração elimina a necessidade de registrar manualmente cada pagamento e oferece visibilidade completa de suas despesas operacionais dentro do Frihet.

Para que serve?​

  • Importar transações como despesas — Os pagamentos e débitos concluídos no Qonto são importados como despesas no Frihet com todos os detalhes
  • Apenas débitos — São importadas apenas as transações de débito (pagamentos realizados), não as receitas, para evitar misturar fluxos
  • Deduplicação automática — As transações já importadas não são duplicadas em importações posteriores
  • Consolidação de despesas — Unifique suas despesas do Qonto com o restante das despesas registradas no Frihet para ter uma visão financeira completa

Requisitos​

  • Conta ativa no Qonto
  • Plano Frihet Pro ou Business
  • Organization slug e Secret key da API do Qonto

Como conectar​

Passo 1: Obter suas credenciais de API no Qonto​

  1. Faça login em app.qonto.com
  2. Vá para Settings (Configurações) no menu lateral
  3. Selecione a seção API ou Integrações > API
  4. Aqui você encontrará dois dados que precisa:
    • Organization slug — O identificador único da sua organização (algo como mi-empresa-abc123)
    • Secret key — A chave secreta da API
  5. Copie ambos os valores

Passo 2: Configurar no Frihet​

  1. No Frihet, vá para Settings → Integrações
  2. Procure por Qonto e clique no card
  3. Insira seu Organization slug no primeiro campo
  4. Insira sua Secret key no segundo campo
  5. Clique em Testar conexão para verificar
  6. Se a conexão for bem-sucedida, clique em Salvar

Como funciona​

Frihet conecta-se à API do Qonto utilizando seu Organization slug e Secret key para autenticar-se. Ao iniciar uma importação, o Frihet consulta as transações concluídas do tipo débito em sua conta Qonto e as registra como despesas.

A importação é sob demanda. Apenas transações de débito concluídas (pagamentos a fornecedores, assinaturas, compras com cartão, etc.) são importadas. Receitas e transferências de entrada não são importadas.

Mapeamento de dados​

Dado no QontoCampo no Frihet
Rótulo / conceitoDescrição da despesa
Valor (débito)Valor da despesa
Data da operaçãoData da despesa
MoedaMoeda da despesa
Nome do beneficiárioNotas da despesa
Categoria QontoCategoria sugerida

Casos de uso​

PME europeia com conta Qonto​

Você usa Qonto como seu banco principal. Todo mês, você importa todas as transações para o Frihet para ter um registro completo de despesas sem digitar nada. Você combina essas despesas importadas com as faturas emitidas no Frihet para ter uma visão completa de sua rentabilidade.

Equipe com cartões corporativos Qonto​

Sua equipe possui cartões Qonto para despesas do dia a dia. Em vez de perseguir cada pessoa para registrar suas despesas, você importa todas as transações de cartão para o Frihet e as categoriza de uma vez.

Solução de problemas​

Erro de conexão​

  • Verifique se o Organization slug e a Secret key estão corretos
  • Verifique se você copiou os valores completos, sem espaços extras
  • Se o Qonto regenerou sua Secret key, atualize-a no Frihet

Transações não são importadas​

  • Apenas transações do tipo débito e com status concluído são importadas
  • Confirme que você tem transações no período selecionado
  • As transações pendentes ou em processamento não aparecem até que sejam concluídas

Faltam algumas transações​

  • Verifique o intervalo de datas da importação
  • As transferências internas entre contas Qonto podem não ser importadas dependendo da configuração

Próximos passos​