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.
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:
Clicca su Genera perché PrestaShop crei la chiave e copiala: ti serve allo step 4.
In Descrizione della chiave scrivi
Furgox, per riconoscerla in seguito.Lascia Abilita chiave webservice su Sì.
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.
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
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.
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:
In Integrazioni, nella scheda del negozio PrestaShop, clicca su Scarica il modulo e copia la Chiave del modulo che compare subito sotto.
Nel back office vai in Moduli → Gestione moduli → Carica un modulo e carica il file
furgoxsync.zip.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.