Pular para o conteúdo principal

Lemon Squeezy

Disponível

Esta integração está ativa e pronta para usar no Frihet.

Conecte sua loja Lemon Squeezy ao Frihet. Importe produtos e pedidos de software digital, registre receitas automaticamente e mantenha toda a sua faturação centralizada. Lemon Squeezy atua como Merchant of Record (gerencia impostos para você) e Frihet registra as transações para sua contabilidade.

Para que serve?​

Com Lemon Squeezy integrado:

  • Importar produtos — Traga seu catálogo de software e produtos digitais para o Frihet
  • Importar pedidos — Cada venda é registrada como receita no seu ERP
  • Deduplicação automática — Os pedidos já importados não são duplicados (prefixo LS-)
  • Multi-loja — Se você tem várias lojas, selecione qual importar ou importe de todas
  • Gestão de impostos simplificada — Lemon Squeezy gerencia os impostos como MoR; Frihet registra os valores líquidos
  • Assinaturas — Rastreamento de pagamentos recorrentes de SaaS

Requisitos​

  • Conta Lemon Squeezy ativa — lemonsqueezy.com
  • API Key — É gerada a partir do dashboard
  • Frihet Pro ou superior

Conectar Lemon Squeezy com Frihet​

Passo 1: Obter sua API Key​

  1. Vá para app.lemonsqueezy.com/settings/api
  2. Faça login na sua conta
  3. Clique em Create API key (ou no botão "+")
  4. Dê um nome a ela (ex: "Frihet ERP")
  5. Copie a API Key gerada
Guarde a chave

A API Key é exibida apenas uma vez ao ser criada. Copie-a antes de fechar a janela.

Passo 2: Configurar no Frihet​

  1. Vá para Configurações → Integrações
  2. Procure por Lemon Squeezy
  3. Clique em Conectar
  4. Cole sua API Key
  5. Clique em Verificar conexão
  6. Se estiver correto, o Frihet carregará suas lojas disponíveis
  7. (Opcional) Selecione uma loja específica no menu suspenso — se nenhuma for selecionada, produtos e pedidos de todas as suas lojas serão importados
  8. Clique em Salvar conexão

Passo 3: Verificar conexão​

  1. Frihet exibirá um resumo da sua loja:
    • Nome da loja
    • Número de produtos
    • Pedidos recentes
  2. Realize uma importação de teste

Como funciona​

Frihet usa a API do Lemon Squeezy com formato JSON:API:

  1. Você fornece sua API Key
  2. Frihet envia a chave no cabeçalho Authorization: Bearer <api-key>
  3. As respostas seguem o formato JSON:API (com data, attributes, relationships)
  4. Os produtos e pedidos são importados sob demanda
  5. A deduplicação é baseada no ID de pedido do Lemon Squeezy (prefixo LS-{id})
  6. A API Key é armazenada criptografada (AES-256-GCM) no Frihet

Dados sincronizados​

DadoDireçãoFrequência
ProdutosLemon Squeezy → FrihetSob demanda
Pedidos (orders)Lemon Squeezy → FrihetSob demanda
Dados do compradorLemon Squeezy → FrihetCom cada pedido
Valor e moedaLemon Squeezy → FrihetCom cada pedido
Status do pedidoLemon Squeezy → FrihetCom cada importação

Merchant of Record​

Lemon Squeezy atua como Merchant of Record, o que significa que:

  • Lemon Squeezy cobra o cliente, gerencia IVA/Sales Tax e emite a fatura ao comprador
  • Você recebe o valor líquido (após impostos e comissões)
  • Frihet registra a receita líquida que você recebe para sua contabilidade interna

Isso simplifica sua contabilidade: você não precisa calcular impostos internacionais para cada venda digital.

Casos de uso​

Desenvolvedor indie com SaaS​

Você vende licenças do seu software através do Lemon Squeezy. Cada pagamento é importado para o Frihet como receita, tanto os pagamentos únicos quanto as renovações de assinatura.

Criador de plugins ou temas​

Você vende plugins de WordPress, temas de Shopify ou extensões. Frihet consolida essas receitas com o restante da sua faturação (serviços de consultoria, outros clientes).

Rastreamento de assinaturas​

Você tem um produto SaaS com plano mensal e anual. No Frihet, você pode ver o detalhamento das receitas recorrentes importadas do Lemon Squeezy junto com o restante do seu negócio.

Importar produtos​

  1. Vá para Configurações → Integrações → Lemon Squeezy
  2. Clique em Importar produtos
  3. Frihet trará os produtos da sua loja

Dados importados por produto:

  • Nome
  • Preço
  • Tipo (pagamento único, assinatura)
  • Status (publicado, rascunho)

Importar pedidos​

  1. Vá para Configurações → Integrações → Lemon Squeezy
  2. Clique em Importar pedidos
  3. Selecione o período
  4. Frihet criará registros de receita para cada pedido

Cada pedido importado inclui:

  • ID do pedido
  • Nome e e-mail do comprador
  • Produto adquirido
  • Valor total e líquido
  • Moeda
  • Data do pedido
  • Status (concluído, reembolsado, pendente)

Tentativas automáticas​

Se uma importação falhar devido a um erro temporário (timeout, erro do servidor), o Frihet tentará automaticamente até 3 vezes com esperas exponenciais (1s, 2s, 4s). Você não precisa fazer nada — as tentativas são transparentes.

Solução de problemas​

"Erro de autenticação"​

  • Verifique se a API Key está correta e não foi revogada
  • Verifique se sua conta Lemon Squeezy está ativa
  • Se você criou uma nova API Key, atualize-a no Frihet

"Pedidos não são importados"​

  • Verifique se você tem pedidos no período selecionado
  • Verifique se a API Key não está restrita a certos escopos
  • Se sua loja é nova, certifique-se de que há pelo menos um pedido concluído

"Os valores não correspondem ao que vejo no Lemon Squeezy"​

  • Frihet importa o valor que você recebe (líquido de impostos e comissões do Lemon Squeezy)
  • O valor bruto que o comprador vê inclui impostos gerenciados pelo MoR
  • Consulte o detalhamento no seu dashboard do Lemon Squeezy para confirmar

"Quero desconectar"​

  1. Vá para Configurações → Integrações → Lemon Squeezy
  2. Clique em Desconectar
  3. Opcionalmente, revogue a API Key do seu dashboard Lemon Squeezy

Próximos passos​