Questa guida ti accompagna passo dopo passo nel collegare i negozi WooCommerce a GelatoConnect, così potrai automatizzare il flusso degli ordini da WooCommerce direttamente nel tuo workflow di produzione.
Cosa serve prima di iniziare
Prima di iniziare a collegare un negozio WooCommerce a GelatoConnect, assicurati di avere:
Configurazione del cliente in GelatoConnect: il cliente che possiede il negozio WooCommerce deve essere creato con l’accesso a Storefronts abilitato
Configurazione WooCommerce compatibile: WooCommerce versione 2.4.8 o superiore con API configurata correttamente
Accesso admin: il PSP (Print Service Provider) o il tuo cliente devono avere accesso come amministratore al negozio WooCommerce
Panoramica del processo di connessione
Il processo di connessione si sviluppa in quattro fasi principali:
Preparazione: assicurati che tutto sia configurato correttamente su GelatoConnect e WooCommerce
Connessione del negozio: crea il collegamento tra WooCommerce e GelatoConnect
Configurazione prodotto: come preparare i prodotti per la stampa
Test: verifica l'integrazione con ordini di prova
Vediamo insieme ogni fase, passo dopo passo.
Fase 1: preparazione in GelatoConnect e WooCommerce
1) Imposta il tuo cliente
Vai alla sezione Clienti nel menu di navigazione a sinistra del tuo account GelatoConnect
Seleziona il cliente che possiede il negozio WooCommerce; se non esiste già, aggiungi un nuovo cliente.
2) Decidi se vuoi dare al tuo cliente l’accesso all’interfaccia Storefronts Connect
Storefronts Connect è l'interfaccia che PSP e i tuoi clienti usano per gestire gli store B2C (incluso WooCommerce), importare file CSV e gestire negozi manuali.
Senza accesso all'interfaccia Storefronts Connect:
I PSP si occupano di collegare i nuovi prodotti allo store WooCommerce
Il tuo cliente potrebbe contattarti per avere dettagli sull'ordine
Avrai bisogno dei permessi da admin sullo store WooCommerce per autorizzare la connessione
Con l'accesso all'interfaccia Storefronts Connect:
I tuoi clienti possono aggiungere nuovi prodotti al loro store WooCommerce quando preferiscono
Il tuo cliente può vedere la cronologia degli ordini e i dettagli di tracciamento
Non avrai bisogno dell’accesso admin al negozio WooCommerce, ma il tuo cliente sì per autorizzare la connessione.
3) Accedi all'interfaccia Storefronts Connect
I PSP possono accedere agli Storefronts usando le stesse credenziali di accesso GelatoConnect che già utilizzano
Per permettere ai tuoi clienti di accedere a Storefronts Connect:
Vai alla sezione Clienti in GelatoConnect
Seleziona il cliente e poi vai su Modifica cliente in alto a destra
Attiva l'interruttore "Abilita storefronts"
Inserisci l'indirizzo email, il nome e il cognome del tuo cliente
Quando clicchi sul pulsante "Aggiungi admin", il tuo cliente riceverà un'email con le istruzioni per accedere.
4) Prepara il tuo catalogo prodotti
Prima di collegare il negozio, assicurati di avere prodotti configurati in GelatoConnect
Dovrai aver creato modelli di prodotto e prodotti per i clienti utilizzando questi modelli di prodotto
All'interno di un prodotto cliente, puoi decidere quale cliente avrà accesso a quel prodotto.
5) Configura il tuo store WooCommerce
Per assicurarti che il tuo store WooCommerce sia configurato correttamente per l'integrazione con GelatoConnect:
Controlla l'accesso all'API REST di WooCommerce:
Verifica che il tuo file
.htaccesscontenga:SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
Attiva Legacy REST API:
Dal tuo Pannello WooCommerce, vai su WooCommerce → Impostazioni → Avanzate
Seleziona la scheda Legacy API
Seleziona la casella per "Abilitare la Legacy REST API"
Fai clic su Salva modifiche
Configura le impostazioni dei permalink:
Vai su Impostazioni → Permalink nella tua Dashboard di WordPress
In Impostazioni comuni, scegli qualsiasi opzione tranne Semplice
Fai clic su Salva modifiche
Verifica che l’API funzioni visitando
https://your-site-url-here.com/wc-api/v1/nel tuo browser
Installa il plugin WooCommerce Legacy REST API (per WooCommerce 9.0+):
Vai su Plugin → Aggiungi nuovo nella tua Dashboard di WordPress
Cerca "WooCommerce Legacy REST API"
Installa e attiva il plugin
Installa il plugin Gelato:
Nella tua Dashboard di WordPress, vai su Plugin → Aggiungi nuovo
Cerca "Gelato"
Installa e attiva il plugin Gelato Integration for WooCommerce
Aggiorna il plugin Gelato per l'uso con il tuo Storefront:
Nel tuo pannello di amministrazione WordPress, vai su Plugin → Editor plugin
Dal menu a discesa in alto a destra, seleziona Gelato Integration for WooCommerce
Nel pannello a destra, trova e apri includes → Connector → GelatoConnector.php
Trova questa riga di codice:
const GELATO_DASHBOARD_URL = 'https://dashboard.gelato.com';Sostituiscilo con:
const GELATO_DASHBOARD_URL = 'https://storefronts.gelato.com';Fai clic su Aggiorna file per salvare le modifiche
Fase 2: collegare un negozio WooCommerce
Per chi vende (il tuo cliente)
Accedi a Storefronts
Vai su Store:
Fai clic sulla scheda Store nella barra di navigazione a sinistra
Clicca sull'icona di WooCommerce per iniziare il processo di connessione
Inserisci l'URL del tuo store WooCommerce
Clicca su "Continua" per autorizzare la connessione:
Verrai reindirizzato alla pagina di autenticazione di WooCommerce
Accedi se richiesto
Controlla quali permessi richiede Gelato
Clicca su Autorizza per confermare la connessione
Conferma la connessione:
Dopo l'autorizzazione, tornerai alla Dashboard di Storefronts Connect
Verifica che il tuo store compaia nell’elenco dei negozi collegati con lo stato "Connesso"
Per PSP (te)
I passaggi per collegare un negozio WooCommerce come PSP sono molto simili a quelli per collegare un negozio come cliente.
La differenza principale è che ti verrà anche chiesto di scegliere a quali delle tue strutture e a quali dei tuoi clienti assegnare il negozio WooCommerce.
Fase 3: configurazione dei prodotti
Una volta che il negozio è collegato, i tuoi prodotti su GelatoConnect devono essere associati alle inserzioni dei prodotti sul negozio WooCommerce. Ci sono tre modi per collegare i prodotti:
Metodo 1: collega i prodotti WooCommerce già esistenti
Se il negozio ha già prodotti che devono essere realizzati tramite GelatoConnect:
Sincronizza prodotti:
Nella Dashboard di Storefronts Connect, clicca sul negozio WooCommerce collegato nell'elenco dei negozi
Fai clic sul pulsante Sincronizza prodotti in alto a destra per recuperare l'elenco attuale dei prodotti del negozio
Attendi che la sincronizzazione sia completata
Associa prodotti:
Dopo la sincronizzazione, tutti i prodotti WooCommerce saranno visibili nella scheda Tutti i prodotti
Per ogni prodotto da produrre, clicca sul prodotto e poi sul pulsante Connetti
Scegli il prodotto che vuoi collegare dal catalogo
Per i prodotti che richiedono file di design, verrai indirizzatə al Design Editor dove potrai caricare un file di design
Fai clic su Connetti per salvare l'associazione
Metodo 2: crea nuovi prodotti in Storefronts Connect
Per creare nuovi prodotti da pubblicare sullo store WooCommerce:
Vai al negozio WooCommerce nell'elenco dei negozi
Fai clic sul pulsante Aggiungi prodotto in alto a destra
Puoi aggiungere un nuovo prodotto con cucitura singola oppure scegliere uno già presente in un negozio esistente.
Se vuoi aggiungere un nuovo prodotto Cucitura singola:
Scegli un prodotto dal catalogo prodotti
Aggiungi un design usando il Design Editor
Configura i dettagli del prodotto (nome, descrizione, prezzo)
Poi pubblica il prodotto sullo store WooCommerce
Metodo 3: collega più prodotti in una volta sola
Per i negozi con tanti prodotti, puoi usare la funzione di operazione in blocco:
Esporta elenco prodotti:
Vai alla pagina del negozio su Storefronts Connect e clicca su Operazioni in blocco in alto a destra
Seleziona Collega prodotti usando file
Fai clic su Esporta CSV e verrà scaricato un file CSV con tutti i prodotti del negozio
Completa il CSV:
Apri il file CSV in un'App per fogli di calcolo
Per ogni prodotto, aggiungi quanto segue nelle colonne corrispondenti:
Product UID: l'identificatore del prodotto GelatoConnect
URL del file di design: URL del file stampabile per ogni prodotto. Deve essere un link diretto al file.
Importa i prodotti mappati:
Torna su Storefronts e clicca su Operazioni in blocco
Inserisci il tuo indirizzo email, clicca su Carica CSV e scegli il tuo file CSV
Fai clic su Collega prodotti usando file in alto a destra
Fase 4: test dell'integrazione
Prima di affidarti all'integrazione per gli ordini di produzione, testa bene la connessione:
Fai un ordine di prova:
Vai sul sito web del negozio WooCommerce
Acquista uno dei prodotti collegati; ti consigliamo di usare un codice sconto per fare una prova.
Completa il processo di checkout
Verifica la ricezione dell'ordine:
Controlla che l’ordine compaia in Storefronts Connect
Verifica che sia visibile anche nella pagina di gestione ordini dell’ordine in entrata sulla tua Dashboard GelatoConnect
Conferma che tutti i dettagli dell’ordine siano corretti, inclusi:
Informazioni cliente
Specifiche del prodotto
File di design
Dettagli di spedizione
Segui l’ordine durante la produzione:
Segui l’ordine di prova durante tutto il tuo flusso di produzione
Verifica che gli aggiornamenti di stato siano visualizzati correttamente sia in Storefronts Connect che nell'area amministratore di WooCommerce
Annullamento ordine di prova (opzionale):
Fai un altro ordine di prova
Annulla direttamente da WooCommerce
Verifica che la cancellazione sia stata gestita correttamente in GelatoConnect
Configurazione delle notifiche di spedizione
La nostra integrazione WooCommerce trasmette automaticamente i link di tracciamento al tuo negozio, senza la necessità di configurare trigger o postback in GelatoConnect.
Nelle pagine di amministrazione del negozio WooCommerce, puoi decidere quali email vengono successivamente inviate ai tuoi clienti. GelatoConnect non controlla le email rivolte ai clienti.
Puoi personalizzare completamente l'email modificando i template di notifica di WooCommerce. Aggiorna il testo, il branding o la struttura come preferisci!
Per ulteriore assistenza, contatta il nostro team di supporto all'indirizzo [email protected].