Passa al contenuto principale

PrestaShop

Disponibile

Questa integrazione è attiva e pronta all'uso in tutti i piani Pro.

Collega il tuo negozio PrestaShop a Frihet. Importa prodotti e ordini direttamente dall'API Webservice.

A cosa serve?​

Con PrestaShop integrato:

  • Importare ordini — Gli ordini del tuo negozio vengono convertiti in fatture in Frihet
  • Importare prodotti — Porta il tuo catalogo PrestaShop per unificare la gestione
  • Dati sincronizzati — Prezzi, quantità, referenze e stati vengono importati automaticamente

Requisiti​

  • PrestaShop 1.7 o superiore — Con il Servizio Web abilitato
  • Chiave API — Generata dal pannello di amministrazione
  • HTTPS obbligatorio — Il tuo negozio deve avere un certificato SSL
  • Frihet Pro o superiore

Configurare la connessione​

Passo 1: Genera una chiave API in PrestaShop​

  1. Nel tuo pannello di amministrazione PrestaShop, vai a Parametri Avanzati → Servizio Web
  2. Clicca su Aggiungi nuova chiave
  3. Attiva i permessi di lettura (GET) per:
    • products — Per importare prodotti
    • orders — Per importare ordini
    • customers — Per i dati del cliente
  4. Copia la chiave generata

Passo 2: Collega in Frihet​

  1. In Frihet, vai a Impostazioni → Integrazioni
  2. Cerca PrestaShop e clicca
  3. Inserisci l'URL del tuo negozio (es: https://mitienda.com)
  4. Incolla la Chiave API
  5. Clicca su Testa Connessione per verificare
  6. Se corretto, clicca su Salva

Importare dati​

Importare prodotti​

  1. Vai a Impostazioni → Integrazioni → PrestaShop → scheda Dati
  2. Clicca su Importa prodotti
  3. Frihet importa tutti i prodotti attivi del tuo negozio
  4. I prodotti duplicati (stesso SKU o nome) vengono automaticamente omessi

Importare ordini​

  1. Nella stessa scheda Dati, clicca su Importa ordini
  2. La prima importazione recupera gli ordini degli ultimi 30 giorni
  3. Le successive importazioni recuperano solo i nuovi ordini dall'ultima sincronizzazione
  4. Ogni ordine genera una fattura con il formato PS-{id}

Dati importati​

Prodotti​

Dato PrestaShopDato Frihet
NomeNome del prodotto
ReferenzaSKU
Prezzo (senza imposte)Prezzo unitario
Descrizione breveDescrizione
Attivo (sì/no)Stato attivo/inattivo

Ordini​

Dato PrestaShopDato Frihet
ID dell'ordineNumero di fattura (PS-{id})
Data dell'ordineData di emissione
Prodotti dell'ordineLinee di fattura
QuantitàQuantità
Prezzo unitario (senza IVA)Prezzo unitario
Referenza dell'ordineNote della fattura

Esempio pratico​

Ordine in PrestaShop​

Ordine #4521 - 18 feb 2026
- 3x Maglietta Base (ref: CAM-001) @ €15 = €45
- 1x Felpa Premium (ref: SUD-010) @ €45 = €45
Totale: €90 + €18,90 IVA (21%) = €108,90

In Frihet dopo l'importazione​

Fattura PS-4521
Data: 18 feb 2026
- 3x Maglietta Base @ €15 = €45
- 1x Felpa Premium @ €45 = €45
Subtotale: €90,00
IVA (21%): €18,90
Totale: €108,90
Stato: Pagata

Differenze con WooCommerce​

CaratteristicaPrestaShopWooCommerce
Tipo di connessioneChiave API (Webservice)Consumer Key + Secret
Sincronizzazione in tempo realeNo (importazione manuale)Sì (webhooks)
DirezionePrestaShop → FrihetWooCommerce → Frihet
Formato fatturaPS-{id}WC-{number}

Limitazioni​

  • Importazione manuale — Gli ordini non si sincronizzano in tempo reale. Devi cliccare su "Importa ordini" periodicamente
  • Solo lettura — Frihet importa dati da PrestaShop ma non scrive dati a PrestaShop
  • Nessun dato di indirizzo nelle fatture — I dati di spedizione dell'ordine non vengono trasferiti al cliente (prossimamente)

Risoluzione dei problemi​

"Errore di connessione durante il test"​

  • Verifica che l'URL sia corretto e utilizzi https://
  • Controlla che il Servizio Web sia abilitato in PrestaShop
  • Verifica che la chiave API abbia i permessi di lettura per products, orders e customers
  • Se utilizzi un firewall o .htaccess, assicurati che non blocchi /api/

"Non vengono importati tutti i prodotti"​

  • Vengono importati solo i prodotti attivi (stato = 1)
  • I prodotti con lo stesso SKU o nome già esistenti vengono omessi (deduplicazione)

"Gli ordini non appaiono"​

  • La prima importazione recupera solo gli ultimi 30 giorni
  • Verifica che gli ordini abbiano stato "in elaborazione" o superiore
  • Clicca di nuovo su "Importa ordini" se sono arrivati nuovi

"Posso disconnettermi senza perdere dati?"​

Sì. I prodotti e le fatture già importati rimangono in Frihet. Disconnettersi impedisce solo nuove importazioni.

Per disconnettersi:

  1. Vai a Impostazioni → Integrazioni → PrestaShop → scheda Configurazione
  2. Clicca su Disconnetti
  3. Conferma

Prossimi passi​