↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak wyeksportować katalog do feedu XML dla dowolnego serwisu

    Jak wyeksportować katalog do Prom.ua plikiem XLSX

    23 min czytaniaZaktualizowano

    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

    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 produktuSymbol 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 PromNazwa w pliku ElbuzCo 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.

    Okno sprawdzenia szablonu eksportu Prom XLSX z kolumnami rabatu dla testowanego produktu
    1Rabat
    2Rabat obowiązuje od
    3Rabat obowiązuje do
    1. Rabat = 10% — procent wzięty z aktywnej reguły promocji.
    2. Rabat obowiązuje od — data rozpoczęcia promocji.
    3. 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 PromZnaczenie i ograniczenia PromŹródło w Elbuz
    Ідентифікатор_товару (identyfikator produktu)obowiązkowy klucz, po którym Prom dopasowuje wiersz do produktu; do 255 znakówUUID produktu (dlaczego bez duplikatów)
    Унікальний_ідентифікатор (unikalny identyfikator)wewnętrzny numer Prom; obowiązkowy dla już dodanych produktów, nie zmienia się go ręczniepole 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 50pola Prom
    Тип_товару (typ produktu)r detal, w hurt, u hurt i detal, s usługastał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 innestała — waluta bazowa
    Одиниця_виміру (jednostka miary)szt., opakowanie, komplet, para, kg, m i inne z listy Promstała шт. (szt.); jednostka produktu — jeśli wyczyścisz formułę kolumny
    Мінімальний_обсяг_замовлення (minimalna wielkość zamówienia)liczbastał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 rabatureguły promocji (rabaty)
    Посилання_зображення (link do zdjęcia)kilka URL przez przecinek ze spacją, pierwszy — głównyzdjęcia produktu, do 10
    Вага,кг / Ширина,см / Висота,см / Довжина,см (waga, szerokość, wysokość, długość)liczbywaga 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ówpole 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ącychmeta title / meta description; _укр — pola Prom
    Подарунки / Супутні, ID_Подарунків / ID_Супутніх (prezenty / produkty powiązane i ich ID)numery wierszy lub ID przez ;; wariant nie może być prezentempola Prom
    Номер_групи / Назва_групи (numer / nazwa grupy)grupa w witrynie Prom; nazwa przy imporcie się nie wczytujepole Prom / kategoria
    Ідентифікатор_групи (identyfikator grupy)Twój identyfikator grupypole 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 wariantypole Prom
    Де_знаходиться_товар (lokalizacja produktu)do trzech miejscowości przez ;pole Prom
    Спосіб_пакування, Особисті_нотатки (sposób pakowania, notatki osobiste)do 500 znaków; notatki po przecinkupola Prom
    Продукт_на_сайті (produkt na stronie)adres produktu; przy imporcie się nie wczytuje„Link zewnętrzny” produktu
    Код_маркування_(GTIN) / Номер_пристрою_(MPN)dla feedu Google MerchantGTIN / 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 PromSką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

    1. Import. Pobierz katalog z Prom do Elbuz — importem XLSX. Każdy produkt dostanie UUID równy jego identyfikatorowi produktu (Ідентифікатор_товару) na Prom.
    2. 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ą.
    3. Eksport. Wygeneruj plik w formacie Prom. Każdy produkt ma Ідентифікатор_товару (UUID), a w nowych Унікальний_ідентифікатор jest pusty.
    4. Import na Prom. Przekaż plik marketplace’owi. Istniejące produkty się zaktualizują, nowe zostaną dodane, a Prom nada im swój wewnętrzny numer.
    Ten sam cykl w czasie: dwie kolumny to dwa systemy, strzałka pokazuje, w którą stronę idą dane
    PromElbuz2. Praca w Elbuz: ceny, dostępność,nowe produkty z własnym UUID4. Istniejące pozycje zaktualizowane,nowe dodane — Prom nadaje im swój numerloop[Każdy kolejny eksport]1. Import katalogu XLSX —UUID produktu równa się jegoidentyfikatorowi produktu na Prom3. Plik eksportu:każdy produkt ma UUID,w nowych unikalny identyfikator pustyte same UUID — aktualizują się te same pozycje
    • Запит або дія
    • Відповідь
    • 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.

    Okno eksportu: lista szablonów eksportu z kolumnami stanu, pliku, ostatniego eksportu i dostępności
    1Kolumna „Plik”
    2Kolumna „Ostatni eksport”
    3Kolumna „Dostępny”
    1. „Plik” — link do wygenerowanego pliku, pod nim rozmiar w MB.
    2. „Ostatni eksport” — kiedy szablon był ostatnio eksportowany i ile trwał ten przebieg.
    3. „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.

    Trzy romby to trzy miejsca, w których przebieg kończy się bez nowego pliku: reguła stop przed składaniem, błąd zapytania o produkty i nieudane przesłanie do chmury. Tylko dolna gałąź dochodzi do nowego linku i daty
    taknie lub tylko ostrzeżenienietaktryb chmurowytryb lokalnynietakUruchomienie szablonuDrzewo kategorii i kody wewnętrzneReguła stop w trybie„Zatrzymaj eksport”zadziałała?„Eksport zatrzymany przez regułęstop”pod linkiem poprzedni plikStary plik o tej samej nazwieusunięty z folderu tymczasowegoPuste pola Prom w kartachwypełniane z kategoriiZapytanie o produktyprzeszło bez błędu?„Eksport danych NIE zostałzakończony”data się nie aktualizujePlik złożony w folderzetymczasowymi wysłany na FTP, jeśli goskonfigurowanoNowy pliktrafił do chmury?W szablonie zapisano link,rozmiar i datę„Plik nie został przesłany domagazynu plików w chmurze”pod linkiem poprzedni plikZ folderu szablonu w chmurzeusunięto stare pliki„Eksport danych zakończony”
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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.

    FormatJak działaKiedy wybrać
    XLSX (ten artykuł)plik ze wszystkimi kolumnami Prom, który przekazujesz marketplace’owiElbuz to system główny: pełny katalog, nowe produkty, cechy, wszystkie pola
    Feed XMLfeed pod linkiem, Prom sam pobiera go według harmonogramutrzeba 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%.

    Okno reguł stop eksportu z progami i trybami dla wybranego szablonu
    1Reguła spadku dostępności
    2Kolumna trybu
    1. Reguła porównuje liczbę dostępnych produktów z poprzednim przebiegiem; próg podaje się w procentach.
    2. 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 widać, dlaczego tak jest i co zrobić
    Co widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo