Elbuz umieszcza w pliku cenę i opis takie, jakie są w katalogu bazowym, a szablon decyduje, które pole pójdzie jako cena, i potrafi obliczyć formułę lub złożyć opis z atrybutów.
Kiedy to się przyda:
- Marketplace potrzebuje RRP, a klient — zwykłej ceny — każdy szablon bierze swoje pole ceny albo formułę „RRP, jeśli jest wypełniona”.
- W pliku cena wynosi 0 — eksport niczego nie dolicza, więc zero oznacza puste pole w karcie produktu.
- Atrybuty są wypełnione, a opisu nie ma — generator złoży opis z atrybutów tylko w eksporcie, karta się nie zmieni.
Od czego zacząć: karta szablonu → tag ceny w szablonie XML albo kolumna „Formuła” w cenniku.
Co potrafi szablon z ceną i opisem
- Pole ceny — dowolne pole ceny z katalogu: „Cena”, „Cena sugerowana (RRP)”, „Stara cena”, „Cena promocyjna”.
- Formuła i kurs — „RRP, jeśli jest wypełniona”, przeliczenie po kursie bezpośrednio w szablonie.
- Generator opisów — opis z atrybutów produktu, tylko w eksporcie.
Cena w eksporcie
Na etapie eksportu nie ma narzutu. W żadnym z formatów nie ma ani procentu, ani współczynnika, ani reguł: do pliku idzie wartość pola dokładnie taka, jaka jest w katalogu bazowym. Narzut stosuje się wcześniej, gdy katalog jest aktualizowany z cenników dostawców — to reguły wyceny dla cennika.
Co można tu zrobić z ceną:
- Wybrać, które pole jest ceną. W szablonie dostępne są wszystkie pola ceny produktu: „Cena”, „Cena sugerowana (RRP)”, „Koszt własny”, „Stara cena”, „Cena promocyjna”, a obok nich „Waluta”, „Stała cena” i „Dynamika ceny”. Do cennika hurtowego zwykle bierze się jedno pole, dla marketplace’u — inne. W szablonie XML zwykła cena z karty to symbol zastępczy
{price}i to on jest w szablonie domyślnie. Każde inne pole ceny wstawia się makrem z jego nazwą:{Produkt BC: Cena sugerowana (RRP)},{Produkt BC: Cena promocyjna},{Produkt BC: Stara cena}. - Napisać formułę. W szablonie XML formułę bierze się w podwójne nawiasy kwadratowe:
[[IF({Produkt BC: Cena sugerowana (RRP)}>0, {Produkt BC: Cena sugerowana (RRP)}, {Produkt BC: Cena})]]— „jeśli jest wypełniona, weź ją, w przeciwnym razie zwykłą cenę”. W cenniku XLSX/CSV to samo robi kolumna „Formuła” na liście wybranych pól. - Przeliczyć po kursie.
{CURRENCY_RATE_USD}wstawia bieżący kurs ze słownika walut — i do nagłówka szablonu, i do wnętrza formuły. Kurs jest wstawiany z zaokrągleniem do dwóch miejsc: dla walut o drobnym kursie (hrywna wobec dolara, tenge) wyraźnie zniekształca to przeliczenie.
Liczby zaokrąglają się same: pola typu „cena” — do dwóch miejsc, pola liczbowe — do czterech, waga — do dwóch. Na wynik formuły to się nie przekłada: trafia do pliku taki, jak policzyła go baza, dlatego zaokrąglenie pisz wewnątrz samej formuły.
Kod waluty w pliku jest zawsze jeden — waluty głównej konta. Ceny w katalogu są przechowywane w tej samej walucie, dlatego „sumowanie różnych walut” w eksporcie nie może się zdarzyć.
Błąd w formule zachowuje się różnie, a drugi przypadek jest groźniejszy. Jeśli formuła nie przeszła kontroli bezpieczeństwa, przebieg idzie dalej, a pola obliczane w pliku wychodzą puste.
Jeśli zaś w formule jest błąd składni — brak przecinka w IF, niezamknięty nawias — psuje się całe zapytanie do bazy. Plik w ogóle się nie tworzy, pod linkiem zostaje poprzedni plik, dziennik kończy się wierszem „Eksport danych NIE został zakończony: plik nie został utworzony”, a data eksportu na liście zostaje stara.
Marketplace, który sam pobiera plik według harmonogramu, nadal dostaje wtedy poprzedni plik — dla niego wygląda to jak „ceny się nie zmieniły”. Dlatego każdą poprawkę formuły sprawdzaj przyciskiem „Sprawdź”: widać tam i treść błędu, i fragment pliku.
Generator opisów: tabela atrybutów zamiast ręcznej pracy
Przycisk „Generator opisów” w sekcji „Dodatkowo” rozwiązuje osobne zadanie: złożyć opis produktu z jego atrybutów i przekazać go do eksportu już gotowy. Wygodne, gdy atrybuty w katalogu są wypełnione, a produkty nie mają pełnego opisu — tysiąca kart nikt nie będzie pisał ręcznie.
W oknie są dwa pola wyboru i pole szablonu. „Generator włączony” uruchamia działanie, „Filtr: pusty opis” zawęża je do produktów z pustym pełnym opisem — czyli nie rusza tego, co już napisano. Samo pole szablonu to z symbolami zastępczymi, z podświetlaniem i podpowiedziami pól katalogu.
Opis jest składany tylko w eksporcie: w karcie produktu pole „Pełny opis” zostaje takie, jakie było. Odznaczysz pole — następny przebieg pójdzie ze starym opisem, niczego nie trzeba przywracać.
Oprócz samych atrybutów do szablonu wstawia się pola produktu:
| Symbol zastępczy | Co wstawia |
|---|---|
{{ product_head.name }} | Nazwę produktu |
{{ product_head.mpn }} | Kod (SKU) producenta |
{{ product_head.ean }} | Kod kreskowy |
{{ product_head.description_short|raw }} | Krótki opis |
{{ product_head.description_full|raw }} | Pełny opis z karty |
{{ product_head.tag }} | Tagi produktu |
Dopisek |raw jest potrzebny tam, gdzie wartość sama zawiera HTML: bez niego tagi trafią do pliku jako tekst.
Edytor szablonu potrafi podpowiadać nazwy pól katalogu w nawiasach klamrowych — {Produkt BC: Nazwa} i podobne. W generatorze opisów one nie działają: rozumie on tylko symbole zastępcze z tabeli wyżej i same atrybuty. Wstawisz taką podpowiedź — zostanie w opisie jako tekst. Makra w nawiasach klamrowych działają w innych miejscach programu, na przykład w szablonie feedu XML.
Jeśli dla produktu wygenerowano stronę docelową, jej kod wstawia się do opisu konstrukcją {% if product_head.landing_url %}{{ product_head.landing_embed|raw }}{% endif %}. Nie trzeba jej wpisywać ręcznie: w samym oknie generatora ta konstrukcja jest gotowa, obok przycisk „Kopiuj konstrukcję”.
Warunek w środku nie jest przypadkowy — kod zostanie wstawiony tylko tym produktom, które naprawdę mają stronę docelową, i właśnie w języku eksportu.
Generator nie bierze każdego atrybutu produktu. Wiersz pojawi się tylko wtedy, gdy spełnione są wszystkie warunki:
- wartość atrybutu nie jest pusta;
- w słowniku atrybutów włączone są „Aktywność” i „Wyświetlać w sklepie na karcie produktu”;
- sam atrybut nie jest opcją produktu.
Dlatego atrybuty założone jako opcje — rozmiar, kolor — z zasady nie trafią do wygenerowanego opisu: opisują wariant, a nie produkt.
Scenariusze
Klient hurtowy chce cennik na e-mail, z RRP tam, gdzie jest
Co skonfigurować: „Dodaj” → „Plik cennika (XLSX, CSV)” → „Cennik (XLSX, CSV)”. Dla kolumny ceny w kolumnie „Formuła” wpisz warunek: jeśli „Cena sugerowana (RRP)” jest większa od zera — ona, w przeciwnym razie „Cena”. Wypełnij „Szablon newslettera”.
Efekt: po każdym przebiegu plik pójdzie jako załącznik w wiadomości według tego szablonu newslettera, w dzienniku pojawi się wiersz „Wysyłka wiadomości e-mail”. Czego nie będzie: narzutu nie będzie — tylko to, co daje formuła. Kategoria bez nazwy w języku eksportu wycina z tego cennika wszystkie swoje produkty, choć w feedach taka kategoria po prostu idzie bez nazwy.
Atrybuty są wypełnione, a produkty nie mają pełnego opisu
Co skonfigurować: w sekcji „Dodatkowo” karty szablonu otwórz „Generator opisów”, zaznacz „Generator włączony” i „Filtr: pusty opis”, w polu szablonu rozmieść atrybuty i symbole zastępcze.
Efekt: produkty z pustym pełnym opisem trafią do pliku z opisem złożonym z atrybutów. Opisy napisane ręcznie się nie zmienią. Czego nie będzie: w karcie produktu pole „Pełny opis” zostanie puste, a atrybuty-opcje nie trafią do opisu.
Marketplace potrzebuje starej ceny, żeby pokazać rabat
Co skonfigurować: w szablonie XML w tagu starej ceny, którego wymaga marketplace, wstaw makro {Produkt BC: Stara cena}.
Efekt: do pliku pójdzie wartość pola „Stara cena” z katalogu, zaokrąglona do dwóch miejsc. Czego nie będzie: produkt z pustym polem dostanie pusty tag — eksport niczego nie dolicza.
Na każdym marketplace cena ma pokrywać jego prowizję
Co skonfigurować: w szablonie każdego marketplace’u wstaw w tag ceny formułę z jego narzutem. Na przykład dla marketplace’u z prowizją 15% — [[ROUND({Produkt BC: Cena} * 1.15, 0)]], dla innego — własny mnożnik. W cenniku XLSX/CSV to samo wpisuje się w kolumnie „Formuła”. Po poprawce kliknij „Sprawdź” i zobacz cenę we fragmencie pliku.
Efekt: każdy marketplace dostaje swoją cenę, a katalog bazowy, sklep i pozostałe szablony zostają z dotychczasową ceną. Czego nie będzie: stawki prowizji program z marketplace’u nie pobiera — gdy się zmieni, mnożnik w szablonie zmieniasz sam.
Co zrobić, gdy w pliku jest nie ta cena
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Makra nie zostały rozpoznane i zostaną usunięte z pliku: ‹lista›” | W szablonie jest makro z błędem w nazwie pola | W edytorze szablonu naciśnij Ctrl+Space i wybierz pole z listy |
| W pliku cena (na przykład w tagu price_prom) wynosi 0 albo jest pusta | Eksport niczego nie dolicza: w polu, do którego odwołuje się tag szablonu, w karcie produktu naprawdę jest 0 albo pusto | Otwórz szablon i sprawdź, jakie pole stoi w tagu ceny; sprawdź to pole w karcie produktu; jeśli pole wypełnia formuła katalogu — najpierw ją zastosuj (cena w eksporcie) |
Najczęstsze pytania
Czy eksport dolicza narzut do ceny?
Nie. Do pliku idzie wartość pola dokładnie taka, jaka jest w katalogu bazowym. Inną cenę ustawia się albo formułą w szablonie, albo wcześniej — regułami wyceny przy aktualizacji katalogu z cenników dostawców.
Czy w szablonie eksportu można pisać {Produkt BC: …}?
Tak. W szablonie XML to zwykły sposób odwołania się do dowolnego pola katalogu bazowego, także do pól własnych: {Produkt BC: Cena sugerowana (RRP)}, {Produkt BC: ‹nazwa Twojego pola›}. Makro działa i w tekście szablonu, i wewnątrz formuły w podwójnych nawiasach kwadratowych.
Pojawia się „Makra nie zostały rozpoznane” albo w dodatkowym polu w eksporcie jest 0. Co jest nie tak?
Nazwa po dwukropku w {Produkt BC: Nazwa pola} musi zgadzać się z nazwą kolumny w tabeli produktów znak w znak. Nie wpisuj jej ręcznie: w edytorze szablonu naciśnij Ctrl+Space i wybierz pole. Jeśli makro zostało rozpoznane, a w pliku jest 0 — puste jest samo pole w produkcie.
Dlaczego w eksporcie według szablonu cena (na przykład price_prom) przychodzi jako zero?
W polu, do którego odwołuje się tag ceny, w karcie produktu naprawdę jest 0 albo pusto. Sprawdź w szablonie, jakie pole stoi w tagu, i sprawdź je w karcie produktu. Jeśli pole wypełnia formuła katalogu, najpierw ją zastosuj (formuły pól katalogu).
Dlaczego w wygenerowanym opisie nie ma rozmiaru i koloru?
Generator pomija atrybuty założone jako opcje produktu, a także te, które w słowniku mają wyłączone „Aktywność” lub „Wyświetlać w sklepie na karcie produktu” (generator opisów).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Eksport danych → karta szablonu
- Inne wejścia
- sekcja „Dodatkowo” karty szablonu → „Generator opisów”
- Uprawnienia
- okno „Szczegółowa konfiguracja szablonu eksportu”
- Przygotuj
- ceny i atrybuty produktów w katalogu bazowym
Powiązane tematy
- Jeśli potrzebny jest ogólny obraz eksportu — Jak skonfigurować eksport produktów.
- Jeśli błędna jest sama cena w katalogu — Reguły wyceny: tam liczony jest narzut. Jeśli ceny nie są jeszcze liczone automatycznie z cen dostawcy — co to daje Twojemu sklepowi.
- Jeśli pole produktu wypełnia formuła — Formuły pól katalogu.
- Jeśli piszesz szablon feedu XML — Eksport w formacie XML.
- Jeśli planujesz sprzedawać na marketplace’ach — co to daje Twojemu sklepowi.
