Pola oferty

Atrybuty opisują sam produkt (materiał, kolor, rozmiar), a pola oferty opisują Twoją ofertę tego produktu: Twoją cenę, Twój stan magazynowy, Twój czas wysyłki, Twój kod kreskowy, opłaty obsługowe i tak dalej. Dwóch sprzedawców oferujących ten sam produkt na tym samym marketplace dzieli te same atrybuty produktu, ale ma różne pola oferty.

Każdy marketplace definiuje własny zestaw pól oferty. Plugin pobiera tę listę dla każdego połączenia, a na stronie Offer Field Mappings wskazujesz mu, dla każdego pola oferty operatora, którą daną z Shopware ma wysłać.

Gdzie to znaleźć

Otwórz moduł admina Mirakl i kliknij kafelek Offer Field Mappings w sekcji Quick Start.

Lista pokazuje Twoje powiązania z kolumnami:

Offer Field — pole oferty operatora (cel powiązania).
Field Type — typ danej, jakiej oczekuje operator (tekst, liczba, data, lista, …).
Required (Mirakl / Export) — dwie flagi rozdzielone ukośnikiem. Pierwsza: czy marketplace wymaga tego pola. Druga: czy plugin traktuje je jako obowiązkowe podczas synchronizacji (patrz Wymagane czy opcjonalne niżej).
Source Type — jakiego rodzaju daną z Shopware czytasz.
Source Value — konkretne pole lub wartość kryjąca się pod typem źródła.
Default Value — wartość zapasowa używana, gdy produkt nie ma własnej wartości (patrz niżej).
Connections — połączenia, których dotyczy powiązanie.

Listę możesz filtrować po Connection, Source Type i Offer Field. Pasek narzędzi udostępnia Refresh, Add Mapping, Export Mappings i Import Mappings.

Pobierz listę pól oferty od operatora

Lista dostępnych pól oferty, z których wybierasz, pochodzi z odświeżenia:

Kreator pierwszego uruchomienia odświeża ją za Ciebie w kroku 6 (Offer Fields).
Na stronie Offer Fields (Quick Start → Offer Fields) przycisk Refresh Fields pobiera aktualną listę operatora w dowolnym momencie. Uruchamiaj go, gdy operator ogłosi zmianę schematu.

Załaduj wartości domyślne — rekomendowany punkt startu

Dla pól oferty nie ma przycisku Auto-Map. Odpowiednikiem jest krok 7 kreatora pierwszego uruchomienia, w którym przycisk Apply Defaults tworzy zestaw rozsądnych powiązań domyślnych (cena → cena, stan → stan, EAN → ean itd.). Wartości domyślne są dodawane tylko tam, gdzie nie ma jeszcze powiązania, więc wielokrotne uruchomienie nie tworzy duplikatów.

W tym samym kroku kreatora możesz też zaimportować plik JSON wyeksportowany z innego połączenia.

Jeśli pominąłeś ten krok albo chcesz później dodać kolejne powiązania, użyj bezpośrednio strony Offer Field Mappings.

Dodaj lub edytuj powiązanie

Kliknij Add Mapping w pasku narzędzi (albo otwórz istniejący wiersz i wybierz Edit z menu kontekstowego). W oknie wskazujesz:

Offer Field — pole operatora, które chcesz powiązać.
Connections — które połączenia obejmuje powiązanie. Jedno powiązanie może dotyczyć kilku połączeń, ale nie da się utworzyć dwóch powiązań dla tego samego pola na tym samym połączeniu.
Source Type — jakiego rodzaju daną z Shopware chcesz czytać. Pola w oknie dostosowują się do wyboru (patrz tabela niżej).
Source Value — zależnie od typu źródła: nazwa pola produktu, klucz pola własnego, referencja do grupy cech, stały tekst itp.
Default Value — wartość zapasowa używana, gdy produkt nie ma własnej wartości. Ikona kłódki steruje zachowaniem: zablokowana to brak wartości domyślnej — używaj standardowej logiki; odblokowana to wyślij tę wartość, nawet pustą.
Required for export — przełącznik bezpieczeństwa na poziomie powiązania. Gdy włączony, produkty bez wartości dla tego pola są pomijane podczas synchronizacji oferty — po prostu nie trafiają do paczki wysyłanej do marketplace’u.

Typy źródła

Lista dostępnych typów źródła jest zamknięta — wybierz ten, który najlepiej opisuje, jak przechowujesz wartość w Shopware.

