PrestaShop
Disponível
Esta integração está ativa e pronta para usar em todos os planos Pro.
Conecta sua loja PrestaShop ao Frihet. Importa produtos e pedidos diretamente da API Webservice.
Para que serve?
Com PrestaShop integrado:
- Importar pedidos — Os pedidos da sua loja se convertem em faturas no Frihet
- Importar produtos — Traz seu catálogo PrestaShop para unificar a gestão
- Dados sincronizados — Preços, quantidades, referências e status são importados automaticamente
Requisitos
- PrestaShop 1.7 ou superior — Com o Serviço Web habilitado
- Chave de API — Gerada a partir do painel de administração
- HTTPS obrigatório — Sua loja deve ter certificado SSL
- Frihet Pro ou superior
Configurar a conexão
Passo 1: Gera uma chave de API no PrestaShop
- No seu painel de administração do PrestaShop, vá para Parâmetros Avançados → Serviço Web
- Clique em Adicionar nova chave
- Ativa as permissões de leitura (GET) para:
products— Para importar produtosorders— Para importar pedidoscustomers— Para dados de cliente
- Copia a chave gerada
Passo 2: Conecta no Frihet
- No Frihet, vá para Configurações → Integrações
- Procure por PrestaShop e clique
- Insira a URL da sua loja (ex:
https://mitienda.com) - Cole a Chave de API
- Clique em Testar Conexão para verificar
- Se estiver correto, clique em Salvar
Importar dados
Importar produtos
- Vá para Configurações → Integrações → PrestaShop → aba Dados
- Clique em Importar produtos
- Frihet importa todos os produtos ativos da sua loja
- Os produtos duplicados (mesmo SKU ou nome) são omitidos automaticamente
Importar pedidos
- Na mesma aba Dados, clique em Importar pedidos
- A primeira importação traz os pedidos dos últimos 30 dias
- As seguintes importações trazem apenas os pedidos novos desde a última sincronização
- Cada pedido gera uma fatura com o formato
PS-{id}
Dados importados
Produtos
| Dado PrestaShop | Dado Frihet |
|---|---|
| Nome | Nome do produto |
| Referência | SKU |
| Preço (sem impostos) | Preço unitário |
| Descrição curta | Descrição |
| Ativo (sim/não) | Estado ativo/inativo |
Pedidos
| Dado PrestaShop | Dado Frihet |
|---|---|
| ID do pedido | Número da fatura (PS-{id}) |
| Data do pedido | Data de emissão |
| Produtos do pedido | Linhas da fatura |
| Quantidade | Quantidade |
| Preço unitário (sem IVA) | Preço unitário |
| Referência do pedido | Notas da fatura |
Exemplo real
Pedido no PrestaShop
Pedido #4521 - 18 fev 2026
- 3x Camiseta Básica (ref: CAM-001) @ €15 = €45
- 1x Sudadera Premium (ref: SUD-010) @ €45 = €45
Total: €90 + €18,90 IVA (21%) = €108,90
No Frihet após importar
Factura PS-4521
Fecha: 18 fev 2026
- 3x Camiseta Básica @ €15 = €45
- 1x Sudadera Premium @ €45 = €45
Subtotal: €90,00
IVA (21%): €18,90
Total: €108,90
Estado: Paga
Diferenças com WooCommerce
| Característica | PrestaShop | WooCommerce |
|---|---|---|
| Tipo de conexão | Chave de API (Webservice) | Consumer Key + Secret |
| Sincronização em tempo real | Não (importação manual) | Sim (webhooks) |
| Direção | PrestaShop → Frihet | WooCommerce → Frihet |
| Formato da fatura | PS-{id} | WC-{number} |
Limitações
- Importação manual — Os pedidos não são sincronizados em tempo real. Você deve clicar em "Importar pedidos" periodicamente
- Somente leitura — Frihet importa dados do PrestaShop mas não escreve de volta
- Sem dados de endereço em faturas — Os dados de envio do pedido não são transferidos para o cliente (em breve)
Troubleshooting
"Erro de conexão ao testar"
- Verifica se a URL está correta e usa
https:// - Confirma que o Serviço Web está habilitado no PrestaShop
- Verifica se a chave de API tem permissões de leitura para
products,ordersecustomers - Se usa um firewall ou
.htaccess, garante que não bloqueia/api/
"Nem todos os produtos são importados"
- Apenas produtos ativos são importados (status = 1)
- Produtos com o mesmo SKU ou nome já existentes são omitidos (deduplicação)
"Os pedidos não aparecem"
- A primeira importação traz apenas os últimos 30 dias
- Verifica se os pedidos têm status "processando" ou superior
- Clique em "Importar pedidos" novamente se houverem novos
"Posso desconectar sem perder dados?"
Sim. Os produtos e faturas já importados permanecem no Frihet. Desconectar apenas impede novas importações.
Para desconectar:
- Vá para Configurações → Integrações → PrestaShop → aba Configuração
- Clique em Desconectar
- Confirma