{"id":6761,"date":"2026-10-01T18:01:53","date_gmt":"2026-10-01T17:01:53","guid":{"rendered":"https:\/\/www.atlantisevo.com\/doc\/?post_type=manual_documentation&p=6761"},"modified":"2026-10-01T18:02:36","modified_gmt":"2026-10-01T17:02:36","slug":"shopify","status":"publish","type":"manual_documentation","link":"https:\/\/www.atlantisevo.com\/doc\/manuale\/e-commerce\/shopify\/","title":{"rendered":"Shopify"},"content":{"rendered":"
<\/div>

Il collegamento con Shopify<\/strong> tiene allineati il gestionale e un negozio online Shopify. Il gestionale pubblica sul negozio gli articoli, i prezzi, le immagini e le giacenze. Dal negozio arrivano gli ordini, che diventano ordini cliente<\/strong>, insieme ai clienti che li hanno fatti. Quando l’ordine viene evaso con un DDT o una fattura, la spedizione torna su Shopify con il corriere e il numero di tracking.<\/p>\n

Da quando il collegamento \u00e8 attivo, il gestionale \u00e8 il master<\/strong>. Articoli, prezzi e giacenze si modificano nel gestionale; su Shopify si gestiscono solo la vetrina (collezioni, temi, canali di vendita) e le impostazioni del negozio.<\/p>\n

Le funzioni si trovano in e-Commerce \u2192 Shopify<\/strong>:<\/p>\n\n\n\n\n\n\n\n\n
Voce<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
Anagrafica siti<\/strong><\/td>\nla configurazione di ogni negozio: credenziali, listini, depositi, causali, transcodifiche<\/td>\n<\/tr>\n
Test connessione<\/strong><\/td>\nverifica le credenziali e i permessi e permette di scegliere la location delle giacenze<\/td>\n<\/tr>\n
Gestione sito<\/strong><\/td>\nsi usa tutti i giorni: pubblicazione, giacenze, import degli ordini, evasioni, primo allineamento<\/td>\n<\/tr>\n
Log sincronizzazioni<\/strong><\/td>\nl’esito di ogni operazione e gli elementi rimasti in coda<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Le voci compaiono solo se il modulo e-commerce Shopify<\/strong> \u00e8 in licenza.<\/p>\n

\n

1. Come funziona il collegamento<\/h2>\n

Il gestionale dialoga direttamente con Shopify tramite le API ufficiali, con le credenziali di un’app<\/strong> creata sul negozio (sezione 2). Sul sito non si installa nulla.<\/p>\n

Cosa viaggia e in quale verso:<\/p>\n\n\n\n\n\n\n\n\n\n\n
Dato<\/th>\nVerso<\/th>\nQuando<\/th>\n<\/tr>\n<\/thead>\n
Articoli, varianti, prezzi, immagini<\/td>\ngestionale \u2192 Shopify<\/td>\na mano, da Gestione sito<\/em><\/td>\n<\/tr>\n
Giacenze<\/td>\ngestionale \u2192 Shopify<\/td>\nin automatico dopo ogni import degli ordini, oppure a mano<\/td>\n<\/tr>\n
Ordini e clienti<\/td>\nShopify \u2192 gestionale<\/td>\ncon la procedura schedulata, oppure a mano<\/td>\n<\/tr>\n
Evasioni (spedito, corriere, tracking)<\/td>\ngestionale \u2192 Shopify<\/td>\na mano, da Gestione sito<\/em><\/td>\n<\/tr>\n
Rimborsi<\/td>\nShopify \u2192 gestionale<\/td>\nsegnalati durante l’import degli ordini<\/td>\n<\/tr>\n
Prodotti gi\u00e0 presenti su Shopify<\/td>\nShopify \u2192 gestionale<\/td>\nuna sola volta, con il primo allineamento<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Tre regole spiegano quasi tutti i comportamenti:<\/p>\n

    \n
  • L’abbinamento si fa per SKU.<\/strong> Per un articolo senza varianti lo SKU Shopify coincide con il codice articolo<\/strong>. Per un articolo con varianti lo SKU di ogni variante \u00e8 il barcode di tipo CVAR<\/strong> della variante. I CVAR mancanti li genera il gestionale alla prima pubblicazione. Dopo il primo collegamento il gestionale riconosce i prodotti anche per identificativo interno: uno SKU cambiato su Shopify non rompe il collegamento, ma la pubblicazione successiva lo riscrive con quello del gestionale.<\/li>\n
  • La disponibilit\u00e0 online \u00e8 l’esistenza meno l’impegnato<\/strong>, sommata sui depositi del sito, meno la scorta di sicurezza. Un ordine Shopify importato diventa impegnato: la merce venduta online non torna disponibile.<\/li>\n
  • Prima gli ordini, poi le giacenze.<\/strong> La procedura schedulata importa gli ordini e subito dopo invia le giacenze cambiate. Inviare le giacenze senza aver importato gli ordini renderebbe di nuovo disponibile la merce appena venduta.<\/li>\n<\/ul>\n
    \n

    2. Preparare Shopify: l’app e i permessi<\/h2>\n

    Chi crea l’app<\/h3>\n

    L’app si crea nell’organizzazione Shopify del negozio<\/strong>, dal Dev Dashboard<\/strong> di Shopify. Pu\u00f2 crearla il titolare del negozio, oppure un account dello staff con il permesso Sviluppo app<\/em>. I collaboratori esterni non hanno accesso al Dev Dashboard.<\/p>\n

    App e negozio devono appartenere alla stessa organizzazione<\/strong>. In caso contrario la richiesta del token viene rifiutata e il gestionale mostra:<\/p>\n

    “L’app non e’ installata sul negozio. Nel Dev Dashboard di Shopify: rilasciare una versione dell’app con gli scope necessari e installarla sul negozio. App e negozio devono appartenere alla stessa organizzazione: un negozio di sviluppo creato dal pannello di Shopify invece che dal Dev Dashboard non ne fa parte.”<\/em><\/p><\/blockquote>\n

    I passi<\/h3>\n
      \n
    1. Nel Dev Dashboard crea una nuova app, per esempio “Atlantis Evo”.<\/li>\n
    2. Nella configurazione della versione indica i permessi (scope)<\/strong> elencati sotto.<\/li>\n
    3. Rilascia<\/strong> la versione dell’app.<\/li>\n
    4. Installa<\/strong> l’app sul negozio.<\/li>\n
    5. Dalle impostazioni dell’app copia Client ID<\/strong> e Client secret<\/strong>. Vanno nella scheda Connessione<\/em> dell’anagrafica siti (sezione 3).<\/li>\n<\/ol>\n

      I permessi da concedere<\/h3>\n

      Concedi all’app tutti<\/strong> questi scope:<\/p>\n

      read_customers,write_customers,read_files,write_files,write_inventory,read_inventory,write_locations,read_locations,read_orders,write_orders,read_products,write_products,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_publications,write_publications<\/code><\/pre>\n\n\n\n\n\n\n\n\n\n\n\n\n
      Scope<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
      read_products<\/code>, write_products<\/code><\/td>\npubblicare articoli, varianti e prezzi; leggere il catalogo per il primo allineamento; collezioni IVA<\/td>\n<\/tr>\n
      read_files<\/code>, write_files<\/code><\/td>\ncaricare le immagini degli articoli<\/td>\n<\/tr>\n
      read_inventory<\/code>, write_inventory<\/code><\/td>\nleggere e scrivere le giacenze<\/td>\n<\/tr>\n
      read_locations<\/code>, write_locations<\/code><\/td>\nelencare le location del negozio per scegliere quella delle giacenze<\/td>\n<\/tr>\n
      read_orders<\/code>, write_orders<\/code><\/td>\nleggere gli ordini e i rimborsi<\/td>\n<\/tr>\n
      read_customers<\/code>, write_customers<\/code><\/td>\nleggere i clienti degli ordini<\/td>\n<\/tr>\n
      read_merchant_managed_fulfillment_orders<\/code>, write_merchant_managed_fulfillment_orders<\/code><\/td>\nsegnare gli ordini come spediti, con corriere e tracking<\/td>\n<\/tr>\n
      read_publications<\/code>, write_publications<\/code><\/td>\nrendere disponibili i prodotti nuovi nei canali di vendita (Online Store\u2026)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
      Se il negozio \u00e8 in pi\u00f9 lingue<\/strong>, o ha una lingua principale diversa dall’italiano<\/strong> (sezione 8), servono anche:<\/p>\n
      read_locales,read_translations,write_translations<\/code><\/pre>\n\n\n\n\n\n\n
      Scope<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
      read_locales<\/code><\/td>\nleggere le lingue attivate sul negozio e quella principale<\/td>\n<\/tr>\n
      read_translations<\/code>, write_translations<\/code><\/td>\nleggere e scrivere le traduzioni dei prodotti<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
      Test connessione<\/strong> elenca gli scope concessi e segnala quelli che mancano (“Scope mancanti per le fasi successive: \u2026”<\/em>).<\/p>\n
      \u26a0\ufe0f Dopo aver aggiunto uno scope bisogna rilasciare una nuova versione dell’app<\/strong> e, se Shopify lo chiede, riapprovarla sul negozio. Senza gli scope delle evasioni, Invia evasioni<\/em> viene rifiutato da Shopify.<\/p><\/blockquote>\n
      Accesso ai dati protetti dei clienti<\/h3>\n
      Nome, indirizzo, email e telefono dei clienti sono dati protetti<\/strong> per Shopify. Senza l’autorizzazione a leggerli, Shopify non restituisce gli ordini: Importa ordini<\/em> si ferma con un errore simile a<\/p>\n
      “This app is not approved to access the Order object \u2026 [ACCESS_DENIED]”<\/em><\/p><\/blockquote>\n
      e non viene importato nulla. L’accesso si concede nel portale Partners di Shopify<\/strong> (partners.shopify.com):<\/p>\n
        \n
      1. entra nel portale Partners con l’account che ha creato l’app;<\/li>\n
      2. apri App<\/strong> e seleziona l’app;<\/li>\n
      3. vai in API access requests<\/strong> (richieste di accesso alle API) \u2192 Protected customer data access<\/strong>;<\/li>\n
      4. nella prima parte indica il motivo d’uso dei dati: gestione ed evasione degli ordini, fatturazione;<\/li>\n
      5. nella seconda parte seleziona i campi Nome<\/strong>, Email<\/strong>, Telefono<\/strong> e Indirizzo<\/strong>, ciascuno con il suo motivo;<\/li>\n
      6. salva. Per un’app ad uso del solo negozio non serve la revisione di Shopify.<\/li>\n<\/ol>\n
        Su alcuni negozi l’accesso \u00e8 concesso in automatico alle app create dal titolare. Se Importa ordini<\/em> funziona gi\u00e0, non serve fare nulla. Se compare ACCESS_DENIED<\/code>, questo \u00e8 il passo mancante.<\/p>\n
        Impostazioni del negozio da controllare<\/h3>\n
          \n
        • Valuta<\/strong> del negozio uguale a quella del listino del sito (di norma EUR). Se sono diverse, la pubblicazione si ferma con “La valuta del negozio (\u2026) e’ diversa da quella del listino (\u2026): impostare la valuta del negozio su Shopify o cambiare listino”<\/em>.<\/li>\n
        • Prezzi IVA inclusa o esclusa<\/strong> (Impostazioni \u2192 Imposte e dazi<\/em>). Il gestionale legge questa impostazione e converte i prezzi del listino: non va dichiarata da nessuna parte.<\/li>\n
        • Aliquota del paese<\/strong>: Shopify applica l’aliquota ordinaria dell’Italia a tutti i prodotti. Le aliquote ridotte richiedono un’eccezione IVA per ogni aliquota (sezione 8).<\/li>\n
        • Location<\/strong>: quella scelta per le giacenze deve essere attiva e evadere gli ordini online<\/strong>. Una location che non evade gli ordini online fa risultare i prodotti esauriti nel negozio anche con la quantit\u00e0 caricata.<\/li>\n
        • Dati fiscali nel checkout<\/strong>: codice fiscale, partita IVA e PEC arrivano dai campi fiscali italiani del checkout Shopify, se il negozio li raccoglie. Il codice SDI<\/strong> non ha un campo nativo: serve un attributo del checkout, aggiunto con un’app o una personalizzazione del checkout, e il suo nome va indicato nell’anagrafica del sito.<\/li>\n<\/ul>\n
          \n
          3. Anagrafica siti<\/h2>\n
          Ogni negozio \u00e8 un record con un codice numerico<\/strong>. Se ne possono configurare pi\u00f9 di uno.<\/p>\n
          Testata<\/h3>\n\n\n\n\n\n\n\n
          Campo<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
          Codice<\/strong><\/td>\nidentificativo numerico del sito<\/td>\n<\/tr>\n
          Descrizione<\/strong><\/td>\nnome del negozio negli elenchi (obbligatoria, fino a 50 caratteri)<\/td>\n<\/tr>\n
          Attivo<\/strong><\/td>\nsolo i siti attivi compaiono in Gestione sito<\/em>, ricevono le giacenze in coda e vengono elaborati dallo scheduler<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
          Scheda “Connessione”<\/h3>\n\n\n\n\n\n\n\n\n\n\n
          Campo<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
          Dominio negozio<\/strong><\/td>\nxxx.myshopify.com<\/code>. Si pu\u00f2 incollare anche l’indirizzo del pannello (admin.shopify.com\/store\/xxx<\/code>) o il solo nome: il gestionale lo converte e lo salva nella forma giusta<\/td>\n<\/tr>\n
          Versione API<\/strong><\/td>\nversione delle API Shopify usata dal gestionale, proposta 2026-07<\/code>. Non va cambiata, salvo indicazione dell’assistenza<\/td>\n<\/tr>\n
          Client ID<\/strong><\/td>\ndalle impostazioni dell’app<\/td>\n<\/tr>\n
          Client secret<\/strong><\/td>\ndalle impostazioni dell’app. A video compaiono asterischi e nel database viene salvato cifrato<\/td>\n<\/tr>\n
          Location giacenze<\/strong>, Id location<\/strong><\/td>\nla location Shopify su cui si scrivono le giacenze. Non si digitano: si scelgono dal test di connessione<\/td>\n<\/tr>\n
          Test connessione e scelta location…<\/strong><\/td>\napre il test di connessione (sezione 4) sul sito. Funziona solo sul sito gi\u00e0 salvato<\/strong>: altrimenti “Salvare il sito prima di eseguire il test di connessione”<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
          La cifratura del Client secret<\/em> nasconde il dato a chi legge il database. Non \u00e8 una protezione forte: la chiave \u00e8 nel programma.<\/p>\n
          Scheda “Prodotti e giacenze”<\/h3>\n\n\n\n\n\n\n\n
          Campo<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
          Listino<\/strong><\/td>\nlistino dei prezzi pubblicati. Obbligatorio per pubblicare<\/td>\n<\/tr>\n
          Listino offerte<\/strong><\/td>\nfacoltativo. Se per l’articolo esiste un prezzo in offerta, su Shopify il prezzo del listino normale diventa il prezzo di confronto<\/strong> (barrato) e quello in offerta il prezzo di vendita<\/td>\n<\/tr>\n
          Scorta di sicurezza<\/strong><\/td>\nquantit\u00e0 tolta dalla disponibilit\u00e0 di ogni variante prima dell’invio, per non vendere online l’ultimo pezzo<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
          Il listino pu\u00f2 essere IVA inclusa o esclusa: il gestionale converte il prezzo con l’aliquota dell’articolo secondo l’impostazione del negozio.<\/p>\n
          Scheda “Liste articoli”<\/h3>\n
          Gli articoli da pubblicare si scelgono con le liste articoli<\/strong>, anche dinamiche. Si pubblicano gli articoli delle liste indicate, tolti quelli delle liste con Escludi gli articoli di questa lista<\/strong>. Ogni riga si conferma con Conferma riga<\/strong>.<\/p>\n
            \n
          • Con nessuna lista la pubblicazione si ferma: “Nessun articolo nelle liste del sito: impostare le liste articoli prima di pubblicare”<\/em>.<\/li>\n
          • Un articolo che esce dalle liste viene messo in bozza<\/strong> su Shopify, mai cancellato. Se rientra nelle liste torna attivo.<\/li>\n<\/ul>\n
            Scheda “Depositi”<\/h3>\n
            I depositi che formano la disponibilit\u00e0 online: si somma l’esistenza meno l’impegnato di ciascun deposito. Senza depositi l’invio delle giacenze si ferma: “Nessun deposito indicato nel sito Shopify: impostare i depositi che formano la disponibilita’ online”<\/em>.<\/p>\n
            Solo i movimenti dei depositi indicati qui mettono in coda le giacenze da inviare.<\/p>\n
            Scheda “Ordini e clienti”<\/h3>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
            Campo<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
            Causale ordini<\/strong><\/td>\ncausale degli ordini cliente creati dagli ordini Shopify. Da questa dipendono causale di magazzino, deposito e scarico<\/td>\n<\/tr>\n
            Serie documento<\/strong><\/td>\nserie degli ordini cliente. Se \u00e8 vuota si usa la serie della causale. Deve essere riservata agli ordini Shopify<\/strong> (vedi sotto)<\/td>\n<\/tr>\n
            Spesa di spedizione<\/strong><\/td>\ncodice spesa su cui si riporta la spedizione pagata dal cliente<\/td>\n<\/tr>\n
            Pagamento predefinito<\/strong><\/td>\npagamento dell’ordine quando il metodo Shopify non ha transcodifica. Se manca anche questo, si usa il pagamento del cliente<\/td>\n<\/tr>\n
            Sottoconto clienti nuovi<\/strong><\/td>\nsottoconto contabile dei clienti creati dall’import. Obbligatorio: senza, l’import si ferma con “Sottoconto dei clienti nuovi non impostato nel sito Shopify”<\/em><\/td>\n<\/tr>\n
            Categoria clienti nuovi<\/strong><\/td>\ncategoria assegnata ai clienti creati<\/td>\n<\/tr>\n
            Prefisso codice clienti<\/strong><\/td>\n1 carattere (predefinito S<\/code>). Il codice dei clienti nuovi \u00e8 il prefisso seguito da 6 caratteri, un progressivo del sito in base 36, per esempio S00001A<\/code><\/td>\n<\/tr>\n
            Attributo checkout SDI<\/strong><\/td>\nnome dell’attributo del checkout che contiene il codice SDI (fino a 50 caratteri)<\/td>\n<\/tr>\n
            Escludi gli ordini di prova<\/strong><\/td>\ndi norma attivo: gli ordini fatti con il gateway di prova di Shopify non si importano<\/td>\n<\/tr>\n
            Ordini dal<\/strong><\/td>\ndata di partenza<\/strong> del collegamento. Obbligatoria: gli ordini creati prima non si importano mai, neanche se modificati dopo, e non ricevono le evasioni<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
            Il numero dell’ordine cliente \u00e8 il numero dell’ordine Shopify<\/strong> (l’ordine #1001<\/code> diventa il documento 1001 della serie del sito). Se nella serie esiste gi\u00e0 un ordine con quel numero non collegato a Shopify, l’import si ferma con “il numero \u2026 e’ gia’ usato da un altro ordine: la serie deve essere riservata agli ordini Shopify”<\/em>.<\/p>\n
            Scheda “Transcodifiche e opzioni”<\/h3>\n
            Il riquadro Opzioni<\/strong>:<\/p>\n\n\n\n\n\n\n\n\n\n\n
            Opzione<\/th>\nEffetto<\/th>\n<\/tr>\n<\/thead>\n
            Prodotti nuovi pubblicati come<\/strong><\/td>\nAttivi (visibili nel negozio)<\/em> oppure Bozza (da pubblicare su Shopify)<\/em>. Vale solo per i prodotti creati; negli aggiornamenti lo stato scelto su Shopify non si tocca<\/td>\n<\/tr>\n
            Codici CVAR mancanti composti con<\/strong><\/td>\ncodici oppure sigle dei valori delle varianti, per i CVAR generati alla pubblicazione<\/td>\n<\/tr>\n
            Separatore<\/strong><\/td>\ncarattere fra le parti del CVAR generato; vuoto = trattino<\/td>\n<\/tr>\n
            Aliquota IVA ordinaria del negozio %<\/strong><\/td>\nvuoto = 22. Gli articoli con un’aliquota diversa (e maggiore di zero) ricevono la collezione IVA della sezione 8<\/td>\n<\/tr>\n
            Canali di vendita dei prodotti nuovi<\/strong><\/td>\ncanali in cui rendere disponibili i prodotti creati dal gestionale, con i nomi che mostra Shopify separati da virgola (per esempio Online Store, Point of Sale<\/em>). Vuoto = Online Store<\/em>; -<\/code> = nessun canale. Il pulsante Scegli…<\/strong> legge i canali dal negozio (il sito deve essere salvato) e li fa scegliere da un elenco, anche pi\u00f9 di uno con Ctrl+clic<\/td>\n<\/tr>\n
            Alla spedizione Shopify avvisa il cliente via email (invio evasioni)<\/strong><\/td>\nse attiva, all’invio dell’evasione Shopify manda al cliente l’email di spedizione<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
            Le quattro tabelle di transcodifica (Aggiungi<\/strong> \/ Elimina<\/strong> righe):<\/p>\n\n\n\n\n\n\n\n\n
            Tabella<\/th>\nChiave<\/th>\nValore<\/th>\n<\/tr>\n<\/thead>\n
            Pagamenti<\/strong><\/td>\nnome del metodo di pagamento come lo riporta Shopify. Si legge nelle note interne dell’ordine importato, riga Pagamento Shopify<\/em><\/td>\npagamento del gestionale<\/td>\n<\/tr>\n
            Aliquote IVA<\/strong><\/td>\naliquota in percentuale: 22, 10, 4, 5,5, 0<\/strong><\/td>\ncodice IVA<\/td>\n<\/tr>\n
            Stati ordine<\/strong><\/td>\nstato del pagamento su Shopify: In attesa di pagamento<\/em>, Autorizzato<\/em>, Pagato in parte<\/em>, Pagato<\/em>, Rimborsato in parte<\/em>, Rimborsato<\/em>, Annullato<\/em>, Scaduto<\/em>. L’ultima riga vale per gli ordini il cui totale non coincide con Shopify<\/td>\nstato dell’ordine cliente<\/td>\n<\/tr>\n
            Lingue<\/strong><\/td>\nlingua del negozio Shopify, con il codice di Shopify: en<\/code>, it<\/code>, de<\/code>, pt-BR<\/code>\u2026 Compresa la lingua principale del negozio, se \u00e8 diversa dall’italiano<\/td>\nlingua del gestionale da cui prendere i testi (sezione 8)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
            \u26a0\ufe0f Le transcodifiche si salvano con il record.<\/strong> Dopo aver aggiunto le righe bisogna salvare l’anagrafica.<\/p><\/blockquote>\n
            Senza transcodifica dell’aliquota, l’ordine usa il codice IVA dell’articolo, se ha la stessa aliquota. Altrimenti l’ordine non viene importato<\/strong> e resta in coda. Le righe e le spedizioni su cui Shopify non applica imposte richiedono la riga con aliquota 0<\/strong>, con un codice esente o non imponibile. Senza quella riga compare “riga senza IVA su Shopify: indicare nelle transcodifiche del sito (scheda Aliquote IVA) il codice IVA per l’aliquota 0 (esente o non imponibile)”<\/em>.<\/p>\n
            Scheda “Primo allineamento”<\/h3>\n
            Valori usati per gli articoli creati<\/strong> dal primo allineamento, cio\u00e8 per i prodotti gi\u00e0 presenti su Shopify e assenti nel gestionale (sezione 6).<\/p>\n\n\n\n\n\n\n\n\n\n\n\n
            Campo<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
            Unit\u00e0 di misura<\/strong><\/td>\nUM degli articoli creati<\/td>\n<\/tr>\n
            Codice iva<\/strong><\/td>\ncodice IVA degli articoli creati: Shopify non conosce l’aliquota dei prodotti, quindi \u00e8 lo stesso per tutti<\/strong><\/td>\n<\/tr>\n
            Gruppo merceologico<\/strong><\/td>\ngruppo degli articoli creati<\/td>\n<\/tr>\n
            Lista articoli creati<\/strong><\/td>\nlista statica<\/strong>, da inserire anche nella scheda Liste articoli<\/em>, a cui si aggiungono gli articoli creati. Senza, la pubblicazione successiva metterebbe in bozza i prodotti appena collegati<\/td>\n<\/tr>\n
            Causale carico iniziale<\/strong><\/td>\ncausale del documento di magazzino con le quantit\u00e0 presenti su Shopify<\/td>\n<\/tr>\n
            Deposito carico iniziale<\/strong><\/td>\ndeposito di quel documento<\/td>\n<\/tr>\n
            Primo allineamento eseguito<\/strong><\/td>\nlo imposta la procedura. Finch\u00e9 non \u00e8 attivo, pubblicazione e invio giacenze sono bloccati<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
            \n
            4. Test connessione<\/h2>\n
            Si apre dal menu o dal pulsante della scheda Connessione<\/em>. Chiede il token a Shopify e legge i dati del negozio. Mostra:<\/p>\n
              \n
            • nome del negozio, valuta, prezzi IVA inclusa o esclusa, piano;<\/li>\n
            • scope concessi<\/strong> e “Scope mancanti per le fasi successive”<\/em>; gli scope delle traduzioni si controllano solo se il sito ha la tabella Lingue<\/em>;<\/li>\n
            • le lingue del negozio<\/strong>, per esempio it (principale), en, de (non pubblicata)<\/em>;<\/li>\n
            • limite di chiamata disponibile;<\/li>\n
            • i canali di vendita<\/strong> del negozio, da copiare nell’opzione Canali di vendita dei prodotti nuovi<\/em>;<\/li>\n
            • l’elenco delle location<\/strong> attive, con l’indicazione (non evade ordini online)<\/em> dove serve.<\/li>\n<\/ul>\n
              Seleziona la location e premi Usa la location selezionata per le giacenze<\/strong>: viene salvata nel sito. Se la location salvata non \u00e8 pi\u00f9 attiva sul negozio, il test avvisa: “La location impostata sul sito non e’ fra quelle attive del negozio: sceglierne una.”<\/em><\/p>\n
              Errori tipici del token:<\/p>\n\n\n\n\n\n\n
              Messaggio<\/th>\nCausa<\/th>\n<\/tr>\n<\/thead>\n
              “\u2026L’app non e’ installata sul negozio\u2026”<\/em><\/td>\napp non rilasciata, non installata, o in un’altra organizzazione (sezione 2)<\/td>\n<\/tr>\n
              “Client ID o Client secret non corretti: ricopiarli dalle impostazioni dell’app nel Dev Dashboard.”<\/em><\/td>\ncredenziali sbagliate<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
              \n
              5. Avviare il collegamento: i casi possibili<\/h2>\n
              La preparazione di Shopify (sezione 2) e la compilazione dell’anagrafica (sezione 3) sono uguali in tutti i casi. Cambia l’ordine delle operazioni, a seconda di dove si trovano gi\u00e0 i dati.<\/p>\n
              5.1 Il gestionale \u00e8 gi\u00e0 in uso e si apre un negozio Shopify nuovo<\/h3>\n
              \u00c8 il caso pi\u00f9 semplice: gli articoli ci sono gi\u00e0, il negozio \u00e8 vuoto.<\/p>\n
                \n
              1. Prepara gli articoli.<\/strong> Crea una o pi\u00f9 liste articoli con quello che vuoi vendere online e controlla per quegli articoli:\n
                  \n
                • titolo e descrizione web nella lingua di default (altrimenti si usano descrizione e descrizione aggiuntiva);<\/li>\n
                • marca, gruppo merceologico, tag;<\/li>\n
                • prezzo nel listino del sito;<\/li>\n
                • immagini nell’archivio documenti, nelle categorie immagine principale<\/em> e altre immagini<\/em> dei dati fissi;<\/li>\n
                • per gli articoli con varianti, al massimo 3 dimensioni<\/strong> (Shopify non ne gestisce di pi\u00f9).<\/li>\n<\/ul>\n<\/li>\n
                • Prepara Shopify<\/strong> (sezione 2): app, scope, valuta, prezzi IVA inclusa, location.<\/li>\n
                • Crea il sito<\/strong> nell’anagrafica e salvalo. Poi Test connessione<\/strong> e scelta della location.<\/li>\n
                • Compila Liste articoli<\/strong>, Depositi<\/strong>, Ordini e clienti<\/strong> e Transcodifiche e opzioni<\/strong>. Come Ordini dal<\/strong> metti il giorno di apertura del negozio.<\/li>\n
                • Primo allineamento<\/strong> da Gestione sito<\/em>, scheda Utilit\u00e0<\/em>. Sul negozio vuoto non trova prodotti. L’anteprima lo conferma e l’esecuzione segna il sito come allineato.<\/li>\n
                • Pubblica tutti<\/strong> (scheda Articoli<\/em>). Se vuoi controllare i prodotti prima di mostrarli, imposta prima l’opzione Prodotti nuovi pubblicati come: Bozza<\/em>.<\/li>\n
                • Per ogni aliquota ridotta imposta l’eccezione IVA<\/strong> sulla collezione IVA n%<\/code> creata dalla pubblicazione (sezione 8).<\/li>\n
                • Invia tutte le giacenze<\/strong> (scheda Giacenze<\/em>): il negozio \u00e8 ancora fermo, quindi non ci sono ordini da perdere.<\/li>\n
                • Fai un ordine di prova<\/strong> e importalo con Importa ordini<\/em>. Controlla cliente, righe, IVA, spedizione e totale. Poi evadilo con un DDT e prova Invia evasioni<\/em>.<\/li>\n
                • Configura la procedura schedulata<\/strong> (sezione 13) e apri il negozio.<\/li>\n<\/ol>\n
                  5.2 Il negozio Shopify \u00e8 gi\u00e0 in uso e il gestionale \u00e8 vuoto<\/h3>\n
                  Il catalogo \u00e8 su Shopify. Il primo allineamento crea gli articoli nel gestionale<\/strong> partendo dai prodotti del negozio.<\/p>\n
                    \n
                  1. Prepara Shopify<\/strong> (sezione 2). Controlla che ogni variante abbia uno SKU<\/strong> e che gli SKU siano univoci. Gli SKU dei prodotti senza varianti possono avere al massimo 20 caratteri<\/strong>, quelli delle varianti 50<\/strong>.<\/li>\n
                  2. Nel gestionale prepara:\n
                      \n
                    • le tabelle di base (unit\u00e0 di misura, codici IVA, un gruppo merceologico, il listino e l’eventuale listino offerte);<\/li>\n
                    • una lista articoli statica<\/strong> per gli articoli creati;<\/li>\n
                    • una causale di magazzino per il carico iniziale<\/strong> e il deposito.<\/li>\n<\/ul>\n<\/li>\n
                    • Crea il sito<\/strong> e compila tutte le schede, compresa Primo allineamento<\/strong>. Metti la lista degli articoli creati anche<\/strong> nella scheda Liste articoli<\/em>.<\/li>\n
                    • Primo allineamento<\/strong> (sezione 6). Leggi con attenzione l’anteprima: conflitti, prodotti senza SKU, configurazione mancante. Correggi su Shopify i conflitti che ti interessano e ripeti l’analisi finch\u00e9 il risultato \u00e8 quello atteso. Poi conferma.<\/li>\n
                    • Controlla gli articoli creati prima di pubblicare.<\/strong> In particolare:\n
                        \n
                      • il codice IVA<\/strong>: \u00e8 quello della scheda Primo allineamento<\/em> per tutti. Correggi gli articoli ad aliquota ridotta;<\/li>\n
                      • le descrizioni e i prezzi nel listino;<\/li>\n
                      • il documento di carico iniziale<\/strong>, che porta in giacenza le quantit\u00e0 presenti su Shopify.<\/li>\n<\/ul>\n<\/li>\n
                      • Pubblica tutti.<\/strong> Da questo momento il gestionale \u00e8 master: titolo, descrizione, prezzi e varianti di Shopify vengono riscritti con quelli del gestionale. Le immagini del negozio sono gi\u00e0 state scaricate nell’archivio documenti e vengono riusate, non ricaricate.<\/li>\n
                      • Eccezioni IVA sulle collezioni IVA n%<\/code> (sezione 8).<\/li>\n
                      • Come Ordini dal<\/strong> metti il giorno da cui il gestionale riceve gli ordini. Gli ordini precedenti restano solo su Shopify e i clienti vengono creati man mano che arrivano ordini nuovi.<\/li>\n
                      • Scegli un momento di negozio fermo, oppure lancia Importa ordini<\/em> subito prima, e fai Invia tutte le giacenze<\/strong>.<\/li>\n
                      • Configura la procedura schedulata<\/strong>.<\/li>\n<\/ol>\n
                        5.3 Il negozio Shopify \u00e8 gi\u00e0 in uso e anche il gestionale \u00e8 gi\u00e0 avviato<\/h3>\n
                        Gli articoli esistono da entrambe le parti. Il primo allineamento li collega<\/strong> e crea nel gestionale solo quelli che mancano.<\/p>\n
                          \n
                        1. Allinea gli SKU prima di iniziare.<\/strong> Il collegamento \u00e8 automatico solo se:\n
                            \n
                          • lo SKU di un prodotto Shopify senza varianti \u00e8 uguale al codice articolo<\/strong>;<\/li>\n
                          • lo SKU di ogni variante \u00e8 uguale al barcode CVAR<\/strong> della variante corrispondente nel gestionale.<\/li>\n<\/ul>\n
                            Maiuscole e minuscole non contano. Dove non coincidono, correggi lo SKU su Shopify, oppure aggiungi il CVAR giusto alla variante nel gestionale.<\/li>\n
                          • Controlla che la struttura varianti<\/strong> del gestionale corrisponda alle opzioni Shopify: tutte le varianti di un prodotto devono portare allo stesso articolo.<\/li>\n
                          • Crea il sito<\/strong> e compila le schede. Le liste articoli devono contenere gli articoli gi\u00e0 in vendita online: gli articoli collegati che non sono nelle liste vengono aggiunti alla Lista articoli creati<\/em>, se \u00e8 impostata.<\/li>\n
                          • Primo allineamento<\/strong>, con l’anteprima. Oltre ai conflitti, guarda le differenze di giacenza<\/strong> sui prodotti collegati: dopo l’allineamento vince la giacenza del gestionale, e per i prodotti collegati non si genera nessun carico. Se il gestionale non ha giacenze affidabili, fai prima un inventario<\/strong>.<\/li>\n
                          • Correggi i conflitti e ripeti l’analisi quante volte serve: l’allineamento ripetuto non crea doppioni.<\/li>\n
                          • Conferma. Poi controlla gli articoli creati (codice IVA, prezzi) come nel caso 5.2.<\/li>\n
                          • Pubblica tutti<\/strong>: i prodotti collegati vengono riscritti con i dati del gestionale. Se un articolo non ha immagini nel gestionale, quelle di Shopify restano. Se ha la descrizione vuota, quella di Shopify non viene toccata.<\/li>\n
                          • Eccezioni IVA, poi Invia tutte le giacenze<\/em> a negozio fermo, poi la procedura schedulata<\/strong>.<\/li>\n
                          • Come Ordini dal<\/strong> metti il giorno da cui gli ordini arrivano dal collegamento: quelli precedenti, inseriti a mano, non vengono importati di nuovo.<\/li>\n<\/ol>\n
                            \u26a0\ufe0f Non pubblicare e non inviare giacenze prima del primo allineamento.<\/strong> Il gestionale lo impedisce (“Primo allineamento non eseguito: eseguirlo prima di pubblicare, per non creare doppioni dei prodotti gia’ presenti sul negozio”<\/em>). Non attivare a mano il flag Primo allineamento eseguito<\/em> su un negozio che ha gi\u00e0 dei prodotti.<\/p><\/blockquote>\n
                            \n
                            6. Il primo allineamento<\/h2>\n
                            Si lancia da Gestione sito<\/em>, scheda Utilit\u00e0<\/em>, Primo allineamento…<\/strong>. Serve una sola volta per negozio, ma si pu\u00f2 ripetere senza creare doppioni.<\/p>\n
                            Anteprima<\/h3>\n
                            La procedura legge tutto il catalogo Shopify e non scrive nulla<\/strong>. Nel riquadro Avanzamento<\/em> elenca:<\/p>\n
                              \n
                            • i prodotti collegati<\/strong> ad articoli esistenti;<\/li>\n
                            • i prodotti da creare<\/strong> nel gestionale;<\/li>\n
                            • i prodotti con varianti senza SKU<\/strong>;<\/li>\n
                            • i conflitti<\/strong>, con il motivo;<\/li>\n
                            • gli articoli delle liste del sito che su Shopify non ci sono (li creer\u00e0 la pubblicazione);<\/li>\n
                            • le giacenze diverse<\/strong> fra gestionale e Shopify sui prodotti collegati;<\/li>\n
                            • la configurazione mancante.<\/li>\n<\/ul>\n
                              Un prodotto va in conflitto<\/strong>, e resta escluso, se:<\/p>\n
                                \n
                              • lo SKU \u00e8 ripetuto nel negozio;<\/li>\n
                              • solo alcune varianti trovano un articolo, oppure varianti diverse portano ad articoli diversi;<\/li>\n
                              • l’articolo \u00e8 gi\u00e0 abbinato a un altro prodotto;<\/li>\n
                              • il prodotto ha pi\u00f9 di 3 opzioni;<\/li>\n
                              • lo SKU supera i 50 caratteri (20 per un prodotto senza varianti);<\/li>\n
                              • lo SKU di un prodotto senza varianti \u00e8 il codice di un articolo con varianti.<\/li>\n<\/ul>\n
                                Le gift card<\/strong> non vengono mai importate.<\/p>\n
                                Se manca la configurazione per creare gli articoli, la procedura lo dice e non chiede conferma: “Per creare gli articoli completare prima nell’anagrafica del sito: \u2026”<\/em>.<\/p>\n
                                Conferma<\/h3>\n
                                La domanda riepiloga quanti prodotti si collegano e quanti articoli si creano. La casella Crea anche i N prodotti con varianti senza SKU<\/strong> va spuntata solo se sei sicuro che quei prodotti non esistono gi\u00e0 nel gestionale: senza SKU non si possono riconoscere, e il rischio \u00e8 un doppione. Per queste varianti il CVAR viene generato e lo SKU viene scritto su Shopify alla prima pubblicazione.<\/p>\n
                                Cosa crea<\/h3>\n
                                Per ogni prodotto da creare:<\/p>\n
                                  \n
                                • l’articolo<\/strong>:\n
                                    \n
                                  • codice = SKU in maiuscolo per i prodotti senza varianti;<\/li>\n
                                  • per i prodotti con varianti, l’handle Shopify in maiuscolo se entra in 20 caratteri, altrimenti SH<\/code> pi\u00f9 un progressivo;<\/li>\n<\/ul>\n<\/li>\n
                                  • UM, codice IVA e gruppo dalla scheda Primo allineamento<\/em>; la marca<\/strong> se ne esiste una con la stessa descrizione del fornitore (vendor) Shopify (le marche non si creano);<\/li>\n
                                  • una struttura varianti<\/strong> propria, con le sole combinazioni presenti su Shopify, e un CVAR<\/strong> per variante uguale allo SKU;<\/li>\n
                                  • il barcode<\/strong> Shopify come barcode web;<\/li>\n
                                  • i prezzi<\/strong> nel listino del sito. Se su Shopify c’\u00e8 un prezzo di confronto, questo va nel listino normale e il prezzo di vendita nel listino offerte;<\/li>\n
                                  • il peso<\/strong>, il titolo, la descrizione e i tag nella lingua di default;<\/li>\n
                                  • la riga nella lista articoli creati<\/strong>;<\/li>\n
                                  • le immagini<\/strong>, scaricate nell’archivio documenti: la prima come immagine principale, le altre (fino a 10) nella categoria delle altre immagini; l’immagine di una variante viene collegata anche alla variante.<\/li>\n<\/ul>\n
                                    Le immagini si scaricano anche per gli articoli collegati<\/strong> che nel gestionale non ne hanno.<\/p>\n
                                    Infine viene creato un solo documento di carico<\/strong> con le quantit\u00e0 disponibili su Shopify, una riga per ogni variante con giacenza. Se il documento non si riesce a salvare, gli articoli restano creati: l’esito lo segnala e il log elenca le quantit\u00e0 da caricare a mano.<\/p>\n
                                    A fine procedura il sito \u00e8 segnato come allineato, anche se ci sono conflitti: i prodotti in conflitto restano esclusi finch\u00e9 non li correggi e ripeti l’allineamento.<\/p>\n
                                    \n
                                    7. Gestione sito<\/h2>\n
                                    In alto si sceglie il Sito<\/strong> (solo i siti attivi). Apri<\/strong> apre l’anagrafica del sito, Log…<\/strong> la consultazione del log. Il riquadro Avanzamento<\/strong> mostra cosa sta facendo l’operazione in corso e il risultato.<\/p>\n
                                    Scheda “Ordini”<\/h3>\n\n\n\n\n\n\n\n\n\n
                                    Pulsante<\/th>\nCosa fa<\/th>\n<\/tr>\n<\/thead>\n
                                    Importa ordini<\/strong><\/td>\nimporta gli ordini nuovi o modificati e ritenta quelli in coda. Poi invia le giacenze in coda<\/td>\n<\/tr>\n
                                    Reimporta ordine…<\/strong><\/td>\nchiede il numero (1001 o #1001) e reimporta quell’ordine anche se non \u00e8 cambiato. Serve per recuperare un ordine cancellato per errore nel gestionale<\/td>\n<\/tr>\n
                                    Ordini in coda: N<\/strong><\/td>\nordini non importati per un errore. Un clic apre il log sulle code, con il motivo<\/td>\n<\/tr>\n
                                    Invia evasioni<\/strong><\/td>\ninvia a Shopify le spedizioni dei DDT e delle fatture, con data da Ordini dal<\/em><\/td>\n<\/tr>\n
                                    Invia evasione ordine…<\/strong><\/td>\ncome sopra, per un solo ordine e senza limite di data<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                    Scheda “Giacenze”<\/h3>\n\n\n\n\n\n\n\n
                                    Pulsante<\/th>\nCosa fa<\/th>\n<\/tr>\n<\/thead>\n
                                    Invia giacenze in coda<\/strong><\/td>\ninvia solo le varianti cambiate dai movimenti di magazzino. Mostra quante sono in attesa<\/td>\n<\/tr>\n
                                    Invia tutte le giacenze<\/strong><\/td>\ninvia le giacenze di tutti gli articoli pubblicati. Operazione di servizio<\/strong>: chiede conferma e va usata a negozio fermo o subito dopo Importa ordini<\/em><\/td>\n<\/tr>\n
                                    Invia giacenze singolo articolo<\/strong><\/td>\ninvia le giacenze dell’articolo indicato<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                    Scheda “Articoli”<\/h3>\n\n\n\n\n\n\n\n
                                    Pulsante<\/th>\nCosa fa<\/th>\n<\/tr>\n<\/thead>\n
                                    Pubblica singolo l’articolo<\/strong><\/td>\npubblica l’articolo indicato, anche se non \u00e8 cambiato<\/td>\n<\/tr>\n
                                    Pubblica modificati<\/strong><\/td>\npubblica gli articoli delle liste nuovi o cambiati dall’ultima pubblicazione (dati, prezzo, varianti, immagini, aliquota)<\/td>\n<\/tr>\n
                                    Pubblica tutti<\/strong><\/td>\nripubblica tutti gli articoli delle liste. Chiede conferma: con molti articoli richiede tempo, ma le immagini gi\u00e0 caricate non si reinviano<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                    Scheda “Utilit\u00e0”<\/h3>\n
                                    Primo allineamento…<\/strong> (sezione 6), la riga Semaforo<\/strong> e il pulsante Sblocca<\/strong> (sezione 14).<\/p>\n
                                    Se un’operazione \u00e8 gi\u00e0 in corso nella maschera compare “Operazione in corso: attendere la fine”<\/em>.<\/p>\n
                                    \n
                                    8. Pubblicazione dei prodotti<\/h2>\n
                                    La pubblicazione \u00e8 solo manuale<\/strong>: salvare un articolo non lo invia al negozio. Dopo aver cambiato prezzi, descrizioni o immagini usa Pubblica modificati<\/strong>.<\/p>\n
                                    Cosa si invia per ogni articolo:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
                                    Su Shopify<\/th>\nDal gestionale<\/th>\n<\/tr>\n<\/thead>\n
                                    Titolo<\/td>\ndescrizione web della lingua di default, altrimenti descrizione dell’articolo<\/td>\n<\/tr>\n
                                    Descrizione<\/td>\ndescrizione estesa (HTML) della lingua di default, altrimenti descrizione aggiuntiva<\/td>\n<\/tr>\n
                                    Titolo e descrizione per i motori di ricerca<\/td>\ntitolo web e meta description della lingua di default<\/td>\n<\/tr>\n
                                    Fornitore<\/td>\nmarca<\/td>\n<\/tr>\n
                                    Tipo prodotto<\/td>\ngruppo merceologico<\/td>\n<\/tr>\n
                                    Tag<\/td>\ntag dell’articolo e della descrizione web, pi\u00f9 il tag IVA (sotto)<\/td>\n<\/tr>\n
                                    Opzioni e varianti<\/td>\nuna opzione per dimensione della struttura varianti, al massimo 3<\/td>\n<\/tr>\n
                                    SKU<\/td>\ncodice articolo, oppure CVAR della variante<\/td>\n<\/tr>\n
                                    Prezzo e prezzo di confronto<\/td>\ndai listini del sito<\/td>\n<\/tr>\n
                                    Barcode, peso<\/td>\nbarcode web, peso lordo<\/td>\n<\/tr>\n
                                    Immagini<\/td>\narchivio documenti: immagine principale, altre immagini, immagine di ogni variante<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                    Regole:<\/p>\n
                                      \n
                                    • un prodotto nuovo<\/strong> nasce attivo o in bozza secondo l’opzione del sito; negli aggiornamenti lo stato impostato su Shopify non cambia;<\/li>\n
                                    • un prodotto viene reso disponibile nei canali di vendita<\/strong> dell’opzione del sito una sola volta: alla creazione, oppure al primo invio dopo l’aggiornamento del programma per i prodotti gi\u00e0 pubblicati. Poi i canali si gestiscono su Shopify e il gestionale non li tocca pi\u00f9. Senza canale un prodotto attivo non compare da nessuna parte;<\/li>\n
                                    • se i canali non si possono leggere (manca lo scope write_publications<\/code>) il prodotto si pubblica lo stesso, ma resta da reinviare: Pubblica modificati<\/em> lo riprova al giro successivo;<\/li>\n
                                    • un articolo obsoleto<\/strong>, eliminato<\/strong> o uscito dalle liste<\/strong> va in bozza. Nessun prodotto viene mai cancellato;<\/li>\n
                                    • un articolo senza immagini nel gestionale non tocca quelle presenti su Shopify;<\/li>\n
                                    • se un prodotto collegato \u00e8 stato cancellato su Shopify, viene ricreato;<\/li>\n
                                    • prima di creare un prodotto si cerca su Shopify una variante con lo stesso SKU, per non creare doppioni;<\/li>\n
                                    • le collezioni del negozio non si toccano, salvo le collezioni IVA.<\/li>\n<\/ul>\n
                                      Aliquote IVA ridotte<\/h3>\n
                                      Shopify non conosce l’aliquota dei singoli articoli: applica a tutti l’aliquota ordinaria dell’Italia, a meno che il prodotto stia in una collezione con eccezione IVA<\/strong>. Il gestionale fa la sua parte in automatico:<\/p>\n
                                        \n
                                      • agli articoli con aliquota diversa dall’ordinaria del sito (e maggiore di zero) aggiunge il tag IVA 10%<\/code>, IVA 4%<\/code>, IVA 5.5%<\/code>\u2026;<\/li>\n
                                      • crea la collezione manuale<\/strong> IVA 10%<\/code> (e cos\u00ec via), una per aliquota;<\/li>\n
                                      • ci inserisce i prodotti con quell’aliquota e li toglie quando l’aliquota cambia.<\/li>\n<\/ul>\n
                                        Gli articoli esenti vengono pubblicati come non soggetti a imposte<\/strong>.<\/p>\n
                                        Una volta per ogni aliquota<\/strong> bisogna impostare l’eccezione su Shopify, perch\u00e9 non esiste un modo di farlo dal gestionale:<\/p>\n
                                          \n
                                        1. pubblica almeno un articolo con quell’aliquota e controlla che la collezione IVA n%<\/code> esista e contenga il prodotto;<\/li>\n
                                        2. su Shopify: Impostazioni \u2192 Imposte e dazi \u2192 Italia \u2192 Eccezioni sui prodotti<\/strong> \u2192 aggiungi un’eccezione per la collezione IVA n%<\/code> con l’aliquota giusta;<\/li>\n
                                        3. fai un ordine di prova: su Shopify deve comparire l’IVA ridotta, e l’ordine cliente deve entrare con il codice IVA corrispondente.<\/li>\n<\/ol>\n
                                          \u26a0\ufe0f Le eccezioni IVA valgono solo sulle collezioni manuali.<\/strong> Non trasformare le collezioni IVA n%<\/code> in collezioni automatiche. Se ne esiste una automatica con quel nome, la pubblicazione segnala l’errore: va eliminata su Shopify e l’articolo ripubblicato.<\/p><\/blockquote>\n
                                          Senza eccezione, Shopify scorpora il 22% anche da un articolo al 10%, e l’ordine entra al 22%.<\/p>\n
                                          Lingue e traduzioni<\/h3>\n
                                          Se il sito ha la tabella Lingue<\/strong> (scheda Transcodifiche e opzioni<\/em>), a ogni pubblicazione il gestionale legge le lingue del negozio e usa la tabella in due modi:<\/p>\n
                                            \n
                                          • lingua principale del negozio<\/strong> (su Shopify Settings \u2192 Languages<\/em>, quella marcata Default<\/em>): se \u00e8 nella tabella, i testi principali<\/strong> del prodotto si prendono dalla lingua del gestionale abbinata. Se non \u00e8 nella tabella, i testi principali restano quelli della lingua di default del gestionale;<\/li>\n
                                          • tutte le altre righe<\/strong> diventano traduzioni<\/strong>, compresa la lingua di default del gestionale quando il negozio ha un’altra lingua principale.<\/li>\n<\/ul>\n
                                            Esempio: il negozio ha l’inglese come lingua principale e l’italiano e il tedesco come traduzioni. La tabella Lingue<\/em> \u00e8:<\/p>\n\n\n\n\n\n\n\n
                                            Lingua Shopify<\/th>\nLingua<\/th>\n<\/tr>\n<\/thead>\n
                                            en<\/code><\/td>\nENG<\/code><\/td>\n<\/tr>\n
                                            it<\/code><\/td>\nITA<\/code><\/td>\n<\/tr>\n
                                            de<\/code><\/td>\nDEU<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                            Il prodotto si pubblica con i testi inglesi dell’articolo, e l’italiano e il tedesco arrivano come traduzioni. Se il negozio avesse l’italiano come lingua principale, basterebbe la riga en<\/code> \u2192 ENG<\/code>.<\/p>\n
                                            I testi usati:<\/p>\n\n\n\n\n\n\n\n\n\n
                                            Su Shopify<\/th>\nDal gestionale, nella lingua abbinata<\/th>\n<\/tr>\n<\/thead>\n
                                            Titolo<\/td>\ndescrizione web<\/td>\n<\/tr>\n
                                            Descrizione<\/td>\ndescrizione estesa (HTML)<\/td>\n<\/tr>\n
                                            Tipo prodotto<\/td>\ndescrizione in lingua del gruppo merceologico<\/td>\n<\/tr>\n
                                            Titolo e descrizione per i motori di ricerca<\/td>\ntitolo web e meta description<\/td>\n<\/tr>\n
                                            Tag (solo testi principali)<\/td>\ntag web, insieme ai tag dell’articolo<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                            Quando un testo manca:<\/strong><\/p>\n\n\n\n\n\n\n\n
                                            Caso<\/th>\nCosa si usa<\/th>\n<\/tr>\n<\/thead>\n
                                            testi principali, lingua abbinata senza testo<\/td>\ni dati dell’articolo: descrizione, descrizione aggiuntiva, gruppo merceologico. L’articolo si pubblica comunque, con l’avviso “testi nella lingua \u2026 (lingua principale del negozio) mancanti: usati quelli dell’articolo per \u2026”<\/em><\/td>\n<\/tr>\n
                                            traduzione nella lingua di default del gestionale<\/td>\nla descrizione web in quella lingua, altrimenti i dati dell’articolo, che sono gi\u00e0 in quella lingua<\/td>\n<\/tr>\n
                                            traduzione in un’altra lingua<\/td>\nsolo la descrizione web in quella lingua. Senza testo il campo non si traduce, e il cliente vede il testo principale<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                            Regole:<\/p>\n
                                              \n
                                            • le traduzioni fatte su Shopify restano<\/strong>: quelle a mano e quelle della traduzione automatica (Translate & Adapt<\/em>) non vengono toccate, finch\u00e9 il gestionale non ha un testo proprio per quel campo. Quando ce l’ha, vince il gestionale, come per il resto del prodotto;<\/li>\n
                                            • un testo svuotato<\/strong> nel gestionale toglie da Shopify solo la traduzione inviata dal gestionale, e solo se nessuno l’ha cambiata su Shopify nel frattempo;<\/li>\n
                                            • si inviano solo i campi cambiati, e le traduzioni entrano nel confronto di Pubblica modificati<\/em>: cambiare un testo tradotto fa ripubblicare l’articolo;<\/li>\n
                                            • opzioni e valori delle varianti<\/strong> (taglia, colore\u2026) restano in una sola lingua, quella delle descrizioni dei valori nel gestionale. Per un negozio tutto in inglese vanno scritte in inglese;<\/li>\n
                                            • un campo si pu\u00f2 tradurre solo se ha un testo principale. Per esempio, una meta description presente solo nella traduzione non si invia, e il log lo segnala come avviso;<\/li>\n
                                            • i tag non si traducono: Shopify non lo prevede.<\/li>\n<\/ul>\n
                                              All’inizio di ogni pubblicazione il riquadro Avanzamento<\/em> dice quale lingua usa, per esempio “Lingua principale del negozio: en, testi dalla lingua ENG del gestionale”<\/em> e “Traduzioni in: de da DEU, it da ITA”<\/em>. Casi particolari:<\/p>\n\n\n\n\n\n\n\n\n
                                              Situazione<\/th>\nCosa succede<\/th>\n<\/tr>\n<\/thead>\n
                                              lingua principale del negozio non in tabella<\/td>\ntesti principali dalla lingua di default del gestionale, con un avviso<\/td>\n<\/tr>\n
                                              lingua della tabella non attivata sul negozio<\/td>\ntraduzioni non inviate, con l’avviso “Lingua ‘\u2026’ non attivata sul negozio (Impostazioni, Lingue): traduzioni non inviate. Dopo averla attivata usare ‘Pubblica tutti'”<\/em><\/td>\n<\/tr>\n
                                              lingua attivata ma non pubblicata<\/td>\ntraduzioni inviate; i clienti le vedono quando la lingua viene pubblicata<\/td>\n<\/tr>\n
                                              lingue del negozio non leggibili (mancano gli scope)<\/td>\nsi pubblica come senza tabella: testi principali dalla lingua di default, nessuna traduzione; gli articoli restano da reinviare al giro successivo<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                              Una riga nuova nella tabella Lingue<\/em> fa risultare modificati tutti gli articoli, e Pubblica modificati<\/em> li reinvia. Se invece la riga c’era gi\u00e0 e la lingua \u00e8 stata attivata su Shopify solo dopo, lancia Pubblica tutti<\/strong>: per il gestionale gli articoli non sono cambiati.<\/p><\/blockquote>\n
                                              \u26a0\ufe0f Se cambi la lingua principale del negozio su Shopify, lancia Pubblica tutti<\/em>.<\/strong> Finch\u00e9 non lo fai, i prodotti gi\u00e0 pubblicati hanno i testi principali nella lingua precedente.<\/p><\/blockquote>\n
                                              Nel primo allineamento<\/strong>, se la lingua principale del negozio \u00e8 nella tabella, titolo, descrizione e tag dei prodotti Shopify vanno nella descrizione web di quella lingua. La descrizione dell’articolo si prende comunque dal titolo di Shopify. Le traduzioni presenti su Shopify non si importano.<\/p>\n
                                              \n
                                              9. Giacenze<\/h2>\n
                                              La quantit\u00e0 inviata per ogni variante \u00e8 la somma, sui depositi del sito, di esistenza meno impegnato clienti<\/strong>, meno la scorta di sicurezza, arrotondata all’intero e mai negativa. Il riservato non si sottrae.<\/p>\n
                                                \n
                                              • Si inviano solo le varianti gi\u00e0 pubblicate, e solo quelle che su Shopify hanno una quantit\u00e0 diversa.<\/li>\n
                                              • Gli articoli senza gestione giacenza<\/strong> non si inviano.<\/li>\n
                                              • Se nel frattempo \u00e8 arrivato un ordine e Shopify ha cambiato la quantit\u00e0, il gestionale rilegge e riprova.<\/li>\n<\/ul>\n
                                                In automatico.<\/strong> Ogni documento che muove il magazzino su un deposito del sito mette in coda<\/strong> le varianti pubblicate che cambiano: salvataggio o cancellazione da maschera, POS, Web API, trasferimenti, rettifiche d’inventario. La coda si svuota con la procedura schedulata, subito dopo l’import degli ordini, oppure con Invia giacenze in coda<\/strong>.<\/p>\n
                                                Non passano dalla coda:<\/p>\n
                                                  \n
                                                • l’azzeramento dei saldi;<\/li>\n
                                                • la modifica manuale dei saldi;<\/li>\n
                                                • la ricostruzione dei movimenti;<\/li>\n
                                                • il cambio codice e la cancellazione degli articoli;<\/li>\n
                                                • le conversioni dati.<\/li>\n<\/ul>\n
                                                  Dopo una di queste operazioni usa Invia tutte le giacenze<\/strong>, a negozio fermo.<\/p>\n
                                                  \n
                                                  10. Import degli ordini e dei clienti<\/h2>\n
                                                  Ogni ordine Shopify diventa un ordine cliente<\/strong> con:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
                                                  Nel gestionale<\/th>\nDa Shopify<\/th>\n<\/tr>\n<\/thead>\n
                                                  Numero, serie, esercizio<\/td>\nnumero dell’ordine, serie del sito, anno della data dell’ordine<\/td>\n<\/tr>\n
                                                  Riferimento cliente<\/td>\nnome dell’ordine (#1001<\/code>)<\/td>\n<\/tr>\n
                                                  Cliente<\/td>\nvedi sotto<\/td>\n<\/tr>\n
                                                  Righe<\/td>\narticolo e variante dallo SKU; quantit\u00e0 attuali; prezzi e sconti<\/td>\n<\/tr>\n
                                                  Spese<\/td>\nspedizione sulla spesa del sito, al netto degli sconti di spedizione<\/td>\n<\/tr>\n
                                                  Destinazione<\/td>\nindirizzo di spedizione, se diverso da quello di fatturazione; viene aggiunto anche fra le destinazioni del cliente<\/td>\n<\/tr>\n
                                                  Pagamento<\/td>\ntranscodifica, poi pagamento predefinito, poi pagamento del cliente<\/td>\n<\/tr>\n
                                                  Stato<\/td>\ntranscodifica dello stato del pagamento<\/td>\n<\/tr>\n
                                                  Confermato<\/td>\ns\u00ec, se l’ordine \u00e8 pagato<\/td>\n<\/tr>\n
                                                  Note interne<\/td>\nnumero Shopify, metodo di pagamento (Pagamento Shopify: \u2026<\/em>), nota e attributi del checkout, riepilogo degli sconti con i codici usati<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                                  Sconti.<\/strong><\/p>\n
                                                    \n
                                                  • Uno sconto sull’intero ordine va in testata: in percentuale se su Shopify \u00e8 uno solo in percentuale, altrimenti a valore.<\/li>\n
                                                  • Uno sconto di riga in percentuale va nello sconto della riga; quello a valore, o pi\u00f9 sconti sulla stessa riga, vanno nel prezzo netto.<\/li>\n
                                                  • Lo sconto previsto dal codice di pagamento non si applica agli ordini Shopify.<\/li>\n<\/ul>\n
                                                    Controllo del totale.<\/strong> Se il totale del gestionale differisce da quello di Shopify di pi\u00f9 di un centesimo, l’ordine entra comunque. La differenza viene scritta nelle note interne e l’ordine prende lo stato dell’ultima riga della transcodifica stati (da verificare<\/em>).<\/p>\n
                                                    Clienti.<\/strong> Il cliente si cerca, nell’ordine, per collegamento, per codice d’import, per email. Se non esiste viene creato con:<\/p>\n
                                                      \n
                                                    • codice = prefisso + progressivo;<\/li>\n
                                                    • persona fisica, se mancano ragione sociale e partita IVA;<\/li>\n
                                                    • codice fiscale o partita IVA dai campi fiscali del checkout (11 cifre = partita IVA);<\/li>\n
                                                    • PEC dal campo fiscale del checkout;<\/li>\n
                                                    • SDI dall’attributo indicato nel sito; 0000000<\/code> per i clienti italiani nuovi senza SDI;<\/li>\n
                                                    • sottoconto, categoria e pagamento dal sito.<\/li>\n<\/ul>\n
                                                      Di un cliente esistente si completano solo i campi vuoti<\/strong>: i dati gi\u00e0 presenti, in particolare quelli fiscali, non vengono sovrascritti.<\/p>\n
                                                      Ordini che non entrano.<\/strong> Un ordine con un errore non viene importato e resta in coda<\/strong>. Viene ritentato a ogni giro, per al massimo 20 volte. I casi tipici:<\/p>\n
                                                        \n
                                                      • una riga senza SKU, o con uno SKU che non corrisponde a nessun articolo (tipicamente un prodotto creato su Shopify e non nel gestionale): crea o correggi l’articolo, oppure correggi lo SKU su Shopify;<\/li>\n
                                                      • un’aliquota senza transcodifica;<\/li>\n
                                                      • il numero gi\u00e0 usato nella serie.<\/li>\n<\/ul>\n
                                                        Il motivo si legge nel log, scheda Code<\/em>.<\/p>\n
                                                        Ordini modificati su Shopify.<\/strong> Un ordine non ancora evaso n\u00e9 fatturato viene sostituito<\/strong> con la versione aggiornata. Un ordine gi\u00e0 evaso o fatturato non si modifica pi\u00f9<\/strong>: la differenza resta segnalata nel log.<\/p>\n
                                                        Ordini annullati su Shopify.<\/strong> Se l’ordine cliente non \u00e8 evaso n\u00e9 fatturato viene cancellato<\/strong>. Altrimenti resta e l’annullamento \u00e8 segnalato nel log.<\/p>\n
                                                        \n
                                                        11. Evasioni e tracking<\/h2>\n
                                                        Quando evadi un ordine Shopify con un DDT<\/strong> o una fattura<\/strong>, anche in pi\u00f9 volte e per righe parziali, Invia evasioni<\/em> segna come spedite su Shopify le righe corrispondenti. Una fattura fatta direttamente dall’ordine evade tutto il residuo.<\/p>\n
                                                          \n
                                                        • Si considerano i documenti con data da Ordini dal<\/em>. Invia evasione ordine…<\/em> lavora su un solo ordine, senza limite di data.<\/li>\n
                                                        • Le righe aggiunte nel gestionale, che su Shopify non esistono, vengono ignorate. Le quantit\u00e0 sono arrotondate all’intero.<\/li>\n
                                                        • Le spedizioni gi\u00e0 fatte a mano su Shopify non vengono raddoppiate.<\/li>\n
                                                        • Un documento gi\u00e0 inviato non si reinvia. Se nel frattempo \u00e8 cambiato il tracking, viene aggiornato su Shopify.<\/li>\n<\/ul>\n
                                                          Corriere e tracking.<\/strong><\/p>\n
                                                            \n
                                                          • Numero di tracking<\/strong>: campo N. Tracking<\/strong> nella scheda dei vettori del documento. Vale il primo vettore del documento che ha un numero.<\/li>\n
                                                          • Nome corriere<\/strong> e URL di tracciamento<\/strong>: nell’anagrafica Vettori<\/strong>, scheda Tracciamento<\/strong> (Archivi \u2192 Tabelle \u2192 Trasporto \u2192 Vettori<\/em>).\n
                                                              \n
                                                            • Il nome va scritto come lo riconosce Shopify (BRT, GLS, Poste Italiane, SDA, DHL Express, UPS\u2026); se \u00e8 vuoto si usa il nome del vettore.<\/li>\n
                                                            • L’URL \u00e8 l’indirizzo della pagina di tracciamento con {tracking}<\/code> al posto del numero, per esempio https:\/\/www.corriere.it\/tracking?numero={tracking}<\/code>. Se \u00e8 vuoto e il corriere \u00e8 noto a Shopify, il link lo genera Shopify.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
                                                              Un documento senza tracking si pu\u00f2 inviare subito con il solo corriere. Il numero, aggiunto dopo, parte con il successivo Invia evasioni<\/em>.<\/p>\n
                                                              L’email di spedizione al cliente parte se \u00e8 attiva l’opzione Alla spedizione Shopify avvisa il cliente via email<\/em>.<\/p>\n
                                                              \n
                                                              12. Rimborsi<\/h2>\n
                                                              Un rimborso fatto su Shopify:<\/p>\n
                                                                \n
                                                              • su un ordine non ancora evaso n\u00e9 fatturato<\/strong>: l’ordine viene reimportato con le quantit\u00e0 correnti e lo stato della transcodifica (Rimborsato<\/em>, Rimborsato in parte<\/em>);<\/li>\n
                                                              • su un ordine gi\u00e0 evaso o fatturato<\/strong>: l’ordine non si tocca. Il gestionale:\n
                                                                  \n
                                                                • scrive un avviso<\/strong> nel log e nel riquadro di avanzamento, per esempio “Ordine #1002 gia’ evaso o fatturato: rimborsato su Shopify il 26\/09\/2026 per 25,50 EUR: valutare nota di credito o reso nel gestionale”<\/em>, con il dettaglio delle righe rimborsate (e se la merce \u00e8 stata rimessa a magazzino su Shopify) e la nota del rimborso;<\/li>\n
                                                                • aggiunge una riga alle note interne<\/strong> dell’ordine cliente;<\/li>\n
                                                                • conta il rimborso nell’esito (rimborsi da gestire<\/em>).<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
                                                                  Ogni rimborso si segnala una sola volta. Nessun documento viene creato in automatico<\/strong>: la nota di credito o il reso si fanno a mano.<\/p>\n
                                                                  \n
                                                                  13. La procedura schedulata<\/h2>\n
                                                                  In automatico gira una sola procedura, Import ordini Shopify e invio giacenze<\/strong>, che importa gli ordini e poi invia le giacenze in coda. Si configura in Utilit\u00e0 \u2192 Amministrazione \u2192 Schedulatore<\/strong> con:<\/p>\n