Esportazione CSV per dati prodotti – Invio tramite e-mail & FTPS¶
Questo plugin consente l'esportazione flessibile di prodotti e varianti Shopware 6 come file CSV – direttamente dalla panoramica dei prodotti (incl. filtri attivi e selezione multipla), tramite profili individuali, per Shopware Flow Builder o completamente automaticamente con invio tramite e-mail e FTPS. Con profili di esportazione, è possibile definire liberamente i campi esportati e l'ordine delle loro colonne.
Punti salienti
- ✅ Esportare prodotti & varianti come CSV – flessibile e configurabile
- 🖱️ Esportazione diretta dalla panoramica dei prodotti – incl. filtri attivi e selezione multipla
- 🔀 Facoltativamente tutte le varianti di un prodotto principale (Interruttore di profilo)
- ✉️ Invio tramite e-mail o caricamento per FTPS
- ⚙️ Attivazione tramite Shopware Flow Builder o manualmente nell'admin
- 🧩 Campi di esportazione liberamente definibili con ordine delle colonne
- 🛠️ Formato CSV configurabile (separatore, separatore decimale/migliaia, data, fuso orario, codifica)
- 🗃️ Prezzi, stock, categorie, produttori, proprietà, SEO & campi personalizzati
- 📊 Cronologia esportazione con download rinnovato di file creati e indicatore di progresso
❓ Domande frequenti¶
Posso inviare le esportazioni tramite e-mail o FTPS?
Sì. Tramite Shopware Flow Builder, il file CSV creato può essere inviato tramite e-mail o caricato per FTPS – ad esempio, per consegnare automaticamente i prodotti ordinati al ricevimento dell'ordine. Le esportazioni possono anche essere eseguite manualmente nell'admin o tramite la CLI.
È supportato l’FTP non crittografato?
No. I file vengono trasferiti esclusivamente tramite FTPS esplicito (AUTH TLS), di solito sulla porta 21. Se il server non offre FTPS, il test di connessione e il caricamento non riescono. Il certificato del server viene verificato per impostazione predefinita; i certificati autofirmati possono essere consentiti nella configurazione del plugin.
Posso esportare direttamente dalla lista dei prodotti?
Sì. Nella panoramica dei prodotti, è possibile esportare l'elenco filtrato attualmente o una selezione multipla di prodotti direttamente con un profilo scelto.
Posso esportare le varianti del prodotto?
Sì. Tramite un interruttore di profilo, è possibile incluire facoltativamente tutte le varianti di un prodotto principale nell'esportazione.
Posso creare i miei profili di esportazione personalizzati?
Sì. È possibile creare profili di esportazione individuali e determinare quali campi devono essere esportati in quale ordine.
Sono supportati i campi personalizzati (Custom Fields)?
Sì. Il plugin supporta campi personalizzati di prodotti e varianti oltre al catalogo di campi integrato.
Quanti prodotti posso esportare contemporaneamente?
Il numero massimo di prodotti è configurabile nella configurazione del plugin (Per impostazione predefinita 50.000). Tramite la CLI, anche quantità molto grandi di dati possono essere esportate.
In quale formato posso esportare?
I prodotti vengono esportati come CSV. Il formato CSV è completamente configurabile (separatore, separatore decimale e migliaia, formato data, fuso orario, codifica).
🔧 Installazione¶
- Installazione tramite Shopware Store o download ZIP
- Attivazione del plugin nell'admin Shopware
- Richiede Shopware 6.7
🧩 Gestisci profili¶
I profili di esportazione definiscono quali dati si trovano nel file CSV e in quale ordine. I profili si trovano nell'admin Shopware in Cataloghi > Esportazione CSV Prodotti > Profili.
All'interno di un profilo, determini precisamente quali campi devono essere inclusi nel file CSV esportato. Tramite la selezione dei campi, è possibile selezionare individualmente i campi del prodotto e organizzarli – l'ordine dei campi nel profilo corrisponde all'ordine delle colonne nel file CSV.
Un profilo contiene anche l'interruttore « Includi varianti », con il quale è possibile includere facoltativamente tutte le varianti di un prodotto principale.
⚙️ Configurazione standard¶
Gli standard di formattazione CSV globali sono impostati nella configurazione del plugin e si applicano a ogni esportazione (un profilo può comunque essere adattato al rispettivo caso d'uso):
| Impostazione | Descrizione | Standard |
|---|---|---|
| Separatore di campo | Separatore CSV (virgola o punto e virgola) | ; |
| Separatore decimale per i prezzi | Separatore decimale nei valori dei prezzi | . |
| Separatore delle migliaia per i prezzi | Separatore delle migliaia nei valori dei prezzi | , |
| Formato data | Formato per i campi data (ad es. d.m.Y, Y-m-d) | d.m.Y |
| Fuso orario | Fuso orario per i valori di data/ora | Europe/Berlin |
| Campi titolo vuoti | Mostra titolo vuoto invece di « Non specificato » | Disabilitato |
| Limite di esportazione per ciclo | Numero di record elaborati per passata | 100 |
| Numero massimo di prodotti da esportare | Limite superiore di prodotti per esportazione | 50000 |
| Accetta certificati FTPS autofirmati | Da attivare solo per server FTPS con certificato autofirmato: la connessione resta crittografata, ma l’identità del server non viene più verificata | Disattivato |
🗂️ Variabili¶
💡 I nomi dei campi devono essere usati esattamente come specificato nella colonna di sinistra.
La seguente panoramica elenca tutte le variabili integrate che possono essere utilizzate in un profilo di esportazione. I nomi dei campi nella colonna di sinistra vengono configurati nel profilo; la colonna di destra descrive il contenuto. Inoltre, la selezione dei campi mostra automaticamente i campi personalizzati definiti nel tuo negozio per prodotti e varianti.
🧾 Dati generali del prodotto¶
| Nome del campo | Descrizione |
|---|---|
id | ID prodotto |
active | Stato attivo |
product_number | Numero articolo / SKU |
name | Nome prodotto |
description | Descrizione |
ean | EAN / GTIN |
release_date | Data di rilascio |
rating_average | Valutazione media |
mark_as_topseller | Contrassegnato come bestseller |
shipping_free | Spedizione gratuita |
sales | Numero di vendite |
canonical_product_id | ID prodotto canonico |
canonical_product_name | Nome prodotto canonico |
🔀 Varianti¶
| Nome del campo | Descrizione |
|---|---|
variation | Dati di variazione |
display_group | Gruppo di visualizzazione varianti |
variant_restrictions | Restrizioni varianti |
options | Opzioni varianti |
💶 Prezzi & Imposta¶
| Nome del campo | Descrizione |
|---|---|
price_net | Prezzo di vendita netto |
price_gross | Prezzo di vendita lordo |
purchase_price_net | Prezzo di acquisto netto |
purchase_price_gross | Prezzo di acquisto lordo |
tax_name | Nome aliquota fiscale |
tax_rate | Aliquota fiscale (%) |
📦 Stock, Quantità & Dimensioni¶
| Nome del campo | Descrizione |
|---|---|
stock | Stock fisico |
available_stock | Stock disponibile |
available | Disponibilità |
is_closeout | Liquidazione / Esaurito |
min_purchase | Quantità minima d'acquisto |
max_purchase | Quantità massima d'acquisto |
purchase_steps | Intervallo di acquisto |
purchase_unit | Unità di vendita |
reference_unit | Unità di riferimento |
pack_unit | Unità di imballaggio |
pack_unit_plural | Unità di imballaggio (Plurale) |
unit_name | Unità di misura |
weight | Peso |
width | Larghezza |
height | Altezza |
length | Lunghezza |
delivery_time_names | Tempo di consegna |
🗂️ Categorie, Produttori & Proprietà¶
| Nome del campo | Descrizione |
|---|---|
category_ids | ID categoria |
category_names | Nomi categoria |
manufacturer_id | ID produttore |
manufacturer_number | Numero prodotto produttore |
manufacturer_name | Nome produttore |
properties | Proprietà prodotto |
tags_names | Tag |
streams | Gruppi di prodotti dinamici |
🖼️ Media & Download¶
| Nome del campo | Descrizione |
|---|---|
cover_id | ID immagine di copertina |
downloads | Download prodotti digitali |
🔎 SEO & Ricerca¶
| Nome del campo | Descrizione |
|---|---|
meta_title | Titolo Meta |
meta_description | Descrizione Meta |
keywords | Parole chiave SEO |
custom_search_keywords | Parole chiave di ricerca personalizzate |
slot_config | Configurazione layout CMS |
🧬 Campi personalizzati & Feature-Sets¶
| Nome del campo | Descrizione |
|---|---|
custom_field_set_selection_active | Selezione set campi personalizzati attivo |
feature_set_id | ID set funzionalità prodotto |
Campi personalizzati (Custom Fields)
Oltre ai campi elencati sopra, la selezione dei campi mostra automaticamente i campi personalizzati definiti nel tuo negozio per prodotti e varianti.
⚡ Esportazione rapida tramite la panoramica dei prodotti¶
- Esportare direttamente l'elenco prodotti filtrato attualmente
- Esportare una selezione multipla di prodotti (Esportazione in massa)
- Selezionare un profilo dall'elenco a discesa per determinare i campi e il formato dell'esportazione
✉️ Invio tramite e-mail & FTPS¶
Tramite Shopware Flow Builder, un'esportazione può essere inviata automaticamente tramite e-mail o caricata per FTPS. Una configurazione tipica aggiunge un flusso che esporta i prodotti ordinati al ricevimento dell'ordine e li invia tramite e-mail o FTPS.
Il formato e la selezione dei campi della consegna sono determinati dal profilo di esportazione scelto nel flusso.
FTPS – l’FTP non crittografato non è supportato
I file vengono trasferiti esclusivamente tramite FTPS esplicito (AUTH TLS), di solito sulla porta 21. Il canale di controllo e quello dei dati sono crittografati. Se il server non offre FTPS, il test di connessione e il caricamento non riescono: non esiste un ripiego su FTP non crittografato. Il certificato e il nome host del server vengono verificati per impostazione predefinita. Se il server usa un certificato autofirmato, attivare «Accetta certificati FTPS autofirmati» nella configurazione del plugin.
Se l’invio non riesce (caricamento FTPS o e-mail), l’esportazione viene contrassegnata come non riuscita nell’attività e l’errore viene registrato.
📊 Attività & Registrazione¶
- Cronologia esportazione & Stato (Successo / Errore)
- Download rinnovato di file già creati
- Indicatore di progresso per esportazioni in corso
- Si trova in Cataloghi > Esportazione CSV Prodotti > Attività
🖥️ Esportazione tramite riga di comando (CLI)¶
Elaborare attività in corso¶
Attivare tutte le esportazioni in corso direttamente, senza aspettare la coda:
Una barra di progresso integrata mostra il progresso – adatta anche per quantità molto grandi di dati.
Esportare con profilo¶
Esportazione con il profilo standard Shopware per i prodotti:
bin/console cnk:csv-products:export --exportType sw_profile --profileName "Default products" --fromDate 2024-01-01 --toDate 2025-02-01
Esportazione con un profilo creato in questo plugin:
bin/console cnk:csv-products:export --exportType config --profileName "PIM feed" --fromDate 2024-01-01 --toDate 2025-02-01
- fromDate: Prodotti creati da questa data, Formato
Y-m-d - toDate: Prodotti creati fino a questa data, Formato
Y-m-d(Standard: oggi) - exportType:
sw_profile(Profilo Importazione/Esportazione Shopware) oconfig(Profilo di questo plugin) - profileName: Nome del profilo da usare (Standard:
Default products)
Elimina file scaduti¶
Eliminare file di esportazione scaduti e le relative voci di registro:
I file scaduti vengono puliti automaticamente una volta al giorno anche tramite l'attività pianificata cnk_product_export_file.cleanup.
🔐 Autorizzazioni (ACL)¶
In Impostazioni > Utenti e permessi > Ruoli trovate tre voci nell’area Cataloghi:
| Livello | Consente |
|---|---|
| Esportazione CSV prodotti: esportazione – Leggere / Creare | Vedere l’avanzamento / avviare esportazioni dalla panoramica prodotti |
| Esportazione CSV prodotti: profili – Leggere / Modificare / Creare / Eliminare | Vedere, modificare, creare ed eliminare profili di esportazione |
| Esportazione CSV prodotti: attività – Leggere / Eliminare | Vedere la cronologia e scaricare i file / eliminare voci |
📬 Support¶
Per domande, suggerimenti per miglioramenti o personalizzazioni, contattateci per email all'indirizzo support@cnk-plugins.de.