Google Sheets
Esta integração está ativa e pronta para uso no Frihet.
Exporte suas faturas, despesas e resumo fiscal para planilhas profissionais no Google Sheets. Compartilhe relatórios com sua contabilidade por meio de um link. Importe dados de qualquer planilha com detecção automática de colunas.
Para que serve?
Com o Google Sheets integrado:
- Exportar faturas — Livro de faturas com formato profissional, fórmulas e totais
- Exportar despesas — Registro de despesas com categorias e resumo por categoria
- Resumo fiscal — Resumo trimestral pronto para compartilhar com seu contador
- Importar dados — Lê qualquer planilha (faturas, despesas, clientes, produtos)
- Detecção automática — Reconhece colunas em espanhol e inglês com correspondência difusa
- Controle de duplicados — Detecta registros duplicados antes de importar
Requisitos
- Conta Google — Gmail, Google Workspace ou Google One
- Frihet Pro ou superior
- Google Sheets API habilitada no Google Cloud Console (configurado pelo administrador)
Esta integração usa OAuth com o Google. Você não precisa copiar nenhuma chave de API ou token. Simplesmente autorize o Frihet a acessar o Google Sheets por meio de uma janela de login do Google.
Conectar Google Sheets ao Frihet
Passo 1: Iniciar a conexão
- Vá para Configurações → Integrações
- Procure por Google Sheets
- Clique em Conectar com o Google
Passo 2: Autorizar no Google
- A janela de login do Google será aberta
- Selecione sua conta do Google
- Revise as permissões solicitadas:
- Criar e editar planilhas no Google Sheets
- Ver e gerenciar arquivos criados pelo aplicativo no Google Drive
- Clique em Permitir
Passo 3: Verificar conexão
- De volta ao Frihet, você verá "Conectado" ao lado de Google Sheets
- As ações de exportar e importar estarão disponíveis
- A integração está pronta para uso
Como funciona
O Frihet usa a API do Google Sheets v4 com fluxo de autorização OAuth 2.0:
- Você clica em "Conectar com o Google" e autoriza na janela do Google
- O Google gera tokens de acesso e de atualização
- O Frihet armazena ambos os tokens criptografados (AES-256-GCM)
- Com o token de acesso, o Frihet pode criar planilhas e ler as existentes
- O token é atualizado automaticamente quando expira
- Em nenhum momento você insere credenciais do Google no Frihet
Dados sincronizados
| Dado | Direção | Frequência |
|---|---|---|
| Exportar faturas | Frihet → Google Sheets | Sob demanda |
| Exportar despesas | Frihet → Google Sheets | Sob demanda |
| Exportar resumo fiscal | Frihet → Google Sheets | Sob demanda |
| Importar dados | Google Sheets → Frihet | Sob demanda |
Exportar para Google Sheets
Exportar faturas
Cria uma pasta de trabalho profissional com 3 abas:
Aba 1: Faturas
| Coluna | Descrição |
|---|---|
| N. Fatura | Número da fatura |
| Cliente | Nome do cliente |
| NIF | NIF/CIF do cliente |
| Data | Data de emissão |
| Vencimento | Data de vencimento |
| Base Tributável | Subtotal sem impostos |
| IVA % | Tipo de IVA aplicado |
| IVA | Valor do IVA |
| IRPF % | Retenção de IRPF |
| IRPF | Valor de IRPF |
| Total | Valor total |
| Status | Rascunho, enviada, paga, vencida |
Inclui:
- Linha de totais com fórmulas
SUM() - Formato de moeda EUR
- Formato condicional: paga (verde), vencida (vermelho), rascunho (cinza)
- Filtro automático em todas as colunas
- Cabeçalho fixo (congelado)
Aba 2: Resumo Fiscal
Detalhamento por trimestres (Q1-Q4):
- Base tributável por trimestre
- IVA cobrado
- IRPF retido
- Totais anuais
Aba 3: Detalhe das Linhas
Uma linha por item da fatura (expandido):
- N. Fatura, Descrição, Quantidade, Preço Unitário, Subtotal, IVA
Exportar despesas
Cria uma pasta de trabalho com 2 abas:
Aba 1: Despesas
- N. Fatura, Fornecedor, Data, Descrição, Categoria, Base, IVA, IRPF, Total, Tipo IVA
- Formato condicional por categoria
- Filtro automático e linha de totais
Aba 2: Resumo por Categoria
- Detalhamento de despesas por categoria com totais
Exportar resumo fiscal
Cria uma pasta de trabalho completa para seu contador com 3 abas:
- Resumo fiscal (receitas + despesas + estimativa M303)
- Faturas emitidas
- Faturas recebidas (despesas)
Como exportar
- Vá para Configurações → Integrações → Google Sheets
- Na aba Dados, escolha a ação de exportação
- O Frihet cria a planilha no seu Google Drive
- Ela é aberta automaticamente em uma nova aba
- O link é copiado para a área de transferência para compartilhar
Importar do Google Sheets
Tipos de dados suportados
| Tipo | Colunas detectadas automaticamente |
|---|---|
| Faturas | fatura, cliente, NIF, data, total, IVA, status |
| Despesas | fornecedor, data, descrição, categoria, valor, IVA |
| Clientes | nome, NIF, e-mail, telefone, endereço |
| Produtos | nome, descrição, preço, IVA |
Detecção automática de colunas
O Frihet reconhece cabeçalhos em espanhol e inglês com correspondência difusa. Exemplos:
| O Frihet espera | Cabeçalhos reconhecidos |
|---|---|
| Data | data, date, data de emissão, issue date |
| Cliente | cliente, client, customer, nome, razão social |
| NIF | nif, cif, tax id, vat, dni |
| Total | total, valor, amount, montante |
Se não for detectado automaticamente, você pode ajustar o mapeamento manualmente.
Fluxo de importação
- Selecionar planilha — Escolha uma das suas planilhas do Google Drive ou cole uma URL
- Selecionar aba — Se a planilha tiver várias abas, escolha a correta
- Mapeamento de colunas — O Frihet detecta automaticamente o tipo de dados e as colunas. Você pode ajustar
- Pré-visualização — Revise os dados analisados com avisos de validação
- Importar — Os registros são criados no Frihet
Detecção de duplicados
Antes de importar, o Frihet compara os dados com seus registros existentes:
- Compara por número de fatura ou documento
- Mostra avisos para possíveis duplicados
- Você pode omitir duplicados ou sobrescrever
Casos de uso
Compartilhar com a contabilidade
Você exporta o resumo fiscal trimestral para o Google Sheets. Compartilha o link com sua contabilidade. Eles têm acesso instantâneo a faturas, despesas e estimativas fiscais em um formato que conhecem.
Migrar de outro sistema
Você tem suas faturas em um Excel exportado do Holded, Billin ou qualquer outro programa. Você o carrega para o Google Sheets, conecta com o Frihet, e o importador reconhece as colunas automaticamente. Em minutos, você tem todos os seus dados no Frihet.
Análise personalizada
Você exporta seus dados para o Google Sheets e cria gráficos, tabelas dinâmicas ou fórmulas personalizadas que não estão (ainda) no Frihet. O melhor dos dois mundos.
Solução de problemas
"Erro ao conectar com o Google"
- Verifique se sua conta do Google está ativa
- Se você usa Google Workspace corporativo, seu administrador pode ter restringido os aplicativos de terceiros
- Verifique se você não tem bloqueadores de pop-ups
"Nenhum dado foi exportado"
- Verifique se você tem faturas ou despesas criadas no Frihet
- Verifique se a sessão do Google não expirou
- Se o erro persistir, desconecte e reconecte o Google Sheets
"Não vejo minhas planilhas ao importar"
- Apenas planilhas do Google Sheets são listadas (não Excel nem CSV)
- Verifique se a planilha está no seu Google Drive (não apenas compartilhada)
- Para planilhas compartilhadas, primeiro adicione-as a "Meu Drive"
"O importador não detecta as colunas"
- Verifique se a primeira linha contém os nomes das colunas (cabeçalhos)
- Os cabeçalhos devem estar na linha 1 da planilha
- Tente com cabeçalhos mais descritivos (ex: "Data" em vez de "D")
- Você pode ajustar o mapeamento manualmente se a detecção automática falhar
"A sessão expirou"
- O Google pode solicitar reautenticação periodicamente
- Vá para Configurações → Integrações → Google Sheets e clique em Reconectar
"Quero desconectar"
- Vá para Configurações → Integrações → Google Sheets
- Clique em Desconectar
- Os tokens são removidos do Frihet
- Opcionalmente, revogue o acesso em myaccount.google.com/permissions