Eksport CSV dla zamówień¶

Ta wtyczka umożliwia elastyczny eksport zamówień Shopware 6 jako plik CSV – w całości lub filtrowany wg okresu, statusu, metody płatności i wielu innych kryteriów. Dzięki indywidualnym profilom możesz swobodnie definiować pola i dostosowywać eksporty do swoich konkretnych potrzeb.

❓ Najczęściej zadawane pytania¶

🔧 Instalacja¶

• Wymagania wstępne (Plugin CNK Foundation)
• Instalacja przez Store lub ZIP
• Aktywacja & Widoczność w Backend

🕒 Wysyłka automatyczna (Harmonogram)¶

Eksport oparty na czasie (Automatyzacja) jest wykonywany poprzez Pracownika w tle Shopware – dokładnie tak samo jak wszystkie inne zaplanowane zadania w Shopware. Na prawidłowo obsługiwanym sklepie eksport zatem uruchamia się całkowicie automatycznie, bez ręcznej interwencji.

*/5 * * * * /usr/bin/php /ścieżka/do/sklepu/bin/console scheduled-task:run-single cnk_order_csv_export.task

🧩 Zarządzaj profilami¶

Profile eksportu określają, jakie dane znajdują się w pliku CSV i w jakiej kolejności się pojawiają. Profile znajdują się w obszarze administracji Shopware w Zamówienia > Eksport CSV > Profile.

W profilu możesz precyzyjnie określić, które pola powinny być zawarte w eksportowanym pliku CSV. Poprzez przycisk « Dodaj pole » możesz indywidualnie wybierać i organizować pola zamówienia, klienta, produktu i adresu. Kolejność pól w profilu odpowiada kolejności kolumn w pliku CSV.

🗂️ Formaty eksportu & Szablony ERP¶

Oprócz standardowego formatu CSV możesz również eksportować swoje profile eksportu jako Excel (XLSX), JSON lub XML.

Format eksportu jest ustawiany na profil w zakładce Konfiguracja poprzez pole « Format pliku » i jest stosowany po stronie serwera do wszystkich ścieżek eksportu (ręczny, szybki eksport, harmonogram, Flow Builder i CLI). Jeśli In-App Purchase nie jest aktywny, eksport automatycznie wraca do CSV.

Włącz format Pro¶

1. Otwórz profil w Zamówienia > Eksport CSV > Profile i przejdź do zakładki Konfiguracja.
2. Wybierz format Pro (XLSX, JSON lub XML) w Format pliku. Jeśli zakup nie jest jeszcze aktywny, pojawia się wiadomość z przyciskiem « Włącz ».
3. Po zakupie format jest natychmiast dostępny i jest stosowany podczas zapisywania.

Zastosuj szablony ERP¶

Szablony ERP wstępnie wypełniają jednym kliknięciem odpowiedni wybór pól oraz ustawienia separatora, liczby, daty i kodowania dla systemu docelowego:

Aby zastosować szablon:

1. Upewnij się, że In-App Purchase « Formaty Pro & Szablony ERP » jest aktywny.
2. Wybierz żądany system w Szablon ERP w profilu i kliknij « Zastosuj szablon ».
3. Wybór pól i ustawienia formatowania są stosowane. Wybrany Format pliku jest zachowywany – możesz na przykład eksportować wybór pól DATEV również jako XLSX.

💡 Zastosowanie szablonu zastępuje bieżący wybór pól profilu. W razie potrzeby dostosuj pola później i zapisz profil.

🔄 Export inkrementalny / Delta¶

W eksporcie delta przy każdym uruchomieniu eksportowane są tylko zamówienia utworzone lub zmienione od ostatniego pomyślnego eksportu. Utrzymuje to system zarządzania zapasami lub księgowość zsynchronizowany bez duplikatów i – zwłaszcza dla dużych ilości zamówień – oszczędza czas i objętość danych.

• Włączalne na profil poprzez przełącznik « Export Delta/Inkrementalny » w zakładce Konfiguracja.
• Uwzględnia zamówienia na podstawie daty utworzenia lub modyfikacji (createdAt/updatedAt), więc nawet zamówienia zmienione później są ponownie eksportowane.
• Delta-Stand (Wasserzeichen) jest aktualizowany tylko po pomyślnym eksporcie – jeśli uruchomienie się nie powiedzie, żadne zamówienie nie zostaje utracone.
• Działa we wszystkich ścieżkach eksportu: Harmonogram, Flow Builder i CLI (Profil Config).

Konfiguruj eksport Delta¶

