Esportazione CSV per gli ordini¶

Questo plugin consente l'esportazione flessibile degli ordini Shopware 6 come file CSV – completamente o filtrato per periodo, stato, metodo di pagamento e altro ancora. Con profili individuali, è possibile definire liberamente i campi e adattare le esportazioni ai requisiti specifici.

❓ Domande frequenti¶

🔧 Installazione¶

• Prerequisiti (Plugin CNK Foundation)
• Installazione tramite Store o ZIP
• Attivazione & Visibilità nel Backend

🕒 Invio automatico (Pianificazione)¶

L'esportazione basata sul tempo (Automazione) viene eseguita tramite il Worker in background di Shopware – esattamente come tutte le altre attività pianificate in Shopware. Su un negozio correttamente gestito, l'esportazione quindi si esegue completamente automaticamente, senza intervento manuale.

*/5 * * * * /usr/bin/php /percorso/negozio/bin/console scheduled-task:run-single cnk_order_csv_export.task

🧩 Gestisci profili¶

I profili di esportazione definiscono quali dati si trovano nel file CSV e in quale ordine appaiono. I profili si trovano nell'area di amministrazione di Shopware in Ordini > Esportazione CSV > Profili.

All'interno di un profilo, è possibile determinare precisamente quali campi devono essere inclusi nel file CSV esportato. Tramite il pulsante « Aggiungi campo », è possibile selezionare e organizzare individualmente i campi di ordine, cliente, prodotto e indirizzo. L'ordine dei campi nel profilo corrisponde all'ordine delle colonne nel file CSV.

🗂️ Formati di esportazione & Modelli ERP¶

Oltre al formato standard CSV, puoi anche esportare i tuoi profili di esportazione come Excel (XLSX), JSON o XML.

Il formato di esportazione è impostato per profilo nella scheda Configurazione tramite il campo « Formato file » e viene applicato lato server a tutti i percorsi di esportazione (manuale, esportazione rapida, pianificazione, Flow Builder e CLI). Se l'acquisto in-app non è attivo, l'esportazione ritorna automaticamente a CSV.

Abilita un formato Pro¶

1. Apri un profilo in Ordini > Esportazione CSV > Profili e vai alla scheda Configurazione.
2. Seleziona un formato Pro (XLSX, JSON o XML) in Formato file. Se l'acquisto non è ancora attivo, compare un messaggio con il pulsante « Abilita ».
3. Dopo l'acquisto, il formato è immediatamente disponibile e viene applicato al salvataggio.

Applica modelli ERP¶

I modelli ERP precompilano in un clic la selezione dei campi appropriata così come le impostazioni di separatore, numero, data e codifica per il sistema di destinazione:

Per applicare un modello:

1. Assicurati che l'acquisto in-app « Formati Pro & Modelli ERP » sia attivo.
2. Seleziona il sistema desiderato in Modello ERP nel profilo e fai clic su « Applica modello ».
3. La selezione dei campi e le impostazioni di formato vengono applicate. Il Formato file scelto viene conservato – ad esempio, puoi esportare una selezione di campi DATEV anche come XLSX.

💡 L'applicazione di un modello sovrascrive la selezione dei campi corrente del profilo. Adatta i campi in seguito se necessario e salva il profilo.

🔄 Esportazione incrementale / Delta¶

Con l'esportazione delta, ad ogni esecuzione vengono esportati solo gli ordini creati o modificati dall'ultimo export riuscito. Questo mantiene un sistema di gestione inventari o contabilità sincronizzato senza duplicati e – specialmente per grandi quantità di ordini – risparmia tempo e volume di dati.

• Abilitabile per profilo tramite l'interruttore « Esportazione Delta/Incrementale » nella scheda Configurazione.
• Considera gli ordini in base alla data di creazione o modifica (createdAt/updatedAt), quindi anche gli ordini modificati successivamente vengono riesportati.
• Il Delta-Stand (Wasserzeichen) viene aggiornato solo dopo un export riuscito – se un'esecuzione fallisce, nessun ordine viene perso.
• Funziona su tutti i percorsi di esportazione: Pianificazione, Flow Builder e CLI (Profilo Config).

Configura esportazione Delta¶

1. Apri un profilo e vai alla scheda Configurazione.
2. Abilita l'interruttore « Esportazione Delta/Incrementale ». Se l'acquisto non è ancora attivo, compare un messaggio con il pulsante « Abilita ».
3. Salva il profilo. Dalla successiva esecuzione, verranno esportati solo gli ordini nuovi o modificati.

