Elbuz publikuje Twój katalog feedem XML pod stałym linkiem, a Prom.ua pobiera go według harmonogramu — ceny i dostępność na marketplace aktualizują się bez ręcznego wgrywania plików.
Kiedy to się przyda:
- Ceny i dostępność zmieniają się codziennie — każdy przebieg składa feed od nowa, Prom bierze go spod tego samego linku.
- Pojawiły się nowe produkty — trafiają do feedu z własnym identyfikatorem, a Prom dodaje je jako nowe.
- Produkty mają rozmiary i kolory — warianty łączą się na Prom w jedną kartę.
- Katalog zepsuł się w nocy — reguła stop nie nadpisze feedu, w którym zniknęła dostępność.
- Promocja — stara cena jest przekreślona.
Od czego zacząć: utwórz szablon „prom.ua (XML)” i wklej link do pliku w panelu Prom.
Co potrafi feed XML dla Prom
- Stały link — Prom sam pobiera spod niego feed, nie trzeba ręcznie wgrywać pliku.
- Identyfikator produktu — ten sam co w pliku , więc pozycje się nie duplikują.
- Edytowalny szablon XML — skład oferty dopasowujesz do wymagań Prom.
- Cechy i warianty — przekazywane elementami
paramigroup_id. - Dostępność jako atrybut — produkt bez stanu zostaje w feedzie z
available="false". - Harmonogram i reguły stop — feed aktualizuje się bez Ciebie i nie zostaje nadpisany zepsutym.
Jak skonfigurować feed
Prom XML to standardowy feed XML: w korzeniu yml_catalog, w środku — blok kategorii i blok ofert (offers). Feed żyje pod adresem: po aktualizacji katalogu w Elbuz pod tym samym linkiem leżą świeże dane.
- Utwórz szablon eksportu i wybierz format „prom.ua (XML)”.
- Określ, które produkty eksportować: cały katalog, wybrane kategorie lub według reguł wyboru.
- W razie potrzeby popraw skład
offerw sekcji „Szablon XML”. - Kliknij „Sprawdź” — zobaczysz jeden produkt w takiej postaci, w jakiej trafi do feedu.
- Uruchom eksport i skopiuj link z kolumny „Plik” do panelu Prom (albo przekazuj plik na ).
- Ustaw harmonogram w „Ustawienia harmonogramu”, a w panelu Prom — jak często marketplace pobiera feed.
Przy pierwszych kilku przebiegach zajrzyj do dziennika i do panelu Prom: czy feed powstaje bez błędów i czy produkty się zaktualizowały.
Oficjalny opis formatu feedu — w pomocy Prom: import przez XML — format pliku. Ogólny dział wymiany — import i eksport.
Co trafia do feedu
Każdy produkt to jeden offer. Zestaw elementów można zmieniać w szablonie; domyślnie wygląda tak:
| Element XML | Co zawiera |
|---|---|
offer id="…" available="…" group_id="…" | id — identyfikator produktu (Twój UUID); available — bieżąca dostępność; group_id — powiązanie wariantu z produktem głównym |
url | link do produktu |
price / currencyId | cena i waluta |
categoryId | identyfikator kategorii produktu |
picture (do 10 szt.) | zdjęcia; dla Prom liczba zdjęć jest ograniczona do dziesięciu |
name | nazwa produktu |
vendor / vendorCode | producent i kod () |
description | opis produktu |
param name="…" unit="…" | cechy (atrybuty): nazwa, jednostka miary i wartość |
Kategorie domyślnie niosą Twoje identyfikatory: w kategorii id="{uuid}" z powiązaniem z nadrzędną, w produkcie — ten sam klucz w categoryId. Żeby przekazywać numer kategorii samego Prom, są podstawienia {category_id_prom} i {category_name_prom}: biorą wartości wypełnione przy dopasowaniu do słownika marketplace’u.
Identyfikator — ten sam UUID co w XLSX
id oferty to nasz UUID produktu, ten sam klucz, który trafia do kolumny «Ідентифікатор_товару» (identyfikator produktu) pliku XLSX. Prom rozpoznaje produkt po id i aktualizuje istniejącą pozycję; nowy produkt z własnym UUID dodaje jako nowy. Formaty ze sobą nie kolidują. Dlaczego to chroni przed duplikatami — Jak Elbuz aktualizuje produkty na Prom bez duplikatów.
Nie ruszaj w szablonie atrybutu id="{uuid}": to klucz synchronizacji, a ręczna zmiana spowoduje duplikowanie pozycji na Prom.
Jeśli id oferty jednak zmieniono
- Przywróć w szablonie atrybut do postaci
id="{uuid}"— tak stoi w szablonie domyślnie. - Kliknij „Sprawdź”: w
idmusi stać ten sam długi identyfikator co w kolumnie «Ідентифікатор_товару» eksportu XLSX. - Uruchom eksport. Następny feed znów będzie odwoływał się do tych samych kart co przed błędem.
Karty, które zdążyły powstać na Prom z innym id, usuwa się w panelu Prom: w feedzie nie ma poleceń usuwania.
Skąd bierze się opis
Domyślnie do feedu trafia pole „Opis pełny” z karty: <description>{description_full}</description>. Znaczniki HTML są przy tym escapowane i tagi trafiają do pliku jako tekst.
- Żeby przekazać bez zmian, owiń podstawienie w CDATA:
<description><![CDATA[{description_full}]]></description>. - Żeby przekazać inny tekst, zamień podstawienie w sekcji „Szablon XML” na inne pole, np.
{description_short}(„Opis krótki”), albo na własny tekst.
Cechy i warianty
Cechy wychodzą jako elementy param z atrybutami name i unit. Ukraińskie nazwy i wartości wyprowadza się własnym szablonem wiersza atrybutu z makrami {Атрибут: Название_ua} i {Атрибут: Значение_ua}.
Warianty łączy group_id: Prom składa je w jedną kartę z wyborem wariantu. Dla Prom do feedu trafiają same warianty (z zaznaczonym „Opcje” w szablonie), a produkt główny, który ma warianty, jest pomijany.
Cena promocyjna i stara przekreślona cena na Prom
Żeby klient na Prom widział starą cenę przekreśloną, a obok nową, offer musi mieć dwie ceny: <price> — cena po rabacie, <oldprice> — cena bez rabatu. Szablon „prom.ua (XML)” domyślnie przekazuje tylko jedną cenę <price>{price}</price>, więc rabatu na Prom nie ma, dopóki nie dodasz drugiego tagu.
Jak przekazać rabat z Elbuz
- Ustaw ceny promocyjne regułami „Promocje/Rabaty” albo ręcznie w karcie produktu. Cena promocyjna trafia do pola katalogu „Cena promocyjna” (
{price_special}). W regule rabatu wpisz procent ze znakiem minus (-7) i nie zaznaczaj flagi „Od ilości (hurt)” — tworzy ona cenę zależną od ilości, która nie trafia do feedu. - Kliknij w oknie reguł „Zastosuj reguły do produktów” i upewnij się, że w tabeli produktów kolumna „Cena promocyjna” się wypełniła.
- W karcie szablonu, sekcja „Szablon XML”, zamień wiersz
<price>{price}</price>na dwa:<price>[[IF({price_special}>0 AND {price_special}<{price}, ROUND({price_special}, 2), ROUND({price}, 2))]]</price> <oldprice>[[IF({price_special}>0 AND {price_special}<{price}, ROUND({price}, 2), '')]]</oldprice> - Kliknij „Sprawdź” na produkcie z promocją: w
pricemusi być cena promocyjna, woldprice— zwykła. Na produkcie bez promocjipricejest zwykła, aoldpricepusty. - Uruchom eksport. Prom odczyta rabat przy najbliższej aktualizacji przez link (jak często Prom pobiera feed).
1
Wiersz price2
Wiersz oldprice- Wiersz price bierze cenę promocyjną, gdy jest niższa od zwykłej.
- Wiersz oldprice wyprowadza zwykłą cenę tylko wtedy, gdy działa cena promocyjna.
1
Sprawdzono na produkcie2
<price>902.00</price>3
<oldprice>1002.00</oldprice>- Sprawdzono na produkcie — próbny eksport wykonano na produkcie #177722, tym z ceną promocyjną.
- Wiersz price zawiera cenę promocyjną 902.00.
- Wiersz oldprice zawiera zwykłą cenę 1002.00, którą marketplace pokazuje jako przekreśloną.
Warunek {price_special}<{price} chroni przed dwoma błędami: przed „rabatem”, który w rzeczywistości jest droższy od zwykłej ceny, i przed przekreśloną ceną w produktach bez promocji. ROUND(…, 2) jest potrzebny, bo w blokach obliczeniowych [[…]] cena ułamkowa wychodzi inaczej z ogonem zer: 699.50000000.
Jak Prom czyta ceny — reguły marketplace’u
| Tag | Co oznacza dla Prom |
|---|---|
price | Cena od 0,01 do 9 999 999 999 — zwykła lub już po rabacie. Obowiązkowy, jeśli jest oldprice. |
oldprice | Cena bez rabatu — to ona będzie przekreślona. Prom przyjmuje też zapis price_old i old_price, ale oldprice ma pierwszeństwo. |
discount | Inny sposób: rabat procentowy (30%) lub kwotowy (20) od price. Jeśli offer ma też oldprice, discount jest ignorowany. |
available | Rabat działa tylko dla produktu dostępnego. Produkt niedostępny lub bez available dostaje jako cenę wartość z oldprice — bez rabatu. |
W pomocy Prom napisano wprost: przy imporcie przez link data rabatu nie jest przekazywana, a rabat ustawia się na stronie na 45 dni. W XML nie ma osobnego tagu dla dat rabatu. Dlatego okres promocji na Prom zależy nie od daty, lecz od zawartości feedu: dopóki produkt ma oldprice, rabat jest; gdy oldprice zniknął — Prom dostaje zwykłą cenę. Jeśli potrzebujesz dokładnych dat rabatu po stronie Prom, przekazuj ręcznie plik XLSX z kolumnami okresu rabatu.
Co dzieje się na Prom od początku do końca promocji
| Moment | Co w Elbuz | Co w feedzie | Co na Prom |
|---|---|---|---|
| Reguła zastosowana | „Cena promocyjna” wypełniona | price — promocyjna, oldprice — zwykła | po najbliższej aktualizacji: stara cena przekreślona, nowa obok |
| Dostawca zmienił cenę | aktualizacja wsadowa przelicza promocję od nowej ceny | obie ceny nowe | ceny aktualizują się z tym samym procentem rabatu |
| Produkt się skończył | status dostępności się zmienił | available="false" | rabat nie działa, ceną staje się oldprice |
| Minęła „Data zakończenia” reguły | przy następnym zastosowaniu reguł „Cena promocyjna” jest zerowana, reguła się wyłącza | price — zwykła, oldprice pusty | po najbliższej aktualizacji zwykła cena bez przekreślenia |
| Regułę wyłączono lub usunięto | „Cena promocyjna” jest zerowana od razu | jak wyżej | jak wyżej |
Zastosowanie reguł uruchamiają: przycisk w oknie reguł, aktualizacja wsadowa cenników, zapis karty produktu i zmiana ceny w tabeli. Przeterminowane promocje usuwa każde zastosowanie w całym katalogu, więc przy codziennej aktualizacji cenników koniec promocji zadziała sam. Jeśli w ciągu dnia nie było żadnego zastosowania, następnego dnia po dacie zakończenia kliknij „Zastosuj reguły do produktów” — w sam dzień zakończenia promocja jeszcze obowiązuje. Cena wpisana ręcznie w karcie zostaje do własnej daty zakończenia. Szczegóły — daty promocji.
Inne źródła starej ceny
- Stała przekreślona cena bez promocji — np. cena sugerowana dostawcy:
<oldprice>[[IF({price_rrp}>{price}, ROUND({price_rrp}, 2), '')]]</oldprice>. Wtedypricezostaje{price}. - Pole „Stara cena” (
{price_old}) — podstawiaj tylko wtedy, gdy sam prowadzisz je jako cenę przed rabatem. Aktualizacja wsadowa cenników sama zapisuje w nim poprzednią cenę przy każdej zmianie, więc pole bywa równe lub nawet niższe od bieżącej — przekreślenia wtedy nie będzie albo będzie nieprawdziwe. - Rabat procentowy zamiast dwóch cen:
<discount>7%</discount>obok zwykłego<price>{price}</price>. Procent można brać z pola produktu przez podstawienie{Produkt BC: nazwa pola}.
Przewodnik po tagach Prom XML i podstawieniach Elbuz
Wszystkie tagi, które Prom przyjmuje w pliku XML, według pomocy Prom, i czym je wypełnić w szablonie Elbuz. Tagi, których nie ma w pomocy, Prom przy imporcie ignoruje. W węźle produktu działa każde pole katalogu — podstawieniem {kod_pola} lub {Produkt BC: Nazwa pola}; wynik sprawdzaj przyciskiem „Sprawdź”.
Grupy (kategorie)
| Tag / atrybut | Co oznacza dla Prom | Podstawienie Elbuz |
|---|---|---|
category id | obowiązkowy identyfikator grupy | {uuid} lub {category_id} kategorii |
parentId | grupa nadrzędna — zagnieżdżona struktura w panelu | identyfikator kategorii nadrzędnej |
portal_id | numer kategorii marketplace’u Prom dla produktów grupy; ważniejszy niż portal_url | {category_id_prom} |
portal_url | link do kategorii marketplace’u | — |
Produkt (offer)
| Tag / atrybut | Co oznacza dla Prom | Podstawienie Elbuz |
|---|---|---|
offer id | obowiązkowy; po nim Prom aktualizuje pozycję przy kolejnych importach | {uuid} — nie zmieniaj (dlaczego) |
available | true — dostępny, false lub puste — niedostępny; bez niego rabat nie działa | {xml_stock_status} |
in_stock | true — status „Готово до відправки” (gotowe do wysyłki) | stała true, jeśli tak pracujesz |
selling_type | r — detal, w — hurt, u — hurt i detal, s — usługa; bez niego Prom ustawia detal | stała, np. r |
group_id | liczba od 1 do 999 999 999, która łączy warianty w jedną kartę | {id_parent} (warianty) |
type="vendor.model" | nazwa składa się z typePrefix + vendor + model, a name jest ignorowany | zwykle niepotrzebny |
name | obowiązkowa nazwa | {name} |
name_ua | nazwa po ukraińsku; aktualizuje się tylko razem z description_ua | {name_ua} — tylko gdy szablon eksportuje w innym języku; jeśli język szablonu to ukraiński, bierz {name} |
typePrefix / model | przedrostek nazwy i model — tylko z vendor.model | {model} |
categoryId | obowiązkowy identyfikator grupy z bloku kategorii | {category_uuid} |
portal_category_id | kategoria marketplace’u dla produktu; ważniejsza niż portal_category_url i portal_id grupy | {category_id_prom} |
price | cena lub cena po rabacie | {price} lub formuła z ceną promocyjną |
oldprice (price_old, old_price) | cena bez rabatu, będzie przekreślona | formuła z {price} |
discount | rabat procentowy lub kwotowy, działa 45 dni | stała lub pole produktu |
currencyId | waluta ceny: UAH, USD, EUR, KZT, BYR | {currency_code} |
prices → price → value + quantity | ceny hurtowe dla typów w i u | ceny zależne od ilości z reguł z flagą „Od ilości (hurt)” nie trafiają do feedu — tylko własnym szablonem z pól produktu |
minimum_order_quantity | minimalne zamówienie dla produktów sprzedawanych tylko hurtowo | {order_minimum} |
quantity_in_stock (stock_quantity) | ilość w magazynie; quantity_in_stock ma pierwszeństwo | {quantity} |
picture | od 1 do 10 linków do zdjęć | {image_list} |
vendor | producent; importuje się tylko, jeśli jest w bazie producentów Prom | {manufacturer_name} |
vendorCode (barcode, article) | kod do 25 znaków: cyfry, litery, - _ . / i spacja | {mpn} lub {sku} |
country | kraj produkcji | cecha {attribute_ID} lub własne pole |
param name unit | cecha; do 100 na produkt; kilka wartości — przez | | {attribute_list} |
dimensions: weight (kg), width, height, length (cm) | waga i wymiary | {weight}, {width}, {height}, {product_length} |
description | obowiązkowy opis; HTML — tylko wewnątrz CDATA | {description_full} (skąd opis) |
description_ua | opis po ukraińsku; aktualizuje się tylko razem z name_ua | {description_full_ua} — tak samo; przy ukraińskim języku szablonu — {description_full} |
keywords / keywords_ua | frazy wyszukiwania po przecinku, do 1024 znaków | {tag} lub {meta_keyword} |
regions → region | lokalizacja produktu, do trzech miejscowości z listy Prom | stała |
gtin / mpn | kod kreskowy i numer producenta dla feedu Google Merchant | {ean} / {mpn} |
Znaki ", &, >, <, ' w tekście feedu muszą być zastąpione kodami. Elbuz zastępuje je w zwykłych podstawieniach pól. Nie zastępuje — w wyniku bloków obliczeniowych [[…]] i w opisie wewnątrz CDATA: jeśli formuła zwraca tekst z takimi znakami, owiń tag w CDATA. HTML w opisie przekazuj tylko w CDATA.
Co nadpisuje każdy przebieg
Feed nie jest dopisywany — za każdym razem składa się od zera. W każdym pliku jest bieżąca wartość z Elbuz dla każdego elementu szablonu: cena, dostępność, nazwa, opis, cechy, zdjęcia. Elbuz nie pyta Prom, co poprawiono tam ręcznie.
Żeby zostawić pole dla siebie, usuń jego element z „Szablon XML”: czego nie ma w szablonie, tego nie ma też w pliku. Osobnego pola wyboru „nie ruszaj tego pola” nie ma. Co Prom robi z polami, których w feedzie nie ma, określa marketplace.
Pole wyboru „Eksportować tylko nowe dane”
Gdy jest zaznaczone, do pliku trafiają tylko produkty bez flagi „Wyeksportowano”. Flaga jest ustawiana na końcu udanego przebiegu produktom, które trafiły do pliku, i zdejmowana, gdy tylko produkt się zmieni — w karcie lub w tabeli.
Flaga jest jedna na produkt i wspólna dla wszystkich szablonów: jeśli pole jest zaznaczone w dwóch szablonach, drugi nie dostanie produktów oznaczonych przez pierwszy. Dla stałego feedu to pole jest zwykle zbędne — pod linkiem nie będzie całego asortymentu, tylko to, co zmieniło się od poprzedniego przebiegu.
Kiedy produkt znika z feedu
Produkt nie trafia do pliku, jeśli nie przeszedł wyboru szablonu: flaga „Eksportuj do pliku (do sklepu)”, aktywna kategoria, filtr, wybrane kategorie, sklep, magazyn. Pełna lista — dlaczego produkt nie trafił do pliku. Dla feedu Prom są jeszcze dwa powody:
- zaznaczono „Eksportować tylko nowe dane”, a produkt jest już oznaczony jako wyeksportowany;
- to produkt główny z wariantami: jest pomijany zawsze, a warianty idą tylko z zaznaczonym „Opcje”.
Zerowy stan nie usuwa produktu z feedu. Domyślnie available="true" dostaje tylko status „Dostępny”, pozostałe statusy — available="false", a produkt zostaje w pliku. Co przekazywać dla każdego statusu, ustawia się w oknie „Ustawienia aktualizacji według dostępności produktu” z karty szablonu.
Masowe znikanie wyłapują reguły stop: domyślnie ostrzegają, jeśli dostępność spadła o ponad 30%, łączna liczba — o ponad 50% albo nie ma nic do eksportu. W trybie „Zatrzymaj eksport” plik nie zostanie nadpisany. Szczegóły — Reguły stop.
1
Próg2
Tryb3
Podsumowanie przed eksportem- Próg — wielkość zmiany, przy której reguła zadziała.
- Tryb — co system robi, gdy reguła zadziała.
- Przełącznik, który pokazuje podsumowanie przed startem eksportu.
Co sam Prom robi z pozycjami, których zabrakło w feedzie, to reguła marketplace’u.
Harmonogram, dziennik i link do feedu
Uruchomienie, podsumowanie przed uruchomieniem, harmonogram i dziennik działają tak samo dla wszystkich szablonów — Uruchomienie ręczne i według harmonogramu, Dziennik przebiegu. Poniżej — co warto wiedzieć właśnie o feedzie Prom.
Jak przebiega eksport
- Podsumowanie przed eksportem i reguły stop: w trybie „Zatrzymaj eksport” plik nie jest w ogóle ruszany.
- Kategorie („Eksport kategorii produktów”), jeśli są włączone w szablonie.
- Produkty: co 500 produktów w dzienniku pojawia się wiersz „Eksport produktów 500 z 12 340”.
- Plik trafia najpierw na FTP (jeśli wypełniono „Ustawienia FTP”), potem do magazynu plików; stare pliki szablonu są usuwane dopiero po przesłaniu nowego.
- W szablonie zapisują się link, rozmiar i data; ostatni wiersz — „Eksport danych zakończony”.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Jeśli przebieg się przerwał
Niedokończonego feedu Prom nie dostanie: publikacja to ostatnie działanie przebiegu. Oznaki przerwania — data w „Ostatni eksport” się nie przesunęła, a w dzienniku jest „Eksport danych NIE został zakończony: plik nie został utworzony” lub „Eksport przerwany przez użytkownika!”. Przycisk „Stop” przerywa feed Prom na najbliższym produkcie.
- Żaden produkt nie pasował — plik nie jest nadpisywany, pod linkiem jest poprzedni.
- Plik nie trafił do magazynu — w dzienniku „Plik nie został przesłany do magazynu plików w chmurze…”. Na FTP nowy plik już leży: trafia tam wcześniej.
Powtarzanie jest bezpieczne: plik składa się od zera, a flaga „Wyeksportowano” jest ustawiana dopiero na końcu udanego przebiegu. Zawieszony harmonogram strażnik odblokowuje, gdy od startu minęła godzina, a oznak życia nie ma od ponad pół godziny.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Jak sprawdzić, co zadziałało
Na liście szablonów wynik widać bez otwierania karty: „Ostatni eksport”, „Dostępny” z różnicą względem poprzedniego przebiegu i „Plik” z przyciskiem „Kopiuj link” oraz rozmiarem. Prawie pusty feed widać już po rozmiarze.
1
Ostatni eksport2
Dostępny3
Plik- „Ostatni eksport” — data i godzina ostatniego przebiegu eksportu.
- „Dostępny” — ile produktów trafiło do pliku.
- „Plik” — nazwa pliku, przycisk kopiowania linku i rozmiar pliku.
Przycisk „Sprawdź” pokazuje gotowy offer jednego produktu i błędy: niepoprawny XML, błąd w formule, nierozpoznane makra. W przebiegu produkcyjnym nierozpoznane makro jest wycinane bez komunikatu, a węzeł wychodzi pusty. Czy nazwy, kategorie i cechy odpowiadają Prom, decyduje sam Prom przy imporcie.
Jak często Prom pobiera feed
Harmonogram Elbuz tylko umieszcza świeży plik pod linkiem. Kiedy Prom go odczyta, decyduje sam marketplace — według pomocy Prom:
- Cena, dostępność, ilość i rabat aktualizują się co 4 godziny, od 6:00 do 22:00; dokładna godzina zależy od obciążenia Prom.
- Pozostałe pola i nowe produkty — raz na dobę, w nocy.
- W ustawieniach importu w panelu Prom można odznaczyć pola, których marketplace nie ma aktualizować, i określić, co robić z produktami, których nie ma w pliku.
- Opcje „Оновити примусово” (wymuś aktualizację) i „Тільки оновлення” (tylko aktualizacja) nie działają dla okresowego importu przez link — tylko dla ręcznego uruchomienia.
- Jeśli plik jest niedostępny przez kilka dni z rzędu, 4. dnia Prom wysyła e-mail, a 6. dnia wyłącza okresowy import. Link w panelu zostaje — import trzeba włączyć ponownie.
Dlatego aktualizowanie feedu w Elbuz częściej niż co kilka godzin nie ma sensu: Prom i tak weźmie najświeższy plik w swoim oknie.
Wyłączyć szablon czy usunąć
- Wyłączony szablon nie uruchamia się według harmonogramu ani w przebiegu zbiorczym, bez wiersza w dzienniku. Pod linkiem zostaje ostatni feed, już nieaktualny. Przyciskiem „Eksportuj” można go uruchomić ręcznie.
- Usunięcie kasuje tekst szablonu XML, wybór, statusy dostępności, FTP i harmonogram. Przywrócić można tylko nowym szablonem z nowym linkiem.
Limity i liczby
- Limitu liczby produktów nie ma. Na koncie demo — 100 produktów, jest o tym wiersz w dzienniku.
- Zdjęcia — do dziesięciu na produkt. Mniej ustawia się w polu „Maksymalna liczba zdjęć” karty szablonu.
- Harmonogram — od godziny. Opcji „co minutę” w kreatorze harmonogramu nie ma.
- Przebieg zbiorczy — po kolei. „Eksportuj wszystkie szablony” bierze aktywne szablony jeden po drugim.
- Każdy szablon ma własny link, nawet przy takiej samej nazwie pliku.
- Rozmiar feedu dla Prom — do 180 MB (zalecenie marketplace’u). Większy katalog podziel na kilka szablonów według kategorii i dodaj w panelu Prom kilka linków.
Nie wstawiaj do nazwy pliku podstawień {DATE}, {DATETIME} ani {TIME}. Nazwa zmienia się wtedy przy każdym przebiegu, a poprzednia kopia jest kasowana — link w panelu Prom przestanie działać już następnego dnia.
XML czy XLSX — kiedy który
Do codziennej automatycznej aktualizacji cen i dostępności wygodniejszy jest feed XML: Prom pobiera go sam. Do pełnej wymiany ze wszystkimi kolumnami Prom — plik XLSX. Klucz produktu jest w nich taki sam, więc można wgrać katalog plikiem, a dalej utrzymywać go aktualnym feedem. Porównanie i to, co się dzieje, gdy te same produkty idą obiema drogami — XLSX czy XML.
Feed działa w jedną stronę: z Prom do Elbuz niczego nie pobiera. Do tego służy import XLSX (Prom/EVO).
Scenariusze
Codziennie aktualne ceny i dostępność na Prom
Co włączyć. Szablon w formacie „prom.ua (XML)”, harmonogram w „Ustawienia harmonogramu”, a link z kolumny „Plik” — w panelu Prom. Pole „Eksportować tylko nowe dane” zostaw odznaczone.
Efekt. Każdy przebieg składa plik od zera z bieżącymi cenami i statusami, a pod tym samym linkiem pojawia się nowy plik. Produkt bez stanu zostaje w pliku z available="false".
Czego nie będzie. Feed nie usuwa pozycji na Prom: w pliku nie ma polecenia „usuń”.
Sprzedaż na Prom tylko części asortymentu
Co włączyć. Wybierz dla szablonu potrzebne kategorie, a węższy wybór ustaw na karcie „Ograniczenie eksportu (filtr)”. Pojedynczy produkt lub kategorię wyłącza się flagą „Eksportuj do pliku (do sklepu)” w ich kartach.
Efekt. Do pliku trafia tylko to, co przeszło wybór. Podsumowanie przed eksportem liczy produkty według tego samego filtra.
Czego nie będzie. Produkty, które wypadły z wyboru, nie są usuwane z Prom — feed po prostu przestaje je zawierać.
Produkty z rozmiarami i kolorami
Co włączyć. Pole „Opcje” w szablonie.
Efekt. Każdy wariant idzie osobnym offer z group_id produktu głównego. Sam produkt główny do feedu dla Prom nie trafia.
Czego nie będzie. Bez zaznaczonego „Opcje” warianty nie trafiają do pliku, a produkt główny i tak jest pomijany — taki produkt znika z feedu całkowicie.
Nie przekazać Prom pustego feedu przez awarię katalogu
Co włączyć. Zaznacz szablon na liście, w menu „Dodatkowe operacje” otwórz „Reguły stop eksportu”, dla wybranej reguły ustaw „Zatrzymaj eksport” i kliknij „Zapisz dla tego szablonu”.
Efekt. Jeśli dostępność lub liczba produktów spadła ponad próg względem poprzedniego udanego przebiegu, przebieg zatrzymuje się jeszcze przed składaniem pliku — ręczny i według harmonogramu. Pod linkiem zostaje poprzedni feed.
Czego nie będzie. Zatrzymany lub niedokończony przebieg nie staje się nowym punktem porównania: jest nim tylko udany eksport.
Nazwy i opisy poprawiasz w panelu Prom, z Elbuz potrzebujesz tylko ceny i dostępności
Co włączyć. Usuń z „Szablon XML” elementy, których nie chcesz przekazywać — np. opis. Atrybutu id="{uuid}" nie ruszaj.
Efekt. Usuniętego elementu w pliku nie ma.
Czego nie będzie. Elbuz nie wie, co zmieniasz na Prom. Jak marketplace traktuje pola, których nie ma w feedzie, to reguła samego Prom.
Promocja minus 7% na kategorię do końca miesiąca z przekreśloną ceną
Co włączyć. W „Promocje/Rabaty” reguła: „%” -7, flaga „Od ilości (hurt)” odznaczona, w „Dodatkowy filtr” — kategoria, „Data zakończenia” — ostatni dzień miesiąca. Zastosuj reguły. W szablonie Prom zamień wiersz ceny na parę price + oldprice z sekcji o cenie promocyjnej.
Efekt. Produkty z kategorii mają w feedzie price o 7% niższy niż oldprice. Po najbliższej aktualizacji przez link Prom pokazuje starą cenę przekreśloną. Po dacie zakończenia następne zastosowanie reguł zeruje „Cena promocyjna”, a feed przekazuje zwykłą cenę bez oldprice.
Czego nie będzie. Prom nie widzi daty zakończenia z feedu — rabat trzyma się na nim, dopóki niesie go feed; Prom domyślnie ustawia rabatowi okres 45 dni. Przeterminowaną promocję usuwa każde zastosowanie reguł; jeśli w ciągu dnia go nie było, kliknij przycisk zastosowania następnego dnia po dacie zakończenia.
Promocja ma zacząć się w poniedziałek
Co włączyć. Reguła z „Data rozpoczęcia” — poniedziałek. W poniedziałek zastosuj reguły przyciskiem (albo poczekaj na aktualizację wsadową cenników, która obejmie te produkty).
Efekt. Do daty rozpoczęcia „Cena promocyjna” się nie wypełnia, więc w feedzie jest zwykła cena. Zastosowanie w dniu rozpoczęcia ustawia cenę promocyjną i trafia ona do feedu.
Czego nie będzie. Promocja nie włączy się sama dokładnie o północy: potrzebne jest zastosowanie reguł tego dnia.
Pokazywanie na Prom przekreślonej ceny sugerowanej dostawcy
Co włączyć. Zostaw <price>{price}</price> i dodaj <oldprice>[[IF({price_rrp}>{price}, ROUND({price_rrp}, 2), '')]]</oldprice>.
Efekt. Produkty, których RRP (sugerowana cena detaliczna) jest wyższa od Twojej ceny, dostają na Prom przekreśloną RRP. Pozostałe — bez przekreślenia.
Czego nie będzie. Prom daje takiemu „rabatowi” ten sam okres 45 dni. Jeśli produkt jest niedostępny, ceną na Prom stanie się oldprice, czyli RRP.
Rabat procentowy bez liczenia dwóch cen
Co włączyć. Obok zwykłej ceny dodaj <discount>10%</discount> — jako stałą lub z pola produktu, jeśli procent jest różny.
Efekt. Prom sam liczy cenę po rabacie od price i pokazuje obie.
Czego nie będzie. Jeśli w tym samym offer jest oldprice, Prom ignoruje discount. Katalog Elbuz nic o takim rabacie nie wie: na Twojej stronie i w innych feedach go nie ma.
Co zrobić, gdy feed się nie zaktualizował
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Eksport danych NIE został zakończony: plik nie został utworzony” | Żaden produkt nie spełnił warunków szablonu, formuła w szablonie zepsuła zapytanie albo plik nie trafił do magazynu — wtedy wyżej w dzienniku jest „Plik nie został przesłany do magazynu plików w chmurze…” | Jeśli plik nie trafił do magazynu — uruchom eksport jeszcze raz. W przeciwnym razie kliknij „Sprawdź”: wskaże błąd formuły lub podstawienia. Dalej sprawdź wybór (kiedy produkt znika z feedu) |
| „Eksport zatrzymany przez regułę stop: …” | Produktów lub dostępności jest wyraźnie mniej niż w poprzednim udanym przebiegu | Sprawdź statusy dostępności w katalogu bazowym; jeśli liczby są prawidłowe — podnieś próg w oknie „Reguły stop eksportu” (kiedy produkt znika z feedu) |
| „Anulowano eksport według harmonogramu, powód: eksportowany jest inny szablon (konflikt przetwarzania danych)” | Dwa eksporty według harmonogramu nie uruchamiają się jednocześnie | Rozłóż szablony w czasie w „Ustawienia harmonogramu” (jeśli przebieg się przerwał) |
W feedzie są puste węzły: <name></name> |
Podstawienie zapisano z błędem — takie są wycinane z pliku bez ostrzeżenia | „Sprawdź”: w uwagach będzie „Makra nie zostały rozpoznane i zostaną usunięte z pliku” (jak sprawdzić, co zadziałało) |
| Do pliku trafiła tylko część asortymentu | Zaznaczono „Eksportować tylko nowe dane”, a pozostałe produkty są już oznaczone jako wyeksportowane | Odznacz pole w sekcji „Co eksportować” i uruchom przebieg jeszcze raz (tylko nowe dane) |
| Link wpisany w panelu Prom przestał się otwierać | W nazwie pliku jest {DATE} lub {DATETIME}: przy każdym przebiegu powstaje nowy plik, a stary jest kasowany |
Usuń podstawienie z nazwy pliku, wyeksportuj ponownie i wpisz w panelu nowy link (limity i liczby) |
| Promocję w Elbuz skonfigurowano, a na Prom nie ma przekreślonej ceny | W szablonie jest tylko <price>{price}</price>; albo „Cena promocyjna” jest pusta — reguł nie zastosowano lub reguła ma flagę „Od ilości (hurt)”; albo produkt jest niedostępny; albo Prom jeszcze nie zaktualizował feedu |
Dodaj parę price + oldprice (jak), sprawdź kolumnę „Cena promocyjna” w tabeli, kliknij „Sprawdź” na produkcie z promocją i poczekaj na najbliższą aktualizację Prom (co 4 godziny od 6:00 do 22:00) |
| Po regule „promocji” cena wyszła wyższa od zwykłej | W kolumnie „%” reguły jest liczba dodatnia — to narzut, a nie rabat | Wpisz procent ze znakiem minus (-7) i zastosuj reguły ponownie (jak liczona jest cena) |
| Promocja się skończyła, a na Prom nadal jest przekreślona cena | Reguł po dacie zakończenia jeszcze nie zastosowano — w „Cena promocyjna” jest stara wartość; albo Prom jeszcze nie pobrał nowego feedu | Kliknij „Zastosuj reguły do produktów”, wyeksportuj feed i sprawdź, czy oldprice jest pusty. Prom zaktualizuje cenę w najbliższym oknie aktualizacji — co 4 godziny od 6:00 do 22:00 |
W feedzie cena w postaci 699.50000000 |
Cenę podstawiono w bloku obliczeniowym [[…]] bez zaokrąglenia |
Owiń pole w ROUND({price}, 2) |
Najczęstsze pytania
Jaki identyfikator produktu jest w feedzie XML?
Atrybut id oferty to UUID produktu w Elbuz, ten sam klucz co identyfikator produktu (Ідентифікатор_товару) w XLSX. Dlatego Prom aktualizuje pozycje bez duplikatów.
Jak Prom odczyta nowe produkty z feedu?
Nowy produkt trafia do feedu z własnym UUID w id. Prom widzi nieznany identyfikator i dodaje produkt jako nowy, a istniejące pozycje aktualizuje.
Dlaczego w feedzie nie ma wszystkich zdjęć produktu?
Dla Prom liczba zdjęć w feedzie jest ograniczona do dziesięciu na produkt — to wymóg marketplace’u. Pierwsze zdjęcie jest uznawane za główne.
Czy trzeba za każdym razem eksportować feed ręcznie?
Nie. Ustaw harmonogram szablonu, a Prom pobiera feed przez link z własną częstotliwością. Dalej katalog na Prom aktualizuje się sam.
Jak przekazywane są warianty produktu?
Przez atrybut group_id: Prom składa je w jedną kartę z wyborem wariantu. Do feedu trafiają same warianty z zaznaczonym „Opcje”, a produkt główny jest pomijany.
Co się stanie, jeśli eksport przerwie się w połowie?
Pod linkiem zostanie poprzedni plik: nowy trafia do magazynu dopiero w całości. Ponowne uruchomienie jest bezpieczne — plik za każdym razem składa się od zera.
Co daje wyłączenie szablonu?
Szablon nie uruchamia się według harmonogramu ani w przebiegu zbiorczym, ale pod linkiem zostaje ostatni feed, już nieaktualny. Po przywróceniu stanu „Aktywny” ustawienia nie giną.
Które pole produktu trafia do opisu (description) feedu Prom i jak podstawić własne?
Domyślnie — „Opis pełny” ({description_full}), tagi HTML są escapowane. Żeby przekazać HTML bez zmian, owiń podstawienie w CDATA; dla innego tekstu zamień je w „Szablon XML” (skąd bierze się opis).
Jak przekazać na Prom starą przekreśloną i nową promocyjną cenę?
Ustaw ceny promocyjne regułami „Promocje/Rabaty” (procent ze znakiem minus, bez flagi „Od ilości (hurt)”) i zamień w szablonie wiersz ceny na parę: price — „Cena promocyjna”, jeśli jest niższa od zwykłej, oldprice — zwykła cena (gotowe wiersze).
Czy po zakończeniu promocji na Prom wróci zwykła cena?
Tak. Po dacie zakończenia następne zastosowanie reguł zeruje „Cena promocyjna”, feed przekazuje zwykłą cenę bez oldprice, a Prom zaktualizuje cenę przy najbliższej aktualizacji — co 4 godziny od 6:00 do 22:00. Daty z feedu Prom nie czyta: przy imporcie przez link rabat działa, dopóki niesie go feed, i nie dłużej niż 45 dni (jak przebiega promocja).
Jak szybko zmiany ceny z Elbuz pojawią się na Prom?
Cenę, dostępność, ilość i rabat Prom aktualizuje przez link co 4 godziny od 6:00 do 22:00, pozostałe pola i nowe produkty — raz na dobę w nocy (jak często Prom pobiera feed).
Dlaczego produkt niedostępny nie ma na Prom rabatu?
To reguła Prom: rabat działa tylko dla produktu dostępnego. Dla produktu z available="false" Prom bierze jako cenę wartość oldprice.
Jakie jeszcze tagi Prom można dodać do feedu?
Na przykład name_ua i description_ua (ukraińska nazwa i opis — tylko w parze), quantity_in_stock, portal_category_id, keywords, dimensions, gtin. Pełna lista z podstawieniami Elbuz — przewodnik po tagach.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Eksport danych
- Reguły stop
- menu listy → „Reguły stop eksportu”
- Uprawnienia
- okno „Eksport danych”; dla karty — „Szczegółowa konfiguracja szablonu eksportu”
- Przygotuj
- dostęp do panelu Prom, żeby wkleić link do feedu
1
Przycisk „Pomoc”2
Folder „Eksport i marketplace’y”- Przycisk „Pomoc” — otwiera menu artykułów przewodnika dla tego okna.
- Folder „Eksport i marketplace’y” — dział przewodnika ze wszystkimi artykułami o eksporcie.
Powiązane tematy
- Jeśli potrzebujesz pełnej wymiany ze wszystkimi kolumnami Prom i nowymi produktami — Eksport do Prom plikiem XLSX.
- Jeśli trzeba pobrać katalog lub zmiany z Prom do Elbuz — Import katalogu z XLSX (Prom/EVO).
- Jeśli nazwy lub ceny dla Prom mają się różnić od katalogu — Reguły feedu.
- Jeśli nie wiesz, dlaczego produkt nie trafił do feedu albo jak ustawić harmonogram — Szablony eksportu.