1. Otwórz profil i przejdź do zakładki Konfiguracja.
2. Włącz przełącznik « Export Delta/Inkrementalny ». Jeśli zakup nie jest jeszcze aktywny, pojawia się wiadomość z przyciskiem « Włącz ».
3. Zapisz profil. Od następnego uruchomienia będą eksportowane tylko nowe lub zmienione zamówienia.

Zresetuj Delta-Stand¶

Jeśli chcesz ponownie wyeksportować wszystkie zamówienia (np. dla pełnej synchronizacji początkowej), zresetuj Wasserzeichen:

1. Otwórz profil w zakładce Konfiguracja.
2. Kliknij « Zresetuj » w wiadomości Delta i zapisz profil.
3. Następne uruchomienie ponownie eksportuje wszystkie pasujące zamówienia i ustawia nowy Wasserzeichen.

💡 Export Delta używa czasu rozpoczęcia eksportu jako Wasserzeichen. W ten sposób w najgorszym przypadku kilka zamówień zostaje wyeksportowanych dwukrotnie, zamiast być pominiętych – idealne dla idempotentnych importów (Upserts) w zarządzaniu zapasami.

Zmienne¶

💡 Nazwy pól muszą być akceptowane dokładnie tak, jak określono w lewej kolumnie.

Poniższy przegląd pokazuje wszystkie dostępne zmienne, które mogą być używane w profilu eksportu. Te określają, jakie dane pojawiają się w pliku CSV – na przykład ogólne dane zamówienia, informacje o kliencie, pola adresu lub szczegóły produktu. Nazwy pól w lewej kolumnie są konfigurowane w profilu, prawa kolumna opisuje zawartość.

🧾 Ogólne dane zamówienia¶

📦 Wiersze zamówienia¶

👤 Dane klienta¶

🚚 Adres wysyłki¶

🧾 Adres rozliczeniowy¶

🛒 Dane produktu¶

🧬 Szczegóły pozycji (Ładunek)¶

Dane migawki przechowywane w momencie zakupu w wierszu zamówienia.

📄 Dokumenty¶

Pola z wygenerowanych dokumentów (Faktura, Potwierdzenie dostawy i – jeśli zainstalowana jest wtyczka Pickware – Lista pobrania Pickware / Paragon POS). Wartości są wypełniane dopiero po utworzeniu odpowiedniego dokumentu dla zamówienia.

Faktura¶

Potwierdzenie dostawy¶

Lista pobrania Pickware ERP¶

Paragon Pickware POS¶

⚡ Szybki eksport poprzez przegląd zamówień¶

• Bezpośredni eksport wybranych zamówień
• Bezpośredni eksport filtrowanych zamówień

• Wybór profilu z listy rozwijanej

🔁 Zadania (Automatyzacja)¶

• Objaśnienie: Scheduled Task / Cronjob
• Opcje konfigurowalne:
  • Interwał czasu lub stałe dni tygodnia + godzina
  • Cel FTP / E-mail
  • Wybór profilu (w tym format, szablon ERP i eksport delta wybranego profilu)

📊 Działalność & Rejestrowanie¶

• Historii eksportu & Status (Sukces/Błąd)
• Plik CSV-Log: Odbiorcy, Ścieżka FTP, Sygnatura czasowa

• Dzienniki znajdują się w Zamówienia > Eksport CSV > Działalność

• Wynik wygląda tak

🖥️ Eksport przez linię poleceń (CLI)¶

Szybki eksport bieżących działań¶

Eksport dużych ilości danych – nawet ponad 10 000 zamówień – jest możliwy. Wbudowany pasek postępu pokazuje postęp eksportu.

Aby nie czekać na kolejkę, możesz ręcznie wyzwolić eksport – np. dla natychmiastowego pobrania CSV po utworzeniu eksportu:

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

Eksport można następnie uruchomić bezpośrednio poprzez konsolę:

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

To polecenie uruchamia wszystkie bieżące eksporty bezpośrednio poprzez konsolę.

Eksportuj z profilem 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

Eksportuj z niestandardowym profilem¶

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

• fromDate: Zamówienia od, format Y-m-d
• toDate: Zamówienia do, format Y-m-d
• exportType: Wybór między sw_profile i config
• mode: Wybór między order i line_items
• profileName: Profil standardowy lub profil utworzony przez użytkownika
• limit: Limit eksportowanych zamówień (Wartość standardowa: 100)

📬 Support¶

W przypadku pytań, sugestii dotyczących ulepszeń lub dostosowań, prosimy o kontakt za pośrednictwem poczty elektronicznej na adres support@cnk-plugins.de.