CSV Export Pro – esportazione di prodotti e combinazioni in CSV compatibile con l’importazione di PrestaShop

A cosa serve il modulo

• Trasferimento del catalogo in un altro negozio. Nuovo negozio, migrazione a una versione più recente di PrestaShop oppure negozio di test: i file sono preparati per l’importazione della versione di destinazione, non della versione da cui esporti.
• Modifica massiva in un foglio di calcolo. Esportazione delle colonne selezionate, modifica in Excel o in un altro foglio e reimportazione nello stesso negozio.
• File fisso per l’integrazione. Grossista, comparatore, sistema ERP oppure un altro negozio possono scaricare un file aggiornato da un indirizzo fisso, aggiornato tramite CRON.

File compatibili con l’importazione della versione PrestaShop selezionata

Quattro versioni di destinazione

• Scelta della versione di importazione. Nel profilo indichi quale PrestaShop leggerà il file: 1.7.0–1.7.2, 1.7.3–1.7.6, 1.7.7–8.x, 9.x oppure “Automaticamente” (versione del negozio corrente).
• Colonne nell’ordine dell’importazione. Il file prodotti ha da 63 colonne (1.7.0–1.7.2) a 68 colonne (1.7.7–8.x), e per PrestaShop 9 – 66 colonne. Il file combinazioni ha da 23 a 26 colonne. L’ordine corrisponde ai campi di importazione della versione specifica, quindi il file completo si adatta automaticamente nella pagina di importazione.
• Colonne presenti solo in alcune versioni. Ad esempio ISBN, MPN, soglia di scorte basse e posizione di magazzino vengono inseriti solo nei file per le versioni il cui import li supporta; le parole chiave meta e le colonne della gestione avanzata del magazzino solo nei file per 1.7.0–1.7.2.
• Due modalità di salvataggio CSV. PrestaShop 9 legge il CSV secondo RFC 4180, mentre le versioni 1.7 e 8 trattano in modo diverso virgolette e barre rovesciate. Il modulo salva i valori in modo che l’importazione della versione specifica li legga senza modifiche e, quando ciò non è possibile, lo segnala nel report.
• Abbinamento colonne salvato. Per ogni profilo il modulo crea in PrestaShop una configurazione salvata di abbinamento colonne (“Esportazione CSV #ID - prodotti” e “Esportazione CSV #ID - combinazioni”), che può essere caricata nella pagina di importazione quando il file contiene solo una parte delle colonne.
• Scheda “Formato CSV”. Descrizione di ogni colonna per la versione PrestaShop selezionata e istruzioni passo dopo passo per le impostazioni di importazione.

File prodotti e file combinazioni

• File separati per due tipi di importazione. File prodotti per il tipo “Prodotti” e file combinazioni per il tipo “Combinazioni” (“Varianti” in PrestaShop 8 e 9); nel profilo è possibile attivarne uno oppure entrambi.
• File combinazioni completo. Il file combinazioni contiene sempre tutte le colonne, perché durante l’aggiornamento delle combinazioni l’importazione sovrascrive prezzo, peso, stock e codici con i valori del file – l’assenza di una colonna cancellerebbe questi dati.
• Immagini come URL. La colonna immagini contiene gli indirizzi dei file immagine originali dal dominio del negozio del profilo, con la copertina al primo posto, oltre ai testi alternativi. Le immagini il cui file manca sul server vengono ignorate e segnalate nel report.
• Caratteristiche, attributi, tag e accessori nel formato atteso dall’importazione (tra l’altro caratteristica come nome:valore:posizione:personalizzata).
• Prezzo con imposta come ultima colonna. L’importazione abbina preliminarmente le colonne in base alla posizione e ignora questo campo, perciò il modulo lo inserisce sempre alla fine per non spostare le altre colonne.

Profili di esportazione

Fonte dei dati

• Numero illimitato di profili. Ogni profilo descrive un insieme di file e ha un proprio nome, stato di attivazione, link di download e indirizzo CRON.
• Negozio del profilo. In multistore prezzi, stock, visibilità e immagini vengono prelevati dal negozio selezionato e il file indica quel negozio nella colonna negozio.
• Lingua dei dati. Nomi, descrizioni, campi SEO, tag, didascalie delle immagini e valori delle caratteristiche vengono esportati nella lingua del profilo; la stessa lingua va selezionata nella pagina di importazione come lingua del file.

Filtri prodotto

• Solo prodotti attivi.
• Solo prodotti disponibili in magazzino. Esclude i prodotti con stock pari o inferiore a 0 e le combinazioni il cui stock proprio è pari o inferiore a 0.
• Categorie selezionate. Il prodotto viene inserito nel file se appartiene ad almeno una delle categorie selezionate; nessuna selezione significa tutte le categorie.
• Esclusioni. Esclusione di marchi selezionati, fornitori (in base al fornitore predefinito del prodotto) e prodotti con gli ID indicati.

Colonne e set

• Selezione delle colonne del file prodotti suddivise in gruppi: identificazione, categorie, prezzi e imposte, sconto, codici (EAN, UPC, ISBN, MPN), dimensioni e peso, stock e disponibilità, descrizioni e SEO, immagini, caratteristiche, accessori e prodotto virtuale.
• Quattro set pronti: “Completo – trasferimento in un altro negozio”, “Modifica massiva in questo negozio”, “Prezzi e stock” e “Descrizioni e SEO”.
• Le colonne ID e riferimento sono sempre nel file, perché l’importazione riconosce il prodotto tramite esse.
• L’elenco delle colonne dipende dalla versione di destinazione. Dopo aver cambiato versione nel modulo, sono disponibili solo le colonne supportate dall’importazione di quella versione.

Chiave prodotto, categorie e separatori

• Chiave prodotto: ID prodotto (importazione con l’opzione “Forza tutti gli ID”) oppure riferimento (importazione con l’opzione “Usa il riferimento prodotto come chiave”). Con il riferimento, le colonne ID restano vuote e l’importazione delle combinazioni trova il prodotto tramite il riferimento.
• Categorie come ID – per l’importazione nello stesso negozio – oppure come percorsi di nomi (ad es. Abbigliamento/Uomini/T-shirt) per l’importazione in un altro negozio. I percorsi vengono salvati nella lingua predefinita del negozio, perché in quella lingua l’importazione cerca le categorie; le categorie mancanti verranno create dall’importazione.
• Separatore di campo: punto e virgola (predefinito, compatibile con Excel nelle impostazioni polacche), virgola oppure barra verticale.
• Separatore di valori multipli: virgola (predefinita in PrestaShop), barra verticale, cancelletto, tilde oppure accento circonflesso. Il modulo non consente di impostare lo stesso carattere del separatore di campo.

Report di compatibilità con l’importazione PrestaShop

L’importazione di PrestaShop interrompe l’intero file alla prima riga che non riesce a salvare e modifica parte dei valori senza avviso. Durante l’esportazione il modulo controlla 34 tipi di casi di questo tipo e salva ciascuno di essi in un file CSV separato di avvisi (livello, codice, ID prodotto, ID combinazione, colonna, valore, descrizione). Il riepilogo con esempi è visibile nella scheda “File e CRON”, suddiviso in errori, avvisi e informazioni.

• Righe che l’importazione rifiuterà: valori che non soddisfano la validazione di PrestaShop, prodotti senza nome nella lingua del profilo, combinazioni con nome attributo o gruppo attributi mancante nella lingua predefinita del negozio.
• Dati che l’importazione non trasferirà: prezzi specifici diversi da un unico sconto per l’intero catalogo, contenuto dei pacchetti, etichette dei campi di personalizzazione, file dei prodotti virtuali.
• Valori che l’importazione modificherà: spazi all’inizio e alla fine della cella, valore “0” nelle caratteristiche e nei tag, sconto a importo netto (l’importazione lo crea come lordo), impatto della combinazione sul prezzo unitario, codice EAN-13 non valido della combinazione, ISBN della combinazione nelle versioni 1.7 e 8.
• Conflitti di separatori e nomi: separatore di valori multipli nel contenuto, due punti nelle caratteristiche e negli attributi, barra nel nome della categoria, nomi di categoria ripetuti, nomi di marchi, fornitori o categorie costituiti da numeri.
• Problemi con la chiave: prodotti e combinazioni senza riferimento, combinazioni con riferimento duplicato (l’importazione le unirebbe in una sola – il modulo esporta solo la prima), accessori senza riferimento.
• Caratteri fuori da UTF-8 vengono sostituiti con il carattere “?”, affinché il resto del file mantenga i caratteri polacchi.

Generazione dei file e CRON

• Generazione dal pannello. Il pulsante “Genera” nell’elenco dei profili apre una finestra con barra di avanzamento, numero di prodotti elaborati, numero di righe di entrambi i file e numero di avvisi; la generazione può essere interrotta.
• Elaborazione a lotti. I prodotti vengono elaborati in lotti da 100, quindi un catalogo grande non supera il limite di tempo di una singola richiesta.
• Ripresa dopo interruzione. Se l’esecuzione viene interrotta, l’avvio successivo continua dall’ultimo lotto salvato e il file risultante è identico a quello di un’esecuzione completata in una sola volta.
• Pubblicazione sicura. I nuovi file sostituiscono i precedenti solo al termine della generazione; fino a quel momento il link rende disponibili gli ultimi file completi. Due esecuzioni simultanee dello stesso profilo vengono bloccate.
• Indirizzo CRON per tutti i profili e per ogni profilo separatamente. L’indirizzo passa tramite il controller del modulo, quindi funziona anche in PrestaShop 9, che blocca le chiamate dirette ai file PHP nella directory dei moduli.
• Continuazione tramite CRON. Se la generazione non rientra nel limite di tempo del server, la chiamata CRON successiva la completerà dal punto in cui si è fermata.
• Stato nell’intestazione del modulo. L’intestazione mostra se ci sono profili attivi, se i file sono stati generati, quando è stato richiamato l’ultima volta il CRON e se l’ultimo report contiene errori o avvisi.

Download dei file e link per le integrazioni

• Download nel pannello del file prodotti, del file combinazioni e del file di avvisi; accanto ai file prodotti e combinazioni sono visibili il numero di righe e la dimensione.
• Link pubblico senza login al file prodotti e al file combinazioni, con token segreto separato per ogni profilo. Il link funziona solo per il profilo attivo.
• Invalidazione dei link. Il pulsante “Nuovo link di download” crea un nuovo token del profilo, mentre il pulsante “Nuovo token CRON” crea un nuovo token per gli indirizzi CRON; gli indirizzi precedenti smettono di funzionare.
• File fuori dalla directory principale del negozio. I file generati vengono conservati nella directory del modulo protetta dal file .htaccess e vengono distribuiti solo tramite link con token oppure a un dipendente nel pannello.

Formato del file e lavoro in Excel

• UTF-8 con BOM, punto e virgola, fine riga CRLF. Il file si apre in Excel con doppio clic mantenendo i caratteri polacchi.
• Punto decimale e date nel formato del database, come richiesto dall’importazione di PrestaShop. Per modificare i prezzi è meglio aprire il file tramite Dati > Da testo/CSV con impostazioni locali “Inglese (Stati Uniti)”.
• La prima riga è l’intestazione con i nomi delle colonne nella lingua del profilo; nella pagina di importazione si imposta l’omissione di una riga.

Pannello amministrativo, permessi e multistore

• Schede nel menu Catalogo: “Esportazione CSV Pro” (elenco profili), “File e CRON” e “Formato CSV”, accessibili dalla barra delle schede del modulo.
• Permessi PrestaShop. L’accesso alle schede si assegna nei permessi standard dei profili dipendente; un dipendente con solo diritto di visualizzazione non può generare file né modificare i profili.
• Dipendenti limitati ai negozi. Il dipendente vede e modifica solo i profili dei negozi a cui ha accesso. Gli indirizzi CRON, il nuovo token CRON e l’eliminazione dei file della versione 1.x sono disponibili solo per i dipendenti con accesso a tutti i negozi, perché il token CRON gestisce ogni negozio.
• Traduzione polacca in entrambi i sistemi di traduzione di PrestaShop (dizionario e cataloghi XLF).

Compatibilità, installazione e aggiornamento

• PrestaShop 1.7.0–9.x, PHP 7.0–8.5 (compatibilità dichiarata). Installazione, generazione dei file e disinstallazione vengono verificate automaticamente su PrestaShop 1.7.4.4, 1.7.5.2, 8.2.6, 9.0.2 e 9.1.5, mentre il ciclo completo esportazione → importazione → confronto con il database su PrestaShop 8.2.6 e 9.0.2.
• Senza librerie esterne e senza Composer.
• Aggiornamento dalla versione 1.x. Il modulo trasferisce le configurazioni salvate nei profili, rimuove le vecchie schede e i punti di ingresso (cron.php, get.php) e mostra nella scheda “File e CRON” i file CSV che la versione 1.x ha lasciato nella directory principale del negozio, in modo che possano essere eliminati.
• Disinstallazione rimuove tabelle, impostazioni, schede, abbinamenti di importazione salvati e file generati del modulo.

Limiti operativi importanti

• Il modulo esporta i dati; l’importazione viene eseguita con l’importazione CSV standard di PrestaShop, che ha propri limiti descritti nel report di compatibilità.
• L’importazione di PrestaShop riconosce le combinazioni esclusivamente tramite il riferimento – le combinazioni senza riferimento, se reimportate nello stesso negozio, creeranno duplicati.
• In PrestaShop 8 e 9 il file combinazioni può essere importato in un negozio in cui i prodotti hanno un fornitore solo una volta; la seconda importazione si interrompe per un errore del database nel core di PrestaShop.
• A partire da PrestaShop 8 l’importazione aggiunge il valore modificato della caratteristica accanto a quello esistente, invece di sostituirlo.
• Il modulo non esporta ordini, clienti né altri dati oltre a prodotti e combinazioni.
• Il file CSV non è protetto dalle formule del foglio di calcolo: i valori che iniziano con il segno “=” vengono salvati senza modifiche, affinché l’importazione di PrestaShop li trasferisca esattamente.