Collega il tuo negozio Shopify
a GSE-Web
Il tuo catalogo e il tuo stock disponibile vanno al negozio. Gli ordini pagati arrivano in GSE-Web come buoni di uscita confermati, con stock riservato.
In breve
Il connettore Shopify collega un negozio Shopify a un magazzino di GSE-Web. GSE-Web pubblica lo stock in una sede del negozio, il negozio invia i suoi ordini. Lo configura un amministratore dell'organizzazione, nel menu ADMIN › «Integrazioni».
- Cosa va al negozio: le schede dei prodotti semplici, dei kit e dei prodotti con varianti (nome, riferimento, prezzo, codice a barre), se lo richiedi, e lo stock disponibile del magazzino pubblicato, posto nella sede Shopify che scegli.
- Cosa arriva in GSE-Web: ogni ordine pagato (o con gli stati di pagamento che scegli) diventa un buono di uscita confermato, con stock riservato; l'acquirente diventa un cliente «Privato». Se lo richiedi, anche la descrizione e le foto dei prodotti collegati vengono riprese dal negozio.
- Quando: lo stock parte verso il negozio pochi secondi dopo ogni modifica in GSE-Web, e un ordine arriva subito tramite webhook. Ogni 5 minuti un passaggio completo recupera ciò che fosse mancato.
- Cosa non viene mai fatto: nulla viene eliminato nel negozio, GSE-Web non scrive mai le righe di un ordine e non emette mai rimborsi. Si limita a evadere o annullare l'ordine, se lo richiedi.
- Interruzione: pausa, disconnessione o chiusura del modulo in qualsiasi momento, senza perdere nulla; alla ripresa, gli ordini effettuati nel frattempo vengono recuperati.
Requisiti
Verifica questi punti prima di aprire la schermata del connettore: il test di connessione li controlla e dice chiaramente cosa non va.
Il dominio myshopify.com del negozio
Il connettore si collega al dominio di amministrazione del negozio, nella forma mio-negozio.myshopify.com, mai al suo indirizzo pubblico.
Un'app nel Dev Dashboard
Creata nell'organizzazione proprietaria del negozio, con queste autorizzazioni: read_products, write_products, read_inventory, write_inventory, read_locations, read_orders, write_orders, write_merchant_managed_fulfillment_orders, read_publications, write_publications. Pubblica una versione, installa l'app sul negozio, poi annota l'ID client e il segreto. Un negozio che ha ancora un'app personalizzata storica usa il suo token Admin (shpat_…) e il suo segreto API.
I dati cliente protetti dichiarati
Nome, e-mail e indirizzo degli acquirenti sono «dati cliente protetti» di Shopify: dichiarane l'uso nel Dev Dashboard. Altrimenti, gli ordini arrivano senza acquirente e diventano punti da gestire.
I moduli attivi per la tua organizzazione
«Integrazioni», poi «Shopify». La loro apertura si richiede a KLS-Concept. Senza «Integrazioni», la voce di menu non compare; senza «Shopify», la sua scheda indica «Non disponibile per la tua organizzazione».
Un account ADMIN con autenticazione a due fattori
L'inserimento delle credenziali del negozio è rifiutato finché l'autenticazione a due fattori non è attiva sul tuo account, in «Le mie informazioni».
Un magazzino reale
Il suo stock disponibile è pubblicato nel negozio e gli ordini vi diventano buoni di uscita. Un magazzino di esercitazione è rifiutato.
La stessa valuta e lo stesso regime dei prezzi
La valuta del negozio deve essere quella della tua organizzazione, e «Prezzi pubblicati» (IVA esclusa o inclusa) deve corrispondere all'impostazione «Includi le tasse nei prezzi» del negozio (Impostazioni › Tasse e dazi).
Configurazione passo passo
Sei passaggi, nell'ordine della schermata.
Aprire la schermata del connettore
Menu ADMIN › «Integrazioni». La scheda Shopify si trova nella categoria «E-commerce». Fai clic su «Configura» (il pulsante diventa «Gestisci» una volta salvato il negozio).
Scheda «Negozio»
Scegli il «Tipo di app»: «App del Dev Dashboard (ID client e segreto)», oppure «App personalizzata storica (token Admin e segreto API)». Compila il «Dominio del negozio» (…myshopify.com), poi l'«ID client dell'app» e il «Segreto dell'app» (oppure il «Token di accesso Admin» e il segreto), e scegli il «Magazzino pubblicato». La scheda ricorda le autorizzazioni da spuntare sull'app.
Le credenziali sono in sola scrittura: una volta salvate, non vengono più mostrate. La schermata mostra solo alcuni caratteri per riconoscerle. Per conservarle, lascia vuoti i campi; per sostituirle, inserisci il segreto E l'ID client (o il token). Con un'app del Dev Dashboard, GSE-Web ottiene da solo il token di accesso, valido 24 ore, e lo rinnova.
Scheda «Impostazioni»
Ogni impostazione ha un valore predefinito:
- «Prezzi pubblicati»: «IVA esclusa» per impostazione predefinita, oppure «IVA inclusa».
- «Crea e aggiorna le schede prodotto nel negozio»: non selezionata per impostazione predefinita. In questo caso GSE-Web non crea nessuna scheda: collega solo i prodotti già presenti nel negozio con lo stesso riferimento (SKU), senza distinguere maiuscole e minuscole.
- «Pubblica lo stock disponibile»: selezionata per impostazione predefinita. Se non è selezionata, lo stock di una scheda creata da GSE-Web non viene tracciato da Shopify.
- «Ricevi gli ordini»: selezionata per impostazione predefinita.
- «Segnalare consegne e annullamenti al negozio»: selezionata per impostazione predefinita. Buono consegnato: ordine evaso nel negozio, con corriere e n. di tracciamento — Shopify avvisa il cliente con la sua e-mail di spedizione. Buono annullato in GSE-Web: ordine annullato nel negozio, senza rimborso.
- «Stati di pagamento importati»: «Pagato» per impostazione predefinita. Puoi aggiungere «Pagamento in attesa», «Pagamento autorizzato» e «Pagato parzialmente» (pagamento alla consegna, bonifico).
- «Età massima di un ordine recuperato (giorni)»: 30 per impostazione predefinita, da 1 a 90. Senza l'autorizzazione
read_all_orders, Shopify restituisce solo gli ordini degli ultimi 60 giorni: il recupero non va più indietro. - «Riprendere descrizione e foto dal negozio»: non selezionata per impostazione predefinita. Il negozio resta il master di descrizione e foto, che GSE-Web non gli invia mai; se selezionata, vengono copiate sulla scheda del prodotto collegato. Una descrizione vuota nel negozio non cancella mai quella di GSE-Web, e una foto aggiunta in GSE-Web non viene mai rimossa.
Salvare
Fai clic su «Salva». «Prova la connessione» e «Attiva» usano la configurazione salvata: finché una modifica non è salvata, la schermata lo ricorda e questi due pulsanti restano in attesa.
Provare la connessione, poi scegliere la sede
«Prova la connessione» interroga il negozio e verifica che le credenziali siano proprio quelle di questo dominio, che l'app abbia tutte le sue autorizzazioni, che la valuta e il regime dei prezzi corrispondano. Carica anche l'elenco delle sedi attive del negozio: scegli la «Sede del negozio» che riceve lo stock, poi «Salva». Anche in caso di rifiuto, il test mostra le autorizzazioni mancanti e le sedi, così puoi correggere.
Attivare
«Attiva» ripete il test (a questo punto è richiesta una sede), poi crea quattro iscrizioni ai webhook nel negozio: ordine creato, modificato, annullato ed eliminato. Lo stato diventa «Attiva — stock inviato appena cambia, sincronizzazione completa ogni 5 minuti» («Attiva — sincronizzazione ogni 5 minuti» se lo stock non è pubblicato). Gli ordini ricevuti prima dell'attivazione non vengono importati.
Cosa si sincronizza, e chi fa fede
Ogni campo ha un solo proprietario. In un ordine del negozio, GSE-Web scrive solo la sua evasione o il suo annullamento, mai le sue righe.
📦 Fa fede GSE-Web
- ✓Nome del prodotto
- ✓Riferimento (SKU nel negozio)
- ✓Prezzo di vendita, IVA esclusa o inclusa secondo l'impostazione
- ✓Codice a barre
- ✓In vendita o bozza
- ✓Stock, nella sede scelta
🛒 Fa fede il negozio
- ✓Descrizione (ripresa in GSE-Web in opzione)
- ✓Foto (riprese in GSE-Web in opzione)
- ✓Collezioni e tag
- ✓Imposte
- ✓Ordini
- ✓Rimborsi
Le regole
- Prodotti semplici, kit e prodotti con varianti. Un prodotto semplice viene pubblicato come un prodotto Shopify con una sola variante. Anche un kit, con come stock il numero di kit assemblabili con i componenti del magazzino pubblicato. Un prodotto con varianti viene pubblicato come un prodotto con opzioni (al massimo tre assi, limite di Shopify), senza prezzo né stock propri; ogni sua variante diventa una variante Shopify, con il suo riferimento, il suo prezzo e il suo stock.
- Un prodotto ritirato dalla vendita in GSE-Web passa in bozza nel negozio; non vi viene mai eliminato. Poiché Shopify non ha uno stato per variante, una variante ritirata dalla vendita viene portata a stock 0. I prodotti creati da GSE-Web vengono pubblicati sul negozio online; una scheda esistente non viene mai ripubblicata, per rispettare la tua scelta se la ritiri da un canale.
- Una scheda modificata nel negozio su un campo per cui fa fede GSE-Web viene riscritta alla successiva modifica del prodotto in GSE-Web. Il tracciamento dello stock di una variante esistente, invece, non viene mai modificato.
- Stock pubblicato = stock disponibile del magazzino pubblicato (fisico meno riservato), arrotondato all'unità inferiore, mai negativo, posto nella sede scelta — le altre sedi del negozio non vengono toccate. Parte verso il negozio pochi secondi dopo ogni modifica: entrata, uscita, trasferimento, inventario, prenotazione posta o liberata su un buono. Il passaggio completo lo rilegge anche ogni 5 minuti.
- 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), e lo stock pubblicato nel negozio scende subito. L'indirizzo di consegna viene ripreso. Mai un buono parziale: se una riga crea problemi (prodotto sconosciuto, variante sconosciuta, kit non pubblicabile, acquirente illeggibile, altra valuta), nessun buono viene creato e un punto da gestire ne spiega il motivo.
- Mai importati: gli ordini di test e quelli con stato di pagamento sconosciuto. Un ordine già evaso in Shopify quando arriva — vendita in cassa (Shopify POS), spedizione fatta dall'amministrazione di Shopify — non genera un buono: farebbe uscire la merce una seconda volta. Un punto da gestire ti chiede di registrarne l'uscita di magazzino in GSE-Web.
- Un acquirente = un cliente «Privato», ritrovato tramite la sua e-mail da un ordine all'altro (codice che inizia con WEB-). Un soggetto già presente in GSE-Web non viene abbinato: viene creato un cliente «Privato».
- Ordine annullato nel negozio (annullato, eliminato, rimborsato o pagamento annullato): il buono viene annullato e le sue riserve liberate, a meno che qualcuno non lo stia già gestendo. In quel caso, un punto da gestire lascia la decisione al team. Un ordine che Shopify non restituisce più (oltre 60 giorni senza
read_all_orders) non viene mai scambiato per un ordine eliminato. - 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 un kit diventa un buono di uscita sui suoi componenti (quantità × numero di kit); la nota del buono cita il kit. Un ordine di una variante dà un buono sulla variante corrispondente, come per qualsiasi prodotto.
- Segnalazione di consegne e annullamenti (impostazione selezionata per impostazione predefinita): un buono consegnato o chiuso evade il suo ordine nel negozio; se è partito in una spedizione, il corriere e il n. di tracciamento vengono trasmessi, e Shopify avvisa il cliente con la sua e-mail di spedizione. Un buono annullato in GSE-Web annulla il suo ordine nel negozio e rimette lo stock in vendita, senza rimborso né e-mail al cliente: il rimborso si fa in Shopify. Un ordine che il negozio ha già evaso non viene annullato, e un'evasione rimasta parziale lato Shopify non è considerata completata: lo segnala un punto da gestire. Consegnato in parte 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 in testo semplice sulla scheda; le foto vengono aggiunte nell'ordine del negozio, la prima è quella principale, e rimosse quando spariscono dal negozio. Al massimo 20 foto per prodotto. Non vengono ripresi: le collezioni, i tag, le imposte, la descrizione e le foto proprie di ogni variante, né i nomi, i prezzi e i 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, sincronizzazione completa ogni 5 minuti». Se lo stock non è pubblicato: «Attiva — sincronizzazione ogni 5 minuti».
- In pausa «In pausa — nulla viene inviato né importato».
- Interrotto — da verificare «Interrotta dal server — verifica le credenziali e prova».
«Sincronizza ora»
Lo stock viene inviato automaticamente al negozio, pochi secondi dopo ogni modifica, e gli ordini arrivano appena vengono effettuati: la schermata lo ricorda sotto il pulsante. Questo pulsante serve solo ad avviare subito la sincronizzazione completa (schede prodotto, ordini mancanti, consegne), che altrimenti avviene ogni 5 minuti. 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 senso va: da GSE-Web al negozio (schede, stock, varianti, consegne e annullamenti), dal negozio a GSE-Web (ordini, annullamenti, descrizione e foto) e ciò che non passa mai (righe di un ordine, rimborsi, collezioni, tag e imposte, 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», «Recupero ordini», «Ritorno dei buoni», «Ordine ricevuto», «Controllo webhook», «Test di connessione». Esiti: «Riuscito», «Parziale», «Non riuscito», «In corso», «Interrotto». Un clic su un passaggio ne apre il dettaglio, elemento per elemento: prodotto creato o aggiornato, stock pubblicato, ordine importato, evaso o annullato, foto ripresa, webhook ricreato… (al massimo 200 elementi per passaggio). 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
- Questo prodotto è di un tipo che il connettore non pubblica. Vengono pubblicati i prodotti semplici, i kit e i prodotti con varianti.
- Cosa fare
- Nulla da fare in GSE-Web. Gestisci questo prodotto direttamente nel negozio.
- Causa
- Il prodotto non ha un prezzo di vendita in GSE-Web.
- Cosa fare
- Inserisci il suo prezzo di vendita. Il punto sparisce al passaggio successivo.
- Causa
- I prezzi sono pubblicati IVA inclusa e il prodotto non ha un'aliquota IVA.
- Cosa fare
- Inserisci l'aliquota IVA del prodotto.
- Causa
- La variante del negozio con questo riferimento è già collegata a un altro prodotto di GSE-Web, appartiene a un prodotto con più varianti mentre quello di GSE-Web è semplice (o viceversa), oppure il negozio usa lo stesso riferimento su più varianti. Anche un riferimento che contiene una virgola non può essere cercato nel negozio.
- Cosa fare
- Fai in modo che un riferimento indichi un solo prodotto, da entrambe le parti.
- Causa
- Shopify ha rifiutato la scheda; il codice di rifiuto è mostrato.
- Cosa fare
- Verifica il prodotto nel negozio a partire da questo codice.
- Causa
- La scheda esiste in Shopify, ma non è stato possibile pubblicarla nel canale «Negozio online»: nessun cliente può acquistarla.
- Cosa fare
- Pubblica il prodotto sul negozio online in Shopify, poi «Ignora». Verifica anche le autorizzazioni di pubblicazione dell'app (
read_publications,write_publications). Questo punto non sparisce da solo: GSE-Web non ripubblica mai una scheda esistente.
- Causa
- Il prodotto collegato non esiste più nel negozio.
- Cosa fare
- Ricrealo nel negozio con lo stesso riferimento. Se non deve più comparirvi, scrivici.
- Causa
- Il prodotto è passato da semplice a «con varianti» (o viceversa): la scheda Shopify del tipo precedente non gli corrisponde più. Il collegamento è stato rimosso; la nuova scheda segue il tipo attuale.
- Cosa fare
- Elimina o archivia la vecchia scheda in Shopify, poi «Ignora».
- Causa
- Il kit non ha alcun componente, uno di essi è archiviato o inattivo, oppure la quantità di un componente è inserita in un'unità diversa dalla sua unità di base. Il kit non viene messo in vendita.
- Cosa fare
- Correggi la distinta del kit. Il punto sparisce al passaggio successivo.
- Causa
- Un prodotto con varianti si vende tramite le sue varianti: senza variante attiva, non viene messo in vendita.
- Cosa fare
- Crea una variante o riattivane una. Il punto sparisce al passaggio successivo.
- Causa
- La variante non può essere pubblicata: il suo prodotto padre è introvabile, archiviato o non ancora pubblicato nel negozio, oppure i suoi assi e valori non sono validi (Shopify accetta al massimo tre assi). Il motivo è indicato tra parentesi.
- Cosa fare
- Correggi la causa indicata, sul prodotto padre o sulla variante. Il punto sparisce al passaggio successivo.
- Causa
- Una foto del negozio non ha potuto essere copiata sulla scheda. Motivi possibili: immagine non trovata, formato non supportato (sono accettati JPEG, PNG, WebP e GIF), oltre 5 MB o illeggibile, negozio non raggiungibile (nuovo tentativo al passaggio successivo), indirizzo immagine non sicuro (HTTPS pubblico richiesto), più di 20 foto (le successive non vengono riprese).
- Cosa fare
- Verifica la foto nei media del prodotto nel negozio. Il punto scompare quando tutto è importato; il resto del prodotto viene ripreso comunque.
Stock
- Causa
- Lo stock disponibile ha dei decimali; il negozio vende solo unità intere.
- Cosa fare
- Solo informativo: il negozio mostra l'unità inferiore.
- Causa
- Shopify ha rifiutato la quantità; il codice di rifiuto è mostrato.
- Cosa fare
- Verifica la scheda del prodotto nel negozio a partire da questo codice.
- Causa
- Lo stock non può essere inviato: nessuna sede è stata scelta, oppure il negozio rifiuta quella scelta (eliminata, disattivata, autorizzazione mancante). GSE-Web non ripiega mai su un'altra sede.
- Cosa fare
- Scegli una sede attiva nella configurazione (metti la connessione in pausa per cambiarla), «Salva», «Prova la connessione», poi «Riprendi».
Ordini
- Causa
- Una riga dell'ordine porta un riferimento che non esiste in GSE-Web.
- Cosa fare
- Crea il prodotto con lo stesso riferimento, poi «Riprova».
- Causa
- Una riga indica una variante che GSE-Web non conosce, oppure il riferimento del prodotto con varianti stesso, senza la sua variante.
- Cosa fare
- Variante sconosciuta: crea la variante in GSE-Web con lo stesso riferimento della variante Shopify, poi «Riprova». Riferimento del prodotto padre ordinato senza variante: gestisci l'ordine a mano.
- Causa
- Senza e-mail, l'acquirente non può essere ritrovato né creato come cliente.
- Cosa fare
- Aggiungi l'e-mail del cliente all'ordine nel negozio, poi «Riprova». Se l'e-mail è già presente, verifica l'accesso dell'app ai dati cliente protetti.
- Causa
- Shopify non comunica all'app né il nome, né l'e-mail, né l'indirizzo dell'acquirente finché non ha dichiarato l'uso dei dati cliente protetti.
- Cosa fare
- Nel Dev Dashboard, dichiara l'accesso ai dati cliente protetti (nome, e-mail, indirizzo), pubblica una versione dell'app, poi «Riprova».
- Causa
- Il cliente che corrisponde a questo acquirente è stato archiviato.
- Cosa fare
- Nessun buono viene creato. Gestisci questo ordine a mano.
- Causa
- L'ordine è in una valuta diversa da quella della tua organizzazione.
- Cosa fare
- Gestisci questo ordine a mano.
- Causa
- Al recupero, l'ordine supera l'«Età massima di un ordine recuperato».
- Cosa fare
- «Riprova» lo importa comunque.
- Causa
- L'ordine era già evaso (in tutto o in parte) in Shopify quando è arrivato: vendita in cassa (Shopify POS) o spedizione fatta dall'amministrazione di Shopify. Un buono lo farebbe uscire una seconda volta; la sua uscita di magazzino non viene quindi registrata in GSE-Web.
- Cosa fare
- Registra l'uscita di magazzino corrispondente in GSE-Web (altrimenti GSE-Web ripubblicherà la sua vecchia disponibilità nel negozio), poi «Ignora».
- Causa
- Il buono è già in preparazione: GSE-Web non lo annulla da solo.
- Cosa fare
- Decidi con il team. Se il buono deve essere annullato, liberalo, poi «Riprova».
- Causa
- L'ordine è cambiato nel negozio dopo la creazione del buono; la modifica non viene riportata.
- Cosa fare
- Confronta l'ordine e il buono, e correggi il buono se necessario.
- Causa
- L'importazione non è riuscita; il motivo è indicato tra parentesi.
- Cosa fare
- Correggi la causa indicata, poi «Riprova».
- Causa
- L'ordine contiene un kit la cui distinta non è valida: nessun componente, un componente archiviato o inattivo, oppure un'unità diversa dall'unità di base. Nessun buono viene creato.
- Cosa fare
- Correggi la distinta del kit, poi «Riprova».
- Causa
- Shopify ha rifiutato di evadere o annullare l'ordine, non l'ha trovato, oppure ne tiene una parte in sospeso (ordine di evasione sospeso o pianificato); il messaggio lo precisa.
- Cosa fare
- Verifica l'ordine nel negozio ed evadilo o annullalo a mano se necessario: il passaggio successivo riprova da solo finché il buono lo richiede.
- Causa
- Il buono è stato annullato in GSE-Web, ma il negozio aveva già evaso o chiuso l'ordine: GSE-Web non lo annulla.
- Cosa fare
- Risolvi la situazione con il cliente (rimborso, reso) direttamente nel negozio.
Webhook
- Causa
- Shopify elimina un'iscrizione ai webhook dopo diversi invii non riusciti, oppure un'iscrizione dell'app è stata eliminata nel negozio.
- Cosa fare
- Nulla da fare: il controllo dei webhook, ogni 6 ore, li ricrea e recupera gli ordini.
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 (credenziali, autorizzazioni, valuta, regime dei prezzi, sede), 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) e se Shopify li restituisce ancora. Quelli più vecchi diventano punti da gestire.
Cambiare credenziali, regime IVA esclusa/inclusa o sede
Con una connessione attiva, il dominio, le credenziali, «Prezzi pubblicati» e la sede sono bloccati. Segui quest'ordine: «Metti in pausa», modifica, «Salva», «Prova la connessione», «Riprendi». Una nuova sede riceve tutto lo stock; la vecchia non viene azzerata — fallo in Shopify, perché il negozio somma le sedi.
Cambiare negozio
Prima «Disconnetti»: le iscrizioni ai webhook del negozio precedente vengono rimosse. Poi inserisci il nuovo negozio; la sede va scelta di nuovo.
Ricollegare lo stesso negozio
I prodotti, gli ordini e i clienti già collegati vengono ritrovati: nessun secondo buono viene creato per un ordine già importato, e tutto lo stock viene reinviato.
Cambiare un'impostazione delle schede
Dopo una modifica di «Prezzi pubblicati» o di «Crea e aggiorna le schede prodotto nel negozio», il passaggio successivo rilegge tutto il catalogo. Una modifica del «Magazzino pubblicato» reinvia tutto lo stock.
«Disconnetti»
Le iscrizioni ai webhook vengono rimosse dal negozio e le credenziali cancellate. Nulla viene eliminato nel negozio né in GSE-Web: i buoni e i clienti già importati restano. Se il negozio non risponde, la schermata ti chiede di eliminare tu stesso le iscrizioni ai webhook dell'app da Shopify.
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.
Credenziali cifrate
Il segreto dell'app, l'ID client o il token Admin sono cifrati sul server (AES-256-GCM). Non vengono mai più mostrati né scritti nei log. Il token di 24 ore di un'app del Dev Dashboard non viene mai salvato.
Autenticazione a due fattori
È obbligatoria per inserire o sostituire le credenziali di un negozio.
Solo il dominio Shopify
Il connettore chiama solo il dominio …myshopify.com inserito, in HTTPS; nessun reindirizzamento viene seguito. Le foto riprese vengono scaricate solo da un indirizzo HTTPS pubblico, senza mai trasmettere il token.
Webhook firmati
Ogni webhook ricevuto è firmato con il segreto dell'app, e la sua firma viene verificata prima di qualsiasi elaborazione. Serve solo da segnale: l'ordine viene riletto presso Shopify, e il suo contenuto non viene conservato.
Dati dell'acquirente
I suoi dati vengono ripresi nella sua scheda cliente e l'indirizzo di consegna sul buono. Il collegamento 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 le credenziali e prova»
Dopo cinque rifiuti di autenticazione consecutivi (app disinstallata, segreto rigenerato, token revocato), il server interrompe la connessione per non insistere. Verifica l'app in Shopify, inserisci nuove credenziali se necessario, «Salva», «Prova la connessione», poi «Attiva».
- Cosa fare
- Inserisci il dominio di amministrazione del negozio (…myshopify.com), non il suo indirizzo pubblico. L'indirizzo di amministrazione incollato dal browser è accettato.
[SHOPIFY_SHOP_DOMAIN_INVALID]
- Cosa fare
- Verifica l'ID client e il segreto nelle impostazioni dell'app (Dev Dashboard), che l'app sia effettivamente installata su questo negozio, e che l'app e il negozio siano nella stessa organizzazione.
[SHOPIFY_SHOP_AUTH_FAILED]
- Cosa fare
- Le credenziali appartengono a un altro negozio: correggi il dominio, oppure inserisci le credenziali dell'app installata su questo negozio.
[SHOPIFY_SHOP_DOMAIN_MISMATCH]
- Cosa fare
- Nel Dev Dashboard, spunta le autorizzazioni mancanti, pubblica una nuova versione e reinstalla l'app sul negozio, poi prova di nuovo. La schermata mostra l'elenco delle autorizzazioni mancanti.
[SHOPIFY_SHOP_SCOPES_MISSING]
- Cosa fare
- Il connettore collega solo un negozio nella valuta della tua organizzazione.
[SHOPIFY_SHOP_CURRENCY_MISMATCH]
- Cosa fare
- In «Impostazioni», scegli per «Prezzi pubblicati» il regime del negozio («Includi le tasse nei prezzi», in Impostazioni › Tasse e dazi). Metti prima la connessione in pausa se è attiva, salva, poi prova.
[SHOPIFY_SHOP_PRICE_MODE_MISMATCH]
- Cosa fare
- «Prova la connessione», scegli la «Sede del negozio», «Salva», poi «Attiva».
[SHOPIFY_LOCATION_REQUIRED]
- Cosa fare
- Metti la connessione in pausa, «Prova la connessione» (l'elenco delle sedi viene ricaricato), scegli una sede attiva, «Salva», poi «Riprendi».
[SHOPIFY_LOCATION_NOT_FOUND]
- Cosa fare
- Risolvi la situazione del negozio con Shopify (abbonamento, pagamento); la sincronizzazione riprende poi da sola.
[SHOPIFY_SHOP_UNAVAILABLE]
- Cosa fare
- Verifica che il negozio risponda, poi riprova.
[SHOPIFY_SHOP_UNREACHABLE]
- Cosa fare
- Riprova un po' più tardi.
[SHOPIFY_SHOP_TIMEOUT]
- Cosa fare
- Attendi: il passaggio successivo riprende da solo.
[SHOPIFY_SHOP_RATE_LIMITED]
- Cosa fare
- Riprova; se il messaggio si ripresenta, scrivici indicando il codice qui sotto.
[SHOPIFY_SHOP_RESPONSE_INVALID]
- Cosa fare
- «Metti in pausa», modifica, «Salva», «Prova la connessione», «Riprendi».
[SHOPIFY_CONNECTION_ACTIVE_CHANGE_REFUSED]
- Cosa fare
- «Disconnetti», poi inserisci il nuovo negozio.
[SHOPIFY_SHOP_CHANGE_REQUIRES_DISCONNECT]
- Cosa fare
- Segui quest'ordine: «Metti in pausa», modifica «Prezzi pubblicati», salva, prova, poi «Riprendi». Il regime viene verificato con il negozio al test e alla ripresa.
[SHOPIFY_PRICE_MODE_CHANGE_REQUIRES_PAUSE]
- Cosa fare
- Inserisci il segreto con l'ID client (o con il token Admin), oppure lascia tutto vuoto per conservare le credenziali salvate.
[SHOPIFY_CREDENTIALS_REQUIRED]
- Cosa fare
- Attivala in «Le mie informazioni» (la schermata propone «Apri «Le mie informazioni»»), poi salva di nuovo.
[SHOPIFY_CONNECTION_TWO_FACTOR_REQUIRED]
- Cosa fare
- Scegli un magazzino reale come «Magazzino pubblicato».
[SHOPIFY_WAREHOUSE_EXERCISE_REFUSED]
- Cosa fare
- Inserisci di nuovo il segreto e l'ID client (o il token), prova, poi attiva.
[INTEGRATIONS_CREDENTIALS_UNREADABLE]
- Cosa fare
- Attendi la fine del passaggio in corso.
[INTEGRATIONS_CONNECTION_BUSY]
Domande frequenti
I prodotti con varianti sono supportati?
Sì. Un prodotto con varianti viene pubblicato come un prodotto con opzioni, e ciascuna delle sue varianti come una variante Shopify, con il suo riferimento, il suo prezzo e il suo stock. Shopify accetta al massimo tre assi (taglia, colore, materiale…). Un ordine di una variante dà un buono sulla variante corrispondente.
Si possono collegare più negozi o più sedi?
No. Un'organizzazione collega un negozio, e un magazzino di GSE-Web, il «Magazzino pubblicato», alimenta una sola sede del negozio. Le altre sedi Shopify non vengono toccate.
Le consegne vengono comunicate al negozio?
Sì, se «Segnalare consegne e annullamenti al negozio» è selezionata, come avviene per impostazione predefinita. Un buono consegnato evade il suo ordine nel negozio; se è partito in una spedizione, il corriere e il n. di tracciamento vengono trasmessi, e Shopify invia al cliente la sua e-mail di spedizione. Un buono annullato in GSE-Web annulla il suo ordine nel negozio, senza rimborso. GSE-Web non scrive mai le righe di un ordine.
Le immagini e la descrizione dei prodotti vengono scambiate?
Non partono mai da GSE-Web: foto e descrizione si gestiscono in Shopify. Se invece selezioni «Riprendere descrizione e foto dal negozio», vengono copiate in GSE-Web sui prodotti collegati. Foto e descrizione proprie di ogni variante non vengono riprese.
Le collezioni, i tag e le imposte del negozio vengono ripresi?
No. Restano gestiti in Shopify, e GSE-Web non li riprende.
E le vendite in cassa (Shopify POS)?
Un ordine già evaso in Shopify quando arriva, come una vendita in cassa, non diventa un buono: la merce è già uscita. Un punto da gestire ti chiede di registrarne l'uscita di magazzino in GSE-Web; altrimenti, GSE-Web ripubblicherebbe la sua vecchia disponibilità nel negozio.
Cosa succede se metto in pausa o se il modulo viene chiuso?
Nulla viene inviato né importato, e nulla viene eliminato. Lo stock nel negozio resta quello dell'ultimo invio. Alla ripresa, gli ordini effettuati nel frattempo vengono recuperati se hanno meno di 30 giorni (regolabile da 1 a 90, e al massimo 60 giorni senza l'autorizzazione read_all_orders).
Dopo quanto tempo un ordine compare in GSE-Web?
Subito, tramite webhook. Se un webhook va perso, il passaggio successivo, ogni 5 minuti, recupera l'ordine.
Il negozio può vendere un prodotto che non è più in stock?
Il rischio si riduce a pochi secondi, senza sparire. Lo stock parte verso il negozio pochi secondi dopo ogni uscita, entrata o prenotazione registrata in GSE-Web, e ogni ordine del negozio riserva subito tutta la sua quantità. Una vendita nel negozio nel momento esatto di un'uscita in magazzino resta possibile: diventa un buono la cui parte mancante si legge «In attesa di ricezione».
Un acquirente già presente tra i miei soggetti viene riconosciuto?
No. Il connettore crea un cliente «Privato» per acquirente e lo ritrova tramite la sua e-mail negli ordini successivi, ma non lo abbina a un soggetto già inserito in GSE-Web.
Gli ordini effettuati prima dell'attivazione vengono importati?
No. Vengono importati solo gli ordini ricevuti dopo l'attivazione.
Come ottengo il connettore?
I moduli «Integrazioni» e «Shopify» vengono aperti da KLS-Concept organizzazione per organizzazione. Scrivici dalla pagina dei contatti.
Collega il tuo negozio Shopify
Chiedi l'apertura del connettore per la tua organizzazione, oppure inviaci le tue domande sul tuo caso.