Importe seus recebimentos do Stripe como faturas em 3 cliques
Stripe Revenue Sync converte recebimentos Stripe em faturas Frihet. Sincronização automática 6h, VeriFactu e zero trabalho manual.
Pontos principais
- O Stripe Revenue Sync importa faturas pagas do Stripe para o Frihet com uma API Key somente leitura — sem OAuth, sem permissões perigosas
- Sincronização automática a cada 6 horas: novos recebimentos aparecem na sua contabilidade sem precisar fazer nada
- As faturas importadas são compatíveis com VeriFactu: cadeia de hash SHA-256 e numeração automática sem lacunas
Conteúdo
Você recebe com Stripe. Seus clientes pagam. Mas essas transações não são faturas até que alguém as converta em uma. Esse “alguém” não precisa mais ser você.
Hoje lançamos o Stripe Revenue Sync: uma integração que importa automaticamente seus recebimentos do Stripe como faturas registradas no Frihet. Com deduplicação, cadeia de hash VeriFactu e sincronização automática a cada 6 horas.
O problema: receber por um lado, faturar por outro
Se você é founder de um SaaS, freelancer que recebe pagamentos pelo Stripe ou vende produtos digitais, provavelmente vive nesta situação:
- Stripe recebe. Seus clientes pagam com cartão, assinaturas são renovadas, pagamentos pontuais chegam.
- Sua contabilidade não sabe. Esses recebimentos existem no Stripe, mas não no seu software de faturamento.
- Você faz a ponte. Todo mês, você cria faturas manualmente copiando dados do Stripe. Ou pior: não faz e seu contador fica louco no trimestre seguinte.
O Stripe emite recibos, mas não faturas fiscalmente válidas na Espanha. Não inclui seu NIF, não aplica a numeração exigida pela Hacienda, não gera a cadeia de hash que o VeriFactu requer. Para cumprir com a legislação fiscal espanhola, você precisa criar faturas reais em um software de faturamento.
Até agora, isso significava trabalho dobrado. Não mais.
O que é Stripe Revenue Sync
O Revenue Sync conecta sua conta Stripe ao Frihet usando uma API Key restrita de somente leitura. Sem OAuth, sem redirecionamentos, sem conceder permissões de escrita sobre seu dinheiro.
O que ele faz:
- Consulta suas faturas pagas no Stripe — apenas as que têm o status
paid - Cria uma fatura no Frihet para cada recebimento — com cliente, linhas de detalhe e valores
- Marca a fatura como paga — o pipeline do VeriFactu é ativado automaticamente
- Deduplica por ID do Stripe — se a fatura já existe, ela é ignorada
O resultado: seus recebimentos do Stripe aparecem no Frihet como faturas registradas, com numeração sequencial, hash SHA-256 e prontas para seu Modelo 303.
Como funciona na prática
Três passos. Sem código, sem configurações complexas.
Passo 1: Crie uma API Key restrita no Stripe
Vá para o seu Stripe Dashboard > Developers > API Keys. Crie uma chave restrita com duas permissões:
- Invoices → Read
- Customers → Read
Nada mais. Você não precisa de permissões de escrita nem acesso a pagamentos, transferências ou saldos. A chave começa com rk_live_ e é somente leitura.
Passo 2: Conecte no Frihet
Vá para Configurações > Integrações > Stripe Revenue Sync. Cole sua API Key e selecione a partir de qual data você deseja importar. Você pode importar os últimos 90 dias ou escolher uma data específica.
Passo 3: Importe
Clique em “Importar agora”. O Frihet consulta o Stripe, busca as faturas pagas e as cria em sua conta. Cada fatura passa pelos triggers do Firestore: numeração sem lacunas e cadeia de hash VeriFactu.
VeriFactu compatível desde a primeira importação
As faturas importadas do Stripe não são “de segunda categoria”. Elas passam exatamente pelo mesmo pipeline que as faturas que você cria manualmente no Frihet:
- Numeração sem lacunas — Contador atômico no servidor. Sem falhas, sem saltos.
- Hash SHA-256 — Cadeia de hash com 8 campos exigidos pela AEAT. Cada fatura referencia o hash da anterior.
- Imutabilidade — Uma vez registrada, os campos críticos ficam bloqueados. As modificações geram retificativas.
- Livro de registro — As faturas importadas aparecem na sua exportação CSV com as 19 colunas que a Hacienda pede.
Isso significa que seus recebimentos do Stripe estão prontos para o Modelo 303, o Modelo 130 e qualquer inspeção. Sem passos adicionais.
Para quem é o Revenue Sync
Fundador de SaaS que recebe com Stripe Billing
Você recebe por assinaturas diretamente no Stripe. Todo mês, dezenas ou centenas de clientes renovam. Com o Revenue Sync, cada renovação aparece como fatura no Frihet automaticamente. Seu MRR, seu IVA trimestral e seu livro de registro sempre atualizados.
Freelancer que recebe por projetos via Stripe
Seus clientes pagam você pelo Stripe e você quer ter todas as faturas em um só lugar para seus trimestrais. Sem criar cada fatura manualmente, sem cruzar dados entre Stripe e sua planilha.
eCommerce com Stripe direto
Você vende produtos digitais ou físicos e recebe com Stripe (não através de Shopify ou WooCommerce). Cada venda se converte em fatura registrada. Especialmente útil se você vende para clientes da UE e precisa de controle do IVA.
Agência com faturamento misto
Alguns clientes pagam você pelo Stripe e outros por transferência. O Revenue Sync importa os do Stripe enquanto você fatura o restante manualmente ou com o faturamento direto do Frihet. Tudo coexiste no mesmo livro de registro.
O que o Revenue Sync NÃO é
É conveniente esclarecer para evitar confusões:
- Não é a integração OAuth do Stripe. Essa já existe no Frihet e permite receber pagamentos pelo próprio app com links de pagamento. O Revenue Sync é unidirecional: apenas importa.
- Não emite recebimentos. Não processa pagamentos nem cria cobranças no Stripe. Apenas lê faturas já pagas.
- Não substitui o Stripe Billing. Ele o complementa. O Stripe recebe, o Frihet registra.
- Não filtra por cliente. Importa todas as faturas pagas a partir da data que você escolher. A deduplicação garante que não haja duplicatas.
Segurança
A API Key restrita tem permissões de somente leitura em dois recursos: invoices e customers. Não pode movimentar dinheiro, criar cobranças nem modificar sua conta Stripe.
A chave é armazenada criptografada com AES-256-GCM no servidor do Frihet. Nunca é exposta ao frontend. Se o Stripe detectar que a chave expirou ou foi revogada, o Frihet marca a integração como “requer reconexão” e avisa você.
Você pode desconectar a qualquer momento em Configurações > Integrações. As faturas já importadas permanecem no Frihet.
Comece agora
Se você recebe com Stripe, suas faturas já estão lá. Elas só precisam chegar à sua contabilidade. O Stripe Revenue Sync faz isso em 3 cliques, sem OAuth, sem permissões perigosas e com VeriFactu desde o primeiro dia.
Conecte sua conta Stripe e deixe que seus recebimentos se tornem faturas registradas automaticamente.
Este artigo foi útil?
Perguntas frequentes
Qual a diferença para a integração normal do Stripe?
A integração normal usa OAuth e é bidirecional: você recebe pagamentos pelo Frihet. O Revenue Sync é unidirecional: ele importa faturas já pagas do Stripe usando uma API Key restrita de somente leitura. Ele não tem acesso ao seu dinheiro.
As faturas são duplicadas se eu importar várias vezes?
Não. Cada fatura importada salva o ID do Stripe como metadado. Se já existir no Frihet, é automaticamente ignorada.
As faturas importadas são compatíveis com VeriFactu?
Sim. Elas passam pela cadeia de hash SHA-256 e pela numeração sem lacunas do Frihet, exatamente como as faturas criadas manualmente. Prontas para o seu Modelo 303 e livro de registro.
Posso escolher quais faturas importar?
Você pode definir uma data de início. Todas as faturas pagas a partir dessa data são importadas. A deduplicação garante que nenhuma fatura seja repetida.