Etsy
Esta integração está disponível no Frihet. Configure-a em Settings → Integrações → Etsy.
Conecte sua loja Etsy ao Frihet para importar automaticamente pedidos, produtos e dados de compradores. O Etsy é o marketplace líder para produtos artesanais, vintage e criativos, com mais de 90 milhões de compradores ativos. Com esta integração, cada venda em sua loja Etsy é registrada como receita no Frihet, as comissões do Etsy são contabilizadas como despesas, e as vendas internacionais são gerenciadas com conversão automática de moeda.
Para que serve?
- Importar pedidos — Cada venda no Etsy é automaticamente convertida em uma receita registrada no Frihet com todos os detalhes do pedido
- Comissões e taxas como despesas — As comissões de listagem, transação e processamento do Etsy são automaticamente registradas como despesas
- Catálogo sincronizado — Seus produtos do Etsy são refletidos no catálogo do Frihet
- Multimoeda — As vendas internacionais são importadas com sua moeda original e taxa de câmbio
- Clientes importados — Os compradores do Etsy são adicionados como clientes no Frihet com seus dados de envio
Requisitos
- Conta de vendedor ativa no Etsy
- Plano Frihet Pro ou Business
- Chave de API do Etsy (obtida no Portal do Desenvolvedor do Etsy)
Como conectar
Passo 1: Criar um aplicativo no Etsy
- Vá para o Etsy Developer Portal
- Faça login com sua conta de vendedor
- Clique em Create a New App
- Preencha o nome ("Frihet ERP") e a descrição
- Uma vez aprovado o aplicativo, copie a Chave de API (Keystring)
Passo 2: Configurar no Frihet
- No Frihet, vá para Settings → Integrações
- Procure por Etsy e clique no card
- Cole sua Chave de API no campo correspondente
- Clique em Conectar com Etsy para autorizar o acesso via OAuth
- Aceite as permissões solicitadas na janela do Etsy
- Clique em Salvar
Passo 3: Importação inicial
- Uma vez conectado, clique em Importar pedidos para trazer o histórico de vendas
- Selecione o período que deseja importar
- Revise os pedidos importados e verifique se os dados estão corretos
Dados que são sincronizados
| Dado | Direção | Detalhes |
|---|---|---|
| Pedidos | Etsy → Frihet | ID, valor, data, produtos, endereço de envio |
| Produtos | Etsy → Frihet | Nome, preço, quantidade, variantes |
| Clientes | Etsy → Frihet | Nome do comprador, e-mail (se disponível), endereço |
| Comissões | Etsy → Frihet | Taxas de listagem, taxas de transação, taxas de processamento de pagamento como despesas |
| Moeda | Etsy → Frihet | Moeda original da venda com taxa de câmbio |
| Status do pedido | Etsy → Frihet | Pago, enviado, concluído, reembolsado |
Casos de uso
Artesão com vendas internacionais
Você vende joias artesanais no Etsy para compradores de todo o mundo. Cada venda é importada para o Frihet com a moeda original (USD, GBP, EUR) e a taxa de câmbio real. As comissões do Etsy são automaticamente registradas como despesas, proporcionando uma visão clara da margem real de cada venda. No final do trimestre, você terá todos os dados para sua declaração fiscal.
Vendedor de produtos vintage
Você gerencia um grande catálogo de produtos vintage no Etsy. Cada venda atualiza seu catálogo no Frihet e registra a receita. Você pode gerar relatórios de lucratividade por produto e ver quais categorias de produtos têm melhor margem após a dedução das comissões do Etsy.
Criador digital com downloads
Você vende modelos, ilustrações ou recursos digitais no Etsy. As vendas são importadas automaticamente sem intervenção manual. Como não há custos de envio em produtos digitais, você pode fazer um acompanhamento preciso da margem líquida: preço de venda menos comissões do Etsy.
Solução de problemas
Erro de conexão
- Verifique se a Chave de API está correta e se o aplicativo está ativo no Portal do Desenvolvedor do Etsy
- Verifique se a autorização OAuth não expirou — reconecte a partir das Configurações se necessário
- Certifique-se de que sua conta do Etsy está em bom estado (não suspensa ou restrita)
Pedidos não são importados
- Confirme que você tem vendas no período selecionado
- Apenas pedidos com pagamento concluído são importados — os pagamentos pendentes são excluídos
- Se você tiver muitos pedidos, a importação pode levar alguns minutos — aguarde a conclusão
Comissões não registradas
- As comissões são importadas como despesas separadas, associadas ao pedido correspondente
- Verifique se a importação de comissões está ativada nas configurações da integração
- As comissões de publicidade do Etsy (Etsy Ads) são importadas separadamente
Moeda incorreta
- Frihet usa a moeda da transação original no Etsy
- Se sua contabilidade é em EUR e a venda foi em USD, o Frihet aplica a taxa de câmbio do dia da transação
- Você pode ajustar manualmente a taxa de câmbio a partir do detalhe da despesa/receita