Elbuz tworzy z katalogu plik Excel w formacie Prom.ua (także satu.kz) z identyfikatorem produktu w każdym wierszu, dzięki czemu Prom aktualizuje istniejące pozycje, a nie je duplikuje.
Kiedy to się przyda:
- Katalog prowadzisz w Elbuz, a sprzedajesz na Prom — plik niesie bieżące ceny, dostępność i wszystkie kolumny Prom.
- W Elbuz pojawiły się nowe produkty — Prom doda je jako nowe, a istniejące zaktualizuje.
- Plik aktualizuje się w nocy według harmonogramu — reguła stop nie przekaże pliku, w którym zniknęła dostępność.
- Opis i zdjęcia prowadzisz w panelu Prom — usuń te kolumny z szablonu.
Od czego zacząć: zaimportuj katalog z Prom, potem utwórz szablon w formacie Prom w „Eksport danych”.
Co potrafi eksport do Prom
- Szablon w formacie Prom od razu zawiera pełny zestaw kolumn Prom — nie trzeba ich układać ręcznie.
- Dwa arkusze pliku — produkty i grupy — w tej samej strukturze, którą Prom daje przy własnym eksporcie.
- Identyfikator produktu w każdym wierszu — Prom rozpoznaje istniejące pozycje i nie tworzy kopii.
- Kolumna dostępności jest liczona z bieżącego statusu dostępności produktu w Elbuz.
- Skład kolumn szablonu decyduje, które pola trafią na Prom, a które zostaną w panelu.
- Harmonogram i reguły stop aktualizują plik bez Ciebie i nie przekażą zepsutego.
Jak utworzyć szablon Prom
W oknie eksportu utwórz szablon i wybierz format Prom. Elbuz od razu wypełni szablon pełnym zestawem kolumn Prom. Następnie wybierz, które produkty eksportować — cały katalog, wybrane kategorie lub według reguł wyboru — i wygeneruj plik.
Plik możesz generować ręcznie przyciskiem „Eksportuj” albo według harmonogramu. Gotowy plik przekazujesz marketplace’owi sam: program nie łączy się z Prom, tylko umieszcza plik pod stałym linkiem, a jeśli skonfigurowano FTP — także tam.
Oficjalny opis po stronie marketplace’u: eksport produktów i grup produktów oraz format pliku XLS(X)/CSV. Ogólny dział wymiany — import i eksport w pomocy Prom.
Co trafia do pliku i skąd biorą się wartości
Dwa arkusze
Plik wynikowy ma tę samą strukturę co plik importu Prom — dwa arkusze. Dlatego Prom przyjmuje go bez przeróbek.
- „Export Products Sheet” — produkty z pełnym zestawem kolumn Prom (nazwa, cena, dostępność, identyfikatory, cechy i dziesiątki dodatkowych pól).
- „Export Groups Sheet” — struktura grup (kategorii): numery, nazwy, identyfikatory i powiązanie „rodzic–dziecko”.
Pola karty i wartości stałe
Kolumny są wypełniane z pól karty produktu. Część — z pól wbudowanych (nazwa, cena, ilość, wymiary, , kategoria, producent, opis, meta). Dziesiątki kolumn specyficznych dla Prom — z pól dodatkowych, które utworzył import przy pierwszym wczytaniu: cena hurtowa, rabaty, typ produktu, sposób pakowania, etykiety, prezenty. Eksport oddaje to, co przyszło z Prom, plus Twoje zmiany.
Sześć kolumn oddaje nie pole karty, lecz wartość stałą, wpisaną przy tworzeniu szablonu:
- Тип_товару (typ produktu) —
r(detal); - Валюта (waluta) — kod Twojej waluty bazowej;
- Одиниця_виміру (jednostka miary) —
шт.(szt.); - Мінімальний_обсяг_замовлення (minimalna wielkość zamówienia) i Можливість_поставки (możliwość dostawy) —
1; - Термін_поставки (termin dostawy) —
день(dzień).
Wartość stała leży w kolumnie „Formuła” na karcie „Wybór pól” szablonu i zastępuje pole karty o tej samej nazwie: w każdym wierszu pliku będzie to samo. Żeby oddawać wartości z kart, wyczyść komórkę „Formuła” tej kolumny.
Kolumna dostępności
Kolumna «Наявність» (dostępność) bierze wartość z osobnego pola karty „Наличие_xls”, które pojawia się razem z szablonem Prom. Wypełnia je formuła tworzona przez import katalogu z Prom. Formuła patrzy na status dostępności produktu:
| Status dostępności produktu | Symbol Prom w pliku |
|---|---|
| standardowy „Dostępny” | + |
| standardowy „Brak w magazynie” | - |
| standardowy „Wkrótce dostępny” | & — Prom zaimportuje jako „Немає в наявності” (brak w magazynie) |
| standardowy „Na zamówienie” | 5 |
| Twój własny status | +, jeśli ilość jest większa od zera, w przeciwnym razie - |
Według pomocy Prom pusta dostępność, zerowy stan i & („oczekiwany”) dają na Prom status braku w magazynie. Prom rozumie też @ — usługa, ! — „Готово до відправки” (gotowe do wysyłki; tylko dla firm z wysokimi wskaźnikami) i cyfrę — ile dni trwa dostawa produktu na zamówienie. Żeby produkt „Wkrótce dostępny” był na Prom dostępny do zamówienia, zmień dla niego symbol w formule na 3 (własne statusy).
Standardowe statusy formuła rozpoznaje nie po nazwie, więc zmiana nazwy ich nie psuje. Jeśli formuła była wcześniej poprawiana pod własne statusy, zostaje Twoja wersja. Sama formuła jest w oknie „Ustawienia formuł dla pól katalogu bazowego”.
Formuła nie działa w chwili eksportu, tylko gdy zapisujesz kartę produktu albo gdy produkty przechodzą przetwarzanie wsadowe cenników. Dlatego do pliku trafia wartość zapisana w karcie w danym momencie.
Jeśli katalog od początku powstawał w Elbuz i nigdy nie był importowany z Prom, formuły nie ma: tworzy ją właśnie import. Pole „Наличие_xls” zostanie puste, a pustą dostępność Prom czyta jako brak w magazynie. Wypełnij pole albo utwórz formułę sam.
Rabaty i promocje w pliku Prom
W pliku Prom rabat niosą trzy kolumny obok zwykłej ceny: wysokość rabatu i okres jego obowiązywania. Cenę po rabacie Prom liczy sam.
| Kolumna Prom | Nazwa w pliku Elbuz | Co zawiera |
|---|---|---|
| Ціна (cena) | Цена | zwykła cena — od niej Prom odejmuje rabat |
| Знижка (rabat) | Скидка | procent (7%) lub kwota (12.50) |
| Термін_дії_знижки_від (rabat od) | Cрок действия скидки от | data rozpoczęcia rabatu |
| Термін_дії_знижки_до (rabat do) | Cрок действия скидки до | data zakończenia rabatu |
Skąd Elbuz bierze rabat
Kolumny rabatu biorą wartości z pól karty „Скидка_xls”, „Cрок действия скидки от” i „Cрок действия скидки до”, które pojawiają się razem z szablonem Prom. Nie trzeba ich wypełniać ręcznie — robi to zastosowanie reguł „Promocje/Rabaty”:
- reguła z procentem daje w „Скидка” ten procent bez znaku (
-7→7%); reguła ze stałą ceną, współczynnikiem lub kwotą — różnicę między zwykłą a promocyjną ceną (12.50); - rabat dają tylko reguły dla grupy detalicznej (domyślnej) i bez „Tylko dla zalogowanych”; ręczna cena promocyjna z karty nie trafia do „Скидка”;
- daty rabatu to „Data rozpoczęcia” i „Data zakończenia” reguły; pusta data daje pustą komórkę. Rabat z przyszłą datą rozpoczęcia trafia do pliku od razu razem z datami — w odróżnieniu od pola „Cena promocyjna”, które czeka na datę rozpoczęcia;
- pola wypełniają się tylko dla prawdziwego rabatu — gdy cena promocyjna jest niższa od zwykłej. Reguła z dodatnim procentem (narzut) nie daje rabatu na Prom;
- gdy data zakończenia minęła albo regułę wyłączono lub usunięto, zastosowanie reguł czyści wszystkie trzy pola — w następnym pliku rabatu już nie będzie.
- wszystko to działa tylko wtedy, gdy pole „Cena promocyjna” nie ma aktywnej formuły: przy formule reguły nie wypełniają ani nie czyszczą kolumn rabatu.
Kolumna ceny zostaje przy tym zwykłą ceną — rabat odejmuje Prom. Nie podstawiaj do „Цена” pola „Cena promocyjna”: Prom odejmie wtedy rabat drugi raz.
1
Rabat2
Rabat obowiązuje od3
Rabat obowiązuje do- Rabat = 10% — procent wzięty z aktywnej reguły promocji.
- Rabat obowiązuje od — data rozpoczęcia promocji.
- Rabat obowiązuje do — data zakończenia promocji.
W pomocy Prom o formacie XML napisano: przez link data rabatu nie jest przekazywana, a rabat ustawia się na 45 dni. Dla pliku XLSX przez link pomoc tego osobno nie opisuje — przyjmij, że daty mogą nie zadziałać, i sprawdzaj w panelu Prom. Pewny termin promocji przy imporcie przez link to zawartość pliku: Elbuz czyści „Скидка” po końcu promocji, a następna aktualizacja Prom zdejmuje rabat.
Reguły z flagą „Od ilości (hurt)” (cena zależna od ilości) nie trafiają do kolumny „Скидка”. Ceny hurtowe Prom przyjmuje w kolumnach «Оптова_ціна» (cena hurtowa) i «Мінімальне_замовлення_опт» (minimalne zamówienie hurtowe) — wypełniają je pola karty, które przyszły z Prom.
Przewodnik po kolumnach Prom
Wszystkie kolumny arkusza produktów według pomocy Prom i skąd bierze je szablon Elbuz. Szablon zapisuje nagłówki tak, jak oddawał je eksport Prom — po rosyjsku („Скидка”, „Cрок действия скидки от”), a aktualna pomoc Prom podaje nazwy ukraińskie. Jeśli po imporcie Prom nie odczytał jakiejś kolumny (np. okresu rabatu), zmień jej nazwę w szablonie na ukraińską z tabeli poniżej. Skład i kolejność kolumn — na karcie „Wybór pól” szablonu. „Pole Prom” oznacza dodatkowe pole karty, które utworzył szablon Prom i wypełnił import katalogu z Prom.
| Kolumna Prom | Znaczenie i ograniczenia Prom | Źródło w Elbuz |
|---|---|---|
| Ідентифікатор_товару (identyfikator produktu) | obowiązkowy klucz, po którym Prom dopasowuje wiersz do produktu; do 255 znaków | UUID produktu (dlaczego bez duplikatów) |
| Унікальний_ідентифікатор (unikalny identyfikator) | wewnętrzny numer Prom; obowiązkowy dla już dodanych produktów, nie zmienia się go ręcznie | pole Prom; w nowych produktach puste |
| Код_товару (kod produktu) | kod do 25 znaków | „Kod (SKU) wewnętrzny” |
| Назва_позиції / Назва_позиції_укр (nazwa / nazwa ukraińska) | nazwa do 110 / 130 znaków; ukraińska aktualizuje się tylko razem z Опис_укр | „Nazwa” / pole Prom |
| Опис / Опис_укр (opis) | opis do 12 160 znaków | „Pełny opis” / pole Prom |
| Пошукові_запити / _укр (frazy wyszukiwania) | po przecinku, do 1024 znaków, słowo do 50 | pola Prom |
| Тип_товару (typ produktu) | r detal, w hurt, u hurt i detal, s usługa | stała r (wartości stałe) |
| Ціна (cena) | od 0,01 do 9 999 999 999 | „Cena” |
| Ціна_від (cena od) | + — pokazywać „cena od” | pole Prom |
| Валюта (waluta) | UAH, USD, EUR i inne | stała — waluta bazowa |
| Одиниця_виміру (jednostka miary) | szt., opakowanie, komplet, para, kg, m i inne z listy Prom | stała шт. (szt.); jednostka produktu — jeśli wyczyścisz formułę kolumny |
| Мінімальний_обсяг_замовлення (minimalna wielkość zamówienia) | liczba | stała 1 |
| Оптова_ціна / Мінімальне_замовлення_опт (cena hurtowa / minimalne zamówienie hurtowe) | kilka wartości przez ; | pola Prom |
| Кількість (ilość) | stan | „Ilość” |
| Наявність (dostępność) | +, -, @, !, liczba dni; & i puste — brak w magazynie | „Наличие_xls” (jak jest liczona) |
| Знижка / Термін_дії_знижки_від / _до (rabat i jego daty) | procent lub kwota; daty rabatu | reguły promocji (rabaty) |
| Посилання_зображення (link do zdjęcia) | kilka URL przez przecinek ze spacją, pierwszy — główny | zdjęcia produktu, do 10 |
| Вага,кг / Ширина,см / Висота,см / Довжина,см (waga, szerokość, wysokość, długość) | liczby | waga i wymiary z karty |
| Виробник (producent) | do 255 znaków; importuje się tylko, jeśli jest w bazie producentów Prom | „Producent” |
| Країна_виробник (kraj produkcji) | do 255 znaków | pole Prom |
| Ярлик (etykieta) | aktualizuje się zawsze, nawet bez «Оновити примусово» (wymuś aktualizację) | pole Prom |
| HTML_заголовок / HTML_опис (i _укр) | SEO do 250 / 270 znaków; puste wartości przy imporcie nie kasują istniejących | meta title / meta description; _укр — pola Prom |
| Подарунки / Супутні, ID_Подарунків / ID_Супутніх (prezenty / produkty powiązane i ich ID) | numery wierszy lub ID przez ;; wariant nie może być prezentem | pola Prom |
| Номер_групи / Назва_групи (numer / nazwa grupy) | grupa w witrynie Prom; nazwa przy imporcie się nie wczytuje | pole Prom / kategoria |
| Ідентифікатор_групи (identyfikator grupy) | Twój identyfikator grupy | pole Prom lub UUID kategorii |
| Ідентифікатор_підрозділу / Посилання_підрозділу (identyfikator / link działu) | kategoria marketplace’u; Prom radzi jej nie zmieniać | pole Prom; jeśli puste — numer kategorii Prom (identyfikator) lub link do kategorii Prom (adres) |
| ID_групи_різновидів (ID grupy wariantów) | liczba od 1 do 999 999 999; wiersze z tym samym numerem i wypełnionymi cechami to warianty | pole Prom |
| Де_знаходиться_товар (lokalizacja produktu) | do trzech miejscowości przez ; | pole Prom |
| Спосіб_пакування, Особисті_нотатки (sposób pakowania, notatki osobiste) | do 500 znaków; notatki po przecinku | pola Prom |
| Продукт_на_сайті (produkt na stronie) | adres produktu; przy imporcie się nie wczytuje | „Link zewnętrzny” produktu |
| Код_маркування_(GTIN) / Номер_пристрою_(MPN) | dla feedu Google Merchant | GTIN / pole Prom |
| Назва_ / Одиниця_виміру_ / Значення_Характеристики (nazwa / jednostka / wartość cechy) | trójka na każdą cechę, dokładnie w tej kolejności; kilka wartości przez | | cechy produktu |
Arkusz grup zawiera numer grupy, nazwę grupy (i ukraińską), identyfikator grupy, numer i identyfikator grupy nadrzędnej, obraz i pola SEO grupy. Według pomocy Prom o XML opisy i zdjęcia grup nie są przekazywane przez link.
Jak Elbuz aktualizuje produkty na Prom bez duplikatów
Wymiana opiera się na identyfikatorach. W pliku eksportu trafiają tak:
| Kolumna Prom | Skąd się bierze w Elbuz |
|---|---|
| Ідентифікатор_товару (identyfikator produktu) | nasz produktu — unikalny klucz pozycji w katalogu. Wypełniany zawsze, dla każdego produktu. |
| Унікальний_ідентифікатор (unikalny identyfikator) | wewnętrzny numer Prom z pola dodatkowego. Jeśli produkt utworzono w Elbuz, a nie przyszedł z Prom, numeru w polu nie ma — i komórka jest pusta. |
| Ідентифікатор_групи (identyfikator grupy) | pole karty produktu o tej samej nazwie. Jeśli jest puste lub równe zero — do pliku idzie UUID kategorii, w której leży produkt. |
| Ідентифікатор_підрозділу (identyfikator działu) | pole karty produktu o tej samej nazwie. Jeśli jest puste lub równe zero — brany jest numer kategorii na Prom zapisany w samej kategorii. |
Dlaczego Prom nie duplikuje produktów z Elbuz
Prom duplikuje produkty, gdy plik edytuje się ręcznie i wczytuje z powrotem bez identyfikatorów: marketplace nie odróżnia istniejących pozycji od nowych. Dlatego pomoc Prom radzi najpierw zrobić eksport z panelu, żeby w pliku pojawiły się identyfikatory.
Z Elbuz tego problemu nie ma: eksport zawsze wpisuje do Ідентифікатор_товару nasz UUID — także dla produktów utworzonych przed chwilą. Prom rozpoznaje istniejące pozycje i aktualizuje właśnie je. Eksport z Prom dla identyfikatorów nie jest potrzebny.
Nie edytuj ręcznie kolumn Ідентифікатор_товару i Унікальний_ідентифікатор w pliku. To klucze synchronizacji: ręczna zmiana UUID istniejącego produktu sprawi, że Prom uzna go za nowy i zduplikuje pozycję.
Wymiana z Prom krok po kroku
- Import. Pobierz katalog z Prom do Elbuz — importem XLSX. Każdy produkt dostanie UUID równy jego identyfikatorowi produktu (Ідентифікатор_товару) na Prom.
- Praca w Elbuz. Zmieniaj ceny i dostępność, edytuj karty, dodawaj nowe produkty. Nowe pozycje dostają własny UUID; numeru Prom w polu «Унікальний_ідентифікатор» nie mają.
- Eksport. Wygeneruj plik w formacie Prom. Każdy produkt ma Ідентифікатор_товару (UUID), a w nowych Унікальний_ідентифікатор jest pusty.
- Import na Prom. Przekaż plik marketplace’owi. Istniejące produkty się zaktualizują, nowe zostaną dodane, a Prom nada im swój wewnętrzny numer.
- Запит або дія
- Відповідь
- loop — повторюється
- Примітка
Dalej cykl się powtarza: kolejne eksporty niosą te same UUID, więc Prom aktualizuje te same pozycje.
Do aktualizacji bez duplikatów import zwrotny nie jest potrzebny: dopasowanie opiera się na naszym UUID. Ponownie zaimportować katalog z Prom warto, żeby odczytać zmiany po stronie marketplace’u: moderację, ręczne poprawki w panelu, nadany przez Prom unikalny identyfikator.
Co przebieg zmienia w katalogu i co nadpisuje na Prom
Eksport w większości tylko czyta katalog, ale trzy rzeczy w nim zmienia — jeszcze zanim zacznie składać wiersze pliku.
- Przelicza drzewo kategorii. Przy uruchomieniu przyciskiem aktualizują się poziomy i ścieżki kategorii. Odwołanie do kategorii nadrzędnej jest ustawiane na nowo tam, gdzie jest puste lub rozeszło się z nadrzędną — przy każdym uruchomieniu, także według harmonogramu.
- Wypełnia pola Prom w kartach — Номер_групи, Ідентифікатор_групи, Ідентифікатор_підрозділу, Адреса_підрозділу. Wartość jest brana z kategorii produktu, a jeśli i tam jest pusto — z innego produktu tej samej kategorii. Wypełniane są tylko puste pola (dla Номер_групи i Ідентифікатор_групи — także te, w których stoi zero).
- Nadaje wewnętrzne kody — jeśli ta opcja jest włączona. Chodzi o ustawienie „Unikalny wewnętrzny kod (SKU)” („Panel klienta” → „Ustawienia systemu” → „Katalog” → „Reguły przetwarzania danych”). Przy nim przebieg nadaje losowy numer produktom z pustym kodem wewnętrznym, a do jednakowych kodów dopisuje sufiks.
Nazwy, ceny, opisu, ilości, statusu dostępności i zdjęć przebieg nie zmienia. Formuły pól karty podczas eksportu się nie przeliczają.
Już zapisanego pola Prom ponowny przebieg nie poprawi: dopóki w polu coś jest, eksport go nie rusza. Wyczyść pole w karcie produktu (albo przetwarzaniem wsadowym według wyboru), a następny przebieg wypełni je na nowo z kategorii.
Ponowny przebieg po zmianach w panelu Prom
Każdy przebieg składa plik od nowa z bieżących wartości katalogu: co jest teraz w karcie, to trafi na marketplace. Stary plik o tej samej nazwie jest usuwany na początku przebiegu.
Do pliku trafiają dokładnie te kolumny, które są wymienione na karcie „Wybór pól” szablonu. Puste pole w karcie daje pustą komórkę. Pole, które prowadzisz w panelu Prom, usuń z szablonu przyciskiem „Usuń pole” — wtedy w pliku nie będzie ani nagłówka, ani wartości. Co Prom robi z kolumną, której nie ma w pliku, decyduje on sam.
Twoje wartości w samym Elbuz może nadpisać nie eksport, lecz formuły pól: działają przy zapisie karty i podczas przetwarzania wsadowego cenników. Produkty z flagą „Nie aktualizuj” (grupa „Ochrona podczas importu” w karcie produktu) formuły pomijają.
Identyfikatory w pliku poprawiano ręcznie i na Prom pojawiły się duplikaty — wygeneruj plik od nowa: Ідентифікатор_товару jest brany z UUID karty, a następny import zaktualizuje właściwe pozycje. Żeby pobrać numery, które marketplace nadał pozycjom, zrób import katalogu z Prom. Zbędną kartę na samym Prom usuwa się tylko w panelu marketplace’u.
Dlaczego produktu nie ma w pliku
Produkt bez komunikatu nie trafia do pliku, jeśli nie przeszedł wyboru szablonu: flaga „Eksportuj do pliku (do sklepu)”, aktywna kategoria, filtr, sklep, magazyn. Pełna lista warunków i sposób sprawdzenia konkretnego produktu — dlaczego produkt nie trafił do pliku. Dla szablonu Prom dochodzą jeszcze dwa warunki:
- produkt bez kategorii nie trafia do pliku: wiersze są budowane od powiązania „produkt — kategoria”;
- produkt musi mieć opis w języku, w którym generowany jest eksport.
Wybór sprawdzisz przed przebiegiem w oknie „Co zostanie wyeksportowane”, które otwiera przycisk „Eksportuj”: podsumowanie przed eksportem.
Elbuz nie oznacza na Prom produktów, których zabrakło w pliku. Kolumny „Товар на удаление” (produkt do usunięcia) i „Причина удаления товара” (powód usunięcia) są w szablonie, ale wartości biorą się z pól karty o tych nazwach, które wypełniasz Ty. Jak Prom traktuje pozycje nieobecne w kolejnym pliku, to reguła marketplace’u.
Harmonogram, dziennik i link do pliku
Uruchomienie, harmonogram, dziennik, reguły stop i stały link działają tak samo dla wszystkich szablonów — Uruchomienie ręczne i według harmonogramu, Gdzie trafia plik. Poniżej — co warto wiedzieć właśnie o szablonie Prom.
Jak upewnić się, że plik powstał
Dziennik przebiegu otwiera się w „Operacjach” i zostaje pod przyciskiem „Historia uruchomień” szablonu. Szablon Prom zapisuje postęp wierszem „Wyeksportowane wiersze N z M” co tysiąc produktów. Sukces — „Eksport danych zakończony” i link „Pobierz plik ‹nazwa›”; porażka — „Eksport danych NIE został zakończony: plik nie został utworzony”. Jak czytać pozostałe wiersze — Dziennik przebiegu.
Na liście szablonów para liczb w kolumnie „Dostępny” wychwytuje załamanie: plik powstał, a produktów jest w nim o połowę mniej.
1
Kolumna „Plik”2
Kolumna „Ostatni eksport”3
Kolumna „Dostępny”- „Plik” — link do wygenerowanego pliku, pod nim rozmiar w MB.
- „Ostatni eksport” — kiedy szablon był ostatnio eksportowany i ile trwał ten przebieg.
- „Dostępny” — liczba dostępnych produktów, zmiana od poprzedniego przebiegu i łączna liczba poniżej.
Zawartość kolumn sprawdza się na jednym produkcie przyciskiem z kolbą — „Próbny eksport jednego produktu”. Buduje on osobny plik testowy, pokazuje pary „kolumna = wartość” i błędy, a nie rusza pliku produkcyjnego, linku ani FTP.
Jeśli przebieg się przerwał lub go zatrzymano
Nowy link, rozmiar i data zapisują się w szablonie dopiero po udanym przesłaniu pliku. Przerwanie na dowolnym etapie przed tym zostawia pod linkiem poprzedni plik. Ponowne uruchomienie jest bezpieczne: plik składa się od zera, a na Prom Elbuz niczego nie wysyła.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Flaga zatrzymania jest sprawdzana między szablonami w trybie „Eksportuj wszystkie szablony”. Przebieg pojedynczego szablonu Prom jej nie czyta i dokończy plik, choć wiersz „Eksport przerwany przez użytkownika!” pojawi się w dzienniku: zapisuje go sam przycisk. Plik i tak się zaktualizuje.
Wyłączyć szablon czy usunąć
- Wyłączony szablon harmonogram pomija bez komunikatu, bez wiersza w dzienniku, a „Eksportuj wszystkie szablony” go nie bierze. Przycisk „Eksportuj” na samym szablonie zadziała także na wyłączonym. Plik, link i ustawienia zostają.
- Usunięcie kasuje skład kolumn, FTP, wybór kategorii, powiązanie z harmonogramem i link do ostatniego pliku. Przywrócić można tylko, tworząc szablon od nowa.
Limity i wolumeny
- Wierszy w pliku — tyle, ile produktów przeszło wybór; limitu nie ma. Na koncie demo — 100 produktów, jest o tym wiersz w dzienniku.
- Komórka XLSX — 32 767 znaków. Dłuższy tekst (zwykle opis) jest przycinany na tej granicy.
- Zdjęcia — pierwsze 10 linków. Do kolumny «Посилання_зображення» trafia dziesięć zdjęć według kolejności sortowania.
- Przebieg zbiorczy — jedna godzina. „Eksportuj wszystkie szablony” działa jako osobny proces, szablony jeden po drugim, na cały proces — godzina.
XLSX czy XML — co wybrać
Prom przyjmuje oba formaty i oba niosą ten sam identyfikator produktu — nasz UUID.
| Format | Jak działa | Kiedy wybrać |
|---|---|---|
| XLSX (ten artykuł) | plik ze wszystkimi kolumnami Prom, który przekazujesz marketplace’owi | Elbuz to system główny: pełny katalog, nowe produkty, cechy, wszystkie pola |
| Feed XML | feed pod linkiem, Prom sam pobiera go według harmonogramu | trzeba głównie utrzymywać aktualne ceny i dostępność przy minimum działań |
Można najpierw wgrać katalog plikiem XLSX, a dalej utrzymywać go aktualnym feedem XML — pozycje zostaną te same.
Jeśli te same produkty idą i plikiem XLSX, i feedem
W samym Elbuz konfliktu nie ma. Oba szablony czytają tę samą kartę, więc nie przyniosą różnych cen ani stanów. Każdy szablon ma własny folder w magazynie plików i własny link, więc przebieg jednego nie rusza pliku drugiego.
Wspólne są w nich pola Prom w kartach (Номер_групи, Ідентифікатор_групи, Ідентифікатор_підрозділу, Адреса_підрозділу): wypełnia je przebieg dowolnego szablonu Prom, i tylko puste. Według harmonogramu dwa eksporty nie idą jednocześnie — drugi jest anulowany z wierszem o konflikcie przetwarzania danych.
Czyja wartość zostanie na Prom, jeśli produkt przyszedł i plikiem, i feedem, decyduje marketplace. Dlatego daj jednemu formatowi rolę „pełnego katalogu”, a drugiemu to, czego w pierwszym nie ma, albo rozdziel je filtrem szablonu.
Scenariusze
Katalog prowadzisz w Elbuz i dodajesz na Prom nowe produkty
Co włączyć. Najpierw pobierz katalog z Prom importem XLSX, potem utwórz szablon w formacie Prom i wygeneruj plik przyciskiem „Eksportuj”. Kolumny «Ідентифікатор_товару» na karcie „Wybór pól” nie usuwaj.
Efekt. Pozycje, które przyszły z Prom, marketplace rozpozna po UUID i zaktualizuje. Produkty utworzone w Elbuz pójdą z pustym «Унікальний_ідентифікатор», a Prom doda je jako nowe.
Czego nie będzie. Elbuz nie wyśle pliku na Prom sam i nie usunie z Prom pozycji, których nie ma w pliku.
Opis i zdjęcia prowadzisz w panelu Prom, z Elbuz — resztę
Co włączyć. Otwórz szablon, kartę „Wybór pól”, i usuń przyciskiem „Usuń pole” kolumny, które prowadzisz na marketplace. «Ідентифікатор_товару» zostaw.
Efekt. Usuniętych kolumn w pliku nie będzie wcale.
Czego nie będzie. Zmiany z panelu Prom same nie trafią do Elbuz: do tego potrzebny jest osobny import katalogu.
Plik aktualizuje się według harmonogramu i nie wolno przekazać katalogu, w którym zniknęła dostępność
Co włączyć. Menu „Dodatkowe operacje” w oknie eksportu → „Reguły stop eksportu”. Dla reguły „gwałtowny spadek dostępności względem poprzedniego przebiegu” ustaw tryb „Zatrzymaj eksport” i kliknij „Zapisz dla tego szablonu”. Próg domyślny — 30%.
1
Reguła spadku dostępności2
Kolumna trybu- Reguła porównuje liczbę dostępnych produktów z poprzednim przebiegiem; próg podaje się w procentach.
- Tryb — wyłączona, ostrzeżenie lub zatrzymanie eksportu, osobno dla każdej reguły.
Efekt. Jeśli dostępnych produktów ubyło względem poprzedniego udanego przebiegu o więcej niż próg, przebieg — ręczny i według harmonogramu — zakończy się wierszem „Eksport zatrzymany przez regułę stop: …”. Pod linkiem zostanie poprzedni plik. Wszystkie reguły i tryby — Reguły stop.
Czego nie będzie. Wyłączonego szablonu harmonogram w ogóle nie uruchamia i reguły stop nic tu nie zmienią. Pilnuj, żeby w kolumnie „Stan” było „Aktywny”.
Masz własne statusy dostępności
Co włączyć. Nic: dla własnego statusu formuła pola „Наличие_xls” oddaje symbol według ilości — +, jeśli jest większa od zera, w przeciwnym razie -. Chcesz dla swojego statusu inny symbol Prom — dopisz gałąź do formuły w oknie „Ustawienia formuł dla pól katalogu bazowego”, potem zapisz karty albo uruchom przetwarzanie wsadowe cenników.
Efekt. Kolumna dostępności w następnym pliku dostanie symbol ustawiony formułą.
Czego nie będzie. Sam przebieg eksportu nie przelicza formuły: dopóki karty nie przeszły zapisu lub przetwarzania wsadowego, do pliku trafi stara wartość pola.
Na Prom idzie tylko część katalogu
Co włączyć. Wybór kategorii w szablonie albo warunki na karcie „Ograniczenie eksportu (filtr)”. Zanim wygenerujesz plik, porównaj liczby w oknie „Co zostanie wyeksportowane”; przejście „Pokaż te produkty w katalogu” pokaże samą listę.
Efekt. Do pliku trafią tylko produkty, które przeszły wybór.
Czego nie będzie. Produkty, które przestały przechodzić wybór, nie są na Prom oznaczane do usunięcia: po prostu znikają z pliku.
Rabat 7% na kategorię od 1. do 30. dnia miesiąca
Co włączyć. W „Promocje/Rabaty” reguła: „%” -7, flaga „Od ilości (hurt)” odznaczona, „Dodatkowy filtr” — kategoria, „Data rozpoczęcia” i „Data zakończenia”. Zastosuj reguły, wygeneruj plik i zaimportuj go ręcznie w panelu Prom. Kolumny „Скидка”, „Cрок действия скидки от/до” muszą zostać na karcie „Wybór pól” szablonu.
Efekt. W wierszach produktów z kategorii „Скидка” = 7% i daty reguły. Prom stosuje rabat od 1. do 30. dnia i sam go zdejmuje po dacie zakończenia.
Czego nie będzie. Jeśli Prom pobiera plik przez link, daty mogą nie zadziałać (w pomocy o XML — rabat na 45 dni), więc rabat trzyma się, dopóki niesie go plik. Wtedy po końcu promocji zastosuj reguły (Elbuz wyczyści kolumny rabatu) i poczekaj na następną aktualizację Prom.
Promocję trzeba zakończyć przed terminem
Co włączyć. Wyłącz regułę w oknie „Promocje/Rabaty” — zapis wyłączenia od razu przelicza promocje. Wygeneruj plik i przekaż go Prom.
Efekt. Produkty z tej reguły mają puste kolumny „Скидка” i okresu rabatu, a „Цена” — zwykłą cenę. Prom po imporcie pokazuje cenę bez rabatu.
Czego nie będzie. Pusta komórka rabatu oznacza „brak rabatu” tylko dla pól, które Prom aktualizuje. Jeśli w ustawieniach importu Prom odznaczono pole rabatu, stary rabat na marketplace zostanie — zdejmij go w panelu Prom.
Co zrobić, gdy plik wyszedł nie taki
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Ostatni eksport” się nie przesunął, a w dzienniku jest „Eksport danych NIE został zakończony: plik nie został utworzony” | Przebieg upadł przed zapisem pliku albo plik nie trafił do chmury — data i link aktualizują się dopiero po sukcesie | Pod linkiem został poprzedni plik, nie przekazuj go na Prom. Zobacz wiersz nad błędem (jak czytać dziennik) i sprawdź szablon przyciskiem próbnego eksportu |
| W pliku pusta kolumna dostępności, na Prom produkty mają status braku w magazynie | Pole „Наличие_xls” jest puste: katalogu nie importowano z Prom, formułę usunięto albo karty jeszcze się nie przeliczyły | Sprawdź formułę pola (kolumna dostępności) i zapisz karty albo uruchom przetwarzanie wsadowe, żeby wartości się przeliczyły |
| Produkt jest w katalogu, ale nie ma go w pliku, a w dzienniku nic o nim nie ma | Nie przeszedł jednego z warunków wyboru — flagi eksportu, kategorii, filtra, sklepu lub magazynu | Przejdź listę warunków i porównaj liczby w oknie „Co zostanie wyeksportowane” |
| Plik według harmonogramu się nie aktualizuje, błędów w dzienniku nie ma | Szablon jest wyłączony — harmonogram pomija go bez komunikatu. Albo w tej chwili trwał już inny eksport | Zobacz kolumnę „Stan” na liście: „Wyłączony” — włącz (więcej). Jeśli stan to „Aktywny”, szukaj w dzienniku wiersza o konflikcie przetwarzania danych |
| Kliknięto „Stop”, a plik i tak się zaktualizował | Flaga zatrzymania jest sprawdzana między szablonami przebiegu zbiorczego; pojedynczy szablon Prom jej nie czyta | Poczekaj na koniec przebiegu — ponowne uruchomienie jest bezpieczne i niczego nie duplikuje (co się dzieje przy przerwaniu) |
| Opis produktu w pliku urywa się w pół słowa | Komórka XLSX mieści 32 767 znaków, dłuższy tekst jest przycinany | Skróć opis w karcie: więcej się w komórce nie zmieści (limity formatu) |
| Promocję w Elbuz skonfigurowano, a kolumna „Скидка” w pliku jest pusta | Reguł nie zastosowano; reguła ma flagę „Od ilości (hurt)” (cena zależna od ilości) lub dodatni procent; promocja już się skończyła; reguła nie jest dla grupy detalicznej; pole „Cena promocyjna” ma formułę | Procent ze znakiem minus, flaga „Od ilości (hurt)” odznaczona, „Zastosuj reguły do produktów” — i wygeneruj plik ponownie (rabaty w pliku) |
| Produkty „Wkrótce dostępny” mają na Prom status braku w magazynie | Formuła oddaje dla tego statusu &, a Prom czyta go jako brak w magazynie |
Zmień symbol dla statusu w formule „Наличие_xls” na liczbę dni dostawy, np. 3 (kolumna dostępności) |
Najczęstsze pytania
Dlaczego przy ręcznej edycji pliku Prom duplikuje produkty, a przez Elbuz — nie?
Prom duplikuje pozycje, gdy w pliku nie ma identyfikatorów produktów. Elbuz zawsze wpisuje identyfikator produktu (nasz UUID) w każdy wiersz, więc Prom rozpoznaje istniejące produkty i aktualizuje właśnie je.
Czy po dodaniu nowych produktów trzeba ponownie eksportować z Prom?
Do aktualizacji bez duplikatów — nie: Elbuz sam wpisuje identyfikatory. Ponownie zaimportować katalog z Prom warto tylko po to, by odczytać zmiany po stronie marketplace’u: moderację, ręczne poprawki, numery nowych produktów.
Jak Prom odczyta nowy produkt utworzony w Elbuz?
Taki produkt idzie z własnym UUID jako identyfikatorem produktu i z pustym unikalnym identyfikatorem. Prom widzi nieznany identyfikator, dodaje produkt jako nowy i nadaje mu swój numer.
Dlaczego dostępność w pliku jest inna niż teraz w karcie?
Do pliku trafia pole „Наличие_xls”, a jego formuła przelicza się przy zapisie karty lub przetwarzaniu wsadowym cenników, nie podczas eksportu. Zapisz kartę — i następny plik poniesie aktualny symbol (kolumna dostępności).
Co się stanie ze zmianami w panelu Prom po następnym eksporcie?
Plik poniesie bieżące wartości z Elbuz we wszystkich kolumnach szablonu. Pole, które prowadzisz w panelu, usuń z szablonu przyciskiem „Usuń pole” (ponowny przebieg).
Czy po kliknięciu „Stop” eksport się zatrzyma?
Przebieg pojedynczego szablonu Prom — nie: plik zostanie dokończony. Flaga zatrzymania jest sprawdzana tylko między szablonami w trybie „Eksportuj wszystkie szablony”. Ponowne uruchomienie niczego nie duplikuje.
Co się stanie, jeśli wyłączę szablon?
Harmonogram pominie go bez komunikatu, a „Eksportuj wszystkie szablony” go nie weźmie. Przycisk „Eksportuj” na samym szablonie zadziała. Plik, link, kolumny, filtr i harmonogram zostają.
Jak przekazać na Prom rabat z datami w pliku XLSX?
Utwórz regułę „Promocje/Rabaty” z procentem ze znakiem minus i datami, a potem zastosuj reguły. Elbuz wypełni kolumny „Скидка” i „Cрок действия скидки от/до”; Prom zastosuje rabat do ceny. Daty działają pewnie przy ręcznym imporcie pliku; przez link mogą nie zadziałać (rabaty w pliku).
Co stanie się z rabatem na Prom, gdy promocja w Elbuz się skończy?
Następne zastosowanie reguł wyczyści kolumny rabatu i nowy plik pójdzie bez niego. Przy ręcznym imporcie z datami Prom sam zdejmie rabat w dniu zakończenia; przez link — po najbliższej aktualizacji.
Które kolumny Prom są obowiązkowe?
Nazwa pozycji, opis, identyfikator produktu, a dla już dodanych produktów — także unikalny identyfikator (Назва_позиції, Опис, Ідентифікатор_товару, Унікальний_ідентифікатор). Szablon Elbuz wypełnia je wszystkie. Pełna lista — przewodnik po kolumnach.
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
- katalog zaimportowany z Prom importem XLSX
Powiązane tematy
- Jeśli katalog nie został jeszcze zaimportowany z Prom — Import katalogu z XLSX (Prom/EVO).
- Jeśli Prom ma sam pobierać ceny i dostępność przez link — Eksport do Prom w formacie XML.
- Jeśli nie wiesz, dlaczego produkt nie trafił do pliku albo jak ustawić harmonogram — Szablony eksportu.
