{"id":1500,"date":"2016-04-22T14:57:28","date_gmt":"2016-04-22T13:57:28","guid":{"rendered":"http:\/\/doc.atlantisevo.com\/?post_type=manual_documentation&p=1500"},"modified":"2026-10-01T18:00:57","modified_gmt":"2026-10-01T17:00:57","slug":"prestashop","status":"publish","type":"manual_documentation","link":"https:\/\/www.atlantisevo.com\/doc\/manuale\/e-commerce\/prestashop\/","title":{"rendered":"Prestashop"},"content":{"rendered":"
<\/div>

Integrazione con Prestashop<\/h1>\n

Atlantis Evo pu\u00f2 collegarsi a un sito Prestashop<\/strong> per leggere<\/strong> quello che il sito produce – prodotti, clienti, ordini – e per rimandare al sito le giacenze<\/strong> del gestionale.<\/p>\n

\u00c8 un collegamento a senso unico per l’anagrafica<\/strong>: il catalogo si costruisce sul sito, e Atlantis lo recepisce. Il gestionale non pubblica prodotti, non crea categorie, non modifica prezzi sul sito. Nell’altra direzione viaggia solo un dato: la quantit\u00e0<\/strong>.<\/p>\n

Il dialogo avviene via HTTP\/HTTPS, Atlantis gli manda dei comandi e riceve dei dati in formato JSON. Perch\u00e9 funzioni servono quindi tre cose: il gateway installato e raggiungibile, l’indirizzo e la chiave impostati nei codici fissi, e la gestione attivata.<\/p>\n

Si configura in Archivi \u2192 Impostazioni \u2192 Codici Fissi \u2192 Codici Fissi<\/strong>, scheda Prestashop<\/em>. Si usa da e-Commerce Terzi \u2192 Prestashop<\/strong>, che contiene due sole voci: Sincronizza con sito<\/em> e Controllo giacenze<\/em>.<\/p>\n

Questa integrazione \u00e8 cosa diversa dal modulo e-commerce WooCommerce<\/strong>, che ha una propria anagrafica siti, una propria finestra di gestione e una logica opposta (l\u00e0 \u00e8 il gestionale a pubblicare il catalogo). I due non condividono nessuna impostazione.<\/p><\/blockquote>\n

\n

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

Ci sono due meccanismi distinti<\/strong>, che vanno tenuti separati in testa perch\u00e9 si configurano in punti diversi e si guastano in modi diversi.<\/p>\n

a) La sincronizzazione a comando.<\/strong> La lanci tu da Sincronizza con sito<\/em>. Chiede al sito articoli, clienti e ordini e li scrive in Atlantis. Non \u00e8 pianificabile: non esiste una sincronizzazione automatica notturna<\/strong> per Prestashop, va lanciata a mano.<\/p>\n

b) L’aggiornamento giacenze in tempo reale (il “trigger”).<\/strong> Ogni volta che in Atlantis si salva un movimento di magazzino che soddisfa certe condizioni, il programma manda subito al sito la differenza<\/strong> di quantit\u00e0. Non \u00e8 una funzione da lanciare: o \u00e8 configurata e scatta sempre, o non scatta mai. \u00c8 il motivo per cui il riquadro delle opzioni nella finestra di sincronizzazione si intitola Opzioni sincronizzazioni (no trigger)<\/em>: quei parametri riguardano solo il punto (a).<\/p>\n

Il Controllo giacenze<\/em> \u00e8 la rete di sicurezza che serve a scoprire quando (a) e (b) hanno lasciato le due giacenze disallineate.<\/p>\n

Come si riconoscono gli articoli<\/h3>\n

