Jak działają mapowanie dostawcy, pola cenowe, waluta i diagnozowanie brakujących produktów

Fragment: Dowiedz się, jak wybrać właściwą ścieżkę produktu i pola dostawcy, skonfigurować interpretację ceny i walutę oraz ustalić, dlaczego produkt nie pojawia się w katalogu B2BLIX lub wygenerowanym eksporcie XML.

Kiedy ten przewodnik jest przydatny

Ten przewodnik jest przydatny podczas dodawania dostawcy lub analizowania takich problemów jak:

• Którą część pliku dostawcy należy wybrać jako ścieżkę produktu?
• Które z kilku pól cenowych dostawcy należy przypisać jako cenę B2BLIX?
• Dlaczego zaimportowana lub wyeksportowana cena wygląda nieprawidłowo?
• Dlaczego produkt znajduje się w pliku dostawcy, ale nie ma go w B2BLIX?
• Dlaczego produkt jest zapisany w B2BLIX, ale nie ma go w eksporcie lub na platformie sprzedażowej?

Najskuteczniejszym sposobem diagnozowania tych problemów jest prześledzenie jednego znanego produktu za pomocą jego EAN na każdym etapie: źródła dostawcy, mapowania dostawcy, zapisanego katalogu, przetwarzania eksportu, wygenerowanego XML oraz platformy odbierającej dane.

Krótka odpowiedź

B2BLIX może przetwarzać wyłącznie dane dostępne w wybranym źródle dostawcy i połączone za pomocą mapowania dostawcy.

Dla każdego dostawcy sprawdź, czy:

• Wybrana ścieżka produktu identyfikuje kompletne, pojedyncze produkty.
• Właściwe pole dostawcy jest przypisane jako EAN.
• Docelowa wartość źródłowa jest przypisana jako cena Feed.
• Waluta dostawcy, sposób naliczania VAT i stawka VAT prawidłowo opisują tę cenę źródłową.
• Ważne pola, takie jak stan magazynowy, tytuł i kategoria, są zmapowane, jeśli są dostępne.
• Źródło główne i dodatkowe są prawidłowo połączone, jeśli używane są oba źródła.

Jeśli produkt jest już widoczny w katalogu B2BLIX, ale nie ma go w eksporcie lub ma w nim nieprawidłową cenę, mapowanie dostawcy może być poprawne. W takiej sytuacji sprawdź filtry eksportu, współczynnik dostawcy, transformacje, wybór dostawcy oraz końcowy wynik XML.

Ostrzeżenie: Zmiana ścieżki produktu dostawcy, mapowania ceny, waluty, ustawień VAT lub połączenia ze źródłem może po synchronizacji zmienić zapisane dane produktu i przyszłe eksporty XML. Przed zastosowaniem zmiany w aktywnym kanale sprzedaży zweryfikuj jeden znany EAN i porównaj wartość źródłową, zapisaną oraz końcową wartość wyeksportowaną.

Jak działa mapowanie dostawcy

1. Ścieżka produktu identyfikuje każdy rekord produktu

Plik XML lub JSON dostawcy może zawierać wiele zagnieżdżonych sekcji. Zanim będzie można zmapować poszczególne pola, B2BLIX musi wiedzieć, która powtarzająca się sekcja reprezentuje jeden kompletny produkt.

Na przykład plik XML może mieć strukturę podobną do:

• catalog
• offers
• offer

Jeśli każdy element offer zawiera EAN, cenę, stan magazynowy, tytuł i kategorię jednego produktu przeznaczonego do sprzedaży, ten kompletny element oferty należy wybrać jako ścieżkę produktu.

Wybranie ścieżki znajdującej się zbyt wysoko może spowodować potraktowanie całej listy produktów jako jednego rekordu. Wybranie ścieżki znajdującej się zbyt nisko może udostępnić tylko jedno pole lub jeden wariant zamiast kompletnego produktu.

2. Pola źródłowe są mapowane na strukturę produktu B2BLIX

Po wybraniu ścieżki produktu pola dostawcy można połączyć ze standardowymi atrybutami B2BLIX, takimi jak:

• EAN
• SKU
• Cena
• Stan magazynowy
• Tytuł
• Opis
• Kategoria i identyfikator kategorii
• Producent
• Zdjęcia, waga, wymiary, kolor i dodatkowe atrybuty

Nazwy w pliku dostawcy nie muszą odpowiadać nazwom pól B2BLIX. Dostawca może nazywać pole kodu kreskowego barcode, gtin, ean13 lub w inny sposób. Mapowanie informuje B2BLIX, która wartość źródłowa ma wymagane znaczenie.

3. EAN określa tożsamość produktu