Typ źródła	Co zwraca
Product Field	Jedno z natywnych pól produktu: Name, Description, EAN, Product Number, Stock, Price, Weight, Width, Height, Length, Manufacturer Number, Unit (name), Purchase Unit, Reference Unit.
Custom Field	Pole własne Shopware. W oknie wybierasz z zestawu pól własnych albo wpisujesz klucz ręcznie (z notacją kropkową dla wartości zagnieżdżonych).
Property Group	Wartość grupy cech produktu.
Product Category	Inteligentny pomocnik: użyj kategorii Mirakl, jeśli jest powiązana, w innym wypadku użyj kategorii Shopware.
Mirakl Category	Tylko powiązana kategoria Mirakl (bez zapasowej).
Shopware Category	Surowa kategoria Shopware, bez powiązania z Mirakl.
Product Image URL	URL zdjęcia okładkowego produktu.
Tax Rate	Stawka VAT produktu w procentach.
EAN with SKU fallback	EAN produktu, jeśli jest ustawiony, w innym wypadku numer produktu (SKU).
Auto Product ID Type (EAN/SHOP_SKU)	Literalny tekst `EAN` albo `SHOP_SKU`, dopasowany do wartości zwróconej przez poprzedni pomocnik.
Shop SKU (Product Number)	Zawsze numer produktu.
Product ID Type: SHOP_SKU	Zawsze literalny tekst `SHOP_SKU`.
EAN / GTIN	Zawsze EAN (puste, gdy produkt go nie ma).
Product ID Type: EAN	Zawsze literalny tekst `EAN`.
Effective Stock	Stan fizyczny albo dostępny (po odjęciu zarezerwowanych). Oba zwracają 0, gdy produkt jest nieaktywny.
Delivery Time	Minimalny albo maksymalny czas dostawy produktu w dniach.
Mirakl Offer State	Wyjątek statusu oferty dla produktu albo domyślny status oferty z połączenia.
Static Value	Stały tekst wysyłany taki sam dla każdego produktu.

Pomocniki EAN/SKU oraz literały Product-ID-Type występują parami, bo operatorzy zwykle chcą zarówno wartość product-id, jak i pasujący literał product-id-type. Powiąż je jako dwa osobne pola oferty z dopasowanymi typami źródła, żeby pozostały spójne.

Wymagane czy opcjonalne

Lista pokazuje dwie flagi obok siebie pod nagłówkiem Required (Mirakl / Export):

Wymagane przez Mirakl — pochodzi z definicji pola u operatora. Jeśli Mirakl oznacza pole jako wymagane, operator odrzuca oferty bez niego.
Required for export — przełącznik bezpieczeństwa po Twojej stronie. Gdy włączony, produkty bez wartości tego pola są pomijane przy synchronizacji oferty — po prostu nie są wysyłane. Przydatne jako miękka bramka, np. pomijaj produkty bez EAN zamiast pozwalać im wywrócić ofertę.

Wyłączenie Required for export dla pola, którego sam marketplace wymaga, wyświetla ostrzeżenie w oknie: może to powodować błędy synchronizacji albo odrzucone oferty po stronie operatora.

Reguły wartości (transformacje)

Każde zapisane powiązanie pola oferty może mieć łańcuch reguł wartości (w oknie edytora nazywanych Value transformations), które dopasowują wartość przed wysłaniem.

Otwórz powiązanie w Edit i kliknij Value transformations w stopce okna (przycisk pokazuje licznik istniejących reguł). Dostępne typy reguł są te same co dla atrybutów: Replacement, Regular expression, Remove HTML, HTML → plain text, Lowercase, Uppercase, Capitalize first letter, Title Case, Max length. Reguły działają w kolejności Priority, niższe liczby uruchamiają się jako pierwsze.

Typowe zastosowania w polach oferty:

Ogranicz stan magazynowy — reguła Max length albo regex ograniczająca ilość do znanego limitu operatora.
Ujednolicaj walutę — reguła Replacement zamieniająca € na EUR, jeśli przechowujesz symbol.
Usuwaj HTML — w polu product-description, jeśli operator chce tekst zwykły.

Reguły wartości można dodać tylko do zapisanego powiązania. Jeśli przycisk Value transformations nie reaguje w nowym powiązaniu, zobaczysz powiadomienie z prośbą o wcześniejsze zapisanie. Zapisz powiązanie przez Save, otwórz wiersz ponownie z menu kontekstowego → Edit i kliknij przycisk jeszcze raz.

Import / Eksport

Przyciski Export Mappings i Import Mappings przenoszą całą konfigurację pól oferty między połączeniami lub między sklepami:

Export Mappings otwiera okno, w którym wybierasz Source connection. Pobrany plik JSON zawiera wszystkie powiązania pól oferty dla wybranego połączenia.
Import Mappings otwiera okno, w którym wybierasz Target connection, Import mode (Merge — keep existing mappings, only add new ones albo Replace — remove existing mappings of the target connection first) oraz plik JSON. Podsumowanie na końcu pokazuje, ile powiązań zostało Imported, Replaced, Skipped oraz ile było Missing fields (wymienionych w pliku JSON, ale nieistniejących w liście pól oferty docelowego połączenia).

Krok Offer Field Mappings w kreatorze pierwszego uruchomienia akceptuje ten sam format JSON, więc wyeksportowany plik możesz zastosować już przy pierwszej konfiguracji.

Wskazówki i pułapki

Powiązane tematy

Offer sync — korzysta z powiązań pól oferty w trakcie synchronizacji
Attributes — opisuje sam produkt (a nie Twoją ofertę)
Offer states — niezależnie od typu źródła Mirakl Offer State