Collega il tuo negozio
PrestaShop a GSE-Web
Il tuo catalogo e il tuo stock disponibile partono verso il negozio. Gli ordini che raggiungono gli stati che scegli arrivano in GSE-Web come buoni di uscita confermati, con lo stock riservato.
In breve
Il connettore PrestaShop collega un negozio PrestaShop a un magazzino di GSE-Web, tramite il Webservice nativo del negozio: non c'è nulla da installare in PrestaShop. GSE-Web pubblica lo stock nel negozio e il negozio invia i suoi ordini. Lo configura un amministratore dell'organizzazione, dal menu ADMIN › «Integrazioni».
- Cosa parte verso il negozio: le schede dei prodotti semplici, dei kit e dei prodotti con varianti (nome, riferimento, prezzo di vendita al netto delle tasse, codice a barre), se lo chiedi, e lo stock disponibile del magazzino pubblicato se selezioni «Pubblica lo stock disponibile».
- Cosa arriva in GSE-Web: ogni ordine che raggiunge uno degli stati d'ordine che scegli diventa un buono di uscita confermato, con lo stock riservato, se selezioni «Ricevi gli ordini»; l'acquirente diventa un cliente «Privato». Se lo chiedi, vengono riprese dal negozio anche la descrizione e le foto dei prodotti collegati.
- Quando: lo stock parte verso il negozio pochi secondi dopo ogni modifica in GSE-Web. PrestaShop non avvisa GSE-Web: gli ordini vengono letti ogni 5 minuti, quindi non arrivano in tempo reale.
- Cosa non viene mai fatto: nel negozio non si elimina nulla (un prodotto ritirato dalla vendita vi viene disattivato), GSE-Web non scrive mai le righe di un ordine e non emette mai un rimborso. Imposta solo lo stato d'ordine che hai scelto alla consegna o all'annullamento di un buono, se lo chiedi.
- Interruzione: pausa, disconnessione o chiusura del modulo in qualsiasi momento, senza perdere nulla; alla ripresa, gli ordini effettuati nel frattempo vengono recuperati.
- Il connettore è compatibile con il Webservice di PrestaShop 8 e 9. PrestaShop è un marchio del suo editore; GSE-Web non è né edito né approvato da PrestaShop.
Requisiti
Verifica questi punti prima di aprire la schermata del connettore: il test di connessione li controlla e rifiuta con chiarezza ciò che manca.
Il Webservice attivato e la riscrittura degli URL
Nell'amministrazione di PrestaShop: Parametri avanzati › Webservice, «Attiva il servizio web di PrestaShop». Il Webservice si trova sotto /api/ e richiede la riscrittura degli URL (Apache: mod_rewrite e AllowOverride All).
Una chiave del Webservice con i permessi giusti
32 lettere e cifre, stato attivato. Lettura su shops, languages, currencies, countries, configurations, categories, tax_rule_groups, images, orders, order_states, addresses, customers; lettura, creazione e modifica su products e combinations; lettura e creazione su product_options e product_option_values; lettura e modifica su stock_availables e order_carriers; creazione su order_histories. Il test nomina ogni permesso mancante.
Un indirizzo HTTPS pubblico
Il negozio deve essere raggiungibile da Internet in HTTPS; è ammessa una sottocartella (https://www.mio-negozio.it/negozio). Un indirizzo http:// o su una rete privata viene rifiutato.
Versioni testate, un solo negozio
Il connettore è testato su PrestaShop 8.2.8, 9.1.0 e 9.1.2. Le altre versioni sono accettate, ma la schermata di connessione mostra allora un avviso: contattaci se riscontri un problema. Una chiave che vede più negozi viene rifiutata: il multinegozio non è supportato.
I moduli attivi per la tua organizzazione
«Integrazioni», poi «PrestaShop». L'apertura si chiede a KLS-Concept. Senza «Integrazioni», la voce di menu non compare.
Un account ADMIN con autenticazione a due fattori
L'inserimento della chiave del negozio è rifiutato finché l'autenticazione a due fattori non è attiva sul tuo account, in «Le mie informazioni». Attivala prima di compilare i campi.
Un magazzino reale, la stessa valuta, un gruppo di imposte
Il magazzino pubblicato è un magazzino reale (un magazzino di esercitazione è rifiutato). La valuta del negozio deve essere quella della tua organizzazione e la gestione dello stock deve essere attiva nel negozio. Perché GSE-Web crei schede, il negozio deve avere un gruppo di regole fiscali: un negozio nuovo non ne ha alcuno.
Configurazione passo passo
Sei passaggi, nell'ordine della schermata.
Aprire la schermata del connettore
Menu ADMIN › «Integrazioni». La scheda PrestaShop si trova nella categoria «E-commerce». Fai clic su «Configura» (il pulsante diventa «Gestisci» una volta salvato il negozio).
Scheda «Negozio»
Compila «Indirizzo del negozio» (HTTPS, per esempio https://www.mio-negozio.it), «Chiave del Webservice» (creata in Parametri avanzati › Webservice) e «Magazzino pubblicato» (un magazzino reale).
La chiave è in sola scrittura: una volta salvata, non viene più mostrata; la schermata ne mostra solo l'inizio e la fine. Un negozio già attivato non cambia indirizzo: va prima disconnesso.
Scheda «Impostazioni»
Ogni impostazione ha un valore predefinito:
- «Crea e aggiorna le schede prodotto nel negozio»: non selezionata per impostazione predefinita. In questo caso GSE-Web collega solo i prodotti già presenti nel negozio, tramite il riferimento. Se selezionata, richiede un «Gruppo di regole IVA delle schede create» e una «Categoria predefinita delle schede create» (una scheda esistente conserva le proprie).
- «Pubblica lo stock disponibile»: non selezionata per impostazione predefinita; selezionala perché GSE-Web scriva lo stock nel negozio. Richiede che la gestione dello stock sia attiva nel negozio.
- «Ricevi gli ordini»: non selezionata per impostazione predefinita; selezionala per importare gli ordini. Se selezionata, richiede «Stati dell'ordine che creano un buono» (almeno uno, per esempio «Pagamento accettato»). Gli stati sono propri di ogni negozio; uno stato sconosciuto non viene mai importato.
- «Stati dell'ordine che annullano il buono»: facoltativo. Se vuoto, il negozio non annulla alcun buono.
- «Età massima di un ordine recuperato (giorni)»: 30 per impostazione predefinita, da 1 a 90. Dopo una pausa o una chiusura, un ordine più vecchio non viene importato in automatico.
- «Segnalare consegne e annullamenti al negozio»: non selezionata per impostazione predefinita; selezionala perché consegne e annullamenti vengano segnalati. Se selezionata, con «Stato impostato alla consegna del buono» (di solito «Spedito») e «Stato impostato all'annullamento del buono» (di solito «Annullato»). Senza uno stato scelto, non viene segnalato nulla.
- «Riprendere descrizione e foto dal negozio»: non selezionata per impostazione predefinita. Il negozio resta padrone di questi contenuti; GSE-Web non li scrive mai nel negozio.
- Nessun regime di prezzo da impostare: GSE-Web pubblica il suo prezzo di vendita al netto delle tasse e il negozio calcola il prezzo con tasse con il gruppo di regole scelto.
Salva
Fai clic su «Salva». «Prova la connessione» e «Attiva» usano la configurazione salvata: la schermata chiede di salvare prima ogni modifica.
Provare la connessione, poi scegliere nelle liste del negozio
«Prova la connessione» interroga il negozio: chiave accettata, permessi della chiave (con l'elenco di quelli mancanti), valuta uguale a quella dell'organizzazione, gestione dello stock, un solo negozio visibile. Mostra ciò che il negozio ha dichiarato (versione di PrestaShop, fuso orario, valuta, lingue) e carica le liste da cui scegliere: gruppi di regole fiscali, categorie, stati d'ordine. Scegli lì i tuoi stati, salva e prova di nuovo.
Attiva
«Attiva» ripete il test, richiede le scelte che le tue impostazioni esigono (stati; gruppo fiscale e categoria se crei le schede), poi avvia la sincronizzazione. Gli ordini effettuati prima dell'attivazione non vengono importati.
Cosa si sincronizza, e chi fa fede
Ogni campo ha un solo padrone. In un ordine del negozio, GSE-Web scrive solo il suo stato di consegna o di annullamento, mai le sue righe.
📦 Fa fede GSE-Web
- ✓Nome del prodotto (tutte le lingue del negozio)
- ✓Riferimento (SKU nel negozio)
- ✓Prezzo di vendita al netto delle tasse
- ✓Codice a barre
- ✓Messa in vendita o disattivazione
- ✓Stock, per prodotto o per combinazione
🛒 Fa fede il negozio
- ✓Descrizione (ripresa in GSE-Web come opzione)
- ✓Foto (riprese in GSE-Web come opzione)
- ✓Categorie, promozioni, caratteristiche
- ✓Imposte (gruppi di regole)
- ✓Ordini e loro stati
- ✓Rimborsi
Le regole
- Prodotti semplici, kit e prodotti con varianti. Un prodotto semplice è pubblicato come prodotto standard di PrestaShop. Anche un kit, con per stock il numero di kit montabili con i componenti del magazzino pubblicato. Un prodotto con varianti è pubblicato come prodotto con combinazioni: gli assi (taglia, colore…) diventano gruppi di opzioni e ogni variante è una combinazione con il suo riferimento, il suo stock e una differenza di prezzo rispetto al prezzo base.
- Fa fede il nome di GSE-Web. Un aggiornamento del nome lo riscrive in tutte le lingue attive del negozio: le traduzioni fatte in PrestaShop vengono sovrascritte.
- Un prodotto ritirato dalla vendita in GSE-Web viene disattivato nel negozio; non vi viene mai eliminato. Una variante ritirata dalla vendita viene messa a stock 0. Alla creazione di una scheda, il negozio rifiuta gli ordini senza stock; una scheda esistente conserva l'impostazione del commerciante.
- Prezzo di vendita al netto delle tasse, pubblicato così com'è con 4 decimali. Il negozio calcola il prezzo con tasse con il gruppo di regole scelto per le schede create: se la sua aliquota differisce dall'IVA del prodotto in GSE-Web, il prezzo con tasse del negozio differisce da quello di GSE-Web.
- Stock pubblicato = stock disponibile del magazzino pubblicato (fisico meno riservato), arrotondato per difetto all'unità, mai negativo. Parte verso il negozio pochi secondi dopo ogni modifica: entrata, uscita, trasferimento, inventario, riserva impostata o liberata su un buono. Il passaggio completo lo rilegge anche ogni 5 minuti. Per una variante, lo stock è scritto per combinazione.
- Un ordine = un buono di uscita confermato del magazzino pubblicato, con «Riserva i prodotti per questo buono» spuntato: tutta la quantità ordinata viene riservata, anche oltre lo stock (la parte mancante si legge «In attesa di ricezione» sul buono). L'indirizzo di consegna viene ripreso. Mai un buono parziale: se una riga crea problemi (prodotto sconosciuto, variante sconosciuta, kit non pubblicabile, acquirente senza e-mail, altra valuta), nessun buono viene creato e un punto da gestire lo spiega.
- Rilevamento tramite lettura, senza webhook. PrestaShop non avvisa GSE-Web: ogni 5 minuti, GSE-Web legge gli ordini nuovi o modificati. Un cambio di stato viene quindi visto al passaggio successivo, mai in tempo reale.
- Un acquirente = un cliente «Privato», ritrovato tramite la sua e-mail da un ordine all'altro. Un terzo già presente in GSE-Web non viene abbinato: viene creato un cliente «Privato».
- Un ordine che passa a uno stato di annullamento da te scelto: il buono viene annullato e le sue riserve liberate, a meno che non sia già stato preso in carico da qualcuno. In tal caso, un punto da gestire lascia la decisione al team.
- Ordine modificato nel negozio dopo l'importazione: la modifica non viene riportata sul buono; un punto da gestire ti invita a verificarlo. Un ordine di kit diventa un buono di uscita sui suoi componenti; un ordine di variante dà un buono sulla variante.
- Segnalazione di consegne e annullamenti (impostazione non selezionata per impostazione predefinita: l'ADMIN la seleziona): un buono consegnato o chiuso riceve prima il suo n. di tracciamento (quando la sua spedizione ne ha uno), poi l'ordine passa allo stato scelto; GSE-Web non attiva l'e-mail del negozio: PrestaShop non avvisa l'acquirente di questo cambiamento. Un buono annullato in GSE-Web imposta lo stato di annullamento scelto, senza rimborso: si fa in PrestaShop. Un ordine che il negozio ha già spedito o consegnato non viene annullato: un punto da gestire lo segnala. Consegnato parzialmente o in preparazione: nulla finché il buono non è completo.
- Ripresa di descrizione e foto (impostazione non selezionata per impostazione predefinita): a ogni passaggio, per ogni prodotto collegato, la descrizione del negozio viene copiata come testo semplice (una descrizione vuota non cancella mai quella di GSE-Web); le foto vengono aggiunte nell'ordine del negozio e rimosse quando scompaiono dal negozio. Al massimo 20 foto per prodotto. Non vengono riprese: categorie, promozioni, caratteristiche, contenuto proprio di ogni variante, né nomi, prezzi e codici a barre modificati nel negozio.
Nel quotidiano
La schermata del connettore si legge dall'alto in basso: lo stato, il negozio, le impostazioni, i pulsanti, poi i punti da gestire e il registro.
La scheda «Stato»
Indica a che punto è la connessione, il nome e la valuta del negozio, la data dell'ultima sincronizzazione, l'ultimo errore e il numero di punti da gestire. Sulla scheda della pagina «Integrazioni», lo stato sta in un'etichetta.
- Da attivare «Configurata, non ancora attivata».
- Connesso «Attiva — stock inviato appena cambia, ordini letti ogni 5 minuti». Lo stato segue le impostazioni salvate: senza «Ricevi gli ordini», «… ordini non ricevuti»; senza «Pubblica lo stock disponibile», «… stock non pubblicato».
- In pausa «In pausa — nulla viene inviato né importato».
- Interrotto — da verificare «Interrotta dal server — verifica la chiave del Webservice e prova».
«Sincronizza ora»
Lo stock viene inviato automaticamente al negozio, pochi secondi dopo ogni modifica. PrestaShop non avvisa GSE-Web: gli ordini vengono letti ogni 5 minuti. Questo pulsante serve ad avviare subito la sincronizzazione completa (schede prodotto, lettura degli ordini, consegne). Il messaggio dice se il passaggio è terminato, se ha rilevato punti da gestire o perché non è stato avviato.
La scheda «Cosa passa tra GSE-Web e il negozio»
Sotto le impostazioni, una scheda indica per ogni scambio in quale direzione va: da GSE-Web verso il negozio (schede, stock, varianti, consegne e annullamenti), dal negozio verso GSE-Web (ordini, annullamenti, descrizione e foto) e ciò che non passa mai (righe di un ordine, rimborsi, categorie, regole fiscali, prezzi specifici, nomi, prezzi e codici a barre modificati nel negozio). Una riga legata a un'impostazione non selezionata è contrassegnata «Disattivato».
Il «Registro»
Ogni passaggio vi compare con il suo tipo e il suo esito. Tipi: «Schede prodotto», «Stock», «Stock in tempo reale» (invio appena uno stock cambia, registrato solo se una quantità è cambiata), «Ripresa dal negozio», «Lettura degli ordini», «Ritorno dei buoni», «Test di connessione». Esiti: «Riuscito», «Parziale», «Non riuscito», «In corso», «Interrotto». Un clic su un passaggio ne apre il dettaglio, elemento per elemento. I passaggi che non hanno cambiato nulla possono essere nascosti.
I «Punti da gestire»
Una riga che non passa non blocca mai la sincronizzazione: diventa un punto da gestire e il resto continua. I punti delle schede e dello stock spariscono da soli quando la loro causa è corretta. I punti degli ordini hanno due pulsanti.
- «Riprova» rilegge l'ordine nel negozio e ritenta l'importazione, qualunque sia la sua età. Non è proposto per i punti di segnalazione (evasione, annullamento nel negozio): il passaggio successivo li ritenta da solo.
- «Ignora» archivia il punto: un punto ignorato non torna nell'elenco. «Ignora tutto», in cima all'elenco, archivia in una volta tutti i punti aperti, compresi quelli non visualizzati, dopo una conferma.
Schede prodotto
- Causa
- Il prodotto non è di un tipo che il connettore sa pubblicare.
- Cosa fare
- Usa un prodotto semplice, un kit o un prodotto con varianti.
- Causa
- Il prodotto non ha un prezzo di vendita in GSE-Web.
- Cosa fare
- Inserisci il prezzo di vendita. Il punto scompare al passaggio successivo.
- Causa
- Il riferimento è portato da più prodotti del negozio, inizia con una parentesi quadra, corrisponde a un prodotto di un altro tipo (pack, virtuale, con combinazioni) o è già collegato a un altro prodotto di GSE-Web.
- Cosa fare
- Rendi il riferimento univoco nel negozio o in GSE-Web; GSE-Web non abbina mai a caso.
- Causa
- Il negozio ha rifiutato la scheda (riferimento troppo lungo, nome vuoto, dato non valido).
- Cosa fare
- Correggi la scheda in GSE-Web: il punto scompare al passaggio successivo.
- Causa
- La scheda collegata è stata eliminata in PrestaShop.
- Cosa fare
- Ricreala, oppure togli il prodotto dall'ambito pubblicato, poi risincronizza.
- Causa
- Il prodotto è passato da semplice a con varianti (o l'inverso): il collegamento alla vecchia scheda viene rimosso.
- Cosa fare
- Disattiva o elimina la vecchia scheda in PrestaShop, poi ignora il punto.
- Causa
- Il kit non ha componenti, un componente è archiviato o la sua unità differisce dalla sua unità di base.
- Cosa fare
- Correggi la composizione del kit in GSE-Web.
- Causa
- Il prodotto non ha alcuna variante pubblicabile.
- Cosa fare
- Crea almeno una variante con un prezzo.
- Causa
- Il padre manca, è archiviato, fuori dall'ambito, non ancora pubblicato, oppure i suoi assi non sono validi.
- Cosa fare
- Pubblica il prodotto padre e correggi i suoi assi, poi risincronizza.
- Causa
- La scheda è stata creata ma PrestaShop non ha accettato l'impostazione «rifiuta gli ordini senza stock».
- Cosa fare
- Imposta questa opzione in PrestaShop se lo desideri, poi ignora il punto.
- Causa
- Una foto del negozio non è stata trovata, ha un formato non supportato, è troppo pesante (oltre 5 MB), il negozio non risponde, o il prodotto ne ha più di 20.
- Cosa fare
- Correggi la foto nel negozio; il resto del prodotto viene ripreso comunque.
Stock
- Causa
- La quantità disponibile non è un intero; PrestaShop gestisce solo quantità intere.
- Cosa fare
- Nessuna azione necessaria; la quantità è arrotondata per difetto all'unità.
- Causa
- Il negozio ha rifiutato la quantità inviata.
- Cosa fare
- Verifica la scheda nel negozio; l'invio viene ritentato al passaggio successivo.
Scelte salvate (negozio)
- Causa
- Il gruppo scelto è stato eliminato o disattivato in PrestaShop.
- Cosa fare
- Metti la connessione in pausa, prova, scegli un altro gruppo, salva e riprendi.
- Causa
- La categoria scelta è stata eliminata in PrestaShop.
- Cosa fare
- Metti la connessione in pausa, prova, scegli un'altra categoria, salva e riprendi.
- Causa
- Nessuno stato è scelto, oppure quello che lo era è stato eliminato dal negozio.
- Cosa fare
- Scegli lo stato in «Impostazioni» (in pausa), salva e riprendi.
- Causa
- Nessuno stato è scelto, oppure quello che lo era è stato eliminato dal negozio.
- Cosa fare
- Scegli lo stato in «Impostazioni» (in pausa), salva e riprendi.
Ordini
- Causa
- Una riga dell'ordine porta un riferimento assente da GSE-Web.
- Cosa fare
- Crea il prodotto con lo stesso riferimento, poi «Riprova».
- Causa
- La combinazione ordinata è sconosciuta a GSE-Web, oppure il riferimento di un prodotto con varianti è stato ordinato senza combinazione.
- Cosa fare
- Crea la variante in GSE-Web, poi «Riprova».
- Causa
- Il negozio non fornisce alcuna e-mail per questo acquirente.
- Cosa fare
- Correggi la scheda cliente in PrestaShop, poi «Riprova».
- Causa
- Il cliente «Privato» collegato a questa e-mail è stato archiviato in GSE-Web.
- Cosa fare
- Disarchivia il cliente, poi «Riprova».
- Causa
- La valuta dell'ordine non è quella dell'organizzazione; non viene fatta alcuna conversione.
- Cosa fare
- Tratta questo ordine a mano in GSE-Web, poi ignora il punto.
- Causa
- È più vecchio di «Età massima di un ordine recuperato».
- Cosa fare
- «Riprova» lo importa, qualunque sia la sua età.
- Causa
- Il buono è già stato preso in carico da qualcuno: GSE-Web non lo annulla in silenzio.
- Cosa fare
- Decidi con il team di magazzino se occorre fermare la preparazione.
- Causa
- Le righe dell'ordine sono cambiate da quando il buono è stato creato.
- Cosa fare
- Verifica il buono e correggilo a mano se serve.
- Causa
- Un errore impedisce di creare il buono.
- Cosa fare
- Leggi la causa nel dettaglio del punto, correggila, poi «Riprova».
- Causa
- Il kit ordinato non ha componenti, un componente è archiviato o la sua unità differisce.
- Cosa fare
- Correggi la composizione del kit, poi «Riprova».
- Causa
- Il negozio ha rifiutato lo stato impostato da GSE-Web.
- Cosa fare
- Verifica l'ordine nel negozio; il passaggio successivo riprova.
- Causa
- Il buono è stato annullato in GSE-Web, ma il negozio aveva già spedito o consegnato l'ordine: GSE-Web non lo annulla.
- Cosa fare
- Risolvi la situazione con il cliente (rimborso, reso) direttamente nel negozio.
- Causa
- L'ordine non ha corriere in PrestaShop, o ne ha più d'uno: il n. di tracciamento non ha potuto essere scritto. Lo stato, invece, viene impostato.
- Cosa fare
- Inserisci il n. di tracciamento in PrestaShop se serve.
Pausa, ripresa e modifiche
Il connettore si spegne e si riaccende in qualsiasi momento. Alcune modifiche seguono una regola, che la schermata ricorda e che il server fa rispettare.
«Metti in pausa»
Nulla viene più inviato né importato, e nulla va perso. Lo stock mostrato nel negozio resta quello dell'ultimo invio.
«Riprendi»
Il negozio viene verificato di nuovo (chiave, permessi, valuta, gruppo fiscale, categoria e stati scelti), poi parte il recupero: gli ordini effettuati durante la pausa vengono importati se hanno meno di N giorni («Età massima di un ordine recuperato», 30 per impostazione predefinita). Quelli più vecchi diventano punti da gestire.
Cambiare la chiave del Webservice
Con una connessione attiva, l'indirizzo del negozio e la chiave sono bloccati. Segui quest'ordine: «Metti in pausa», modifica, «Salva», «Prova la connessione», «Riprendi».
Cambiare l'indirizzo del negozio
Prima «Disconnetti»: i prodotti e gli ordini già collegati designano il negozio precedente. Inserisci poi il nuovo indirizzo e la sua chiave.
Ricollegare lo stesso negozio
I prodotti, gli ordini e i clienti già collegati vengono ritrovati: non viene creato un secondo buono per un ordine già importato.
Cambiare il gruppo fiscale, la categoria o gli stati
Solo in pausa. Alla ripresa, queste scelte vengono verificate di nuovo sul negozio: PrestaShop accetta in silenzio un gruppo fiscale o una categoria che non esiste, quindi il controllo lo fa GSE-Web. Un gruppo fiscale o una categoria eliminati nel negozio diventano un punto da gestire e non viene creata alcuna scheda.
«Disconnetti»
La chiave viene cancellata e la sincronizzazione si ferma. Nulla viene eliminato nel negozio né in GSE-Web: i buoni e i clienti già importati restano.
Chiusura del modulo
Se KLS-Concept chiude il modulo per la tua organizzazione, tutto si ferma senza eliminare nulla. Alla riapertura, il passaggio successivo recupera gli ordini e ripubblica lo stock.
Sicurezza e dati
Cosa conserva il connettore, e come.
Chiave cifrata
La chiave del Webservice è cifrata sul server (AES-256-GCM). Non viene mai più mostrata né scritta nei registri.
Autenticazione a due fattori
È obbligatoria per inserire o sostituire le credenziali di un negozio.
Solo negozio HTTPS pubblico
Il connettore chiama solo l'indirizzo HTTPS inserito, su un host pubblico il cui indirizzo è verificato; nessun reindirizzamento viene seguito. Le foto riprese vengono scaricate solo da un indirizzo HTTPS pubblico, senza mai trasmettere la chiave.
Nulla da aprire sul lato GSE-Web
PrestaShop non invia nulla a GSE-Web: è GSE-Web a interrogare il negozio. Nessun indirizzo di GSE-Web va esposto al negozio e nessun modulo va installato al suo interno.
Dati dell'acquirente
I suoi recapiti vengono ripresi nella sua scheda cliente e l'indirizzo di consegna sul buono. Il legame con il negozio conserva solo un'impronta della sua e-mail.
Nulla nell'esportazione
Le credenziali cifrate non compaiono nell'esportazione di portabilità dell'organizzazione.
Risoluzione dei problemi
Il messaggio mostrato dalla schermata, la sua causa e cosa fare. Il codice tra parentesi quadre aiuta l'assistenza a ritrovare il caso. L'app mostra questi messaggi in inglese (o in francese); la traduzione in questa pagina serve a capirli e il codice tra parentesi quadre li identifica.
«Interrotta dal server — verifica la chiave del Webservice e prova»
Dopo cinque rifiuti di autenticazione di fila (chiave disattivata o eliminata in PrestaShop), il server interrompe la connessione per non insistere. Verifica la chiave in Parametri avanzati › Webservice, inseriscila di nuovo se serve, «Salva», «Prova la connessione», poi «Attiva».
- Cosa fare
- Inserisci l'indirizzo HTTPS del negozio, per esempio https://www.mio-negozio.it, senza credenziali né parametri.
[PRESTASHOP_SHOP_URL_INVALID]
- Cosa fare
- Usa l'indirizzo pubblico del negozio.
[PRESTASHOP_SHOP_URL_PRIVATE_HOST]
- Cosa fare
- Verifica che la chiave sia copiata per intero (32 caratteri) e attiva in Parametri avanzati › Webservice.
[PRESTASHOP_SHOP_AUTH_FAILED]
- Cosa fare
- Prova la connessione: la schermata elenca i permessi che mancano alla chiave.
[PRESTASHOP_SHOP_ACCESS_DENIED]
- Cosa fare
- In Parametri avanzati › Webservice, spunta per questa chiave i permessi elencati, poi prova di nuovo.
[PRESTASHOP_RIGHTS_MISSING]
- Cosa fare
- Attiva il Webservice in Parametri avanzati › Webservice e verifica che la riscrittura degli URL funzioni.
[PRESTASHOP_WEBSERVICE_UNAVAILABLE]
- Cosa fare
- Non viene fatta alcuna conversione: allinea la valuta predefinita del negozio a quella dell'organizzazione.
[PRESTASHOP_SHOP_CURRENCY_MISMATCH]
- Cosa fare
- Attiva la gestione dello stock in PrestaShop, oppure deseleziona «Pubblica lo stock disponibile».
[PRESTASHOP_STOCK_MANAGEMENT_DISABLED]
- Cosa fare
- Crea una chiave limitata a un solo negozio.
[PRESTASHOP_MULTISHOP_UNSUPPORTED]
- Cosa fare
- Scegli un gruppo di regole fiscali dopo aver provato la connessione. Un negozio nuovo non ne ha: creane uno in PrestaShop (Internazionale › Imposte › Regole fiscali).
[PRESTASHOP_TAX_GROUP_REQUIRED]
- Cosa fare
- Prova la connessione, poi scegli una categoria dall'elenco.
[PRESTASHOP_CATEGORY_REQUIRED]
- Cosa fare
- Scegli uno stato (per esempio «Pagamento accettato»), oppure deseleziona «Ricevi gli ordini».
[PRESTASHOP_IMPORT_STATES_REQUIRED]
- Cosa fare
- Fai clic su «Disconnetti», poi inserisci il nuovo indirizzo e la sua chiave.
[PRESTASHOP_SHOP_CHANGE_REQUIRES_DISCONNECT]
- Cosa fare
- «Metti in pausa», modifica, «Salva», «Prova la connessione», «Riprendi».
[PRESTASHOP_SHOP_SETTINGS_CHANGE_REQUIRES_PAUSE]
- Cosa fare
- «Metti in pausa», cambia la chiave, «Salva», «Prova la connessione», «Riprendi».
[PRESTASHOP_CONNECTION_ACTIVE_CHANGE_REFUSED]
- Cosa fare
- Inserisci la chiave del Webservice.
[PRESTASHOP_CREDENTIALS_REQUIRED]
- Cosa fare
- Apri «Le mie informazioni», attiva l'autenticazione a due fattori, poi torna.
[PRESTASHOP_CONNECTION_TWO_FACTOR_REQUIRED]
- Cosa fare
- Scegli un magazzino reale come «Magazzino pubblicato».
[PRESTASHOP_WAREHOUSE_EXERCISE_REFUSED]
- Cosa fare
- Verifica che il negozio sia online; riprova tra qualche istante.
[PRESTASHOP_SHOP_UNREACHABLE]
- Cosa fare
- Riprova; se il messaggio persiste, contatta il supporto con il codice qui sotto.
[PRESTASHOP_SHOP_RESPONSE_INVALID]
- Cosa fare
- Attendi qualche minuto; il passaggio successivo riprende.
[PRESTASHOP_SHOP_RATE_LIMITED]
- Cosa fare
- Attendi la fine del passaggio in corso.
[INTEGRATIONS_CONNECTION_BUSY]
- Cosa fare
- Inserisci di nuovo la chiave del Webservice, prova, poi attiva.
[INTEGRATIONS_CREDENTIALS_UNREADABLE]
Domande frequenti
I prodotti con varianti sono supportati?
Sì. Un prodotto con varianti è pubblicato come prodotto con combinazioni, e ogni variante come una combinazione con il suo riferimento, il suo stock e una differenza di prezzo rispetto al prezzo base. Gli assi diventano gruppi di opzioni del negozio.
Si possono collegare più negozi?
No. Un'organizzazione collega un negozio, e un magazzino di GSE-Web, il «Magazzino pubblicato», alimenta quel negozio. Il multinegozio di PrestaShop non è supportato: una chiave che vede più negozi viene rifiutata.
Le consegne vengono rinviate al negozio?
Sì, se «Segnalare consegne e annullamenti al negozio» è selezionata (per impostazione predefinita non lo è: l'ADMIN deve selezionarla) e se hai scelto lo stato da impostare. Un buono consegnato o chiuso porta l'ordine allo stato scelto, con il n. di tracciamento quando la spedizione ne ha uno; GSE-Web non attiva l'e-mail del negozio, PrestaShop non avvisa l'acquirente di questo cambiamento. Un buono annullato imposta lo stato di annullamento scelto, senza rimborso.
Le immagini e la descrizione dei prodotti vengono scambiate?
Non escono mai da GSE-Web: foto e descrizione si gestiscono in PrestaShop. Se invece selezioni «Riprendere descrizione e foto dal negozio», GSE-Web le copia sulla scheda del prodotto collegato a ogni passaggio.
Vengono riprese le categorie, le promozioni e le caratteristiche?
No. Restano gestite in PrestaShop. Le schede create da GSE-Web ricevono una sola categoria predefinita, che scegli tu.
Gli ordini arrivano in tempo reale?
No. PrestaShop non offre un webhook nativo: GSE-Web legge gli ordini nuovi o modificati ogni 5 minuti. Un ordine può quindi comparire fino a 5 minuti dopo il passaggio allo stato scelto. Lo stock, invece, parte da GSE-Web verso il negozio pochi secondi dopo ogni modifica.
Cosa succede se metto in pausa o se il modulo viene chiuso?
Non viene inviato né importato nulla, e nulla viene eliminato. Lo stock nel negozio resta quello dell'ultimo invio. Alla ripresa, gli ordini effettuati nel frattempo vengono recuperati, entro l'età massima scelta.
Quali versioni di PrestaShop sono supportate?
Il connettore è testato su PrestaShop 8.2.8, 9.1.0 e 9.1.2. Le altre versioni sono accettate, con un avviso nella schermata di connessione: contattaci se riscontri un problema.
Il nome dei miei prodotti viene modificato nel negozio?
Quando la creazione e l'aggiornamento delle schede sono attivi, sì: fa fede il nome di GSE-Web, che viene riscritto in tutte le lingue attive del negozio, sovrascrivendo le traduzioni fatte in PrestaShop. Senza questa opzione, GSE-Web non tocca le schede.
Un acquirente già presente tra i miei terzi viene riconosciuto?
No. Il connettore crea un cliente «Privato» per acquirente e lo ritrova tramite la sua e-mail negli ordini successivi.
Gli ordini effettuati prima dell'attivazione vengono importati?
No. Vengono importati solo gli ordini letti dopo l'attivazione.
Come ottengo il connettore?
I moduli «Integrazioni» e «PrestaShop» vengono aperti da KLS-Concept organizzazione per organizzazione. Scrivici dalla pagina Contatti indicando la versione del tuo PrestaShop.
Collega il tuo negozio PrestaShop
Chiedi l'apertura del connettore per la tua organizzazione, oppure poni le tue domande sul tuo caso.