L’aggancio fra i due sistemi \u00e8 il riferimento<\/strong> (reference<\/em>) del prodotto Prestashop, che diventa il codice articolo<\/strong> in Atlantis, convertito in maiuscolo.<\/p>\n

    \n
  • il codice articolo di Atlantis \u00e8 lungo al massimo 20 caratteri<\/strong>: un prodotto con riferimento pi\u00f9 lungo non viene importato<\/strong> e finisce nel log come “Codice articolo troppo lungo. Articolo non sincronizzabile.”<\/em>;<\/li>\n
  • per le combinazioni<\/strong> (varianti Prestashop) Atlantis compone il codice come RIFERIMENTO~XX<\/code>, dove XX<\/code> \u00e8 l’id della combinazione scritto in esadecimale maiuscolo<\/strong>. Esempio: riferimento TS100<\/code>, combinazione 26 \u2192 codice articolo TS100~1A<\/code>;<\/li>\n
  • l’id numerico del prodotto sul sito viene conservato nel campo Sku<\/strong> dell’anagrafica articoli (riquadro e-Commerce<\/em>), che \u00e8 di sola lettura.<\/li>\n<\/ul>\n

     <\/p>\n

    \n

    2. Attivazione e parametri di collegamento<\/h2>\n

    Tutto sta nella scheda Prestashop<\/strong> dei codici fissi. Finch\u00e9 Attiva gestione<\/strong> non \u00e8 acceso, la sincronizzazione risponde “Gestione Prestashop non attivata!”<\/em> e non fa nulla.<\/p>\n

    Riquadro “Sincronizzazione HTTP”<\/h3>\n\n\n\n\n\n\n\n\n
    Campo<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
    Url<\/strong><\/td>\nindirizzo completo dello script gateway sul sito. Fino a 255 caratteri<\/td>\n<\/tr>\n
    Key<\/strong><\/td>\nchiave di cifratura, esattamente 16 caratteri<\/strong> fra numeri e lettere. Deve coincidere con quella configurata sul gateway<\/td>\n<\/tr>\n
    GG da considerare (0 = tutto)<\/strong><\/td>\nnumero di giorni proposto come predefinito nella finestra di sincronizzazione<\/td>\n<\/tr>\n
    Disattiva criptazione chiamte HTTP<\/strong><\/td>\nse acceso, le chiamate viaggiano in chiaro<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Il flag di disattivazione della criptazione \u00e8 attivo per impostazione predefinita<\/strong>: su un’installazione dove non \u00e8 mai stato toccato, le chiamate viaggiano in chiaro. Se il gateway \u00e8 configurato per accettare solo chiamate cifrate, va spento esplicitamente. Se lo spegni, la Key<\/strong> diventa obbligatoria.<\/p><\/blockquote>\n

    Identificazione del sito<\/h3>\n\n\n\n\n\n\n
    Campo<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
    Id Sito<\/strong><\/td>\nnumero dello shop, per le installazioni Prestashop multishop<\/strong>. Viene passato a ogni chiamata<\/td>\n<\/tr>\n
    Prefisso tabelle<\/strong><\/td>\nprefisso delle tabelle Prestashop (es. ps_<\/code>). Oggi non ha effetto<\/strong>: viene letto e conservato ma non entra in nessuna chiamata<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Dove finiscono gli ordini<\/h3>\n\n\n\n\n\n\n\n
    Campo<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
    Sincronizza su<\/strong><\/td>\nVendite a banco (Pos)<\/em> oppure Ordini<\/em>. \u00c8 la scelta strutturale dell’integrazione<\/td>\n<\/tr>\n
    Causale doc. vendita sito (POS)<\/strong><\/td>\ncausale usata quando si sincronizza sulle vendite al banco<\/td>\n<\/tr>\n
    Causale doc. vendita sito (Ord)<\/strong><\/td>\ncausale usata quando si sincronizza sugli impegni cliente<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    La causale scelta non porta solo il tipo di documento<\/strong>: da lei Atlantis ricava la serie, la causale di trasporto, la causale di magazzino, i depositi 1 e 2 e il flag di scarico magazzino, e soprattutto il cliente collegato alla causale<\/strong>, che fa da modello per tutti i clienti creati dal sito (vedi \u00a7 6).<\/p>\n

    \u26a0\ufe0f Se la causale indicata non ha un cliente collegato, la sincronizzazione si ferma subito con “Errore durante il caricamento dei dati del cliente associato al tipo documento. Operazione non eseguibile.”<\/em> \u00c8 il primo errore da cercare quando “non funziona niente”.<\/p><\/blockquote>\n

    Come nascono i nuovi articoli<\/h3>\n

    Questi valori si applicano solo alla creazione<\/strong> di un articolo nuovo: su un articolo gi\u00e0 presente non vengono pi\u00f9 toccati.<\/p>\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
    Listino<\/strong><\/td>\nlistino di vendita su cui scrivere il prezzo letto dal sito (fino a 14 caratteri)<\/td>\n<\/tr>\n
    Cod. Iva<\/strong><\/td>\ncodice IVA predefinito, usato quando il regime fiscale del prodotto non \u00e8 mappato<\/td>\n<\/tr>\n
    Tabella cod. Iva<\/strong><\/td>\ncorrispondenza fra i regimi fiscali di Prestashop e i codici IVA di Atlantis<\/td>\n<\/tr>\n
    Cod. Monofase<\/strong><\/td>\ncodice monofase predefinito<\/td>\n<\/tr>\n
    Cod. Contropartita<\/strong><\/td>\ncontropartita di vendita<\/td>\n<\/tr>\n
    U.M. Base<\/strong><\/td>\nunit\u00e0 di misura dei nuovi articoli<\/td>\n<\/tr>\n
    Fuori giacenza<\/strong> \/ Fuori disponibilit\u00e0<\/strong><\/td>\ncomportamento nei documenti: Non gestito<\/em>, Avvisa<\/em>, Blocca<\/em><\/td>\n<\/tr>\n
    Non sincronizzare i gruppi merceologici articoli<\/strong><\/td>\nse acceso, Atlantis non ricostruisce l’albero delle categorie<\/td>\n<\/tr>\n
    Associa a gruppo<\/strong><\/td>\ngruppo merceologico da assegnare ai nuovi articoli quando il flag qui sopra \u00e8 acceso<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Ordini e importi<\/h3>\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
    Cod. spesa trasporto<\/strong><\/td>\ncodice spesa su cui riportare le spese di spedizione dell’ordine. Se \u00e8 vuoto, le spese di spedizione non vengono importate<\/strong><\/td>\n<\/tr>\n
    Cod. Art. x Cancell.<\/strong><\/td>\narticolo di comodo da usare al posto di un articolo che sull’ordine non esiste pi\u00f9 in anagrafica<\/td>\n<\/tr>\n
    Deposito sito<\/strong><\/td>\ndeposito del gestionale che rappresenta il magazzino del sito<\/td>\n<\/tr>\n
    Elenco ‘id’ stato ordine annullato<\/strong><\/td>\nid degli stati Prestashop che devono cancellare<\/strong> il documento in Atlantis<\/td>\n<\/tr>\n
    Tabella id gruppo\/cat. cli<\/strong><\/td>\ncorrispondenza gruppi cliente Prestashop \u2192 categorie cliente Atlantis<\/td>\n<\/tr>\n
    Tabella corrispon. pagamenti<\/strong><\/td>\ncorrispondenza pagamenti Prestashop \u2192 pagamenti Atlantis<\/td>\n<\/tr>\n
    Scarica ordini con valori IVA inclusa<\/strong><\/td>\nse acceso, dagli ordini vengono presi gli importi IVA compresa<\/strong> e il documento nasce con lo scorporo IVA attivo<\/td>\n<\/tr>\n
    Scarica anche le immagini<\/strong><\/td>\nproposta predefinita della casella Sincronizza immagini<\/em><\/td>\n<\/tr>\n
    Integrit\u00e0 su aggiornamenti sito<\/strong><\/td>\nriguarda solo il trigger: vedi \u00a7 8<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Il Deposito sito<\/strong> ha due usi diversi e va impostato con cura: \u00e8 il deposito usato come ripiego sui documenti importati quando la causale non ne indica uno, ed \u00e8 il deposito che abilita l’aggiornamento in tempo reale<\/strong> delle giacenze.<\/p>\n

    \n

    3. Le tabelle di corrispondenza<\/h2>\n

    Quattro campi della scheda sono elenchi codificati, scomodi da scrivere a mano. Accanto a ciascuno c’\u00e8 un pulsante con la matita<\/strong> che apre una finestrella dedicata: legge dal sito i valori disponibili, li presenta in una tendina, e costruisce l’elenco al posto tuo. Ogni riga si aggiunge con Aggiungi<\/strong> e si toglie con il collegamento Canc.<\/em> della griglia.<\/p>\n\n\n\n\n\n\n\n\n
    Pulsante<\/th>\nFinestra<\/th>\nCosa collega<\/th>\n<\/tr>\n<\/thead>\n
    accanto a Tabella cod. Iva<\/em><\/td>\nTabella corrispondeza Tassazione – Codici IVA<\/em><\/td>\nregime fiscale Prestashop \u2192 codice IVA Atlantis<\/td>\n<\/tr>\n
    accanto a Elenco ‘id’ stato ordine annullato<\/em><\/td>\nStati ordine Prestashop<\/em><\/td>\ngli stati che annullano l’ordine<\/td>\n<\/tr>\n
    accanto a Tabella id gruppo\/cat. cli<\/em><\/td>\nTabella corrispondeza categorie clienti<\/em><\/td>\ngruppo cliente Prestashop \u2192 categoria cliente Atlantis<\/td>\n<\/tr>\n
    accanto a Tabella corrispon. pagamenti<\/em><\/td>\nTabella corrispondeza pagamenti<\/em><\/td>\npagamento Prestashop \u2192 pagamento Atlantis<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Queste finestre interrogano il sito nel momento in cui si aprono<\/strong>: se il collegamento non \u00e8 ancora configurato, o il gateway non risponde, compare “Errore su lettura dati remoti”<\/em> oppure “Errore: 404”<\/em> e la tendina resta vuota. Vanno quindi compilate dopo<\/strong> aver impostato Url e Key.<\/p>\n

    Se manca la corrispondenza, il programma non si ferma:<\/p>\n

      \n
    • pagamento non mappato<\/strong> \u2192 sul documento viene messo il pagamento dell’anagrafica cliente<\/strong>;<\/li>\n
    • regime fiscale non mappato<\/strong> \u2192 sui nuovi articoli viene usato il Cod. Iva<\/strong> predefinito.<\/li>\n<\/ul>\n

      I formati, se te li trovi gi\u00e0 scritti, sono questi: codici IVA e categorie clienti separati da virgola<\/strong> a coppie (1,22,2,04<\/code> \u00b7 1,CAT1,2,CAT2<\/code>), pagamenti separati da barra verticale<\/strong> (bankwire|BB|cheque|RB<\/code>), stati annullati come semplice elenco di numeri (6,7<\/code>).<\/p>\n

      \n

      4. Sincronizza con sito<\/h2>\n

      e-Commerce Terzi \u2192 Prestashop \u2192 Sincronizza con sito<\/strong> apre una finestra piccola: “Eseguire la sincronizzazione con sito?”<\/em>, un riquadro Opzioni<\/strong> e un riquadro Opzioni sincronizzazioni (no trigger)<\/strong>.<\/p>\n\n\n\n\n\n\n\n\n\n\n
      Opzione<\/th>\nProposta all’apertura<\/th>\n<\/tr>\n<\/thead>\n
      Articoli<\/strong><\/td>\nattiva<\/td>\n<\/tr>\n
      Sincronizza immagini<\/strong><\/td>\ncome impostato in Scarica anche le immagini<\/em><\/td>\n<\/tr>\n
      Clienti<\/strong><\/td>\nattiva<\/td>\n<\/tr>\n
      Ordini<\/strong><\/td>\nattiva<\/td>\n<\/tr>\n
      Non elaborare ordini a zero<\/strong><\/td>\nspenta<\/td>\n<\/tr>\n
      Giorni da sincronizzare (0 = tutto)<\/strong><\/td>\ncome impostato in GG da considerare<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      Il campo giorni<\/strong> limita l’elaborazione a quello che sul sito \u00e8 stato modificato negli ultimi n<\/em> giorni, e vale per tutte e tre le sezioni. 0 significa tutto<\/strong>: al primo allineamento \u00e8 quello che serve, nell’uso quotidiano \u00e8 un’elaborazione inutilmente lunga.<\/p>\n

      Non elaborare ordini a zero<\/strong> fa saltare la scrittura dei documenti il cui totale risulta zero. L’ordine viene comunque letto e calcolato, semplicemente non viene salvato.<\/p>\n

      Se Sincronizza immagini<\/em> \u00e8 acceso ma il modulo document-management non \u00e8 installato<\/strong>, la casella non compare nemmeno; se il modulo c’\u00e8 ma non \u00e8 configurato, compare “Attenzione! Sincronizzazione immagini non possibile, verificare configurazione.”<\/em><\/p>\n

      Premendo Conferma<\/strong> i pulsanti e le caselle si disabilitano e l’elaborazione parte in secondo piano, con le barre di avanzamento Syncro tabelle di appoggio<\/em>, Syncro Articoli<\/em>, Syncro Clienti<\/em>, Syncro Ordini<\/em>. La finestra resta aperta fino al termine.<\/p>\n

      L’ordine delle operazioni, e perch\u00e9 conta<\/h3>\n

      L’elaborazione procede sempre nella stessa sequenza:<\/p>\n

        \n
      1. tabelle di appoggio<\/strong> – categorie (\u2192 gruppi merceologici), nazioni, marche;<\/li>\n
      2. articoli<\/strong>;<\/li>\n
      3. clienti<\/strong>;<\/li>\n
      4. ordini<\/strong>.<\/li>\n<\/ol>\n

        \u26a0\ufe0f Al primo errore tutto quello che segue non viene pi\u00f9 elaborato.<\/strong> Se un articolo va in errore, clienti e ordini non vengono nemmeno richiesti al sito; se un ordine va in errore, tutti gli ordini successivi vengono saltati in silenzio<\/strong>. Il messaggio finale \u00e8 un generico “Errore durante la sincronizzazione.”<\/em>, e i conteggi mostrati si fermano a prima dell’errore. Quando compare quel messaggio, la sincronizzazione non \u00e8 completa<\/strong>: va letto il log, risolto il problema e rilanciata.<\/p><\/blockquote>\n

        Ogni articolo, ogni cliente e ogni ordine vengono per\u00f2 salvati in una transazione propria<\/strong>. Quindi ci\u00f2 che \u00e8 stato importato prima dell’errore resta<\/strong> in archivio: rilanciare la sincronizzazione dopo la correzione \u00e8 l’operazione giusta, non c’\u00e8 niente da ripulire a mano.<\/p>\n

        Il risultato<\/h3>\n

        A elaborazione riuscita compare il riepilogo:<\/p>\n

        Sincronizzazione terminata correttamente.<\/em>
        \nSincronizzati:<\/em>
        \nN. Articoli: \u2026 N. Clienti: \u2026 N. Ordini: \u2026<\/em><\/p><\/blockquote>\n

        Se durante l’elaborazione si \u00e8 accumulata qualche segnalazione si apre inoltre la finestra Errori di sincronizzazione<\/strong>. Le righe che ci si trovano pi\u00f9 spesso:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n
        Messaggio<\/th>\nSignificato<\/th>\n<\/tr>\n<\/thead>\n
        Codice articolo troppo lungo. Articolo non sincronizzabile.<\/em><\/td>\nil riferimento del prodotto supera i 20 caratteri<\/td>\n<\/tr>\n
        Sono presenti N articoli con la referenza: \u2026<\/em><\/td>\nreferenze duplicate sul sito<\/td>\n<\/tr>\n
        Articolo ‘\u2026’ non trovato!<\/em><\/td>\nuna riga d’ordine cita un codice che in Atlantis non esiste<\/td>\n<\/tr>\n
        Articolo senza codice: \u2026<\/em><\/td>\nla riga d’ordine non porta nessun riferimento, solo il nome del prodotto<\/td>\n<\/tr>\n
        Errore durante il parsing della data ordine. Ordine n.: \u2026<\/em><\/td>\nl’ordine sul sito ha una data non interpretabile<\/td>\n<\/tr>\n
        Errore durante il caricamento del cliente ‘\u2026’ !<\/em><\/td>\nil cliente dell’ordine non \u00e8 stato creato<\/td>\n<\/tr>\n
        Ordine ‘\u2026’ non salvato!<\/em><\/td>\nil documento \u00e8 stato costruito ma il salvataggio \u00e8 fallito<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
        \n

        5. Come arrivano gli articoli<\/h2>\n

        Per ogni prodotto restituito dal sito, Atlantis crea o aggiorna l’articolo. Su un articolo gi\u00e0 esistente aggiorna solo quattro cose<\/strong>: descrizione, Sku, marca e gruppo merceologico. Tutto il resto – IVA, unit\u00e0 di misura, contropartita, controlli di giacenza – viene scritto solo alla creazione<\/strong>, quindi correzioni fatte a mano in anagrafica non vengono sovrascritte.<\/p>\n

        \u26a0\ufe0f La marca non viene mai valorizzata sui nuovi articoli.<\/strong> Sugli articoli gi\u00e0 esistenti viene aggiornata con quella del sito, ma su quelli creati dalla sincronizzazione resta vuota: va assegnata a mano, o in blocco dal pannello di selezione articoli.<\/p><\/blockquote>\n

        Oltre all’articolo vengono aggiornati:<\/p>\n

          \n
        • il prezzo<\/strong> sul listino indicato nei codici fissi. La riga viene creata se manca, altrimenti ne viene aggiornato il solo prezzo (quantit\u00e0 minima 0,1, massima 99.999.999, senza sconti). Se il listino \u00e8 impostato lordo IVA<\/strong> viene preso il prezzo IVA compresa del sito, altrimenti il prezzo netto;<\/li>\n
        • il codice a barre<\/strong> letto dal campo EAN del prodotto, registrato come barcode di tipo web. Se sul sito l’EAN viene svuotato, il barcode viene eliminato<\/strong> dall’articolo;<\/li>\n
        • il gruppo merceologico<\/strong>, quando la ricostruzione delle categorie \u00e8 attiva.<\/li>\n<\/ul>\n

          Le categorie<\/h3>\n

          Se Non sincronizzare i gruppi merceologici articoli<\/em> \u00e8 spento, prima degli articoli Atlantis ricostruisce l’albero delle categorie del sito dentro i gruppi merceologici<\/strong>: ogni livello \u00e8 l’id della categoria Prestashop portato a 4 cifre<\/strong> con gli zeri davanti, i livelli si concatenano con il punto, e si scende fino a 6 livelli<\/strong> (oltre il sesto le categorie vengono ignorate). Una categoria con figli diventa un nodo, una senza figli una foglia.<\/p>\n

          All’articolo viene assegnata la prima<\/strong> categoria del prodotto che corrisponde a una foglia<\/strong> gi\u00e0 presente in archivio. Se il prodotto sta solo in categorie-nodo, l’articolo resta senza gruppo.<\/p>\n

          Se invece il flag \u00e8 acceso, i gruppi non vengono toccati e i nuovi articoli prendono tutti il gruppo indicato in Associa a gruppo<\/em>.<\/p>\n

          Le immagini<\/h3>\n

          Con Sincronizza immagini<\/em> attivo, l’immagine principale del prodotto viene scaricata e allegata all’articolo nella categoria documenti impostata come immagine principale<\/strong> nei codici fissi. Se un allegato di quella categoria \u00e8 gi\u00e0 collegato all’articolo, il file viene scaricato solo se manca fisicamente<\/strong>: le immagini gi\u00e0 presenti non vengono riscaricate a ogni sincronizzazione.<\/p>\n

          Marche e nazioni<\/h3>\n

          Prima degli articoli vengono allineate anche due tabelle:<\/p>\n

            \n
          • le marche<\/strong>, con codice uguale all’id del produttore Prestashop e descrizione uguale al nome;<\/li>\n
          • le nazioni<\/strong>, con codice e ISO uguali al codice ISO del sito. Alla nazione SM<\/code> viene acceso il flag San Marino.<\/li>\n<\/ul>\n

            \u26a0\ufe0f Queste due tabelle vengono sovrascritte<\/strong> con i dati del sito a ogni sincronizzazione: descrizioni corrette a mano in Atlantis tornano quelle di Prestashop.<\/p><\/blockquote>\n

            \n

            6. Come arrivano i clienti<\/h2>\n

            Il codice cliente in Atlantis \u00e8 l’id Prestashop portato a 6 cifre con gli zeri davanti, seguito dalla lettera V<\/strong>: il cliente 123 del sito diventa 000123V<\/code>. \u00c8 una regola fissa e non configurabile: significa che i clienti del sito vivono in un blocco riservato dell’anagrafica e non vanno mai rinumerati<\/strong>.<\/p>\n

            Del soggetto vengono aggiornati ragione sociale (cognome + nome, in maiuscolo), indirizzo, CAP, citt\u00e0, provincia, nazione, telefono, cellulare, e-mail, partita IVA e note, presi dal primo indirizzo<\/strong> del cliente sul sito. Alcuni campi hanno una regola propria:<\/p>\n

              \n
            • il CAP<\/strong> viene portato a 5 cifre con gli zeri davanti solo se la nazione dell’azienda \u00e8 IT<\/code>;<\/li>\n
            • il codice fiscale<\/strong> arriva dal campo dni<\/em> del sito, ma se sul sito \u00e8 vuoto e in Atlantis c’\u00e8 gi\u00e0 un valore, quello esistente viene mantenuto<\/strong>;<\/li>\n
            • il codice destinatario SDI<\/strong> viene impostato solo alla creazione<\/strong> del cliente e solo per le aziende italiane: 0000000<\/code> per i clienti italiani, XXXXXXX<\/code> per gli esteri. Per gli esteri, inoltre, il codice fiscale letto dal sito viene spostato in partita IVA e il campo codice fiscale viene svuotato.<\/li>\n<\/ul>\n

              Il cliente modello<\/h3>\n

              I dati commerciali – listino, sconti, pagamento, agenti, contropartita, esenzione IVA, banca – non arrivano dal sito<\/strong>. Vengono copiati dal cliente collegato alla causale documento<\/strong> indicata nei codici fissi. Quel cliente \u00e8, di fatto, il modello di tutti i clienti web: si configura una volta, con le condizioni che si vogliono applicare agli ordini del sito, e non lo si usa per fatturare.<\/p>\n

              Sopra al modello viene poi applicata la categoria cliente<\/strong> ricavata dai gruppi Prestashop tramite la tabella di corrispondenza. Se il cliente appartiene a pi\u00f9 gruppi mappati, vince l’ultimo<\/strong> che il programma incontra.<\/p>\n

              Le destinazioni<\/h3>\n

              Ogni indirizzo del cliente sul sito diventa una destinazione diversa<\/strong> dell’anagrafica clienti, numerata con l’id dell’indirizzo Prestashop. Il primo indirizzo finisce quindi sia<\/strong> nei dati del soggetto sia<\/strong> fra le destinazioni: \u00e8 normale, non \u00e8 un doppione da cancellare.<\/p>\n

              \n

              7. Come arrivano gli ordini<\/h2>\n

              Ogni ordine Prestashop diventa un documento in Atlantis – vendita al banco<\/strong> o impegno cliente<\/strong> secondo l’impostazione Sincronizza su<\/em> – con:<\/p>\n

                \n
              • numero documento<\/strong> = id dell’ordine Prestashop portato a 7 cifre con gli zeri davanti;<\/li>\n
              • serie<\/strong> presa dalla causale;<\/li>\n
              • esercizio<\/strong> determinato dalla data dell’ordine;<\/li>\n
              • data documento<\/strong> = data dell’ordine.<\/li>\n<\/ul>\n

                Poich\u00e9 la chiave \u00e8 il numero d’ordine del sito, una sincronizzazione ripetuta aggiorna<\/strong> il documento gi\u00e0 presente invece di duplicarlo.<\/p>\n

                In coda al corpo viene sempre aggiunta una riga descrittiva<\/strong> “Rif. Ordine “<\/em>, che riporta il codice alfanumerico dell’ordine Prestashop: \u00e8 il modo per ritrovare l’ordine sul sito partendo dal documento.<\/p>\n

                Cosa viene calcolato e cosa no<\/h3>\n

                Il documento viene ricalcolato da Atlantis come se fosse stato scritto a mano: imponibili per aliquota, IVA, totali, e le scadenze<\/strong> in base al pagamento e alle regole del cliente (mesi esclusi e giorni di scadenza compresi).<\/p>\n

                  \n
                • il prezzo<\/strong> di riga \u00e8 quello unitario dell’ordine, senza sconti di riga<\/strong>: eventuali sconti di Prestashop sono gi\u00e0 dentro il prezzo;<\/li>\n
                • lo sconto coupon<\/strong> dell’ordine viene riportato come sconto in valore<\/strong> nel piede del documento;<\/li>\n
                • le spese di spedizione<\/strong> diventano una riga spese, con conto e codice IVA presi dall’anagrafica spese;<\/li>\n
                • il corriere<\/strong>, se presente, viene scritto nelle note interne<\/strong> come “trasporto: \u2026”<\/em>;<\/li>\n
                • il codice IVA<\/strong> di riga \u00e8 quello dell’articolo, salvo che il cliente abbia un’esenzione, che prevale su tutto;<\/li>\n
                • se l’ordine porta un indirizzo di spedizione diverso<\/strong> da quello di fatturazione, i dati vengono scritti nella destinazione del documento; altrimenti il riquadro resta vuoto.<\/li>\n<\/ul>\n

                  Con Scarica ordini con valori IVA inclusa<\/em> acceso, prezzi, spese e sconto vengono presi IVA compresa e il documento nasce con lo scorporo IVA<\/strong> attivo.<\/p>\n

                  Gli ordini che non vengono toccati<\/h3>\n

                  Alcuni ordini vengono saltati senza nessun messaggio<\/strong>. Non \u00e8 un errore, \u00e8 una protezione:<\/p>\n

                    \n
                  • l’ordine corrispondente in Atlantis \u00e8 gi\u00e0 stato fatturato<\/strong>;<\/li>\n
                  • l’ordine corrispondente \u00e8 gi\u00e0 stato evaso<\/strong>, anche solo in parte.<\/li>\n<\/ul>\n

                    In entrambi i casi il documento resta com’\u00e8: le modifiche fatte nel frattempo sul sito non arrivano pi\u00f9. \u00c8 il comportamento voluto – un impegno gi\u00e0 evaso non deve cambiare sotto ai piedi di chi ci sta lavorando – ma va saputo, perch\u00e9 dall’esterno sembra che la sincronizzazione “non veda” quell’ordine.<\/p>\n

                    Gli ordini annullati<\/h3>\n

                    Se lo stato dell’ordine \u00e8 fra quelli elencati in Elenco ‘id’ stato ordine annullato<\/em>, il documento viene cancellato<\/strong> da Atlantis. La cancellazione viene tentata sull’esercizio della data ordine e sull’esercizio precedente<\/strong>, per intercettare gli ordini di fine anno.<\/p>\n

                    Gli articoli mancanti<\/h3>\n

                    Se una riga d’ordine cita un codice che in anagrafica non esiste:<\/p>\n

                      \n
                    • se \u00e8 impostato Cod. Art. x Cancell.<\/strong>, la riga viene ribattuta su quell’articolo, con la descrizione integrata da ” – ex. art. “<\/em>;<\/li>\n
                    • altrimenti l’intero ordine non viene salvato<\/strong>, il log riporta “Articolo ‘\u2026’ non trovato!”<\/em> e – come detto al \u00a7 4 – tutti gli ordini successivi vengono saltati<\/strong>.<\/li>\n<\/ul>\n

                      \u00c8 il singolo motivo pi\u00f9 frequente di sincronizzazione incompleta. Le due cause tipiche sono un prodotto aggiunto sul sito dopo l’ultima sincronizzazione articoli, e una combinazione<\/strong> il cui codice RIFERIMENTO~XX<\/code> non esiste in Atlantis.<\/p>\n

                      \n

                      8. Le giacenze verso il sito<\/h2>\n

                      L’unico dato che Atlantis scrive sul sito \u00e8 la quantit\u00e0, e lo fa in tempo reale<\/strong>, movimento per movimento. Perch\u00e9 scatti devono valere tutte<\/strong> queste condizioni:<\/p>\n

                        \n
                      1. Attiva gestione<\/strong> acceso nei codici fissi;<\/li>\n
                      2. il movimento riguarda il deposito<\/strong> indicato in Deposito sito<\/em>;<\/li>\n
                      3. la causale di magazzino<\/strong> del movimento ha il flag Aggiorna saldi e-Commerce<\/em> acceso (Archivi \u2192 Tabelle \u2192 Magazzino \u2192 Causali di magazzino<\/strong>);<\/li>\n
                      4. l’articolo ha il flag Sincronizza con sito<\/strong> acceso e il campo Sku<\/strong> valorizzato;<\/li>\n
                      5. l’articolo non \u00e8 escluso dalla gestione giacenze.<\/li>\n<\/ol>\n

                        Al sito viene mandata la variazione<\/strong> di quantit\u00e0, non il valore assoluto. Il flag Sincronizza con sito<\/em> si pu\u00f2 impostare in blocco su pi\u00f9 articoli con Imposta valori\u2026<\/em> del pannello di selezione articoli<\/strong>.<\/p>\n

                        \u26a0\ufe0f Il campo Sku<\/strong> viene compilato solo dalla sincronizzazione articoli<\/strong> ed \u00e8 di sola lettura. Un articolo creato a mano in Atlantis, per quanto abbia il flag acceso, non aggiorner\u00e0 mai la giacenza del sito<\/strong>. \u00c8 la causa tipica di un articolo che “sul sito resta sempre alla stessa quantit\u00e0”.<\/p><\/blockquote>\n

                        \u26a0\ufe0f L’aggiornamento non scatta<\/strong> durante i ricalcoli da inventario. Dopo un inventario le due giacenze sono quasi certamente disallineate: si riallineano con il Controllo giacenze<\/em>.<\/p><\/blockquote>\n

                        Integrit\u00e0 su aggiornamenti sito<\/h3>\n

                        Il flag Integrit\u00e0 su aggiornamenti sito<\/strong> decide cosa fare quando il sito non risponde:<\/p>\n

                          \n
                        • spento<\/strong> (predefinito): il movimento in Atlantis viene salvato lo stesso e il sito resta indietro, in silenzio;<\/li>\n
                        • acceso<\/strong>: l’impossibilit\u00e0 di aggiornare il sito fa fallire l’operazione sul gestionale<\/strong>.<\/li>\n<\/ul>\n

                          Acceso \u00e8 pi\u00f9 rigoroso ma lega la fatturazione alla raggiungibilit\u00e0 del sito: se il sito \u00e8 gi\u00f9, in Atlantis non si salvano pi\u00f9 documenti che movimentano quel deposito. Vale la pena accenderlo solo dove il disallineamento costa pi\u00f9 del fermo.<\/p>\n

                          \n

                          9. Controllo giacenze<\/h2>\n

                          e-Commerce Terzi \u2192 Prestashop \u2192 Controllo giacenze<\/strong> mette a confronto, articolo per articolo, la giacenza del gestionale e quella del sito.<\/p>\n\n\n\n\n\n\n\n\n\n\n
                          Filtro<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
                          Origine controllo<\/strong><\/td>\nGiacenze attuali<\/em> oppure Inventario di magazzino<\/em><\/td>\n<\/tr>\n
                          Inventario<\/strong><\/td>\nl’inventario da usare come origine. Obbligatorio con la seconda scelta, altrimenti compare “Seleziona un inventario.”<\/em><\/td>\n<\/tr>\n
                          Gruppo Merc.<\/strong><\/td>\nlimita l’elaborazione a un ramo dei gruppi merceologici<\/td>\n<\/tr>\n
                          Verifica \/ elabora su<\/strong><\/td>\nEsistenza<\/em> oppure Disponibilit\u00e0<\/em> – quale delle due colonne confrontare e riportare sul sito<\/td>\n<\/tr>\n
                          Mostra solo differenze<\/strong><\/td>\nnasconde le righe allineate<\/td>\n<\/tr>\n
                          Mostra solo articoli sincronizzati con sito<\/strong><\/td>\nnasconde gli articoli che non hanno il flag di sincronizzazione<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                          Il pulsante Elabora<\/strong> legge le giacenze del gestionale (per il Deposito sito<\/em>) e le confronta con quelle chieste al sito. L’elenco ha sei colonne: Articolo<\/em>, Descrizione<\/em>, Sync<\/em>, Giac. Gest.<\/em>, Disp. Gest.<\/em>, Giac. Sito<\/em>.<\/p>\n

                          La colonna Sync<\/strong> riporta il flag Sincronizza con sito<\/em> dell’articolo. Le righe con Sync = N e giacenza gestionale a zero<\/strong> sono prodotti che esistono solo sul sito<\/strong>: Atlantis li aggiunge in coda all’elenco proprio per farli vedere. Sono la spia di prodotti creati sul sito e mai sincronizzati, oppure di combinazioni non presenti in anagrafica.<\/p>\n

                          Le righe vengono selezionate tutte dopo ogni elaborazione. I tre pulsanti della barra lavorano sulle righe selezionate<\/strong>:<\/p>\n\n\n\n\n\n\n\n
                          Pulsante<\/th>\nDirezione<\/th>\nCosa fa<\/th>\n<\/tr>\n<\/thead>\n
                          Rettifica giac. sito<\/strong><\/td>\ngestionale \u2192 sito<\/td>\nscrive sul sito la quantit\u00e0 del gestionale (esistenza o disponibilit\u00e0, secondo Verifica \/ elabora su<\/em>)<\/td>\n<\/tr>\n
                          Genera Rettifiche<\/strong><\/td>\nsito \u2192 gestionale<\/td>\ngenera due documenti di magazzino<\/strong>, uno di carico e uno di scarico, per portare il gestionale alla giacenza del sito<\/td>\n<\/tr>\n
                          Esporta<\/strong><\/td>\n–<\/td>\nesporta l’elenco su file<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                          Rettifica giac. sito<\/strong> manda un valore assoluto<\/strong>, non una differenza, e procede con una pausa ogni 50 articoli per non sovraccaricare il sito: su cataloghi grandi \u00e8 lenta di suo. Gli articoli che non riesce ad aggiornare finiscono in un log a fine elaborazione. Al termine l’elenco viene rielaborato da capo, cos\u00ec si vede subito cosa \u00e8 rimasto disallineato.<\/p>\n

                          Genera Rettifiche<\/strong> apre la finestra Sincronizzazione Giacenze e-Commerce<\/em>, che chiede conferma e mostra le due causali di rettifica e il deposito.<\/p>\n

                          \u26a0\ufe0f Quella finestra propone le causali e il deposito configurati per VirtueMart<\/strong>, non quelli della scheda Prestashop: se non hai mai usato VirtueMart li troverai vuoti. Vanno indicati a mano prima di confermare – i campi sono modificabili, e la scelta fatta l\u00ec \u00e8 quella che conta.<\/p><\/blockquote>\n

                          \n

                          10. Personalizzare con gli script<\/h2>\n

                          Tre punti dell’elaborazione possono essere agganciati a uno script<\/strong> (Nashorn\/JavaScript, gestiti in Utilit\u00e0 \u2192 Amministrazione \u2192 Script<\/em>):<\/p>\n\n\n\n\n\n\n\n
                          Campo<\/th>\nQuando viene eseguito<\/th>\n<\/tr>\n<\/thead>\n
                          Script di pre-syncro<\/strong><\/td>\nuna volta, prima di chiedere qualsiasi dato al sito<\/td>\n<\/tr>\n
                          Script syncro ordine<\/strong><\/td>\nsu ogni singolo ordine<\/strong>, prima che venga elaborato<\/td>\n<\/tr>\n
                          Script di post-syncro<\/strong><\/td>\nuna volta, alla fine, solo se l’elaborazione \u00e8 andata a buon fine<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                          Lo script syncro ordine<\/em> \u00e8 quello con pi\u00f9 potere: riceve nella variabile _json_order<\/code> l’ordine cos\u00ec com’\u00e8 arrivato dal sito e deve restituire l’ordine<\/strong> che Atlantis elaborer\u00e0. Serve a correggere al volo casi che la configurazione standard non copre – riferimenti da riscrivere, righe da eliminare, campi da spostare.<\/p>\n

                          Il nome dello script pu\u00f2 essere lungo al massimo 15 caratteri. Se lo script indicato non esiste compare “Errore. Script ‘\u2026’ non trovato!”<\/em> e l’elaborazione prosegue comunque<\/strong>.<\/p>\n

                          \n

                          11. Impostazioni che oggi non hanno effetto<\/h2>\n

                          Nella scheda Prestashop ci sono campi che si compilano ma che il programma non usa. Compilarli non fa danno, ma non risolve nessun problema:<\/p>\n