Configurazione eCommerce

Guida configurazione EBAY

Per configurare il connettore Ebay in Gsped, è necessario compiere la seguente azione e compilare il modulo in tuo possesso (di seguito disponibile), da restituire via email allo specialista Gsped che sta gestendo la tua integrazione.

Autorizzare Gsped su Ebay

Gsped ti fornirà un link da selezionare e con cui accedere alla tua utenza Ebay con tua login privata. Attraverso questo link potrai autorizzare Gsped ad interfacciarsi con il tuo negozio Ebay.

Guida configurazione MAGENTO 2

Per configurare il connettore Magento in Gsped, è necessario recuperare dalla tua utenza Magento le seguenti informazioni e compilare il modulo qui disponibile, da restituire via email allo specialista Gsped che sta gestendo la tua integrazione.

Tipo di autenticazione

Fornire il tipo di autenticazione che sarà utilizzato dal sistema per prelevare ed aggiornare gli ordini. Puoi utilizzare Username e Password, oppure selezionare Access Token. Se si utilizza Username e Password sarà necessario creare un nuovo utente su Magento (come illustrato di seguito) a cui associare i permessi e permettere a Gsped di importare gli ordini.

User e Password

Se si è selezionata l'autenticazione tramite username e password è necessario creare un nuovo ruolo in Magento con i corretti permessi ed un nuovo utente al quale associare il ruolo appena creato. Ti invitamo a creare queste impostazioni sul tuo Magento per ottenere User e Password

1. Creare un Ruolo

Dal pannello di amministrazione di Magento selezionare: System / User role e poi cliccare su “Add New Role”

Dare un nome al ruolo, per esempio “Web Services”. +

Cliccare su “Role Resources” e selezionare “All” oppure selezionare i permessi minimi qui sotto.

Cliccare su “Save Role”, e se richiesto, svuotare la cache di Magento 2.

2. Creare un Utente

Una volta che il nuovo Ruolo è creato è necessario creare l’Utente. Dal pannello di amministrazione di Magento selezionare: System / All users e poi cliccare su “Add New User”

Prendere nota della password assegnata (che dovrà essere poi riportata nel modulo PDF fornito da Gsped)

Cliccare su “Save User”.

3. Aggiungere l’Utente al Ruolo

Cliccare su “User Role” e selezionare il ruolo “Web Service” prima creato. Cliccare su “Save User”.

Store ID

Recuperare da Magento (Stores > All Stores ) gli Store ID dai quali dovranno essere prelevati gli ordini.

Status ordini da prelevare

Nel modulo di configurazione Gsped verrà chiesto di Indicare lo status degli ordini che saranno prelevati da Magento, per esempio: Processing

Guida configurazione PRESTASHOP

Per configurare il connettore Prestashop in Gsped, è necessario recuperare dalla tua utenza Prestashop le seguenti informazioni e compilare il modulo qui disponibile, da restituire via email allo specialista Gsped che sta gestendo la tua integrazione.

Chiave di servizio (Auth)

Puoi trovare queste informazioni sul tuo Prestashop, dal menù di sinistra, Parametri Avanzati > Web Service

Aggiungere una nuova Chiave di servizio che dovrà essere fornita a Gsped.

Permessi Prestashop

Ti invitamo a impostare su Prestashop i seguenti permessi di scrittura per permettere l’aggiornamento ordini. La scrittura dello stato deve essere abilitata nei permessi webservices su Prestashop.

Store ID

Indicare gli Store ID (separati da virgola) dai quali dovranno essere prelevati gli ordini, per esempio 1,2,5. Per indicare tutti gli store utilizzare 0

Status ordini da prelevare

Indicare lo status degli ordini che saranno prelevati automaticamente dal sistema. Questo dato puoi trovarlo sul tuo Prestashop dal menù di sinistra, Parametri negozi > Impostazioni ordine

Guida configurazione WOOCOMMERCE

Per configurare il connettore WooCommerce in Gsped, è necessario recuperare dalla tua utenza WooCommerce le seguenti informazioni e compilare il modulo qui disponibile, da restituire via email allo specialista Gsped che sta gestendo la tua integrazione.

Chiave API e Chiave Segreta

Per generare una chiave API, accedere alla sezione API REST presente nella propria area di amministrazione dell'ecommerce nella sezione WooCommerce -> Avanzate. In questa sezione cliccare sul tasto Aggiungi Chiave

Nella schermata di inserimento compilare il campo descrizione con "Gsped Connector", selezionare un utente con permessi di amministrazione (tipicamente quello che viene proposto di default) ed impostare le autorizzazioni a Leggi/Scrivi per permettere sia la lettura che l’aggiornamento dello status degli ordini.

Dopo aver compilato il form cliccare su Genera Chiave API. La schermata successiva presenta due stringhe alfanumeriche che compongono la chiave API; questi due valori saranno da fornire a Gsped.

