Pular para o conteúdo principal

Square

Disponível

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

Conecte sua conta do Square ao Frihet para importar automaticamente as transações e pagamentos do seu ponto de venda. Square é uma plataforma de cobranças que inclui terminais POS, pagamentos online e gestão de inventário. Com esta integração, cada venda registrada no Square é importada para o Frihet como receita, eliminando a entrada manual e mantendo sua contabilidade sincronizada com as vendas presenciais e online.

Para que serve?​

  • Importar transações — Cada pagamento processado no Square (PDV, online, fatura) é importado como receita no Frihet com todos os detalhes
  • Reconciliação automática — Cruza os pagamentos do Square com suas faturas no Frihet sem esforço manual
  • Clientes sincronizados — Os clientes registrados no Square são importados para sua base de dados de contatos no Frihet
  • Comissões como despesas — As comissões que o Square cobra por cada transação são registradas automaticamente como despesas no Frihet
  • Histórico completo — Importa transações passadas para ter uma visão completa de sua atividade comercial

Requisitos​

  • Conta ativa no Square
  • Plano Frihet Pro ou Business
  • Access Token da API do Square (obtido no Square Developer Dashboard)

Como conectar​

Passo 1: Obter seu Access Token no Square​

  1. Faça login em developer.squareup.com
  2. Crie um novo aplicativo ou selecione um existente
  3. No painel do aplicativo, navegue até Credentials
  4. Copie o Production Access Token (não use o de sandbox para dados reais)
  5. Certifique-se de que o token tem permissões de leitura para Payments, Orders e Customers

Passo 2: Configurar no Frihet​

  1. No Frihet, vá para Settings → Integrações
  2. Procure por Square e clique no card
  3. Cole seu Access Token no campo correspondente
  4. Clique em Testar conexão para verificar se as credenciais estão corretas
  5. Selecione a localização (location) do Square que você quer sincronizar
  6. Clique em Salvar

Dados que são sincronizados​

DadoDireçãoDetalhes
Transações/pagamentosSquare → FrihetValor, data, método de pagamento, referência
ClientesSquare → FrihetNome, e-mail, telefone do comprador
ComissõesSquare → FrihetComissões do Square registradas como despesas
Produtos vendidosSquare → FrihetLinhas de detalhe de cada transação
Status de pagamentoSquare → FrihetConcluído, reembolsado, pendente

Casos de uso​

Loja física com contabilidade digital​

Você tem uma loja e cobra com o terminal do Square. Cada venda do dia é importada automaticamente para o Frihet à noite. Sua contabilidade reflete todas as vendas presenciais sem que você precise copiar nada à mão. As comissões do Square aparecem como despesas para que você veja sua margem real.

Negócio com vendas presenciais e online​

Você vende tanto na loja com Square quanto pelo seu site. O Frihet consolida as transações do Square com suas faturas online para lhe dar uma visão unificada de todas as suas receitas. Você pode gerar relatórios fiscais com todas as fontes de receita centralizadas.

Autônomo com cobranças por celular​

Você é autônomo e cobra seus clientes com Square no celular (eventos, serviços a domicílio, mercados). Cada cobrança é registrada automaticamente no Frihet com o detalhe do serviço, para que você tenha sua contabilidade em dia sem dedicar tempo extra.

Solução de problemas​

Erro de conexão​

  • Verifique se você está usando o Production Access Token, não o de sandbox
  • Verifique se o token não expirou ou foi revogado do Developer Dashboard
  • Certifique-se de que o aplicativo do Square tem as permissões necessárias (Payments Read, Orders Read, Customers Read)

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

  • Confirme que você tem transações no período de datas selecionado
  • Apenas transações com status concluído são importadas — as pendentes ou canceladas são excluídas
  • Verifique se você selecionou a localização (location) correta do Square

Transações duplicadas​

  • O Frihet deduplica por ID de transação do Square. Não deveria haver duplicatas
  • Se você vir duplicatas, desconecte e reconecte a integração
  • As transações já importadas no Frihet não são afetadas pela reconexão

Comissões não registradas​

  • As comissões são registradas como despesas separadas, não são descontadas do valor da transação
  • Verifique se a importação de comissões está ativada na configuração da integração

Próximos passos​