Eksport CSV dla danych produktów – Wysyłka e-mailem & FTPS¶
Ta wtyczka umożliwia elastyczny eksport produktów i wariantów Shopware 6 jako plik CSV – bezpośrednio z przeglądu produktów (w tym aktywne filtry i wybór wielokrotny), za pośrednictwem profili indywidualnych, przez Shopware Flow Builder lub całkowicie automatycznie z wysyłką e-mailem i FTPS. Dzięki profilom eksportu możesz swobodnie definiować eksportowane pola i kolejność ich kolumn.
Najważniejsze funkcje
- ✅ Eksportuj produkty & warianty jako CSV – elastycznie i konfigurowalne
- 🖱️ Eksport bezpośrednio z przeglądu produktów – w tym aktywne filtry i wybór wielokrotny
- 🔀 Opcjonalnie wszystkie warianty produktu głównego (Przełącznik profilu)
- ✉️ Wysyłka e-mailem lub przesyłanie przez FTPS
- ⚙️ Wyzwolenie poprzez Shopware Flow Builder lub ręcznie w panelu administracyjnym
- 🧩 Swobodnie definiowalnie pola eksportu z kolejnością kolumn
- 🛠️ Format CSV konfigurowalny (separator, separator dziesiętny/tysięcy, data, strefa czasowa, kodowanie)
- 🗃️ Ceny, zapasy, kategorie, producenci, właściwości, SEO & pola dodatkowe
- 📊 Historia eksportu z ponownym pobieraniem utworzonych plików i wskaźnikiem postępu
❓ Najczęściej zadawane pytania¶
Czy mogę wysyłać eksporty e-mailem lub FTPS?
Tak. Za pośrednictwem Shopware Flow Builder, utworzony plik CSV można wysłać e-mailem lub przesłać przez FTPS – na przykład, aby automatycznie dostarczyć zamawiające produkty po otrzymaniu zamówienia. Eksporty mogą być również wykonywane ręcznie w panelu administracyjnym lub przez CLI.
Czy obsługiwany jest nieszyfrowany FTP?
Nie. Pliki są przesyłane wyłącznie przez jawne FTPS (AUTH TLS), zwykle na porcie 21. Jeśli serwer nie oferuje FTPS, test połączenia i przesyłanie kończą się błędem. Certyfikat serwera jest domyślnie weryfikowany; certyfikaty samopodpisane można dopuścić w konfiguracji wtyczki.
Czy mogę eksportować bezpośrednio z listy produktów?
Tak. W przeglądzie produktów możesz eksportować aktualnie filtrowaną listę lub wielokrotny wybór produktów bezpośrednio z wybranym profilem.
Czy mogę eksportować warianty produktu?
Tak. Poprzez przełącznik profilu możesz opcjonalnie uwzględnić wszystkie warianty produktu głównego w eksporcie.
Czy mogę tworzyć niestandardowe profile eksportu?
Tak. Możesz tworzyć indywidualne profile eksportu i określać, które pola mają być eksportowane w jakiej kolejności.
Czy obsługiwane są pola dodatkowe (Custom Fields)?
Tak. Wtyczka obsługuje pola dodatkowe produktów i wariantów oprócz wbudowanego katalogu pól.
Ile produktów mogę eksportować jednocześnie?
Maksymalna liczba produktów jest konfigurowalna w konfiguracji wtyczki (Domyślnie 50 000). Za pośrednictwem CLI można eksportować nawet bardzo duże ilości danych.
W jakim formacie mogę eksportować?
Produkty są eksportowane jako CSV. Format CSV jest w pełni konfigurowalny (separator, separator dziesiętny i tysięcy, format daty, strefa czasowa, kodowanie).
🔧 Instalacja¶
- Instalacja przez Shopware Store lub pobranie ZIP
- Aktywacja wtyczki w panelu administracyjnym Shopware
- Wymaga Shopware 6.7
🧩 Zarządzaj profilami¶
Profile eksportu określają, jakie dane znajdują się w pliku CSV i w jakiej kolejności. Profile znajdują się w panelu administracyjnym Shopware w Katalogi > Eksport CSV Produkty > Profile.
W profilu precyzyjnie określasz, które pola powinny być zawarte w eksportowanym pliku CSV. Poprzez wybór pól możesz indywidualnie wybierać pola produktu i je organizować – kolejność pól w profilu odpowiada kolejności kolumn w pliku CSV.
Profil zawiera również przełącznik « Uwzględnij warianty », za pomocą którego możesz opcjonalnie uwzględnić wszystkie warianty produktu głównego.
⚙️ Ustawienia standardowe¶
Globalne standardy formatowania CSV są ustawiane w konfiguracji wtyczki i dotyczą każdego eksportu (profil może być nadal dostosowany do danego przypadku użycia):
| Ustawienie | Opis | Standard |
|---|---|---|
| Separator pola | Separator CSV (przecinek lub średnik) | ; |
| Separator dziesiętny dla cen | Separator dziesiętny w wartościach cen | . |
| Separator tysięcy dla cen | Separator tysięcy w wartościach cen | , |
| Format daty | Format pól daty (np. d.m.Y, Y-m-d) | d.m.Y |
| Strefa czasowa | Strefa czasowa dla wartości daty/godziny | Europe/Berlin |
| Puste pola powitania | Wyświetl puste powitanie zamiast « Nie określono » | Wyłączone |
| Limit eksportu na pętlę | Liczba rekordów przetwarzanych na przejście | 100 |
| Maksymalna liczba produktów do eksportu | Górny limit produktów na eksport | 50000 |
| Akceptuj samopodpisane certyfikaty serwera FTPS | Włączać tylko dla serwerów FTPS z certyfikatem samopodpisanym: połączenie pozostaje szyfrowane, ale tożsamość serwera nie jest już weryfikowana | Wył. |
🗂️ Zmienne¶
💡 Nazwy pól muszą być używane dokładnie tak, jak określono w lewej kolumnie.
Poniższy przegląd wyświetla wszystkie wbudowane zmienne, które mogą być używane w profilu eksportu. Nazwy pól w lewej kolumnie są konfigurowane w profilu; prawa kolumna opisuje zawartość. Ponadto wybór pól automatycznie wyświetla pola dodatkowe zdefiniowane w Twoim sklepie dla produktów i wariantów.
🧾 Ogólne dane produktu¶
| Nazwa pola | Opis |
|---|---|
id | ID produktu |
active | Status aktywny |
product_number | Numer artykułu / SKU |
name | Nazwa produktu |
description | Opis |
ean | EAN / GTIN |
release_date | Data wydania |
rating_average | Średnia ocena |
mark_as_topseller | Oznaczono jako bestseller |
shipping_free | Bezpłatna wysyłka |
sales | Liczba sprzedaży |
canonical_product_id | ID produktu kanonicznego |
canonical_product_name | Nazwa produktu kanonicznego |
🔀 Warianty¶
| Nazwa pola | Opis |
|---|---|
variation | Dane wariantu |
display_group | Grupa wyświetlania wariantów |
variant_restrictions | Ograniczenia wariantów |
options | Opcje wariantów |
💶 Ceny & Podatek¶
| Nazwa pola | Opis |
|---|---|
price_net | Cena sprzedaży netto |
price_gross | Cena sprzedaży brutto |
purchase_price_net | Cena zakupu netto |
purchase_price_gross | Cena zakupu brutto |
tax_name | Nazwa stawki podatkowej |
tax_rate | Stawka podatkowa (%) |
📦 Zapasy, Ilości & Wymiary¶
| Nazwa pola | Opis |
|---|---|
stock | Zapasy fizyczne |
available_stock | Dostępne zapasy |
available | Dostępność |
is_closeout | Likwidacja / Wyprzedana |
min_purchase | Minimalna ilość zakupu |
max_purchase | Maksymalna ilość zakupu |
purchase_steps | Interwał zakupu |
purchase_unit | Jednostka sprzedaży |
reference_unit | Jednostka referencyjna |
pack_unit | Jednostka opakowania |
pack_unit_plural | Jednostka opakowania (Liczba mnoga) |
unit_name | Jednostka miary |
weight | Waga |
width | Szerokość |
height | Wysokość |
length | Długość |
delivery_time_names | Czas dostawy |
🗂️ Kategorie, Producenci & Właściwości¶
| Nazwa pola | Opis |
|---|---|
category_ids | ID kategorii |
category_names | Nazwy kategorii |
manufacturer_id | ID producenta |
manufacturer_number | Numer artykułu producenta |
manufacturer_name | Nazwa producenta |
properties | Właściwości produktu |
tags_names | Tagi |
streams | Dynamiczne grupy produktów |
🖼️ Media & Pliki do pobrania¶
| Nazwa pola | Opis |
|---|---|
cover_id | ID obrazu okładki |
downloads | Pobieranie produktów cyfrowych |
🔎 SEO & Wyszukiwanie¶
| Nazwa pola | Opis |
|---|---|
meta_title | Tytuł Meta |
meta_description | Opis Meta |
keywords | Słowa kluczowe SEO |
custom_search_keywords | Niestandardowe słowa kluczowe wyszukiwania |
slot_config | Konfiguracja układu CMS |
🧬 Pola dodatkowe & Feature-Sets¶
| Nazwa pola | Opis |
|---|---|
custom_field_set_selection_active | Wybór zestawu pól dodatkowych aktywny |
feature_set_id | ID zestawu funkcji produktu |
Pola dodatkowe (Custom Fields)
Oprócz pól wymienionych powyżej, wybór pól automatycznie wyświetla pola dodatkowe zdefiniowane w Twoim sklepie dla produktów i wariantów.
⚡ Szybki eksport poprzez przegląd produktów¶
- Eksportuj bezpośrednio aktualnie filtrowaną listę produktów
- Eksportuj wielokrotny wybór produktów (Eksport zbiorczy)
- Wybierz profil z listy rozwijanej, aby określić pola i format eksportu
✉️ Wysyłka e-mailem & FTPS¶
Za pośrednictwem Shopware Flow Builder, eksport może być automatycznie wysłany e-mailem lub przesłany przez FTPS. Typowa konfiguracja dodaje przepływ, który eksportuje zamawiające produkty przy otrzymaniu zamówienia i wysyła je e-mailem lub przez FTPS.
Format i wybór pól dostawy są określane przez wybrany profil eksportu w przepływie.
FTPS – nieszyfrowany FTP nie jest obsługiwany
Pliki są przesyłane wyłącznie przez jawne FTPS (AUTH TLS), zwykle na porcie 21. Kanał sterujący i kanał danych są szyfrowane. Jeśli serwer nie oferuje FTPS, test połączenia i przesyłanie kończą się błędem – nie ma powrotu do nieszyfrowanego FTP. Certyfikat i nazwa hosta serwera są domyślnie weryfikowane. Jeśli serwer używa certyfikatu samopodpisanego, włącz w konfiguracji wtyczki opcję „Akceptuj samopodpisane certyfikaty serwera FTPS”.
Jeśli wysyłka się nie powiedzie (przesyłanie FTPS lub e-mail), eksport zostaje oznaczony w aktywności jako nieudany, a błąd jest zapisywany w logu.
📊 Działalność & Rejestrowanie¶
- Historia eksportu & Status (Sukces / Błąd)
- Ponowne pobieranie już utworzonych plików
- Wskaźnik postępu dla bieżących eksportów
- Znaleźć w Katalogi > Eksport CSV Produkty > Działalność
🖥️ Eksport przez linię poleceń (CLI)¶
Przetwarzaj bieżące działania¶
Wyzwól wszystkie bieżące eksporty bezpośrednio, bez czekania na kolejkę:
Wbudowany wskaźnik postępu pokazuje postęp – dostosowany również do bardzo dużych ilości danych.
Eksportuj z profilem¶
Eksport z domyślnym profilem Shopware dla produktów:
bin/console cnk:csv-products:export --exportType sw_profile --profileName "Default products" --fromDate 2024-01-01 --toDate 2025-02-01
Eksport z profilem utworzonym w tej wtyczce:
bin/console cnk:csv-products:export --exportType config --profileName "PIM feed" --fromDate 2024-01-01 --toDate 2025-02-01
- fromDate: Produkty utworzone od tej daty, Format
Y-m-d - toDate: Produkty utworzone do tej daty, Format
Y-m-d(Standard: dzisiaj) - exportType:
sw_profile(Profil Importu/Eksportu Shopware) lubconfig(Profil tej wtyczki) - profileName: Nazwa profilu do użycia (Standard:
Default products)
Usuń wygasłe pliki¶
Usunąć wygasłe pliki eksportu i ich wpisy dziennika:
Wygasłe pliki są również automatycznie czyszczone raz dziennie za pośrednictwem zaplanowanego zadania cnk_product_export_file.cleanup.
🔐 Uprawnienia (ACL)¶
W Ustawienia > Użytkownicy i uprawnienia > Role w obszarze Katalogi znajdują się trzy wpisy:
| Poziom | Pozwala |
|---|---|
| Eksport CSV produktów: eksport – Odczyt / Tworzenie | Podgląd postępu / uruchamianie eksportu z przeglądu produktów |
| Eksport CSV produktów: profile – Odczyt / Edycja / Tworzenie / Usuwanie | Przeglądanie, zmiana, tworzenie i usuwanie profili eksportu |
| Eksport CSV produktów: aktywność – Odczyt / Usuwanie | Przeglądanie historii i pobieranie plików / usuwanie wpisów |
📬 Support¶
W przypadku pytań, sugestii dotyczących ulepszeń lub dostosowań, prosimy o kontakt za pośrednictwem poczty elektronicznej na adres support@cnk-plugins.de.