WooCommerce
Esta integração está ativa e pronta para usar em todos os planos Pro.
Conecte sua loja WooCommerce ao Frihet. Os pedidos são sincronizados automaticamente e geram faturas.
Para que serve?
Com o WooCommerce integrado:
- Sincronização de pedidos — Novos pedidos aparecem no Frihet automaticamente
- Faturas automáticas — São criadas sem que você faça nada
- Dados do cliente — Nome, e-mail, endereço do pedido são importados
- Controle de estoque — Produtos sincronizados entre ambas as plataformas (opcional)
Requisitos
- WordPress com WooCommerce instalado — Sua loja online
- Acesso ao WordPress — Usuário admin ou com permissões de plugins
- Frihet Pro ou superior
Instalar plugin de conexão
Passo 1: Baixe o plugin
- No WordPress, vá para Plugins → Adicionar novo
- Busque por "Frihet WooCommerce"
- Clique em Instalar
- Depois Ativar
Ou baixe-o manualmente em: frihet.io/plugins/woocommerce
Passo 2: Autorize a conexão
- No WordPress, vá para Configurações → Frihet WooCommerce
- Clique em "Conectar com Frihet"
- Você será redirecionado para o Frihet
- Autorize o acesso
- Redireciona automaticamente para o WordPress
Passo 3: Configure o que sincronizar
Em Configurações → Frihet WooCommerce, escolha:
- ✅ Sincronizar pedidos — Recomendado
- ✅ Criar faturas automáticas — Recomendado
- ⚪ Sincronizar clientes — Opcional
- ⚪ Sincronizar estoque — Somente se precisar
Salve as alterações.
Como funciona a sincronização
Novo pedido no WooCommerce
1. Cliente compra em sua loja
↓
2. WooCommerce recebe o pedido
↓
3. Plugin detecta mudança
↓
4. Envia dados para o Frihet (em tempo real)
↓
5. Frihet cria automaticamente:
- Cliente (se for novo)
- Fatura com os produtos do pedido
↓
6. A fatura aparece em sua lista do Frihet
Dados sincronizados
| Dado | Do WooCommerce para o Frihet |
|---|---|
| Número do pedido | Número da fatura |
| Produtos | Linhas da fatura |
| Quantidade | Quantidade |
| Preço | Preço unitário |
| Cliente | Nome, e-mail, endereço |
| Data do pedido | Data da fatura |
| Status do pedido | Status do pagamento |
| IVA (se configurado) | IVA detalhado |
Status de pedido e fatura
WooCommerce → Frihet
| Status WooCommerce | Status Frihet |
|---|---|
| Pendente de pagamento | Pendente |
| Processando | Pendente |
| Concluído | Paga ✅ |
| Cancelado | Cancelada |
| Reembolso | Reembolso parcial |
Se o cliente marcar o pedido como "Concluído", a fatura é marcada como paga automaticamente.
Exemplo real
Cliente compra em sua loja
Pedido no WooCommerce:
Pedido #1234 - 10 fev 2025
- 2x Produto A @ €50 = €100
- 1x Produto B @ €30 = €30
Total: €130 + €27,30 IVA (21%) = €157,30
Cliente: Juan García
Email: juan@example.com
No Frihet automaticamente
Fatura criada:
Fatura #1234
Data: 10 fev 2025
Cliente: Juan García
- 2x Produto A @ €50 = €100
- 1x Produto B @ €30 = €30
Subtotal: €130,00
IVA (21%): €27,30
Total: €157,30
Status: Paga ✅
A fatura aparece em sua lista. Sem fazer nada.
Configurações avançadas
Mapeamento de categorias de produto
Se você quiser que os produtos do WooCommerce sejam criados como produtos no Frihet:
- Vá para Configurações → Frihet WooCommerce
- Ative "Sincronizar produtos"
- Escolha se deseja sincronizar o estoque
Isso é útil se você quiser reutilizar esses produtos em orçamentos futuros.
Formato de fatura personalizado
Por padrão, o Frihet usa seu formato. Você pode personalizar:
- No Frihet, vá para Configurações → Faturamento
- Modifique o modelo de fatura
- Os novos pedidos do WooCommerce usam esse modelo
E-mail para o cliente
Quando uma fatura é criada a partir do WooCommerce:
- ✅ WooCommerce envia e-mail de confirmação do pedido
- ✅ Frihet pode enviar e-mail da fatura (se você ativar)
Ambos os e-mails irão para o cliente. Você pode desativar um em Configurações para evitar duplicatas.
Teste a integração
Pedido de teste
- Vá para sua loja WooCommerce
- Faça um pedido de teste (como cliente)
- No Frihet, vá para Faturamento → Faturas
- Você deverá ver a fatura criada automaticamente nos últimos 30 segundos
Se não aparecer:
- Espere 1 minuto (às vezes demora)
- Verifique se WooCommerce → Frihet mostra "Conectado"
- Revise os logs de erro em Configurações → Integrações → Logs
Reembolsos e cancelamentos
Cliente cancela pedido no WooCommerce
- O status muda para "Cancelado"
- Frihet detecta a mudança
- A fatura é marcada como "Cancelada"
Cliente solicita reembolso
Se você processar um reembolso no WooCommerce:
- É registrado no pedido
- Frihet cria automaticamente uma nota de crédito (se você ativar em Configurações)
- Ou você pode criar manualmente a nota de crédito no Frihet
Limitações
Frihet → WooCommerce:
- Não sincroniza faturas do Frihet para o WooCommerce — Apenas WooCommerce → Frihet
- Edições no Frihet não afetam o WooCommerce — Se você mudar o preço de uma fatura no Frihet, o WooCommerce não será atualizado
- Produtos novos no Frihet não vão para o WooCommerce — Apenas os existentes são sincronizados
Solução de problemas
"Não vejo as faturas do WooCommerce no Frihet"
- Verifique se a integração está conectada ✅
- O pedido deve estar no status "Processando" ou superior
- Espere 1-2 minutos após criar o pedido
- Recarregue o Frihet (F5)
"Por que os e-mails estão duplicados?"
- WooCommerce envia e-mail do pedido
- Frihet também pode enviar e-mail da fatura
- Solução: Desative os e-mails do Frihet para pedidos do WooCommerce em Configurações → E-mail
"O cliente não corresponde entre WooCommerce e Frihet"
- WooCommerce criou um novo cliente no Frihet
- Se o cliente já existia, pode ter havido duplicidade
- Solução: Mescle clientes manualmente no Frihet
"Posso desconectar sem perder faturas?"
Sim. As faturas já criadas permanecem no Frihet. A desconexão apenas:
- Para novas sincronizações
- Os novos pedidos no WooCommerce não são mais sincronizados
Para desconectar:
- Vá para Configurações → Integrações
- Busque por WooCommerce
- Clique em Desconectar
- Confirme
Frihet emite webhooks em eventos como invoice.created e invoice.paid. Use-os para sincronizar sua loja WooCommerce com sistemas externos ou disparar automações quando faturas forem geradas a partir de pedidos.
Próximos passos
Anterior: Stripe Connect