Esportazione CSV per dati prodotti – Invio tramite e-mail & FTP¶
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 FTP. 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 FTP
- ⚙️ 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 FTP?
Sì. Tramite Shopware Flow Builder, il file CSV creato può essere inviato tramite e-mail o caricato per FTP – 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.
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¶
- Prerequisito: Plugin CNK Foundation
- 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 |
🗂️ 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 & FTP¶
Tramite Shopware Flow Builder, un'esportazione può essere inviata automaticamente tramite e-mail o caricata per FTP. Una configurazione tipica aggiunge un flusso che esporta i prodotti ordinati al ricevimento dell'ordine e li invia tramite e-mail o FTP.
Il formato e la selezione dei campi della consegna sono determinati dal profilo di esportazione scelto nel flusso.
📊 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.
📬 Support¶
Per domande, suggerimenti per miglioramenti o personalizzazioni, contattateci per email all'indirizzo support@cnk-plugins.de.