{"id":4878,"date":"2021-06-22T11:50:46","date_gmt":"2021-06-22T10:50:46","guid":{"rendered":"https:\/\/www.atlantisevo.com\/doc\/?post_type=manual_documentation&#038;p=4878"},"modified":"2026-09-16T11:19:02","modified_gmt":"2026-09-16T10:19:02","slug":"anagrafica-siti","status":"publish","type":"manual_documentation","link":"https:\/\/www.atlantisevo.com\/doc\/manuale\/e-commerce\/woocommerce\/anagrafica-siti\/","title":{"rendered":"Anagrafica siti"},"content":{"rendered":"<div id=\"toctoc\"><\/div><p><img loading=\"lazy\" class=\"aligncenter size-full wp-image-4896\" src=\"https:\/\/www.atlantisevo.com\/doc\/wp-content\/uploads\/2021\/06\/anag_siti.png\" alt=\"Integrazione WooCommerce - anagrafica siti\" width=\"890\" height=\"641\" srcset=\"https:\/\/www.atlantisevo.com\/doc\/wp-content\/uploads\/2021\/06\/anag_siti.png 890w, https:\/\/www.atlantisevo.com\/doc\/wp-content\/uploads\/2021\/06\/anag_siti-300x216.png 300w, https:\/\/www.atlantisevo.com\/doc\/wp-content\/uploads\/2021\/06\/anag_siti-768x553.png 768w\" sizes=\"(max-width: 890px) 100vw, 890px\" title=\"\"><\/p>\n<p>Questa maschera contiene <strong>tutta la configurazione del collegamento tra Atlantis e un sito WooCommerce<\/strong>: come raggiungerlo, in che verso far viaggiare i prodotti, come tradurre IVA, pagamenti e stati degli ordini, come creare i clienti che arrivano dal sito.<\/p>\n<p>Qui <strong>non si sincronizza nulla<\/strong>: si configura soltanto. Le sincronizzazioni vere (scaricamento prodotti, caricamento prodotti e immagini, sincronizzazione quantit\u00e0 e prezzi, scaricamento ordini) si lanciano dalla maschera <strong>Gestione sito<\/strong>, che usa quanto impostato qui.<\/p>\n<p>Si possono configurare <strong>pi\u00f9 siti<\/strong>: ogni sito \u00e8 un record con un proprio codice numerico.<\/p>\n<hr \/>\n<h2>1. Come funziona il collegamento<\/h2>\n<p>Vale la pena capirlo prima di compilare i campi, perch\u00e9 spiega l&#8217;ordine delle operazioni e la maggior parte degli errori.<\/p>\n<p>Atlantis <strong>non dialoga direttamente con WooCommerce<\/strong>. Il collegamento avviene in due tempi:<\/p>\n<ol>\n<li>Atlantis carica sul sito, <strong>via FTP o SFTP<\/strong>, un piccolo <strong>client<\/strong> (un insieme di file PHP) nella cartella indicata. Durante il caricamento il client viene personalizzato con il <strong>token<\/strong> e con alcuni parametri (memoria, tempo massimo, nomi degli attributi taglia e colore);<\/li>\n<li>da quel momento Atlantis parla con il client <strong>via HTTP<\/strong>, autenticandosi con lo stesso token.<\/li>\n<\/ol>\n<hr \/>\n<h2>2. Testata<\/h2>\n<table>\n<thead>\n<tr>\n<th>Campo<\/th>\n<th>A cosa serve<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Codice<\/strong><\/td>\n<td>identificativo numerico del sito<\/td>\n<\/tr>\n<tr>\n<td><strong>Descrizione<\/strong><\/td>\n<td>nome con cui riconoscerlo negli elenchi<\/td>\n<\/tr>\n<tr>\n<td><strong>Url<\/strong><\/td>\n<td>indirizzo del sito, usato per tutte le chiamate al client<\/td>\n<\/tr>\n<tr>\n<td><strong>Attivo<\/strong><\/td>\n<td>disattivando il sito lo si esclude dalle elaborazioni<\/td>\n<\/tr>\n<tr>\n<td><strong>Tipo<\/strong><\/td>\n<td>WooCommerce<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Il pulsante <strong>Apri sito<\/strong> apre l&#8217;URL nel browser.<\/p>\n<hr \/>\n<h2>3. Scheda &#8220;Principale&#8221;<\/h2>\n<table>\n<thead>\n<tr>\n<th>Campo<\/th>\n<th>A cosa serve<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Token<\/strong><\/td>\n<td>la chiave condivisa tra Atlantis e il client sul sito. <strong>Genera<\/strong> ne crea una nuova di 64 caratteri<\/td>\n<\/tr>\n<tr>\n<td><strong>Modalit\u00e0 prodotti<\/strong><\/td>\n<td>il verso in cui viaggiano i prodotti (vedi sotto)<\/td>\n<\/tr>\n<tr>\n<td><strong>Attiva chiamate asincrone<\/strong><\/td>\n<td>da attivare se le chiamate al server vengono interrotte per timeout: il sito prepara i dati e Atlantis li recupera controllando ogni 10 secondi<\/td>\n<\/tr>\n<tr>\n<td><strong>Esecuzione sincronizzazione bloccata \/ in corso<\/strong><\/td>\n<td>semaforo automatico<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>I tre pulsanti<\/h3>\n<ul>\n<li><strong>Test FTP sito<\/strong> &#8211; esegue la diagnostica passo passo della connessione (vedi \u00a7 9);<\/li>\n<li><strong>Carica server<\/strong> &#8211; installa o aggiorna il <strong>client<\/strong> sul sito. Richiede che il record sia <strong>gi\u00e0 salvato<\/strong>: se ci sono modifiche in sospeso compare <em>&#8220;E&#8217; necessario eseguire prima il salvataggio dei dati&#8221;<\/em>;<\/li>\n<li><strong>Apri sito<\/strong> &#8211; apre il sito nel browser.<\/li>\n<\/ul>\n<h3>Modalit\u00e0 prodotti<\/h3>\n<p>\u00c8 la scelta che determina tutto il resto della configurazione dei prodotti:<\/p>\n<table>\n<thead>\n<tr>\n<th>Modalit\u00e0<\/th>\n<th>Significato<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Anagrafica articoli su sito<\/strong><\/td>\n<td>i prodotti nascono sul sito e Atlantis li <strong>scarica<\/strong>, creando automaticamente gli articoli in anagrafica<\/td>\n<\/tr>\n<tr>\n<td><strong>Gestione manuale<\/strong><\/td>\n<td>i prodotti si creano a mano da entrambe le parti; Atlantis si limita ad allineare quantit\u00e0 e prezzi<\/td>\n<\/tr>\n<tr>\n<td><strong>Anagrafica articoli su gestionale<\/strong><\/td>\n<td>i prodotti nascono in Atlantis e vengono <strong>pubblicati<\/strong> sul sito<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Scegliendo <em>Anagrafica articoli su sito<\/em> diventano <strong>obbligatori<\/strong> i campi che servono a creare gli articoli: N. giorni, unit\u00e0 di misura, gruppo merceologico e contropartita nella scheda <em>Prodotti da sito<\/em>.<\/p>\n<h3>Il flag di blocco sincronizzazione<\/h3>\n<p>Viene acceso <strong>automaticamente<\/strong> all&#8217;avvio di una sincronizzazione e spento alla fine: serve a impedire che due elaborazioni sullo stesso sito partano insieme.<\/p>\n<blockquote><p>\u26a0\ufe0f Se una sincronizzazione si interrompe in modo anomalo (blocco del programma, caduta della rete) il flag pu\u00f2 restare acceso e le sincronizzazioni successive non partono. In quel caso va <strong>tolto a mano<\/strong> da qui, dopo essersi assicurati che non ci sia davvero un&#8217;elaborazione in corso.<\/p><\/blockquote>\n<hr \/>\n<h2>4. Scheda &#8220;Prodotti&#8221;<\/h2>\n<h3>Generale<\/h3>\n<table>\n<thead>\n<tr>\n<th>Campo<\/th>\n<th>A cosa serve<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Listino<\/strong><\/td>\n<td>con prodotti da sito, il listino in cui vengono <strong>scritti<\/strong> i prezzi letti dal sito; con prodotti da gestionale, il listino da cui vengono <strong>letti<\/strong><\/td>\n<\/tr>\n<tr>\n<td><strong>Listino personalizz.<\/strong><\/td>\n<td>usato con prodotti da gestionale per determinare il prezzo da pubblicare<\/td>\n<\/tr>\n<tr>\n<td><strong>Listino personal. offerte<\/strong><\/td>\n<td>il prezzo in <strong>offerta<\/strong>: sul sito compare il prezzo scontato e il prezzo pieno barrato<\/td>\n<\/tr>\n<tr>\n<td><strong>Deposito movim.\/giac.<\/strong><\/td>\n<td>deposito usato per giacenze e per la creazione dei prodotti<\/td>\n<\/tr>\n<tr>\n<td><strong>N. dec. prezzi \/ N. dec. qta<\/strong><\/td>\n<td>decimali usati nello scambio dati<\/td>\n<\/tr>\n<tr>\n<td><strong>Qta da sincronizzare<\/strong><\/td>\n<td><em>Non sincronizzare<\/em>, <em>Esistenza<\/em>, <em>Disponibilit\u00e0<\/em>, <em>Esistenza disponibile<\/em> (al netto dell&#8217;impegnato da cliente)<\/td>\n<\/tr>\n<tr>\n<td><strong>Costo<\/strong><\/td>\n<td>il costo di riferimento da inviare<\/td>\n<\/tr>\n<tr>\n<td><strong>Stato nuovi prodotti<\/strong><\/td>\n<td>i prodotti creati sul sito nascono <strong>Pubblicati<\/strong> o in <strong>Bozza<\/strong><\/td>\n<\/tr>\n<tr>\n<td><strong>Gestione descrizione<\/strong><\/td>\n<td>la descrizione va nella <strong>descrizione principale<\/strong> o nella <strong>descrizione breve<\/strong> del prodotto<\/td>\n<\/tr>\n<tr>\n<td><strong>Meta key barcode<\/strong><\/td>\n<td>nome del campo meta di WooCommerce che contiene il codice a barre<\/td>\n<\/tr>\n<tr>\n<td><strong>Ordini arretrati<\/strong><\/td>\n<td>se il sito accetta ordini a fronte di giacenza esaurita: <em>non permettere<\/em>, <em>permetti<\/em>, <em>permetti e avvisa il cliente<\/em><\/td>\n<\/tr>\n<tr>\n<td><strong>Modalit\u00e0 aggiornamento prezzi<\/strong><\/td>\n<td><em>predefinita<\/em> (segue la modalit\u00e0 prodotti) oppure <em>aggiorna sempre i listini del sito con quelli del gestionale<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Sono inoltre presenti le opzioni di <strong>gestione varianti tramite codice variante<\/strong> (con modalit\u00e0, separatore e generazione automatica del codice): usano il codice variante definito nella sezione <em>Codici a barre<\/em> dell&#8217;articolo per riconoscere le varianti.<\/p>\n<blockquote><p>\u26a0\ufe0f La gestione <strong>varianti generiche<\/strong> e la gestione <strong>varianti con codice variante<\/strong> sono <strong>incompatibili tra loro<\/strong>: attivandole entrambe, al salvataggio compare una segnalazione esplicita. Entrambe, inoltre, vanno attivate <strong>solo su configurazioni nuove<\/strong>: su un sito gi\u00e0 avviato cambiano il modo in cui i prodotti vengono riconosciuti.<\/p><\/blockquote>\n<h3>Prodotti da sito<\/h3>\n<p>I valori usati per <strong>creare gli articoli<\/strong> a partire dai prodotti del sito: unit\u00e0 di misura, gruppo merceologico, codice monofase, contropartita, numero di reparto, controlli su <em>fuori giacenza<\/em> e <em>fuori disponibilit\u00e0<\/em> (non gestito \/ avvisa \/ blocca), struttura varianti per gli articoli taglia-colore.<\/p>\n<p>Qui si imposta anche il comportamento dello scaricamento: <strong>N. gg<\/strong> (scarica i prodotti modificati negli ultimi <em>n<\/em> giorni), <strong>modo scarico varianti<\/strong> (tutte o solo quelle disponibili), <strong>scarica codice variante<\/strong>, <strong>usa varianti generiche<\/strong>, <strong>scarica prodotti non pubblicati<\/strong>.<\/p>\n<h3>Liste articoli<\/h3>\n<p>L&#8217;elenco delle <strong>liste articoli<\/strong> che determinano quali prodotti pubblicare sul sito, nella modalit\u00e0 &#8220;articoli da gestionale&#8221;. Con il flag <strong>Escludi<\/strong> una lista viene usata al contrario, per togliere articoli dalla pubblicazione.<\/p>\n<blockquote><p>Nei prodotti a varianti vengono comunque esportate <strong>tutte<\/strong> le varianti.<\/p><\/blockquote>\n<h3>Immagini<\/h3>\n<table>\n<thead>\n<tr>\n<th>Campo<\/th>\n<th>A cosa serve<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Categoria Immagine principale<\/strong><\/td>\n<td>la categoria documenti da cui prendere l&#8217;immagine principale dell&#8217;articolo<\/td>\n<\/tr>\n<tr>\n<td><strong>Categoria altre Immagini<\/strong><\/td>\n<td>la categoria da cui prendere le immagini aggiuntive<\/td>\n<\/tr>\n<tr>\n<td><strong>Immagine watermark<\/strong> e <strong>Applica watermark<\/strong><\/td>\n<td>filigrana (formato PNG) da sovrapporre alle immagini pubblicate<\/td>\n<\/tr>\n<tr>\n<td><strong>Percorso immagini su sito<\/strong><\/td>\n<td>cartella di destinazione sul sito<\/td>\n<\/tr>\n<tr>\n<td><strong>Disattiva collegamento immagini<\/strong><\/td>\n<td>da attivare se le immagini si gestiscono direttamente dal sito<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>Altri depositi<\/h3>\n<p>L&#8217;elenco dei depositi <strong>aggiuntivi<\/strong> che concorrono, sommandosi, all&#8217;esistenza o disponibilit\u00e0 inviata al sito. Serve a chi pubblica la giacenza complessiva di pi\u00f9 magazzini.<\/p>\n<h3>Articoli \/ depositi<\/h3>\n<p>Un deposito <strong>specifico per singolo articolo<\/strong>, quando quell&#8217;articolo va sincronizzato guardando un magazzino diverso da quello generale. Se si compila una delle due colonne bisogna compilarle entrambe: la riga non viene salvata se manca l&#8217;articolo o il deposito.<\/p>\n<h3>Varie<\/h3>\n<p>Tre tabelle di dettaglio: <strong>Articoli \/ categorie<\/strong> (id categoria web per articolo), <strong>Articoli \/ Tag<\/strong> (id tag web per articolo) e <strong>Articoli correlati<\/strong> (prodotti da proporre insieme).<\/p>\n<hr \/>\n<h2>5. Scheda &#8220;Clienti&#8221;<\/h2>\n<p>Regola come vengono creati e riconosciuti i clienti che arrivano dal sito.<\/p>\n<table>\n<thead>\n<tr>\n<th>Campo<\/th>\n<th>A cosa serve<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Prefisso num. clienti<\/strong><\/td>\n<td>prefisso per numerare a parte i clienti provenienti dal sito<\/td>\n<\/tr>\n<tr>\n<td><strong>Sottoconto<\/strong>, <strong>Categoria<\/strong>, <strong>Cod. contropartite<\/strong>, <strong>Categ. Provv.<\/strong><\/td>\n<td>valori attribuiti ai clienti creati<\/td>\n<\/tr>\n<tr>\n<td><strong>Cod. SDI default<\/strong><\/td>\n<td>codice destinatario impostato sui nuovi clienti<\/td>\n<\/tr>\n<tr>\n<td><strong>Meta key<\/strong> codice fiscale \/ partita IVA \/ cod. SDI \/ email PEC<\/td>\n<td>i nomi dei campi meta di WooCommerce da cui leggere quei dati (es. <code>billing_codice_fiscale<\/code>)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>Il riconoscimento per e-mail<\/h3>\n<p>Due coppie di opzioni, una per i clienti <strong>registrati<\/strong> sul sito e una per gli acquisti <strong>Guest<\/strong>:<\/p>\n<ul>\n<li><strong>Tenta di determinare clienti in archivio tramite email<\/strong> &#8211; invece di creare un nuovo cliente, Atlantis cerca in anagrafica un soggetto con la stessa e-mail e usa quello;<\/li>\n<li><strong>Se trova cliente in archivio aggiorna l&#8217;anagrafica nel gestionale con dati sito<\/strong> &#8211; a riconoscimento avvenuto, sovrascrive i dati anagrafici con quelli del sito.<\/li>\n<\/ul>\n<blockquote><p>\u26a0\ufe0f La seconda opzione \u00e8 segnalata come <strong>ATTENZIONE<\/strong> gi\u00e0 nella maschera, ed \u00e8 il caso di prenderla sul serio: attivandola, l&#8217;anagrafica curata nel gestionale viene sostituita da quella che il cliente ha digitato sul sito, indirizzo di fatturazione compreso. Attivala solo se il sito \u00e8 la fonte autorevole dei dati cliente.<\/p><\/blockquote>\n<hr \/>\n<h2>6. Scheda &#8220;Ordini&#8221;<\/h2>\n<h3>Principale<\/h3>\n<table>\n<thead>\n<tr>\n<th>Campo<\/th>\n<th>A cosa serve<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>N. gg<\/strong><\/td>\n<td>scarica gli ordini modificati negli ultimi <em>n<\/em> giorni<\/td>\n<\/tr>\n<tr>\n<td><strong>Stato ordini da importare<\/strong><\/td>\n<td>quali stati WooCommerce vanno importati (selezione <strong>multipla<\/strong> con Ctrl + clic)<\/td>\n<\/tr>\n<tr>\n<td><strong>Stato ordini da cancellare<\/strong><\/td>\n<td>gli stati che provocano la <strong>cancellazione<\/strong> dell&#8217;impegno gi\u00e0 importato (es. ordine annullato o rimborsato)<\/td>\n<\/tr>\n<tr>\n<td><strong>Scarica ordini dal<\/strong><\/td>\n<td>data sotto la quale non scaricare nulla: utile alla prima attivazione per non importare lo storico<\/td>\n<\/tr>\n<tr>\n<td><strong>Causale doc.<\/strong><\/td>\n<td>la causale con cui viene creato l&#8217;impegno cliente. L&#8217;elenco \u00e8 filtrato sui documenti di tipo impegno<\/td>\n<\/tr>\n<tr>\n<td><strong>Cod. spesa spediz.<\/strong><\/td>\n<td>la spesa con cui viene addebitato il costo di spedizione<\/td>\n<\/tr>\n<tr>\n<td><strong>Cod. articolo default<\/strong><\/td>\n<td>articolo da usare per le righe non riconosciute<\/td>\n<\/tr>\n<tr>\n<td><strong>Codice pagamento predefinito<\/strong><\/td>\n<td>usato quando sull&#8217;ordine non \u00e8 indicata alcuna modalit\u00e0 di pagamento<\/td>\n<\/tr>\n<tr>\n<td><strong>Salva note su<\/strong><\/td>\n<td>note interne dell&#8217;impegno oppure note stampate<\/td>\n<\/tr>\n<tr>\n<td><strong>Ricalcola prezzi con condizioni commerciali cliente<\/strong><\/td>\n<td>ignora i prezzi del sito e riapplica listini e sconti del cliente<\/td>\n<\/tr>\n<tr>\n<td><strong>Applica condizione di pagamento del cliente<\/strong><\/td>\n<td>usa il pagamento dell&#8217;anagrafica invece di quello dell&#8217;ordine<\/td>\n<\/tr>\n<tr>\n<td><strong>Accoda codice variante WooCommerce a descrizione articolo<\/strong><\/td>\n<td>riporta il codice della variante nella descrizione di riga<\/td>\n<\/tr>\n<tr>\n<td><strong>Scarica ordini con valori IVA inclusa<\/strong><\/td>\n<td>l&#8217;ordine viene creato a valori lordi<\/td>\n<\/tr>\n<tr>\n<td><strong>Determina aliquota iva in base configurazione WooCommerce<\/strong><\/td>\n<td>usa le aliquote configurate su WooCommerce invece della tabella IVA (\u00a7 7)<\/td>\n<\/tr>\n<tr>\n<td><strong>Escludi articoli in ordine da lista<\/strong><\/td>\n<td>una lista articoli le cui righe non vengono importate<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>Pagamenti<\/h3>\n<p>La tabella di corrispondenza tra la <strong>descrizione del pagamento sul sito<\/strong> e il <strong>codice pagamento di Atlantis<\/strong>. Si compilano i due campi e si preme <strong>Aggiungi<\/strong>; la riga compare nell&#8217;elenco sottostante, con un collegamento <strong>Canc.<\/strong> per rimuoverla.<\/p>\n<p>La corrispondenza viene cercata in due passaggi:<\/p>\n<ol>\n<li><strong>corrispondenza esatta<\/strong> del testo (senza distinzione tra maiuscole e minuscole);<\/li>\n<li><strong>espressione regolare<\/strong>, per le voci scritte con il prefisso <code>regex:<\/code> &#8211; per esempio <code>regex:^Paga in 3 rate\\b<\/code> intercetta tutte le varianti di quel testo.<\/li>\n<\/ol>\n<blockquote><p>\u26a0\ufe0f Se un ordine arriva con un pagamento che <strong>non trova corrispondenza<\/strong>, l&#8217;importazione di quell&#8217;ordine fallisce con <em>&#8220;Corrispondenza codice pagamento non trovata per pagamento &#8216;\u2026'&#8221;<\/em>. Ogni volta che sul sito si attiva un nuovo metodo di pagamento, va aggiunta qui la riga corrispondente.<\/p><\/blockquote>\n<h3>Stati ordine<\/h3>\n<p>La corrispondenza tra lo <strong>stato dell&#8217;ordine su WooCommerce<\/strong> e lo <strong>stato del documento<\/strong> in Atlantis: si indicano codice stato del sito e stato gestionale, poi <strong>Aggiungi<\/strong>.<\/p>\n<p>Il pulsante con la <strong>i<\/strong> mostra l&#8217;elenco degli stati standard di WooCommerce:<\/p>\n<table>\n<thead>\n<tr>\n<th>Codice<\/th>\n<th>Significato<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>pending<\/code><\/td>\n<td>pagamento in sospeso<\/td>\n<\/tr>\n<tr>\n<td><code>processing<\/code><\/td>\n<td>in elaborazione<\/td>\n<\/tr>\n<tr>\n<td><code>on-hold<\/code><\/td>\n<td>in attesa di pagamento (es. bonifico)<\/td>\n<\/tr>\n<tr>\n<td><code>completed<\/code><\/td>\n<td>completato<\/td>\n<\/tr>\n<tr>\n<td><code>cancelled<\/code><\/td>\n<td>cancellato<\/td>\n<\/tr>\n<tr>\n<td><code>refunded<\/code><\/td>\n<td>rimborsato<\/td>\n<\/tr>\n<tr>\n<td><code>failed<\/code><\/td>\n<td>pagamento fallito<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>Escludi articoli in scaricamento ordini<\/h3>\n<p>Un elenco di testi: se la <strong>descrizione dell&#8217;articolo<\/strong> in una riga d&#8217;ordine <strong>contiene<\/strong> uno di questi testi, la riga non viene importata. Serve per le righe tecniche che WooCommerce aggiunge agli ordini e che non hanno senso nel gestionale.<\/p>\n<hr \/>\n<h2>7. Scheda &#8220;IVA&#8221;<\/h2>\n<p>La tabella di corrispondenza tra l&#8217;<strong>aliquota IVA del sito<\/strong> (il valore numerico, es. <code>22<\/code>) e il <strong>codice IVA di Atlantis<\/strong>. Si compilano i due campi e si preme <strong>Aggiungi<\/strong>.<\/p>\n<blockquote><p>\u26a0\ufe0f Come per i pagamenti, un&#8217;aliquota <strong>non mappata<\/strong> fa fallire l&#8217;importazione dell&#8217;ordine con <em>&#8220;Corrispondenza codici IVA non trovata per iva \u2026&#8221;<\/em>. Mappa tutte le aliquote che il sito pu\u00f2 produrre, comprese quelle a 0 per le esenzioni.<\/p><\/blockquote>\n<p>Se si attiva l&#8217;opzione <em>Determina aliquota iva in base configurazione WooCommerce<\/em> (scheda Ordini), le aliquote vengono lette dalla configurazione del sito.<\/p>\n<hr \/>\n<h2>8. Scheda &#8220;FTP \/ SFTP&#8221;<\/h2>\n<p>Le credenziali con cui Atlantis installa il client e carica le immagini.<\/p>\n<table>\n<thead>\n<tr>\n<th>Campo<\/th>\n<th>Note<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Tipo connessione<\/strong><\/td>\n<td>FTP, SFTP o FTPS<\/td>\n<\/tr>\n<tr>\n<td><strong>Host<\/strong>, <strong>Utente<\/strong>, <strong>Password<\/strong>, <strong>Porta<\/strong><\/td>\n<td>tipicamente 21 per FTP, 22 per SFTP<\/td>\n<\/tr>\n<tr>\n<td><strong>Cartella<\/strong><\/td>\n<td>la cartella radice del sito, es. <code>\/htdocs<\/code><\/td>\n<\/tr>\n<tr>\n<td><strong>Modalit\u00e0 passiva<\/strong><\/td>\n<td>solo per connessioni FTP<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<hr \/>\n<h2>9. Test FTP sito<\/h2>\n<p>La diagnostica passo passo del collegamento: ogni riga si spunta se il passaggio riesce, e ci si ferma al primo che fallisce mostrando l&#8217;errore. I controlli, nell&#8217;ordine, sono:<\/p>\n<ol>\n<li>connessione FTP, autenticazione utente, posizionamento sulla cartella;<\/li>\n<li>creazione di una cartella e caricamento di un file HTML;<\/li>\n<li><strong>lettura via HTTP<\/strong> di quel file &#8211; \u00e8 il passaggio che verifica che la cartella FTP corrisponda davvero all&#8217;URL del sito, l&#8217;errore di configurazione pi\u00f9 frequente;<\/li>\n<li>cancellazione del file e della cartella;<\/li>\n<li>caricamento di uno script PHP, sua <strong>esecuzione via HTTP<\/strong> e cancellazione.<\/li>\n<\/ol>\n<p>Conviene farlo passare tutto <strong>prima<\/strong> di premere <em>Carica server<\/em>.<\/p>\n<hr \/>\n<h2>10. Specifiche CMS \u2192 WooCommerce<\/h2>\n<p>I nomi degli <strong>attributi<\/strong> di WooCommerce che rappresentano taglia e colore (proposti <code>taglia<\/code> e <code>colore<\/code>). Vanno scritti esattamente come sono definiti sul sito.<\/p>\n<blockquote><p>Modificandoli \u00e8 necessario <strong>ricaricare il client<\/strong>: questi due valori vengono scritti dentro la configurazione del client durante il caricamento.<\/p><\/blockquote>\n<hr \/>\n<h2>11. Scheda &#8220;Avanzate&#8221;<\/h2>\n<table>\n<thead>\n<tr>\n<th>Campo<\/th>\n<th>A cosa serve<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Memoria massima<\/strong><\/td>\n<td>limite di memoria PHP del client, in MB. <strong>Richiede il ricaricamento del client<\/strong><\/td>\n<\/tr>\n<tr>\n<td><strong>Tempo massimo<\/strong><\/td>\n<td>tempo massimo di esecuzione, in secondi. <strong>Richiede il ricaricamento del client<\/strong><\/td>\n<\/tr>\n<tr>\n<td><strong>Nr. record per chiamata<\/strong><\/td>\n<td>quanti record per ogni chiamata nelle sincronizzazioni di articoli, quantit\u00e0 e prezzi (0 = 1000)<\/td>\n<\/tr>\n<tr>\n<td><strong>Intervallo fra chiamate server<\/strong><\/td>\n<td>pausa in secondi tra una chiamata e l&#8217;altra<\/td>\n<\/tr>\n<tr>\n<td><strong>Attiva log sincronizzazioni sul server<\/strong><\/td>\n<td>scrive un log lato sito, utile in diagnosi<\/td>\n<\/tr>\n<tr>\n<td><strong>Lingua default<\/strong><\/td>\n<td>proposta <code>it<\/code><\/td>\n<\/tr>\n<tr>\n<td><strong>Script caricamento prodotti<\/strong><\/td>\n<td>script eseguito per ogni prodotto in fase di pubblicazione<\/td>\n<\/tr>\n<tr>\n<td><strong>Script ins.to \/ agg.to clienti<\/strong><\/td>\n<td>script eseguito all&#8217;inserimento o aggiornamento di un cliente<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Se il sito va in timeout o in errore di memoria durante le sincronizzazioni, i tre parametri da rivedere sono <strong>memoria<\/strong>, <strong>tempo massimo<\/strong> e <strong>numero di record per chiamata<\/strong> (abbassandolo), oltre alle <em>chiamate asincrone<\/em> nella scheda Principale.<\/p>\n<h3>Gli script<\/h3>\n<p>Accanto a ciascuno dei due campi, il pulsante con l&#8217;icona apre il <strong>template<\/strong> con le variabili disponibili.<\/p>\n<p>Per lo script di <strong>caricamento prodotti<\/strong>:<\/p>\n<table>\n<thead>\n<tr>\n<th>Variabile<\/th>\n<th>Contenuto<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>_ditta<\/code><\/td>\n<td>azienda corrente<\/td>\n<\/tr>\n<tr>\n<td><code>_xmlProd<\/code><\/td>\n<td>l&#8217;oggetto XML del prodotto gi\u00e0 compilato, che sta per essere inviato<\/td>\n<\/tr>\n<tr>\n<td><code>_enArticolo<\/code><\/td>\n<td>l&#8217;articolo di Atlantis<\/td>\n<\/tr>\n<tr>\n<td><code>_enSito<\/code><\/td>\n<td>il sito corrente<\/td>\n<\/tr>\n<tr>\n<td><code>_listaDepositi<\/code><\/td>\n<td>i depositi considerati<\/td>\n<\/tr>\n<tr>\n<td><code>_tipoUpload<\/code><\/td>\n<td><code>A<\/code> articoli, <code>Q<\/code> quantit\u00e0, <code>P<\/code> prezzi e quantit\u00e0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Per lo script di <strong>inserimento\/aggiornamento clienti<\/strong>: <code>_ditta<\/code> e <code>_enSogg<\/code> (il soggetto).<\/p>\n<p>Servono per le personalizzazioni: modificare al volo un dato prima dell&#8217;invio, valorizzare campi non previsti, applicare regole specifiche del cliente.<\/p>\n<hr \/>\n<h2>12. Scheda &#8220;Note&#8221;<\/h2>\n<p>Riporta le indicazioni operative e i limiti dichiarati della procedura:<\/p>\n<ul>\n<li>sono gestiti i <strong>prezzi per variante<\/strong>: il prezzo particolare di una taglia o di un colore viene trasmesso al sito;<\/li>\n<li>nella struttura varianti la variante colore deve chiamarsi <strong>COLORE<\/strong> e quella taglia <strong>TAGLIA<\/strong>;<\/li>\n<li>nei dati scambiati, <code>NetPrice1<\/code> e <code>GrossPrice1<\/code> sono sempre i prezzi di vendita netto e lordo IVA; <code>NetPrice2<\/code> e <code>GrossPrice2<\/code>, se presenti, sono i prezzi <strong>non<\/strong> in promozione.<\/li>\n<\/ul>\n<hr \/>\n<h2>13. Sequenza di attivazione di un nuovo sito<\/h2>\n<ol>\n<li>crea il sito: codice, descrizione, <strong>URL<\/strong>, flag <em>Attivo<\/em>;<\/li>\n<li>compila la scheda <strong>FTP \/ SFTP<\/strong> e fai passare tutti i controlli di <strong>Test FTP sito<\/strong>;<\/li>\n<li>premi <strong>Genera<\/strong> per il token e <strong>salva<\/strong> il record;<\/li>\n<li>premi <strong>Carica server<\/strong> per installare il client sul sito;<\/li>\n<li>scegli la <strong>modalit\u00e0 prodotti<\/strong> e compila le schede <em>Prodotti<\/em> e <em>Clienti<\/em> di conseguenza;<\/li>\n<li>compila le tabelle di corrispondenza: <strong>IVA<\/strong>, <strong>pagamenti<\/strong>, <strong>stati ordine<\/strong>;<\/li>\n<li>imposta <em>Scarica ordini dal<\/em> per non importare tutto lo storico;<\/li>\n<li>salva, e prova le sincronizzazioni una alla volta da <strong>Gestione sito<\/strong>.<\/li>\n<\/ol>\n<hr \/>\n<h2>14. Promemoria<\/h2>\n<ul>\n<li><strong>Dopo aver rigenerato il token, cambiato gli attributi taglia\/colore o i limiti di memoria e tempo, ricarica il client<\/strong>: finch\u00e9 non lo fai, sul sito resta la configurazione precedente.<\/li>\n<li><strong>Carica server<\/strong> funziona solo con i dati <strong>salvati<\/strong>.<\/li>\n<li>Le tabelle di corrispondenza (IVA, pagamenti, stati, articoli esclusi) vengono memorizzate <strong>insieme al record<\/strong>: dopo aver premuto <em>Aggiungi<\/em> bisogna comunque <strong>salvare l&#8217;anagrafica<\/strong>, altrimenti le righe si perdono.<\/li>\n<li>Una <strong>corrispondenza mancante<\/strong> su IVA o pagamento fa fallire l&#8217;importazione del singolo ordine: sono le prime due cose da controllare quando &#8220;un ordine non \u00e8 entrato&#8221;.<\/li>\n<li>Se le sincronizzazioni non partono pi\u00f9, controlla il flag <strong>&#8220;Esecuzione sincronizzazione bloccata \/ in corso&#8221;<\/strong> nella scheda Principale.<\/li>\n<li>Le opzioni marcate <em>&#8220;attivare solo su nuove configurazioni&#8221;<\/em> (varianti generiche, varianti con codice variante) <strong>non vanno attivate su un sito gi\u00e0 in produzione<\/strong>.<\/li>\n<li>L&#8217;aggiornamento automatico dell&#8217;anagrafica cliente con i dati del sito sovrascrive quanto c&#8217;\u00e8 nel gestionale: valutalo prima di attivarlo.<\/li>\n<\/ul>\n<aside class=\"modulo-atlantis\"><p>Funzione inclusa in <a href=\"https:\/\/www.atlantisevo.com\/prodotti\/integrazione-woocommerce\/\">Modulo Integrazione WooCommerce<\/a> di Atlantis Evo.<\/p><\/aside>\n","protected":false},"author":1,"featured_media":0,"parent":4876,"menu_order":29,"template":"","manualdocumentationcategory":[55],"manual_doc_tag":[],"_links":{"self":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/4878"}],"collection":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation"}],"about":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/types\/manual_documentation"}],"author":[{"embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":8,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/4878\/revisions"}],"predecessor-version":[{"id":6495,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/4878\/revisions\/6495"}],"up":[{"embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/4876"}],"wp:attachment":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/media?parent=4878"}],"wp:term":[{"taxonomy":"manualdocumentationcategory","embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manualdocumentationcategory?post=4878"},{"taxonomy":"manual_doc_tag","embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_doc_tag?post=4878"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}