EAN jest głównym identyfikatorem produktu w standardowym procesie Feed B2BLIX. Produkt bez prawidłowego EAN jest ignorowany i nie trafia do standardowego procesu przetwarzania oraz łączenia katalogu.

Podczas sprawdzania mapowania EAN upewnij się, że wskazuje ono kod kreskowy produktu przeznaczonego do sprzedaży. Niektóre formaty dostawców zawierają kilka identyfikatorów, na przykład:

• Identyfikator grupy produktów.
• SKU dostawcy.
• EAN produktu nadrzędnego.
• Oddzielny EAN dla każdego rozmiaru, koloru lub wariantu.

Przypisanie identyfikatora grupy, SKU lub wartości nadrzędnej jako EAN produktu przeznaczonego do sprzedaży może spowodować odrzucenie produktów, ich nieprawidłowe pogrupowanie lub wyświetlenie pod nieoczekiwanym produktem.

4. Zmapowana cena powinna być oryginalną wartością dostawcy, której chcesz użyć

Źródło dostawcy może zawierać kilka pól związanych z ceną, takich jak:

• Cena bez VAT.
• Cena z VAT.
• Cena pierwotna lub sugerowana.
• Aktualna cena promocyjna.
• Cena zakupu.
• Cena sprzedaży na platformie sprzedażowej.

B2BLIX nie określa właściwego znaczenia handlowego wyłącznie na podstawie nazwy pola. Wymagane pole źródłowe należy przypisać jako cenę Feed.

Użyj podglądu mapowania, aby porównać znaną wartość z oryginalnego pliku dostawcy ze zmapowaną wartością. Nie polegaj wyłącznie na podobnie wyglądających nazwach pól.

Jeśli wymagana cena nie występuje w bieżącym źródle dostawcy, zmapowanie innego pola nie utworzy brakującej wartości. W takim przypadku może być konieczne użycie innego eksportu dostawcy, zmiana skonfigurowanego adresu URL źródła lub podłączenie dostępnego alternatywnego źródła, takiego jak JSON zawierający wymaganą cenę.

5. Ustawienia waluty i VAT określają sposób interpretacji zmapowanej ceny

Ustawienia finansowe dostawcy powinny odpowiadać wartości wybranej w mapowaniu ceny. Sprawdź:

• Walutę źródłową.
• Czy VAT jest już zawarty w zmapowanej cenie.
• Obowiązującą stawkę VAT.
• Kraj dostawcy, jeśli ma znaczenie dla konfiguracji.

W przypadku obsługiwanych walut innych niż EUR przeliczenie waluty może być stosowane podczas przygotowywania eksportu. Wynik przeliczenia zależy od skonfigurowanej waluty źródłowej i oryginalnej zmapowanej ceny.

Na przykład nie wybieraj EUR tylko dlatego, że końcowy eksport na platformę sprzedażową używa EUR. Jeśli zmapowana cena dostawcy jest podana w PLN, waluta źródłowa dostawcy powinna opisywać otrzymywaną wartość w PLN.

Jeśli przeliczona cena wygląda nieprawidłowo, najpierw zweryfikuj oba elementy konfiguracji:

1. Potwierdź, że zmapowana cena jest oryginalną wartością dostawcy, którą chcesz zaimportować.
2. Potwierdź, że wybrana waluta źródłowa jest walutą używaną przez tę wartość.

Jeśli oba ustawienia są poprawne, ale kierunek lub wynik przeliczenia nadal wydaje się nieprawidłowy, porównaj jeden przykład źródłowy z jego przetworzoną wartością, aby umożliwić dokładne zbadanie różnicy.

6. Źródło główne i dodatkowe muszą spójnie opisywać ten sam produkt

Dostawca może korzystać ze źródła głównego i opcjonalnego źródła dodatkowego. Na przykład jedno źródło może zawierać treść produktu, a drugie — często aktualizowane informacje o cenie i stanie magazynowym.

Jeśli używane są dwa źródła, sprawdź, czy:

• Dla każdego źródła wybrano właściwą ścieżkę produktu.
• Z każdego źródła zmapowano odpowiednie pola.
• Wybrane wartości połączenia ze źródłem identyfikują ten sam produkt przeznaczony do sprzedaży w obu plikach.
• Podgląd połączenia pokazuje oczekiwaną część wspólną obu źródeł.

Produkt może nie być dostępny lub może zachować niekompletne dane, jeśli jego rekordów nie można połączyć między źródłem głównym i dodatkowym.

Co sprawdzić na koncie

Krok 1: Otwórz konfigurację dostawcy

Po zalogowaniu otwórz Dostawcy i wybierz dostawcę, którego chcesz sprawdzić. Aby zrozumieć ekrany konfiguracji i mapowania, przeczytaj Dostawcy: dodawanie i konfigurowanie źródła dostawcy.

