Prima installazione¶

Questa pagina segue il collegamento di un negozio Shopify dall'inizio: l'app sul negozio, gli articoli in Facile, il file di configurazione, la configurazione del negozio, l'eventuale abbinamento del catalogo esistente e il primo caricamento. Alla fine si accende l'esecuzione continua.

In sintesi

Ordine dei passi: app ▸ articoli ▸ file .ini ▸ configurazione (988) ▸ abbinamento (987, se serve) ▸ primo caricamento ▸ esecuzione continua (979)
Tempo: il primo caricamento di qualche migliaio di articoli richiede alcune ore; i giri successivi pochi secondi

1. Crea l'app sul negozio¶

Facile entra nel negozio attraverso un'app personalizzata. Come si crea e si installa lo spiega la documentazione di Shopify, alla pagina Custom apps: le voci del pannello di Shopify cambiano nel tempo, e quella è la fonte aggiornata.

Il connettore accetta i due tipi di app:

App	Cosa si copia nel file di configurazione
App creata dal Dev Dashboard di Shopify, nella stessa organizzazione del negozio. È il modo previsto da Shopify per le app nuove.	Client ID e segreto, nelle chiavi `client_id` e `client_secret`. Facile chiede da solo un accesso valido 24 ore e lo rinnova quando scade.
App creata dall'amministrazione del negozio prima del 1° gennaio 2026: Shopify le mantiene, ma non se ne creano più di nuove.	Il token di accesso all'Admin API, nella chiave `token`.

Se nel file ci sono sia il token sia client ID e segreto, vale il token.

Crea l'app seguendo la documentazione di Shopify.
Assegna all'app i permessi elencati nei requisiti.
Installa l'app sul negozio.
Copia client ID e segreto, oppure il token: ti servono al passo 3.

Segreto e token sono chiavi del negozio

Con il segreto o con il token chiunque può modificare prodotti e ordini del negozio. Non mandarli per email e conservali solo nel file di configurazione.

2. Prepara gli articoli in Facile¶

Per ogni articolo da vendere sul sito, da Impostazione Dati Web:

Attiva Includi WEB.
Compila Web Nome: è il nome del prodotto sul negozio. Se lo lasci vuoto, il prodotto prende le due righe di descrizione dell'articolo.
Compila Web Des. Estesa, oppure almeno Web Des. Breve: è la descrizione della scheda prodotto.
Spunta le tassonomie in cui l'articolo deve comparire: diventano le collezioni del negozio.
Carica le fotografie nell'anagrafica dell'articolo.

Controlla anche i marchi: un marchio con Stock Ecommerce impostato a non esporre le giacenze manda sul negozio disponibilità zero per tutti i suoi articoli.

3. Prepara il file di configurazione¶

Scarica il file di prova descritto in Il file di configurazione e salvalo nella cartella cfg di Facile: l'installazione di Facile non lo porta.
Nella sezione [LOGIN] indica archivio, utente e password di Facile.
Nella sezione [ECOMMERCE] indica in web_host l'indirizzo nomenegozio.myshopify.com del negozio e il token, oppure client ID e segreto.
Rivedi le altre chiavi: listini, depositi, registro degli ordini, articoli per spese di trasporto e sconti.

Per i passi 4, 5 e 6 conviene preparare una copia del file per ciascuna operazione, cambiando solo operation nella sezione [COMMAND].

4. Lancia la configurazione¶

La configurazione (operazione 988) prepara il negozio e non modifica nessun prodotto.

Imposta operation = 988 e lancia FacileToWeb, come descritto in E-commerce.
Apri il registro operation_988_<data>.txt nella cartella log.
Controlla che riporti il nome del negozio, l'ubicazione per le giacenze, il canale per la pubblicazione e la riga finale Fine configurazione Shopify.

Se il registro elenca dei permessi mancanti, aggiungili all'app, reinstallala e ripeti la configurazione.

L'ubicazione è il magazzino di Shopify su cui Facile scrive le giacenze. Se il negozio ne ha più d'una, indica quella giusta nella chiave location_name; se la lasci vuota, Facile usa la prima ubicazione attiva.

Il canale è quello su cui vengono pubblicati prodotti e collezioni nuovi; se non indichi niente nella chiave canale, è il negozio online (Online Store).

Se il negozio era già collegato a Facile con il connettore precedente, la configurazione converte i collegamenti esistenti: i prodotti già pubblicati non vengono ricreati.

5. Abbina il catalogo già presente¶

Salta questo passo se il negozio è nuovo e vuoto.

Se sul negozio ci sono già dei prodotti, prima di mandare gli articoli di Facile va fatto l'abbinamento (operazione 987): collega ogni variante del negozio all'articolo di Facile che ha come codice il suo SKU. Senza abbinamento, Facile creerebbe un secondo prodotto accanto a quello esistente.

Imposta operation = 987 e lancia FacileToWeb.
Nel registro controlla la riga finale, che riporta le varianti lette, quelle abbinate e quelle non abbinate.
Apri il file shopify_non_abbinati.csv nella cartella log: elenca le varianti non abbinate, con il motivo.
Correggi lo SKU sul negozio, o il codice in Facile, e ripeti l'abbinamento finché l'elenco contiene solo quello che non va venduto da Facile.

Motivo nell'elenco	Che cosa significa
`senza SKU`	La variante non ha SKU: Facile non ha niente su cui abbinarla.
`SKU non trovato in Facile`	Nessun articolo di Facile ha quel codice.
`EAN di variante: si abbina solo con la versione taglie e colori`	Lo SKU è il codice di una variante a taglie e colori, ma la versione di Facile non le gestisce.
`EAN di variante non riconosciuto (articolo inesistente o senza taglie)`	Lo SKU ha la forma di una variante a taglie e colori, ma l'articolo non esiste o non ha taglie.
`prodotto doppio: articolo ... gia' collegato a ...`	Due prodotti del negozio portano lo stesso articolo: ne resta collegato uno solo.

6. Primo caricamento¶

Il primo caricamento manda tutto il catalogo e richiede tempo. Lancia le operazioni in quest'ordine, aspettando la fine di ciascuna:

Ordine	Operazione	Tempo misurato su 3.550 articoli
1	984 Prodotti e collezioni	circa 1 ora e 50 minuti
2	982 Giacenze	meno di un minuto
3	983 Prezzi	circa 20 minuti
4	985 Immagini (11.000 fotografie)	circa 2 ore e 40 minuti

I tempi dipendono soprattutto dai limiti di velocità che Shopify impone a ogni app, non dal computer. Le giacenze e i prezzi vanno dopo i prodotti perché si possono inviare solo a varianti che esistono già.

Ogni operazione si può interrompere e rilanciare: riparte dagli articoli che non ha ancora inviato.

7. Accendi l'esecuzione continua¶

Da qui in avanti il negozio si aggiorna da solo con l'esecuzione continua: un unico file .ini, con le operazioni da fare e ogni quanto, e un'attività pianificata che la avvia insieme al computer.