Pular para o conteúdo principal

Gumroad

Disponível

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

Conecte sua conta do Gumroad ao Frihet. Importe produtos e vendas de sua loja digital, gere faturas automáticas e consolide suas receitas de criador com o restante de sua faturação.

Para que serve?​

Com Gumroad integrado:

  • Importar produtos — Traga seu catálogo do Gumroad para o Frihet
  • Importar vendas — Cada venda se torna um registro de receita
  • Faturas automáticas — Gere faturas para cada venda com dados do comprador
  • Deduplicação — As vendas já importadas não são duplicadas
  • Prefixo GR- — As vendas importadas são identificadas com o prefixo GR- para fácil rastreamento
  • Status de reembolsos — Os reembolsos no Gumroad são refletidos automaticamente

Requisitos​

  • Conta Gumroad ativa — gumroad.com
  • Access Token da API — É gerado a partir das configurações do Gumroad
  • Frihet Pro ou superior

Conectar Gumroad ao Frihet​

Passo 1: Obter seu Access Token​

  1. Vá para app.gumroad.com/settings/advanced
  2. Faça login em sua conta do Gumroad
  3. Na seção Applications, procure por Access Token
  4. Se você não tiver um, clique em Create application:
    • Nome: "Frihet ERP"
    • Redirect URI: https://app.frihet.io (não é usado, mas é obrigatório)
  5. Copie o Access Token gerado

Passo 2: Configurar no Frihet​

  1. Vá para Configurações → Integrações
  2. Procure por Gumroad
  3. Clique em Conectar
  4. Cole seu Access Token
  5. Clique em Verificar conexão
  6. Se estiver correto, você verá o nome do seu perfil do Gumroad

Passo 3: Verificar conexão​

  1. O Frihet exibirá um resumo de sua conta:
    • Número de produtos ativos
    • Vendas recentes
  2. Faça uma importação de teste para verificar se tudo funciona

Como funciona​

O Frihet usa a API do Gumroad com autenticação Bearer:

  1. Você fornece seu Access Token
  2. O Frihet envia o token no cabeçalho Authorization: Bearer <token>
  3. Os produtos e vendas são importados sob demanda
  4. Cada venda importada recebe um identificador com prefixo GR- (ex: GR-abc123)
  5. A deduplicação é baseada no ID de venda do Gumroad: se uma venda já foi importada, ela não é duplicada
  6. O token é armazenado criptografado (AES-256-GCM) no Frihet

Dados sincronizados​

DadoDireçãoFrequência
ProdutosGumroad → FrihetSob demanda
VendasGumroad → FrihetSob demanda
Dados do compradorGumroad → FrihetCom cada venda
Status de reembolsoGumroad → FrihetCom cada importação
Preço e moedaGumroad → FrihetCom cada venda

Mapeamento de status​

Status GumroadStatus Frihet
Venda concluídaReceita registrada
Reembolso parcialReceita ajustada
Reembolso completoReceita anulada / nota de crédito

Casos de uso​

Criador digital com ebooks e cursos​

Você vende ebooks, templates e cursos no Gumroad. Cada venda é importada para o Frihet automaticamente com os dados do comprador, gerando um registro de receita que você pode faturar e declarar.

Freelancer que vende templates​

Além dos seus serviços de consultoria, você vende templates no Gumroad. O Frihet consolida suas receitas de serviços (faturas manuais) com as de produtos digitais (importados do Gumroad) em um único painel.

Controle de reembolsos​

Um comprador solicita um reembolso no Gumroad. Ao importar novamente as vendas, o Frihet detecta a mudança de status e ajusta o registro de receita para refletir o reembolso.

Importar produtos​

  1. Vá para Configurações → Integrações → Gumroad
  2. Clique em Importar produtos
  3. O Frihet trará todos os seus produtos ativos do Gumroad
  4. Os produtos aparecerão em seu catálogo do Frihet

Dados importados por produto:

  • Nome do produto
  • Preço
  • Descrição
  • Status (ativo/inativo)

Importar vendas​

  1. Vá para Configurações → Integrações → Gumroad
  2. Clique em Importar vendas
  3. Selecione o intervalo de datas
  4. O Frihet importará as vendas e criará registros de receita

Cada venda importada inclui:

  • ID da venda com prefixo GR- (ex: GR-xYz123)
  • Nome e e-mail do comprador
  • Produto vendido
  • Valor e moeda
  • Data da venda
  • Status (concluída / reembolsada)

Retentativas automáticas​

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

Solução de problemas​

"Erro de autenticação"​

  • Verifique se o Access Token está correto
  • Verifique se sua conta do Gumroad está ativa
  • Se você regenerou o token, atualize-o no Frihet

"Minhas vendas não são importadas"​

  • Verifique se você tem vendas no intervalo de datas selecionado
  • As vendas muito antigas podem demorar mais para serem importadas
  • Verifique se o Access Token tem permissões de leitura

"Vejo vendas duplicadas"​

  • Não deveria ocorrer: o Frihet deduplica por ID de venda do Gumroad
  • Se ocorrer, desconecte e reconecte a integração
  • As vendas já registradas no Frihet não serão afetadas

"Um reembolso não é refletido"​

  • Importe as vendas novamente para que o Frihet detecte a mudança de status
  • O reembolso deve estar processado no Gumroad (não apenas solicitado)

Próximos passos​