Krok 2: Potwierdź obecność produktu w oryginalnym źródle

Wybierz jeden problematyczny produkt i skopiuj jego oczekiwany EAN. Sprawdź bieżące dane źródłowe dostawcy i potwierdź, że rekord produktu jest obecny.

W tym rekordzie znajdź dokładne wartości źródłowe dla:

• EAN.
• Ceny.
• Stanu magazynowego.
• Tytułu.
• Kategorii lub identyfikatora kategorii.

Jeśli produktu nie ma w bieżącym źródle dostawcy, zmiana mapowania B2BLIX go nie przywróci.

Krok 3: Zweryfikuj ścieżkę produktu

Potwierdź, że wybrana ścieżka produktu wskazuje powtarzający się element zawierający kompletny produkt. Porównaj liczbę wykrytych elementów z przybliżoną liczbą produktów oczekiwanych w źródle.

Sama liczba pasujących elementów nie wystarczy. Otwórz podgląd i potwierdź, że jeden wybrany element zawiera pełne dane jednego produktu przeznaczonego do sprzedaży.

Krok 4: Zweryfikuj mapowanie EAN

Sprawdź, czy podgląd EAN zwraca dokładny kod kreskowy wybrany do diagnozy. Nie powinien zwracać SKU dostawcy, wewnętrznego identyfikatora produktu, kodu produktu nadrzędnego ani pustej wartości.

Jeśli produkt jest wariantem, potwierdź, że mapowanie używa EAN przypisanego do tego konkretnego wariantu przeznaczonego do sprzedaży.

Krok 5: Zweryfikuj mapowanie ceny

Porównaj wszystkie dostępne pola cenowe w oryginalnym źródle. Zmapuj pole reprezentujące cenę dostawcy, której chcesz użyć jako wartości wyjściowej do obliczeń.

Jeśli źródło zawiera zarówno cenę pierwotną, jak i promocyjną, zdecyduj, która z nich ma zostać ceną Feed. Mapowanie powinno wskazywać bezpośrednio tę wartość.

Krok 6: Zweryfikuj interpretację waluty i VAT

Potwierdź, że waluta źródłowa dostawcy, ustawienie dotyczące zawartości VAT i stawka VAT odpowiadają wybranej cenie źródłowej. Ustawienia te powinny opisywać otrzymywaną wartość dostawcy, a nie tylko walutę lub format podatkowy wymagany przez miejsce docelowe.

Krok 7: Sprawdź pozostałe podstawowe wartości produktu

EAN jest wymagany w standardowym procesie. Sprawdź również, czy wartości ceny, stanu magazynowego, tytułu i kategorii są dostępne oraz zmapowane zgodnie z oczekiwaniami.

Jeśli dostawca nie udostępnia użytecznych kategorii, sprawdź, czy dla tego dostawcy należy włączyć opcję Zezwalaj na produkty bez kategorii. Po jej włączeniu produkty bez zmapowanej kategorii mogą pozostać z zastępczą wartością „bez kategorii” zamiast zostać zablokowane z powodu braku kategorii.

Krok 8: Sprawdź, czy produkt trafił do zapisanego katalogu

Aby wyszukać produkt w przetworzonym katalogu, otwórz Wszystkie produkty. Szczegółowe informacje o dostępnych danych produktu znajdziesz w przewodniku Interfejs „Wszystkie produkty”.

Wyszukaj produkt przy użyciu tego samego EAN. Wynik pokaże, czy problem wystąpił przed zapisaniem produktu, czy po nim:

• Nie znaleziono w sekcji Wszystkie produkty: Sprawdź rekord źródłowy, ścieżkę produktu, mapowanie EAN, pozostałe zmapowane wartości, połączenie ze źródłem i synchronizację dostawcy.
• Znaleziono w sekcji Wszystkie produkty: Produkt został zaimportowany. Przejdź do kontroli na poziomie eksportu.

Krok 9: Sprawdź produkt w eksporcie

Aby sprawdzić jeden produkt w konkretnym eksporcie, otwórz Kontroler eksportu. Aby zrozumieć raport, przeczytaj Kontroler eksportu: przegląd danych produktu i wyników eksportu.

Wprowadź EAN produktu i wybierz odpowiedni eksport. W zależności od dostępnego wyniku sprawdź:

• Oryginalne wartości dostawcy.
• Zmapowane atrybuty produktu.
• Wybraną ofertę dostawcy.
• Współczynnik dostawcy i obliczenia ceny.
• Filtry eksportu i transformacje wpływające na produkt.
• Końcowe wartości użyte w eksporcie.
• Wygenerowany wynik XML lub przyczynę wykluczenia.

