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 APISeleziona la casella per
"Abilitare la Legacy REST API"Fai clic su
Salva modificheConfigura le impostazioni dei permalink
:Vai su
Impostazioni → Permalink nella tua Dashboard di WordPressIn
Impostazioni comuni, scegli qualsiasi opzione tranne SempliceFai clic su
Salva modificheVerifica che l’API funzioni visitando
https://your-site-url-here.com/wc-api/v1/
nel tuo browserInstalla il plugin WooCommerce Legacy REST API
(per WooCommerce 9.0+):Vai su
Plugin → Aggiungi nuovo nella tua Dashboard di WordPressCerca "WooCommerce Legacy REST API"
Installa e attiva il plugin
Installa il plugin Gelato
:Nella tua Dashboard di WordPress, vai su
Plugin → Aggiungi nuovoCerca "Gelato"
Installa e attiva il plugin
Gelato Integration for WooCommerceAggiorna 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 fileper salvare le modificheFase 2: collegare un negozio WooCommercePer 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 negoziFai clic sul pulsante
Sincronizza prodotti
in alto a destra per recuperare l'elenco attuale dei prodotti del negozioAttendi che la sincronizzazione sia completataAssocia prodotti
:
Dopo la sincronizzazione, tutti i prodotti WooCommerce saranno visibili nella scheda Tutti i prodottiPer 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 destraPuoi 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 destraSeleziona Collega prodotti usando file
Fai clic su Esporta CSV
e verrà scaricato un file CSV con tutti i prodotti del negozioCompleta il CSV:
Apri il file CSV in un'App per fogli di calcoloPer 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 CSVFai clic su Collega prodotti usando file
in alto a destraFase 4: test dell'integrazionePrima di affidarti all'integrazione per gli ordini di produzione, testa bene la connessione:
Fai un ordine di prova
:
Vai sul sito web del negozio WooCommerceAcquista 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 ConnectVerifica 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 produzioneVerifica 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 provaAnnulla direttamente da WooCommerce
Verifica che la cancellazione sia stata gestita correttamente in GelatoConnect
Cancel it through WooCommerce
Verify the cancellation is processed correctly in GelatoConnect