↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak zmapować cennik XML, BMEcat, DATANORM, JSON i CSV

    7 min czytaniaZaktualizowano

    Mapowanie jest takie samo dla wszystkich formatów, różni się adres: w tabeli to litera lub numer kolumny, w XML — nazwa tagu, w JSON — numer kolumny rozwiniętej tabeli. Elbuz sam znajduje wiersz nagłówków w Excelu, separator CSV i tagi feedu XML.

    Kiedy to się przyda:

    • Dostawca udostępnia feed XML — adresy dobierają się automatycznie, nazw tagów nie trzeba wpisywać.
    • XML z własnymi tagami — wpisujesz je ręcznie, AI podpowiada strukturę.
    • W CSV zamiast nagłówków są niezrozumiałe znaki — chodzi o kodowanie pliku, a nie o mapowanie.
    • Cennik w BMEcat lub DATANORM — plik mapuje się sam.
    • Cennik w JSON — plik rozwija się w tabelę, a adresy ustawia się numerami kolumn.

    Od czego zacząć: wybierz swój format.

    Jaki masz format

    Logika mapowania jest jedna dla wszystkich formatów, ale to, co dokładnie wpisać w adres, zależy od tego, co przysłał dostawca.

    • Skoroszyt ExcelAdres to litera lub numer kolumny; program sam szuka wiersza nagłówków
    • CSV, TXT lub TSVAdres to numer kolumny; osobno liczą się separator i kodowanie pliku
    • XMLAdres to nazwa tagu, atrybuty w nawiasach kwadratowych; do tego cztery gałęzie struktury feedu
    • BMEcatNie trzeba mapować: program sam rozpoznaje katalog i rozkłada pola
    • DATANORMNie trzeba mapować; ważne, jak przesłano plik cen i czy włączone jest zaokrąglanie
    • JSONAutomatycznego dopasowania nie ma wcale: plik rozwija się w tabelę, adresy ustawia się ręcznie

    Jakie rozszerzenia i archiwa przyjmuje program i jak rozpoznaje feed z nietypowym rozszerzeniem — Jakie pliki są obsługiwane.

    Co wpisać w adres dla skoroszytu Excel

    Adres to litera kolumny lub jej numer. Kolumny i przykładowe wartości program bierze z podglądu arkusza, więc w kreatorze widzisz to samo co w pliku.

    Wiersz nagłówków to wiersz z największą liczbą zgodności z zapisanymi nazwami kolumn; jeśli takiego nie ma, brany jest wiersz przed pierwszym wierszem danych. Techniczny wiersz numeracji, który rysuje sam Excel, jest pomijany. Zdarza się, że nazwa arkusza trafia do mapowania jako „kolumna” — takie wiersze program odrzuca, porównując je z nazwami arkuszy.

    Jeszcze jeden niuans, który chroni przed błędnym wnioskiem. Przykładowe wartości w kreatorze są dobierane według tekstu nagłówka, a dopiero gdy takiego nagłówka w wierszu nie ma — według numeru kolumny. Możesz więc widzieć w kreatorze poprawne przykłady nawet wtedy, gdy dostawca przesunął kolumny.

    Sam adres to jednak litera lub numer i import czyta go dosłownie: gdy dostawca przestawi kolumny, adresy trzeba poprawić. Program pomoże to zauważyć: po udanym imporcie zapamiętuje nagłówki kolumn, a następnym razem porównuje z nimi nowy plik. Jak to wygląda — w scenariuszu „Dostawca dodał kolumny na początku pliku”.

    Jak zmapować CSV, TXT i TSV

    Adres to numer lub litera kolumny; numeracja zaczyna się od jedynki w pierwszym wierszu pliku. Dwie rzeczy, które decydują o losie takiego cennika, leżą poza mapowaniem.

    Pierwsza to separator. Jest brany z ustawień źródła, a jeśli nie jest ustawiony, program wykrywa go sam na podstawie pierwszych piętnastu wierszy. Tabulator można zapisać jako \t. Druga to : jeśli w cenniku nie oznaczono, że plik jest w , zawartość jest przekodowywana z windows-1251. Gdy w kreatorze zamiast nagłówków widać „Ð¦ÐµÐ½Ð°”, chodzi właśnie o kodowanie, a nie o mapowanie.

    Jak zmapować feed XML

    Najpierw upewnij się, że potrzebujesz właśnie cennika. Plik XML można wczytać na dwa różne sposoby i prowadzą one w różne miejsca. Cennik to asortyment dostawcy: jego ceny porównuje się z Twoimi, produkty dopasowuje do katalogu, a na wierzch nakłada się narzut. Import katalogu z XML to sytuacja, gdy feed opisuje Twój własny asortyment i ma trafić prosto do kart, bez dopasowań i narzutów.

    Tutaj adres to nazwa tagu, a nie litera. Atrybut węzła zapisuje się w nawiasach kwadratowych: [id], [available]. Automatyczne dopasowanie porównuje nazwy tagów ze słownikiem dokładnie, słowo w słowo. Taki adres można wpisać zarówno w komórce tabeli pól karty, jak i w panelu „Skonfiguruj kolumnę” kreatora — dla źródła XML kontrola formatu nie jest tam stosowana.

    Adres złożony działa w feedzie inaczej niż w tabeli. Kilka tagów po przecinku feed XML skleja — także dla ceny, czyli zasada „brana jest pierwsza niepusta” tu nie obowiązuje; w polu ceny ze sklejonego ciągu zostają potem same cyfry. Wyjątek jest ten sam co w tabeli: wartości tagów dla pola „Ilość” są sumowane.

    Tagi skleja się tak samo jak kolumny tabeli: bez odstępu, a separator ustawia się tekstem w nawiasach klamrowych. Za to zakres 7-9 i lista po kresce pionowej 11|12 w feedzie nie działają: adres jest tam nazwą tagu, myślnik występuje w samych nazwach (offer-name), a kreska pionowa w XPath oznacza już sumę zbiorów wyników.

    Kilka znanych feedów mapuje się tak samo, bo mają standardowe tagi. Dla feedów w formacie , w którym katalogi udostępnia większość marketplace’ów i systemów , adresy dobierają się automatycznie — nie trzeba ręcznie wpisywać nazw tagów.

    Google Merchant ma własne tagi, ale też stałe: g:id, title, g:price, g:availability, g:brand, g:mpn, link, g:image_link — wpisuje się je w pola docelowe jak zwykłe adresy.

    Jeśli jednak dostawca przysłał z własnymi nazwami węzłów — a zdarza się to częściej, niż by się chciało — automatyczne dopasowanie nie zadziała i adresy trzeba będzie ustawić ręcznie. To normalna sytuacja, a nie awaria: przejrzyj sam plik, znajdź tag produktu i tagi pól, wpisz ich nazwy.

    W kreatorze dla XML nie ma przykładowych wartości — zamiast nich w wierszach widać „—”. To nie błąd odczytu: podgląd dla feedu po prostu nie jest budowany i trzeba kierować się samymi nazwami tagów.

    Oprócz kolumn dla XML ustawia się cztery gałęzie struktury — osobna sekcja „Struktura XML” w karcie: „tag produktu”, „tag kategorii”, „tag listy atrybutów”, „tag listy zdjęć”. Automatyczne wykrywanie wypełnia tylko puste gałęzie, tego, co już ustawiono, nie nadpisuje. Najważniejszy jest tag produktu: bez niego feed w ogóle nie zostanie odczytany, dlatego wypełnia się go praktycznie zawsze.

    Sekcja „Struktura XML” w karcie źródła cennika XML
    1Tag produktu
    2Przycisk „Powiąż automatycznie”
    3Kursy walut z pliku
    1. Tag produktu — element XML, który obejmuje jeden produkt w feedzie.
    2. „Powiąż automatycznie” — wykrywa strukturę feedu i mapuje tagi przez AI (podczas zrzutu nie kliknięto).
    3. „Pobieraj kursy walut z pliku” — odczytuje kursy z tagu currencies feedu.

    Dla XML karta ma też analizę struktury feedu przez AI: przycisk „Powiąż automatycznie” w tej samej sekcji, pod nim — „Znalezione tagi” w postaci plakietek, tabela „Pole systemu ← Tag” z przyciskiem „Dodaj wiersz”, przycisk „Zastosuj powiązanie” i rozwijany blok „Przykładowy węzeł produktu”. Dla tego bloku nie ma.

    Tam też jest pole „Pobieraj kursy walut z pliku (tag currencies)”. Podpowiedź wyjaśnia je dosłownie: „Jeśli włączone, ceny są przeliczane według kursów z bloku currencies pliku. Jeśli wyłączone — używane są kursy podane w kolumnach cennika lub w słowniku walut.”

    Dwie kontrole, które w pozostałych formatach zatrzymują import, w XML w ogóle nie są wykonywane: feed trafi do przetwarzania nawet z pustym mapowaniem, a komunikatu o niewypełnionych adresach nie zobaczysz. Dlatego w XML „import się uruchomił” nie oznacza jeszcze „mapowanie jest poprawne” — sprawdzaj liczbę wczytanych produktów i same produkty.

    Jak wczytać katalog BMEcat

    wczytuje się jak zwykły cennik: plikiem, z linku, e-mailem lub z FTP, także w archiwum. Program rozpoznaje katalog po zawartości, a nie po nazwie, więc rozszerzenie może być dowolnym z dozwolonych, na przykład .xml lub .txt. Elementy są czytane tak samo we wszystkich wersjach; sprawdzono na katalogach 1.01, 1.2 i 2005.

    Nowy cennik mapuje się sam: tag produktu i adresy kolumn ustawiają się po pierwszym wczytaniu według pól obecnych w pierwszych 50 produktach pliku. Kreator dodawania źródła i nowe źródło dodatkowo przepuszczają plik przez automatyczne dopasowanie z AI, więc sprawdź wynik w sekcji „Kolumny”.

    Ponowne wczytanie trafia do już zapisanego mapowania, Twoje poprawki nie są nadpisywane.

    Sekcja „Kolumny” źródła BMEcat: tabela pól i adresów obok podglądu pliku
    1Adres code
    2Podgląd pliku
    1. Adres code przenosi indeks dostawcy z pliku BMEcat do pola „Kod kontrahenta”.
    2. Podgląd pliku pokazuje katalog przekształcony do formatu wewnętrznego, z source_format="bmecat" w tagu głównym.
    Pole ElbuzSkąd pochodzi
    Kod kontrahentaindeks katalogu (SUPPLIER_AID lub SUPPLIER_PID)
    Kod producentaMANUFACTURER_AID lub MANUFACTURER_PID
    EANEAN lub INTERNATIONAL_PID typu ean albo gtin; 14 cyfr z zerem na początku staje się EAN-13
    Nazwa i opiskrótki i długi opis w głównym języku katalogu
    Producent, jednostkaMANUFACTURER_NAME, jednostka zamówienia ORDER_UNIT
    Kategoriapierwsza grupa katalogu, do której przypisano produkt
    Zdjęciaobrazy z pełnym adresem; ścieżki względne — jeśli w katalogu podano adres strony (MIME_ROOT); miniatury są pomijane

    Jak liczona jest cena

    Cena w cenniku jest za jednostkę zamówienia: kwota × mnożnik ÷ ilość, dla której podano tę kwotę. Na przykład 81,04 z mnożnikiem 0,8 da 64,832, a 500 za 100 sztuk da 5. Przecinek dziesiętny też jest odczytywany. Jeśli progów jest kilka, brany jest próg z najmniejszą ilością.

    Jeśli produkt ma kilka typów cen, brana jest pierwsza dostępna w tej kolejności: umowna (net_customer), umowna eksportowa (net_customer_exp), cennikowa bez VAT (net_list), cennikowa z VAT (gros_list), sugerowana (nrp). Sugerowana cena cennika to nrp, a jeśli jej nie ma — gros_list, o ile ten typ nie został użyty jako cena główna.

    Sprawdź walutę po pierwszym wczytaniu. Ustawia ją kolumna „Waluta” w wierszach „Cena” i „Cena sugerowana (RRP)” sekcji „Kolumny”. Jeśli jest pusta, liczby są czytane w walucie domyślnej: katalog w euro da te same liczby w złotych. Kreator sam uruchamia import, więc po poprawieniu waluty uruchom go jeszcze raz, a dopiero potem stosuj ceny. Automatyczne dopasowanie może zresetować już wybraną walutę, dlatego sprawdź ją po nim.

    Rekord z oznaczeniem usunięcia (mode="delete") nie trafia do cennika. Produkt bez kwoty, w tym „cena na zapytanie”, wczyta się bez ceny.

    Katalog aktualizacji cen (T_UPDATE_PRICES) zwykle zawiera tylko indeks i cenę; nie ma w nim ilości, dla której podano kwotę, więc cena „500 za 100 sztuk” zostanie odczytana jako 500. Cechy (FEATURE) nie są przenoszone.

    Ucięty lub uszkodzony katalog nie wczytuje się częściowo: plik zostaje bez zmian, produkty z niego nie zostaną odczytane. Poproś dostawcę o przesłanie pełnego pliku.

    Jak wczytać cennik DATANORM

    wczytuje się jak zwykły cennik. Obsługiwane są wersje 4 i 5, program rozpoznaje plik po zawartości i przyjmuje rozszerzenia w rodzaju .001. Nowy cennik mapuje się sam: nie trzeba mapować kolumn, sprawdź adresy w sekcji „Kolumny”.

    Sekcja „Kolumny” źródła DATANORM: tabela pól i adresów obok podglądu pliku
    1Adres code
    2Podgląd pliku
    1. Adres code przenosi indeks dostawcy z danych DATANORM do pola „Kod kontrahenta”.
    2. Podgląd pliku pokazuje przekształcony katalog z source_format="datanorm" w tagu głównym.
    Co przysłał dostawcaCo zrobić
    Plik DATANORM.001 z cenami w wierszach indeksówwczytać plik
    Archiwum ZIP z DATANORM.nnn, DATPREIS.nnn, .WRG, .RABwczytać archiwum: komplet złoży się sam w jednym wczytaniu, wersje 4 i 5. Nazwy plików muszą być standardowe: plik o innej nazwie nie trafi do kompletu
    Osobne DATANORM.001 i DATPREIS.001, wersja 5spakować do jednego ZIP albo podłączyć plik cen jako źródło powiązane
    Osobne DATANORM.001 i DATPREIS.001, wersja 4spakować do jednego ZIP: osobno taki plik cen nie jest przyjmowany, bo nie ma w nim jednostki ceny

    Ceny w osobnym pliku: źródło powiązane dla wersji 5

    1. Wczytaj DATANORM.001 do źródła głównego i uruchom import.
    2. Przycisk „Dodaj” → „Cennik stanów do „…””, potwierdź.
    3. Wczytaj DATPREIS.001 do nowego źródła i uruchom jego import.

    Mapowanie i pola „Kopiuj wartość do cennika głównego” dla ceny, RRP i statusu dostępności ustawiają się same, a podczas importu drugiego źródła pary są szukane po kodzie kontrahenta. Indeksy, których nie ma w pliku cen, dostaną status „brak w magazynie”. Walutę ustaw także w drugim źródle. W jego wierszach nazwa jest równa indeksowi — to normalne. Przy każdej aktualizacji kolejność jest ta sama: najpierw źródło główne, potem drugie. Jak działa taki cennik — cennik stanów. Jeśli pliki da się spakować do ZIP, jest prościej: jedno wczytanie zamiast trzech kroków.

    Jak liczona jest cena

    Brana jest pierwsza dostępna kwota: netto z pliku cen, cena cennikowa z pliku cen, cena w wierszu indeksu, najniższy próg cenowy. Kwota jest dzielona przez jednostkę ceny pliku, zwykle 1, 10, 100 lub 1000 sztuk. Jeśli jest i netto, i cena cennikowa, cena cennikowa trafia do RRP. Walutę sprawdź tak samo jak dla BMEcat.

    „Zaokrąglaj w górę” psuje drobne ceny. To ustawienie działa też na DATANORM, a tu cenę często podaje się za 100 lub 1000 sztuk: 84,70 za 100 sztuk da 0,847, a w cenie pojawi się 1. Dokładna kwota jest zapisana w kolumnie „Cena z cennika”, ale wyświetla się z dwoma miejscami po przecinku: 0,85. Ustawienie działa na wszystkie ceny programu, dla pojedynczego produktu nie da się go wyłączyć. Jeśli drobny towar jest ważniejszy, wyłącz „Zaokrąglaj w górę” i „Zaokrąglaj w dół”: ceny będą zaokrąglane do dwóch miejsc.

    Czego program nie uwzględnia

    • Wersja 3 się nie wczytuje: „DATANORM w wersji 3 nie jest obsługiwany, cennik nie został wczytany. Poproś dostawcę o wersję 4 lub 5.”
    • Rabat dostawcy (Rabatt). Cena wczytuje się bez rabatu, a dziennik importu poda, ile indeksów go ma. Cenę zakupu sprawdź samodzielnie.
    • Dopłata za miedź nie jest doliczana do ceny, o tym też jest wiersz w dzienniku. Cena kabla bez niej jest wyraźnie niższa od końcowej.
    • Progi cenowe. Najniższy próg jest brany tylko wtedy, gdy nie ma innych kwot; ceny za większe partie nie są przenoszone.
    • Nazwy i teksty są ograniczone przez format: dwa pola po 40 znaków, więc nazwa od dostawcy może być ucięta.

    Ucięty lub uszkodzony plik się nie wczytuje, poprzedni plik cennika zostaje: „DATANORM: plik jest ucięty lub uszkodzony, cennik nie został wczytany. Pobierz plik od dostawcy ponownie.” Przy wczytywaniu plikiem błąd widać od razu w oknie. Z linku, e-mailem i z FTP import idzie na starym pliku, w dzienniku pojawi się ten błąd i wiersz „Nadal działają produkty z poprzedniego pliku.”, a przebieg dostanie status błędu.

    Uszkodzone lub chronione hasłem archiwum, a także archiwum powyżej 2 GB, się nie wczytuje: „Archiwum jest uszkodzone, chronione hasłem lub zbyt duże. Plik nie został wczytany.” Jeśli w cenniku nie ma znacznika końca, nie da się sprawdzić kompletności: plik się wczyta, w dzienniku pojawi się ostrzeżenie z liczbą indeksów — porównaj ją z dostawcą.

    Jak zmapować JSON

    Format jest obsługiwany, plik się wczytuje — ale automatycznego dopasowania dla niego nie ma na żadnym z trzech poziomów: ani przy analizie pliku, ani przyciskiem, ani w automatycznej konfiguracji źródła. Mapowanie jest tu w pełni ręczne.

    Żeby było jasne, co wpisać w adres: program rozwija JSON w tabelę. Bierze tablicę produktów — domyślnie products albo tę, którą wskażesz w polu „tag produktu” — pierwszy rekord daje nazwy kolumn, pozostałe stają się wierszami, a zagnieżdżone struktury są spłaszczane do osobnych kolumn. Adres dla JSON to numer kolumny w tej rozwiniętej tabeli.

    Jeśli kolumn jest dużo, prościej poprosić dostawcę o XML lub .

    Scenariusze

    Dostawca udostępnia feed XML

    Dodaj feed jak zwykłe źródło i uruchom import. Efekt: adresy tagów dobiorą się automatycznie, zostaje sprawdzić tag produktu w sekcji „Struktura XML” i liczbę wczytanych produktów.

    Dostawca udostępnia feed Google Merchant

    Wpisz w pola docelowe stałe tagi Merchant — ich lista jest w części o XML. Efekt: feed jest czytany tak samo jak zwykły feed XML dostawcy, a mapowanie nie zmieni się przy następnym pliku.

    Dostawca przysyła katalog BMEcat

    Utwórz źródło i wczytaj plik. W sekcji „Kolumny” sprawdź adresy i wybierz walutę w wierszach cen, potem uruchom import. Efekt: w cenniku będzie cena za jednostkę zamówienia; zostaje porównać ją na kilku produktach i sprawdzić liczbę wczytanych wierszy.

    Dostawca przysyła DATANORM.001 i DATPREIS.001

    Spakuj pliki do jednego ZIP i wczytaj jako cennik. Efekt: indeksy i ceny staną się jednym cennikiem w jednym wczytaniu, a cena za 100 sztuk zostanie przeliczona na sztukę. Sprawdź dziennik importu i ustawienia zaokrąglania, jeśli masz produkt tańszy niż jednostka waluty.

    XML z własnymi nazwami węzłów

    Rozwiń blok „Przykładowy węzeł produktu”, znajdź tag produktu i tagi pól. Kliknij „Powiąż automatycznie” w sekcji „Struktura XML”, a to, czego AI nie powiązało, dopisz w tabeli „Pole systemu ← Tag”. Efekt: po kliknięciu „Zastosuj powiązanie” feed zostanie odczytany według Twoich tagów.

    Co zrobić, gdy feed nie został odczytany

    Omówienie częstych problemów
    Co widziszDlaczego tak jestCo zrobić
    „Nie znaleziono węzła produktu (‹tag›) w XML” W feedzie nie ma węzła o takiej nazwie: jest ustawiony błędnie lub jest pusty Wpisz „tag produktu” ręcznie w sekcji „Struktura XML” — znajdziesz go w bloku „Przykładowy węzeł produktu” (o XML)
    „Struktura wykryta. AI nie powiązało pól — ustaw tagi ręcznie poniżej.” Struktura feedu została odczytana, ale AI nie zaproponowało par „pole — tag” Wypełnij ręcznie tabelę „Pole systemu ← Tag” i kliknij „Zastosuj powiązanie” (o XML)

    Najczęstsze pytania

    W XML zamiast przykładowych wartości widać „—”. Czy to błąd?

    Nie. Dla feedu podgląd wartości nie jest budowany, a w wierszach kreatora jest kreska. Kieruj się nazwami tagów, a fragment feedu obejrzyj w bloku „Przykładowy węzeł produktu” w sekcji „Struktura XML”.

    Dla JSON automatyczne dopasowanie nie działa. Co zrobić?

    Zmapować ręcznie. Program rozwija JSON w tabelę: bierze tablicę produktów (domyślnie products), a pierwszy rekord daje nazwy kolumn. Adres to numer kolumny w tej tabeli.

    Feed XML zaimportował się bez błędu, a produktów nie ma. Dlaczego?

    W XML kontrole niewypełnionych adresów nie są wykonywane, więc feed trafi do przetwarzania nawet z pustym mapowaniem. Sprawdź tag produktu i liczbę wczytanych produktów. Więcej: mapowanie XML.

    W kreatorze zamiast nagłówków jest „Цена”. Co jest nie tak?

    Kodowanie: jeśli w cenniku nie oznaczono, że plik jest w UTF-8, zawartość jest przekodowywana z windows-1251. Więcej: CSV, TXT, TSV.

    Czy cechy z BMEcat są przenoszone?

    Nie, elementy FEATURE nie trafiają do cennika. Indeksy, nazwa, opis, cena, producent, kategoria i zdjęcia są przenoszone (katalog BMEcat).

    Cennik DATANORM: dlaczego cena to 1, a u dostawcy 0,85?

    Włączone jest „Zaokrąglaj w górę”, a cenę podano za 100 lub 1000 sztuk. Dokładna kwota jest zapisana w kolumnie „Cena z cennika”. Wyłącz zaokrąglanie, wtedy wszystkie ceny będą miały dwa miejsca po przecinku (jak liczona jest cena).

    XML opisuje mój własny asortyment, a nie dostawcy. Co wybrać?

    Nie cennik, tylko import katalogu z XML: feed trafi prosto do kart, bez dopasowań i narzutów.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Przetwarzanie cenników → Lista cenników
    Adresy kolumn
    karta źródła → sekcja „Kolumny”
    Struktura XML
    karta źródła XML → sekcja „Struktura XML”
    Separator CSV
    karta źródła → sekcja „Produkty” → „Jakie dane importować” → „Separator kolumn”
    Uprawnienia
    okno „Lista cenników” w „Uprawnieniach grup”

    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