Come collegare il tuo negozio PrestaShop a Furgox

PrestaShop non ha un pulsante «autorizza»: crei una chiave webservice nel tuo back office e la incolli in Furgox. Ti mostriamo esattamente dove e con quali permessi.

A differenza di Shopify o WooCommerce, PrestaShop non ha una schermata di autorizzazione. Il collegamento si fa con una chiave della API Webservice che crei nel tuo back office e incolli in Furgox. Niente codice da toccare, niente da installare.

Prima di iniziare

  • Devi accedere al back office del negozio come amministratore.

  • Tieni a portata di mano l'indirizzo del negozio. Se PrestaShop è installato in una sottocartella, includila (mionegozio.it/shop).

  • Il tuo server deve avere attiva la riscrittura degli URL: il webservice di PrestaShop ne ha bisogno per rispondere.

1. Attiva il webservice del negozio

Nel back office vai in Parametri avanzati → Webservice. Più in basso, nella configurazione, imposta Abilita il webservice di PrestaShop su Sì e salva. Se era già attivo, passa allo step successivo.

Schermata Webservice del back office di PrestaShop con il servizio attivo

2. Crea una chiave per Furgox

Clicca su Aggiungi nuova chiave webservice (a seconda della versione e della lingua di PrestaShop, il pulsante può chiamarsi in modo leggermente diverso). Nella scheda:

  1. Clicca su Genera perché PrestaShop crei la chiave e copiala: ti serve allo step 4.

  2. In Descrizione della chiave scrivi Furgox, per riconoscerla in seguito.

  3. Lascia Abilita chiave webservice su Sì.

Modulo per creare una chiave webservice in PrestaShop

3. Spunta i permessi

Nella tabella Permessi della stessa schermata, spunta l'intera riga —Visualizza (GET), Modifica (PUT) e Aggiungi (POST)— di queste risorse, e salva:

products, combinations, stock_availables, orders, order_states, order_histories, order_carriers, customers, addresses, countries

A cosa ci serve ogni gruppo:

  • Prodotti e stock: leggere il catalogo con le sue combinazioni, scrivere lo SKU Furgox e aggiornare le unità disponibili.

  • Ordini e stati: importare gli ordini pagati e tenerne aggiornato lo stato.

  • Clienti e indirizzi: sapere dove spedire ogni ordine.

  • Corrieri dell'ordine: scrivere il numero di tracciamento quando il pacco lascia il magazzino.

Ti consigliamo di spuntare anche queste, anche se non sono indispensabili: states, currencies, product_option_values, configurations. Con queste leggiamo la provincia di ogni indirizzo, la valuta degli ordini, i nomi delle opzioni delle combinazioni (taglia, colore…) e il nome e il fuso orario del negozio.

Al collegamento controlliamo che la chiave abbia accesso a ogni risorsa e ti diciamo quali mancano. Quello che in quel momento non possiamo verificare è il permesso di scrittura: se dimentichi PUT o POST, il collegamento funziona ma l'errore comparirà più avanti, quando pubblichiamo lo stock o scriviamo il tracciamento. Spunta l'intera riga.

4. Incolla la chiave in Furgox

Nel pannello apri Integrazioni, clicca su Collega un negozio, scegli PrestaShop e compila URL del tuo negozio e Chiave dell'API Webservice con la chiave copiata. Clicca su Collega con PrestaShop.

Modulo per collegare un negozio PrestaShop nel pannello Furgox

Il collegamento richiede un po' più che su altre piattaforme perché in quel momento leggiamo catalogo e ordini. Nei negozi grandi può volerci un minuto: non chiudere la scheda.

5. Fatto: il negozio è collegato

Avviso di negozio collegato nel pannello Furgox

Cosa succede da adesso

Prodotti

Importiamo i prodotti e le loro combinazioni con riferimento, codice a barre e foto. Quando includi un prodotto nella sua prima entrata riceve il suo SKU Furgox, che scriviamo anche nel tuo PrestaShop. Se più combinazioni condividono lo stesso riferimento, diamo a ciascuna un codice proprio per distinguerle in magazzino. Più dettagli in Cosa facciamo con il tuo catalogo.

Ordini

PrestaShop non può avvisarci da solo di ciò che succede nel negozio, quindi lo interroghiamo ogni 15 secondi. Importiamo gli ordini pagati. Quelli non ancora pagati restano in attesa ed entrano da soli appena il negozio conferma il pagamento; quelli annullati o con errore di pagamento vengono scartati.

Se preferisci controllare ogni ordine prima che venga preparato, attiva Accetto io gli ordini nella scheda del negozio.

Elenco degli ordini importati nel pannello Furgox

Stock

Pubblichiamo su PrestaShop le unità reali del magazzino man mano che entra merce ed escono ordini.

Spedizioni

PrestaShop ha un tracciamento nativo: scriviamo il numero di tracciamento sul corriere dell'ordine —lo stesso che il cliente vede nel suo account e nell'email— e poi portiamo l'ordine allo stato Spedito.

Ricevi gli ordini all'istante (facoltativo)

Se vuoi che gli ordini compaiano subito, senza aspettare il controllo successivo, puoi installare il nostro modulo Furgox Sync:

Scheda del negozio PrestaShop con il pulsante per scaricare il modulo e la chiave
  1. In Integrazioni, nella scheda del negozio PrestaShop, clicca su Scarica il modulo e copia la Chiave del modulo che compare subito sotto.

  2. Nel back office vai in Moduli → Gestione moduli → Carica un modulo e carica il file furgoxsync.zip.

  3. Clicca su Configura e incolla la chiave del modulo. L'indirizzo del pannello è già compilato.

È facoltativo: senza modulo tutto funziona allo stesso modo, solo con qualche secondo di attesa. E anche se lo installi, continuiamo a interrogare il negozio come rete di sicurezza.

Se qualcosa non va

«La chiave non è valida o è disattivata»

Controlla di averla copiata per intero (32 caratteri) e che il suo stato sia Sì in Parametri avanzati → Webservice.

«Il webservice del tuo negozio è disattivato»

Torna allo step 1: devi ancora impostare Abilita il webservice di PrestaShop su Sì.

«Non troviamo l'API a questo indirizzo»

Controlla l'URL. Se PrestaShop è in una sottocartella, includila. Se il negozio è in manutenzione, il tuo IP deve essere nell'elenco di quelli consentiti perché l'API risponda.

«Alla chiave mancano dei permessi»

Ti diciamo quali risorse mancano. Torna alla chiave nel back office, spunta quelle righe per intero e clicca di nuovo su Collega con PrestaShop.

Lo stock o il tracciamento non arrivano al negozio

Quasi sempre alla chiave manca il permesso di scrittura (PUT o POST) su qualche risorsa. Controlla nel back office che le righe dello step 3 siano complete.

Ho eliminato o rigenerato la chiave in PrestaShop

Smettiamo di sincronizzare e, pochi minuti dopo che il negozio inizia a rifiutare la nostra chiave, la scheda passa da sola a Scollegato. Crea una nuova chiave e clicca su Ricollega nella scheda, oppure vai su Collega un negozio → PrestaShop con lo stesso URL: si aggiorna il negozio che avevi già, senza perdere ordini né storico. Cosa fa ogni pulsante della scheda te lo spieghiamo in Sincronizzare, scollegare o eliminare un negozio.

Ti sei bloccato a metà? Scrivici dalla chat del pannello e lo completiamo insieme.

Questo articolo è stato utile?

Torna a Integraciones