↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Gdzie w karcie produktu trafiają kolumny pliku Prom

    11 min czytaniaZaktualizowano

    Elbuz sam rozkłada plik Excel z katalogiem Prom.ua lub Satu.kz na karty produktów i zachowuje nawet te kolumny, dla których w standardowej karcie nie ma miejsca — ręczne mapowanie kolumn nie jest potrzebne.

    Kiedy to się przyda:

    • Szukasz, gdzie podziała się kolumna z pliku — tabela pokazuje, do którego pola karty trafiła.
    • Sam przygotowujesz plik dla Prom — tu są formaty i limity długości pól.
    • Dostępność w eksporcie jest inna niż w pliku — symbol Prom jest liczony z bieżącego statusu produktu.
    • Prowadzisz warianty i grupy na Prom — powiązania są zachowywane i wracają na Prom eksportem.

    Od czego zacząć: tabela „kolumna pliku → pole karty”.

    Co zachowuje import pliku Prom

    • Dwa arkusze pliku — produkty i grupy są czytane po nazwach kolumn, kolejność kolumn nie ma znaczenia.
    • Główne pola karty — nazwa, cena, stan, kategoria, opis i zdjęcia trafiają do własnych pól karty.
    • Formaty wartości — jakie długości i kody przyjmuje Prom.
    • Dostępność — symbole Prom stają się statusami, a w eksporcie są liczone z bieżącego statusu.
    • Pola dodatkowe — pozostałe kolumny Prom są w całości zachowywane w karcie.
    • Cechy, warianty i grupy — przenoszone do atrybutów, pola wariantów i drzewa kategorii.
    • Droga powrotna — te same pola eksportują się z powrotem na Prom.

    Jak Elbuz czyta plik: dwa arkusze

    Oficjalny opis formatu jest w pomocy Prom: Імпорт через Excel — формат файлів XLS(X) та CSV (import przez Excel — format plików XLS(X) i CSV). Tutaj wyjaśniamy, jak ten sam format czyta i zachowuje właśnie Elbuz.

    Plik Excel z Prom (XLS/XLSX) zawiera dwa arkusze, a Elbuz czyta je po nazwach:

    • „Export Products Sheet” — produkty. Każdy wiersz oprócz pierwszego to jeden produkt; pierwszy wiersz to nagłówki kolumn.
    • „Export Groups Sheet” — grupy (kategorie): ich numery, nazwy, identyfikatory i powiązanie „rodzic–dziecko”.

    W formacie arkusz jest tylko jeden (same produkty), w kodowaniu lub UTF-16.

    Pierwszy wiersz każdego arkusza to nagłówki: Elbuz porównuje je ze znanymi nazwami pól i w ten sposób ustala, co jest w której kolumnie. Nazwy są rozpoznawane zarówno po rosyjsku, jak i po ukraińsku (Код_товара = Код_товару, Название_позиции = Назва_позиції itd.), więc obie wersje językowe pliku czyta się tak samo.

    Kolejność kolumn nie ma znaczenia — ważna jest nazwa w nagłówku; jeśli którejś kolumny brakuje, odpowiednie pole zostanie puste.

    Z trzech formatów, które potrafi wydać Prom, Elbuz czyta tylko .xlsx. Pole wyboru pliku przepuszcza tylko takie rozszerzenie, a na serwerze plik jest dodatkowo sprawdzany pod kątem początku skoroszytu Open XML — stary .xls i .csv przemianowane na .xlsx też nie przejdą.

    Niewłaściwy plik zatrzymuje przebieg jeszcze przed analizą komunikatem „Plik nie jest skoroszytem XLSX. Prom.ua i Satu.kz eksportują katalog w formacie .xlsx — stary format .xls nie jest obsługiwany. Otwórz plik w Excelu i zapisz jako «Skoroszyt programu Excel (.xlsx)».”, a katalog w ogóle się przy tym nie zmienia.

    Gdzie trafiają główne wartości karty

    Część kolumn trafia wprost do własnych pól karty produktu — tych, które są w każdej karcie Elbuz:

    Kolumna plikuPole karty w Elbuz
    Назва_позиції / Назва_позиції_укрnazwa produktu (wersja ukraińska — do ukraińskiej wersji językowej karty)
    Ціна + Валютаcena (przeliczana na Twoją walutę bazową po kursie)
    Кількістьstan
    Наявністьstatus dostępności (zob. część o symbolach)
    Номер_групи / Назва_групи / Ідентифікатор_групиkategoria produktu (powiązanie z drzewem z arkusza grup)
    Виробникproducent (nowego producenta Elbuz sam dodaje do słownika)
    Опис / Опис_укрopis produktu (wersja ukr. — do ukraińskiej wersji językowej)
    HTML_заголовок / HTML_опис / HTML_ключові_слова (+ _укр)meta-title, meta-description, meta-keywords karty
    Вага, Ширина, Висота, Глибина, Довжинаpola wagi i wymiarów karty
    Код_маркування_()GTIN (kod kreskowy dla Google Merchant)
    Посилання_зображенняzdjęcia produktu (kilka rozdzielonych przecinkiem i spacją; pierwszy — główne)

    Kod (Код_товару) zapisuje się od razu w dwóch polach karty — kod i .

    Przed zapisaniem cena jest sprowadzana do Twojej waluty bazowej: jeśli ceny w pliku są w innej walucie, Elbuz bierze kurs według kodu waluty i przelicza. Kategoria produktu łączy się z drzewem grup z arkusza „Export Groups Sheet”, a jeśli grupy produktu tam nie ma, jest tworzona automatycznie z numeru i nazwy podanych w samym wierszu produktu.

    W Prom obowiązuje osobna zasada: żeby zaktualizowała się ukraińska wersja produktu, w pliku muszą być wypełnione oba ukraińskie pola — i Назва_позиції_укр, i Опис_укр. Jeśli wypełnisz tylko jedno z nich, tłumaczenie po stronie Prom się nie zaktualizuje.

    Elbuz przyjmuje ukraińskie pola do ukraińskiej wersji językowej karty bez zmian — ale pamiętaj o tej zasadzie Prom, gdy przygotowujesz plik do eksportu zwrotnego.

    Jakie formaty i limity wartości przyjmuje Prom

    Pola Prom mają konkretne formaty i plik warto przygotować z ich uwzględnieniem — inaczej marketplace odrzuci wiersz albo przytnie wartość:

    • Код_товару — do 25 znaków (cyfry, cyrylica, alfabet łaciński, znaki - _ . / i spacja).
    • Назва_позиції — do 110 znaków (wersja ros.), Назва_позиції_укр — do 130.
    • Опис / Опис_укр — do 12 160 znaków; HTML_заголовок/опис — do 250 (ros.) / 270 (ukr.).
    • Ціна — liczba od 0.01; Валюта — kod (UAH, USD, EUR, PLN, KZT…) lub skrót (грн, дол, $).
    • Тип_товару — litera: r — tylko detal, w — tylko hurt, u — hurt i detal, s — usługa.
    • Одиниця_виміру — z listy Prom (szt., opakowanie, komplet, para, m, kg, l, zestaw…).
    • Оптова_ціна i Мінімальне_замовлення_опт — kilka wartości rozdzielonych ;; Подарунки/Супутні — numery wierszy lub rozdzielone ;.
    • Знижка — liczba lub procent (na przykład 12.5 albo 30%) z datami obowiązywania „od/do”.

    Elbuz zapisuje te wartości tak, jak są w pliku (w odpowiednich polach karty — zob. niżej), a zgodność z wymaganiami Prom sprawdza już sam marketplace przy eksporcie. Dlatego czysty, poprawny pod względem formatu plik oszczędza czas po obu stronach.

    Jak przekładana jest dostępność: symbole Prom i formuła zwrotna

    Dostępność w pliku Prom jest kodowana symbolami, a Elbuz przekłada je na swoje statusy dostępności:

    • + (lub ! — „gotowe do wysyłki”) → dostępny;
    • - → brak w magazynie;
    • & → oczekiwany;
    • cyfra (na przykład 7) → na zamówienie (liczba dni do dostawy);
    • puste pole lub dowolna inna wartość (w tym @) → podstawowy status „dostępny” Twojego katalogu.

    Pole dostępności działa w obie strony. Razem z polem dodatkowym «Наличие_xls» Elbuz tworzy dla niego formułę, która liczy symbol Prom nie ze starej wartości z pliku, lecz z bieżącego statusu dostępności produktu w Twoim katalogu:

    • status „dostępny” → +;
    • „brak w magazynie” → -;
    • „oczekiwanie” → &;
    • „przedsprzedaż” → 5;
    • status założony przez Ciebie → +, jeśli ilość jest większa od zera, w przeciwnym razie -.

    Standardowe statusy formuła rozpoznaje po ich numerze, więc zmiana nazwy statusu na nią nie wpływa. Dlatego gdy eksportujesz katalog z powrotem na Prom, dostępność jest zawsze aktualna — taka, jaka jest teraz w Twoim systemie, a nie zamrożona w chwili importu.

    Gdzie trafiają pola Prom, których nie ma w karcie

    Prom ma znacznie więcej pól niż standardowa karta produktu. Żeby niczego z pliku nie stracić, Elbuz podczas importu sam tworzy w katalogu bazowym odpowiednie pola dodatkowe i zapisuje w nich te wartości.

    Czyli karta nie „przycina” pliku Prom do kilku standardowych pól — zachowuje całą jego zawartość. Oto główne grupy takich pól, które pojawiają się w karcie po pierwszym imporcie:

    • Ceny i zamówienia: Оптова_ціна, Мінімальний_обсяг_замовлення, Мінімальне_замовлення_опт, Ціна_від, Знижка, Термін_дії_знижки_від/до.
    • Logistyka i pakowanie: Можливість_постачання, Термін_поставки, Спосіб_пакування (+ ukr.), Одиниця_виміру, Де_знаходиться_товар, Країна_виробник. Гарантійний_термін nie dostaje osobnego pola — zapisuje się w standardowym polu gwarancji karty.
    • Klasyfikacja Prom: Тип_товару, Ярлик, Номер_групи, Назва_групи, Ідентифікатор_підрозділу, Ідентифікатор_групи, ID_групи_різновидів, Номер_пристрою_(MPN).
    • Treść i : Ключові_слова, Пошукові_запити, Особисті_нотатки oraz ukraińskie wersje nazwy, opisu i pól meta.
    • Powiązania i pola techniczne: Подарунки, Супутні (i ich ID), Товар_на_видалення i Причина_видалення, Унікальний_ідентифікатор (osobne indeksowane pole na wewnętrzny numer Prom).

    W karcie te pola mają nazwy z rosyjskiej wersji pliku Prom: «Оптовая_цена», «Тип_товара», «Уникальный_идентификатор», a rabat — «Скидка_xls». Widać je obok standardowych i można z nimi pracować jak ze zwykłymi: filtrować, pokazywać w tabeli, używać w formułach i — co najważniejsze — eksportować z powrotem.

    Karta produktu, sekcja „Pozostałe pola”: pola użytkownika nazwane jak kolumny pliku Prom
    1Pole unikalnego identyfikatora
    2Pole ceny hurtowej
    1. Pole unikalnego identyfikatora przechowuje wewnętrzny numer pozycji na Prom.
    2. Pole ceny hurtowej to jedno z dziesiątek pól z pliku Prom zachowanych w produkcie.

    Jak importowane są cechy

    Cechy produktu Prom trzyma w trójkach kolumn, które zawsze idą w ścisłej kolejności: Назва_Характеристики, Одиниця_виміру_Характеристики, Значення_Характеристики (nazwa, jednostka, wartość cechy). Takich trójek w pliku może być wiele — po jednej na każdą cechę, a kolumna jednostki musi być obecna, nawet jeśli jest pusta. Wiele wartości jednej cechy rozdziela się znakiem | (na przykład Aluminium | Plastik).

    Elbuz rozpoznaje te trójki po nagłówku i przenosi do atrybutów produktu: nazwa staje się atrybutem, wartość — jego wartością, a jednostka (cm, kg, W…) jest automatycznie dodawana do słownika jednostek, jeśli jeszcze jej tam nie ma.

    Cechy importują się automatycznie razem z resztą danych pliku — nie trzeba ich osobno włączać. Jeśli produkt nie ma atrybutów, w pliku nie było odpowiednich trójek kolumn albo nie udało się ich rozpoznać po nagłówku.

    Jak zachowywane są warianty produktu

    Prom oznacza warianty jednego produktu (kolory, rozmiary itp.) polem ID_групи_різновидів (ID grupy wariantów): wszystkie wiersze z tą samą wartością tego pola i wypełnionymi cechami są uznawane za warianty jednego produktu, a pierwszy wiersz w grupie — za podstawowy.

    Elbuz zachowuje to pole, więc powiązanie wariantów nie gubi się przy eksporcie zwrotnym. Jeśli prowadzisz warianty na Prom, trzymaj ID_групи_різновидів w pliku wypełnione — to ono trzyma warianty razem.

    Jak arkusz grup staje się drzewem kategorii

    Drzewo kategorii Elbuz buduje z arkusza grup.

    • Każda grupa ma Номер_групи (numer na stronie Prom), nazwę (i jej wersję ukr.), Ідентифікатор_групи (zewnętrzny ID — na przykład numer grupy w Twoim ), a zagnieżdżenie wyznaczają pola Номер_батьківської_групи i Ідентифікатор_батьківської_групи (dla grup głównych są puste).
    • Są też pola SEO grupy oraz opisy „przed” i „po” liście produktów.
    • Grupy są dopasowywane przede wszystkim po identyfikatorze, a jeśli go nie ma — po numerze; nowe są tworzone, istniejące aktualizowane.
    • Jeśli produkt odwołuje się do grupy, której nie ma w arkuszu grup, Elbuz utworzy ją z danych samego wiersza produktu, żeby pozycja nie została „bezdomna”.
    Jak grupa z arkusza grup znajduje swoją kategorię: najpierw po identyfikatorze grupy, potem po numerze grupy. Dolne rozwidlenie — co stanie się kluczem nowej kategorii
    TakNieTakNieTakNieGrupa z arkusza „Export GroupsSheet”Jest kategoria z takim„Ідентифікатор_групи”?Istniejąca kategoria jestaktualizowanaJest kategoria z takim„Номер_групи”?Powstaje nowa kategoriaWypełniono„Ідентифікатор_групи”?Staje się kluczem kategoriiKluczem staje się „Номер_групи”
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    Jak te pola wracają na Prom

    Format Prom jest zbudowany tak, że plik importu i plik eksportu są takie same. Dlatego pola, do których import zapisał dane, to te same pola, z których dane potem eksportują się z powrotem na Prom. W szczególności nasz produktu przy eksporcie wraca do kolumny Ідентифікатор_товару, a pole dodatkowe «Унікальний_ідентифікатор» — do kolumny o tej samej nazwie.

    Produkt utworzony w Elbuz trafia do pliku eksportu z własnym UUID w kolumnie Ідентифікатор_товару i z pustym Унікальний_ідентифікатор — Prom doda go jako nowy, a istniejące zaktualizuje. Pełna kolejność wymiany: eksport na Prom (XLSX).

    UUID produktu (czyli Ідентифікатор_товару na Prom) i «Унікальний_ідентифікатор» to klucze synchronizacji. Jeśli zmienisz UUID istniejącego produktu, Prom przy następnym eksporcie uzna go za nowy i zdubluje pozycję. Dlatego tych pól nie edytuje się ręcznie — import i eksport zarządzają nimi same.

    Nie usuwaj automatycznie utworzonych pól Prom, nawet jeśli któreś z nich nie jest Ci teraz potrzebne. To właśnie one zapewniają eksport zwrotny bez strat: jeśli usuniesz pole, odpowiednia kolumna w eksporcie na Prom pojedzie pusta.

    Najczęstsze pytania

    Czy można zaimportować stary .xls lub CSV z Prom?

    Nie, szablon przyjmuje tylko .xlsx. Otwórz plik w Excelu i zapisz jako „Skoroszyt programu Excel (.xlsx)”. Nieudana próba nie zmienia katalogu. Więcej: jak Elbuz czyta plik.

    Dlaczego na Prom nie zaktualizowała się ukraińska nazwa lub opis produktu?

    W Prom wersja ukraińska aktualizuje się tylko wtedy, gdy w pliku wypełnione są oba ukraińskie pola — i Назва_позиції_укр, i Опис_укр. Jeśli wypełnione jest tylko jedno, Prom je zignoruje. Więcej: główne wartości karty.

    Dlaczego dostępność w eksporcie nie zgadza się z tym, co było w pliku?

    Bo symbol dostępności jest liczony formułą z bieżącego statusu produktu w Twoim katalogu, a nie brany z pliku „bez zmian”. Na Prom idzie aktualna dostępność. Więcej: jak przekładana jest dostępność.

    Dlaczego nie zaimportowały się cechy?

    W pliku nie było trójek kolumn „nazwa / jednostka / wartość cechy” albo nie rozpoznano ich po nagłówku — kolumny muszą iść właśnie w tej kolejności. Cech nie trzeba osobno włączać. Więcej: cechy.

    Dlaczego pola dodatkowe w karcie mają rosyjskie nazwy?

    Elbuz zakłada je pod nazwami z rosyjskiej wersji pliku Prom — «Оптовая_цена», «Тип_товара», «Уникальный_идентификатор» — niezależnie od języka Twojego pliku. Wartości trafiają do nich te same. Więcej: pola Prom, których nie ma w karcie.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Import danych → szablon „XLSX - prom.ua, satu.kz”
    Gdzie widać wynik
    karta produktu, „Pozostałe pola” → „Pola użytkownika”
    Uprawnienia
    okno „Import danych” w „Uprawnieniach grup”
    Przygotuj
    plik .xlsx wyeksportowany z Prom

    Jak skonfigurować szablon i uruchomić import — w artykule przeniesienie katalogu z Prom.ua plikiem 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