Eksport CSV dla danych produktów – Wysyłka e-mailem & FTP¶
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 FTP. 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 FTP
- ⚙️ 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 FTP?
Tak. Za pośrednictwem Shopware Flow Builder, utworzony plik CSV można wysłać e-mailem lub przesłać przez FTP – 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 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¶
- Wymaganie wstępne: Plugin CNK Foundation
- 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 |
🗂️ 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 & FTP¶
Za pośrednictwem Shopware Flow Builder, eksport może być automatycznie wysłany e-mailem lub przesłany przez FTP. Typowa konfiguracja dodaje przepływ, który eksportuje zamawiające produkty przy otrzymaniu zamówienia i wysyła je e-mailem lub przez FTP.
Format i wybór pól dostawy są określane przez wybrany profil eksportu w przepływie.
📊 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.
📬 Support¶
W przypadku pytań, sugestii dotyczących ulepszeń lub dostosowań, prosimy o kontakt za pośrednictwem poczty elektronicznej na adres support@cnk-plugins.de.