Attenzione: questi due valori NON saranno più leggibili dopo aver chiuso la pagina, nel caso non si sia riusciti a copiare i valori, consigliamo di revocare la chiave (sempre dalla Avanzate->API REST) e di ripetere completamente la procedura.

Copiare la Chiave Utente e Utente Nascosto (Label Secret Key) nei rispettivi campi del form da restituire a Gsped. E` possibile utilizzare il tasto Copia presente su WooCommerce.

Guida configurazione SHOPIFY

Per configurare il connettore Shopify in Gsped, è necessario recuperare dalla tua utenza Shopify le seguenti informazioni e compilare il modulo qui disponibile, da restituire via email allo specialista Gsped che sta gestendo la tua integrazione.

Creazione App privata

Per fare questa operazione accedere alla gestione della App private:

• Cliccare su Impostazioni (in basso a sinistra) e selezionare SVILUPPA APP (in basso a destra)

Successivamente cliccare sul tasto Crea un'app presente in alto a destra.

Si aprirà una finestra popup all'intero della quale è necessario indicare un nome per la App che si sta andando a creare inserite il nome Gsped Connect

Dopo aver cliccato il pulsante Crea app verrà visualizzata la scheda della app, cliccare quindi su Configura gli ambiti dell'API del pannello di controllo per definire i permessi da concedere al connettore Gsped per il corretto funzionamento.

Utilizzando il filtro oppure scorredo la barra di scorrimento è possibile trovare e selezionare tutti i permessi. I permessi necessari per il corretto funzionamento del connettore sono

• read_orders

• write_orders

• read_locations

• read_inventory

• read_products

• read_fulfillments

• write_fulfillments

• read_third_party_fulfillment_orders

• write_third_party_fulfillment_orders

• read_merchant_managed_fulfillment_orders

• write_merchant_managed_fulfillment_orders

• read_assigned_fulfillment_orders

• write_assigned_fulfillment_orders

Al termine della selezione di tutti i permessi la schermata dovrebbe presentare un tasto Salva che permette il salvataggio della configurazione (verificare di avere effettivamente selezionato i permessi richiesti)

Dopo il salvataggio dei permessi è possibile passare alla scheda Credenziali API che riporta le chiavi che dovete comunicare a Gsped per l'attivazione effettiva. Cliccare quindi sul tasto Installa App e successivamente confermare l'installazione.

Al termine della creazione sarà caricata una pagina che riporta i dati di accesso API Chiave API e Token di accesso

ATTENZIONE: IL TOKEN SARÀ VISIBILE SOLO 1 VOLTA

Shop name

Dovrà essere comunicato l'url shopify del negozio, quello che termina con shopify.com (esempio: https://nomenegozio.myshopify.com/ )

È possibile tovare l'url corretto da CANALI DI VENDITA dal menu di sinistra, nella parte Negozio online, Domini.

N.B.: Se sono presenti più voci, selezionare quella con "Provider" Shopify (deve terminare con .myshopify.com).

Contrassegno (se attivo)

Indicare la stringa testuale attraverso la quale dovranno essere riconosciuti gli ordini con pagamento in contrassegno (es: Cash On Delivery, Pagamento Alla Consegna)

Stati di prelievo

Indicare gli stati che dovranno avere gli ordini su Shopify per poter essere prelevati

Indicare comportamento per ogni ordine scaricato

In questo campo si va ad indicare come l'applicazione dovrà gestire gli ordini scaricati da Shopify. Le possibili selezioni sono:

• Crea automaticamente la spedizione La creazione automatica della spedizione, genererà una spedizione basata sull'ordine e sulle impostazioni inserite nella sezione impostazioni.

• Effettua picking magazzino e crea la spedizione Gli ordini saranno caricati nella sezione "Pannello di controllo -> Ordini" e necessiteranno di una conferma manuale con picking dei prodotti per la generazione della spedizione.

• Conferma i dati e crea la spedizione Gli ordini saranno caricati nella sezione "Pannello di controllo -> Ordini" e necessiteranno di una conferma manuale senza picking dei prodotti per la generazione della spedizione.

Stati nelle diverse fasi della spedizione

È possibile indicare gli stati che dovrà assumere l'ordine nelle diverse fasi della spedizione. Si prega di indicare anche se il connettore Gsped deve inviare il comando di invio mail a Shopify.

Stati possibili:

• Spedizione creata

• Spedizione partita

• Spedizione in consegna

• Spedizione consegnata

• Spedizione in giacenza

Guida configurazione STOREDEN

Per configurare il connettore Storeden in Gsped, è necessario recuperare dalla tua utenza Storeden le seguenti informazioni e compilare il modulo qui disponibile, da restituire via email allo specialista Gsped che sta gestendo la tua integrazione.

Chiave API

Dal tuo pannello di controllo del tuo Storeden, clicca su Account > Impostazioni

Accedi alla sezione 'Accessi Remoti' e crea un nuovo accesso remoto chiamato Gsped. La chiave di accesso creata sarà da fornire a Gsped.