Ripristina Delta-Stand¶

Se desideri riesportare tutti gli ordini (ad es. per una sincronizzazione iniziale completa), reimposta il Wasserzeichen:

1. Apri il profilo nella scheda Configurazione.
2. Fai clic su « Ripristina » nel messaggio Delta e salva il profilo.
3. L'esecuzione successiva riesporta tutti gli ordini corrispondenti e quindi imposta un nuovo Wasserzeichen.

💡 L'esportazione Delta utilizza l'ora di inizio dell'esportazione come Wasserzeichen. In questo modo, nel peggiore dei casi, alcuni ordini vengono esportati due volte piuttosto che essere saltati – ideale per importazioni idempotenti (Upserts) nella gestione inventari.

Variabili¶

💡 I nomi dei campi devono essere accettati esattamente come specificato nella colonna di sinistra.

La seguente panoramica mostra tutte le variabili disponibili che possono essere utilizzate in un profilo di esportazione. Questi determinano quali dati appaiono nel file CSV – ad esempio, dati generali dell'ordine, informazioni del cliente, campi di indirizzo o dettagli del prodotto. I nomi dei campi nella colonna di sinistra vengono configurati nel profilo, la colonna di destra descrive il contenuto.

🧾 Dati generali dell'ordine¶

📦 Righe ordine¶

👤 Dati cliente¶

🚚 Indirizzo di spedizione¶

🧾 Indirizzo di fatturazione¶

🛒 Dati prodotto¶

🧬 Dettagli riga (Payload)¶

Dati snapshot memorizzati al momento dell'acquisto sulla riga dell'ordine.

📄 Documenti¶

Campi da documenti generati (Fattura, Documento di trasporto e – se il plugin Pickware è installato – Lista di prelievo Pickware / Ricevuta POS). I valori vengono compilati solo dopo che il documento rispettivo è stato creato per l'ordine.

Fattura¶

Documento di trasporto¶

Lista di prelievo Pickware ERP¶

Ricevuta Pickware POS¶

⚡ Esportazione rapida tramite la panoramica ordini¶

• Esportazione diretta degli ordini selezionati
• Esportazione diretta degli ordini filtrati

• Selezione di un profilo nell'elenco a discesa

🔁 Processi (Automazione)¶

• Spiegazione: Scheduled Task / Cronjob
• Opzioni configurabili:
  • Intervallo di tempo o giorni della settimana fissi + ora
  • Destinazione FTP / E-mail
  • Scelta del profilo (incluso formato, modello ERP ed esportazione delta del profilo scelto)

📊 Attività & Registrazione¶

• Cronologia esportazione & Stato (Successo/Errore)
• File CSV-Log: Destinatario, Percorso FTP, Timestamp

• I registri si trovano in Ordini > Esportazione CSV > Attività

• Il risultato appare così

🖥️ Esportazione tramite riga di comando (CLI)¶

Esportazione rapida delle attività in corso¶

L'esportazione di grandi quantità di dati – anche più di 10.000 ordini – è possibile. Una barra di progresso integrata mostra l'avanzamento dell'esportazione.

Per non aspettare la coda, puoi attivare manualmente l'esportazione – ad es. per il download immediato di CSV dopo la creazione di un'esportazione:

#[AsCommand(
    name: 'cnk:csv-order-log:consume',
    description: 'Export all the activities in progress',
)]

L'esportazione può quindi essere avviata direttamente tramite la console:

bin/console cnk:csv-order-log:consume

Questo comando avvia tutte le esportazioni in corso direttamente tramite la console.

Esporta con profilo Shopware¶

bin/console cnk:csv-orders:export --fromDate 2023-05-15 --toDate 2025-02-01 --exportType sw_profile --mode order --profileName "Default orders" --limit 500

Esporta con profilo personalizzato¶

bin/console cnk:csv-orders:export --fromDate 2023-05-15 --toDate 2025-02-01 --exportType config --mode line_items --profileName "WAWI" --limit 500

• fromDate: Ordini da, formato Y-m-d
• toDate: Ordini fino a, formato Y-m-d
• exportType: Scelta tra sw_profile e config
• mode: Scelta tra order e line_items
• profileName: Profilo standard o profilo creato dall'utente
• limit: Limite degli ordini da esportare (Valore standard: 100)

📬 Support¶

Per domande, suggerimenti per miglioramenti o personalizzazioni, contattateci per email all'indirizzo support@cnk-plugins.de.