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 pliku | Pole 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.5albo30%) 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.
1
Pole unikalnego identyfikatora2
Pole ceny hurtowej- Pole unikalnego identyfikatora przechowuje wewnętrzny numer pozycji na Prom.
- 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 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
- Jeśli potrzebujesz ogólnego obrazu — jak przenieść i regularnie aktualizować katalog z Prom: import katalogu z Prom.ua plikiem XLSX.
- Jeśli kolejny import utworzył duplikaty — jak program rozpoznaje produkt.
- Jeśli katalog trzeba odesłać na Prom — eksport na Prom.ua (XLSX).
- Jeśli marketplace wydaje katalog w XML — import katalogu z XML.
