WooCommerce si collega a Furgox con la procedura di autorizzazione che ha di serie: nessun plugin da installare, nessuna chiave da copiare a mano. Tu scrivi l'indirizzo del negozio, approvi il collegamento dal tuo WordPress e al resto pensiamo noi.
Prima di iniziare
Devi accedere al tuo WordPress come amministratore del negozio.
Il negozio deve essere in HTTPS. WooCommerce non consegna le chiavi API su una connessione non cifrata.
I permalink non possono essere impostati su «Semplice» (Impostazioni → Permalink). La procedura di WooCommerce si trova a un indirizzo tipo
/wc-auth/v1/authorizee senza permalink leggibili restituisce un errore 404.Il negozio deve essere raggiungibile da internet: alla fine del processo è il server di WooCommerce a inviarci le chiavi.
Il tuo WooCommerce deve stare nella radice di un dominio o sottodominio (
mionegozio.itoshop.mionegozio.it). Se si trova in una sottocartella (mionegozio.it/shop), scrivici prima di collegarlo: questo caso non si può collegare dal pannello.
1. Apri Integrazioni e scegli WooCommerce
Nel pannello Furgox apri Integrazioni, clicca su Collega un negozio e seleziona WooCommerce.
2. Scrivi l'indirizzo del negozio
In URL del tuo negozio, inserisci l'indirizzo dove è installato WooCommerce, così come lo scrivono i tuoi clienti (mionegozio.it). Se è in un sottodominio, includilo. Poi clicca su Collega con WooCommerce.
3. Approva il collegamento dal tuo WordPress
Ti portiamo sul tuo negozio. Se non hai la sessione aperta, WordPress ti chiederà di accedere. Vedrai una schermata di WooCommerce che dice che Furgox Fulfillment vuole collegarsi con permessi di lettura e scrittura. Clicca su Approva.
Il permesso di scrittura serve per aggiornare lo stock, scrivere lo SKU Furgox sui tuoi prodotti e segnare gli ordini come spediti. Con la sola lettura, il resto toccherebbe a te.
Quando approvi, WooCommerce crea una chiave API a nome di Furgox e ce la invia. Puoi vederla, e revocarla quando vuoi, in WooCommerce → Impostazioni → Avanzate → API REST.
4. Fatto: il negozio è collegato
Torni al pannello con l'avviso di negozio collegato. In quel momento importiamo il catalogo e gli ordini degli ultimi 30 giorni, e registriamo nel negozio gli avvisi automatici (webhook) che ci informano di ogni nuovo ordine e di ogni modifica ai prodotti.
Cosa succede da adesso
Prodotti
Importiamo prodotti e variazioni con SKU e foto. Quando includi un prodotto nella sua prima entrata riceve il suo SKU Furgox, quello che usiamo sullo scaffale, e lo scriviamo anche nel tuo WooCommerce perché le due parti parlino la stessa lingua. Te lo spieghiamo in Cosa facciamo con il tuo catalogo.
Da WooCommerce non importiamo il codice a barre: se i tuoi prodotti hanno un EAN di fabbrica, indicalo quando crei l'entrata (come creare un'entrata).
Ordini
Ogni nuovo ordine arriva in Furgox all'istante grazie ai webhook. Lo vedi in Ordini con il suo stato di preparazione.
Gli ordini «In attesa di pagamento», «In sospeso» (per esempio un bonifico non ancora arrivato) e «Non riuscito» restano in attesa ed entrano da soli una volta pagati.
Inoltre, ogni 5 minuti ripassiamo il negozio come rete di sicurezza: recuperiamo gli ordini rimasti indietro e registriamo di nuovo gli avvisi se WooCommerce li ha disattivati.
Se preferisci controllare ogni ordine prima che venga preparato, attiva Accetto io gli ordini nella scheda del negozio.
Stock
Pubblichiamo su WooCommerce le unità realmente presenti in magazzino, man mano che entra merce ed escono ordini.
Spedizioni
Quando l'ordine parte lo passiamo a Completato e aggiungiamo una nota visibile al cliente con corriere e numero di tracciamento. WooCommerce non ha un campo di tracciamento nativo, quindi lo salviamo anche come metadato dell'ordine nel caso tu usi un plugin che lo legge. Al passaggio a Completato, WooCommerce invia la sua email di ordine completato se l'hai attivata nelle sue impostazioni email.
Se qualcosa non va
La schermata di autorizzazione dà un errore 404
È il caso più comune e la causa è sempre la stessa: i permalink sono su «Semplice». Cambiali in Impostazioni → Permalink (per esempio «Nome articolo»), salva e riprova.
«Impossibile inviare i dati» al momento di approvare
Quando clicchi su Approva è il tuo server WooCommerce a inviarci le chiavi. Se un firewall o un plugin di sicurezza (Wordfence, regole Cloudflare rigide, ecc.) blocca le chiamate in uscita, l'invio non arriva. Consenti il traffico in uscita verso panel.furgox.com e ripeti la procedura.
«Questo negozio è già collegato a un altro account Furgox»
Uno stesso indirizzo non può stare in due account. Se pensi che sia un errore, scrivici.
Ho eliminato o revocato la chiave di Furgox in WooCommerce
La sincronizzazione si ferma: non riceviamo più ordini e non aggiorniamo lo stock. Quando il negozio rifiuta la nostra chiave più volte di seguito, nel giro di pochi minuti la scheda passa da sola a Scollegato. Per darci una nuova chiave, clicca su Ricollega nella scheda, oppure vai su Collega un negozio → WooCommerce e scrivi lo stesso URL: quando approvi si aggiorna il negozio che avevi già, senza perdere ordini né storico.
Gli ordini hanno smesso di arrivare
Clicca su Sincronizza nella scheda del negozio per recuperare gli ordini degli ultimi 30 giorni e su Webhook per registrare di nuovo gli avvisi. Se la scheda dice «Scollegato», la chiave non è più valida: fai come nel punto precedente. Cosa fa ogni pulsante te lo spieghiamo in Sincronizzare, scollegare o eliminare un negozio.
Se ti blocchi in qualche passaggio, scrivici dalla chat del pannello e lo guardiamo insieme.