Jeśli cena w sekcji Wszystkie produkty jest prawidłowa, ale różni się w końcowym eksporcie, różnica może wynikać ze współczynnika dostawcy w eksporcie, reguł transformacji, rabatów lub logiki wyboru dostawcy, a nie z mapowania ceny dostawcy.

Znajdź etap, na którym produkt znika

Typowe przyczyny nieprawidłowych cen lub brakujących produktów

• Nieprawidłowa ścieżka produktu: B2BLIX odczytuje niewłaściwy poziom struktury dostawcy.
• Nieprawidłowe pole EAN: Zamiast kodu kreskowego produktu przeznaczonego do sprzedaży zmapowano SKU, identyfikator produktu nadrzędnego lub kod grupy wariantów.
• Pusty lub nieużyteczny EAN: Produkt nie może wejść do standardowego procesu katalogowego opartego na EAN.
• Niewłaściwe pole ceny: Zamiast docelowej ceny dostawcy zmapowano wartość pierwotną, sugerowaną, zawierającą VAT lub nieprzecenioną.
• Wymaganej ceny nie ma w źródle: Może być potrzebne inne źródło dostawcy lub dostępny format źródłowy.
• Nieprawidłowa waluta źródłowa: Skonfigurowana waluta nie opisuje zmapowanej wartości źródłowej.
• Nieprawidłowa interpretacja VAT: Cena netto jest skonfigurowana jako zawierająca VAT lub cena zawierająca VAT jest skonfigurowana jako netto.
• Brak kategorii: Produkt nie ma użytecznej kategorii, a produkty bez kategorii nie są dozwolone dla tego dostawcy.
• Źródła główne i dodatkowe nie łączą się: Wybrane identyfikatory nie odnoszą się do tego samego produktu.
• Filtr eksportu: Produkt jest zapisany, ale nie spełnia warunków uwzględnienia wybranego eksportu.
• Warunki dotyczące stanu magazynowego lub ceny: Eksport wyklucza produkty z zerowym stanem magazynowym, pustą ceną lub inną niedozwoloną wartością.
• Transformacja eksportu: Reguła zmienia cenę lub inne wymagane pole po zmapowaniu danych dostawcy.
• Przetwarzanie przez zewnętrzną platformę: Końcowy XML jest prawidłowy, ale platforma odbierająca dane odrzuca produkt, opóźnia jego przetworzenie lub go nie aktywuje.

Przykład

Produkt dostawcy zawiera następujące wartości:

• EAN: 5901234567890
• price_without_vat: 80
• original_price: 100
• discounted_price: 72
• Waluta: PLN

Sprzedawca chce użyć aktualnej promocyjnej ceny dostawcy jako wartości wyjściowej do obliczeń eksportu.

Właściwa konfiguracja polega na przypisaniu discounted_price jako ceny Feed i skonfigurowaniu PLN jako waluty źródłowej dostawcy. Przypisanie original_price spowodowałoby rozpoczęcie obliczeń od wartości 100 zamiast 72. Skonfigurowanie źródła jako EUR również spowodowałoby nieprawidłową interpretację otrzymywanej wartości.

Jeśli tego produktu całkowicie brakuje, sprzedawca powinien następnie sprawdzić, czy wartość 5901234567890 jest zwracana przez zmapowane pole EAN dla wybranej ścieżki produktu. Jeśli EAN jest mapowany z rekordu nadrzędnego, a cena i stan magazynowy są zapisane na poziomie wariantu, rekord może nie reprezentować jednego kompletnego produktu przeznaczonego do sprzedaży.

Co zrobić dalej

1. Wybierz jeden problematyczny produkt ze znanym EAN-em i zapisz jego oczekiwaną cenę źródłową, walutę, stan magazynowy, tytuł i kategorię.
2. Potwierdź, że produkt istnieje w bieżącym źródle XML lub JSON dostawcy.
3. Sprawdź ścieżkę produktu dostawcy i podglądy pól.
4. Zweryfikuj mapowanie EAN oraz docelowej ceny źródłowej.
5. Potwierdź, że ustawienia waluty i VAT prawidłowo opisują zmapowaną cenę źródłową.
6. Wyszukaj EAN w sekcji Wszystkie produkty.
7. Jeśli produkt jest zapisany, sprawdź ten sam EAN w Kontrolerze eksportu.
8. Porównaj wartość źródłową, zmapowaną, przetworzoną wartość eksportu i końcowy XML przed wprowadzeniem zmian w aktywnym miejscu docelowym.

Sprawdzając jeden EAN od początku do końca, możesz ustalić, czy problem wynika z danych dostawcy, mapowania, interpretacji finansowej, walidacji katalogu, przetwarzania eksportu czy zewnętrznej platformy.