Jak diagnozować nagłe zmiany liczby produktów i błędy plików danych dostawcy

Fragment: Dowiedz się, jak ustalić, dlaczego katalog dostawcy lub eksport nagle zawiera mniej produktów, oraz określić, czy problem wystąpił podczas importu od dostawcy, przetwarzania katalogu, generowania eksportu czy przetwarzania po stronie marketplace.

Kiedy ten poradnik jest przydatny

Skorzystaj z tego poradnika, gdy liczba produktów w B2BLIX Feed, wygenerowanym eksporcie XML lub marketplace zmieni się nieoczekiwanie. Dotyczy on również sytuacji, gdy produkty jednego dostawcy wyglądają na usunięte albo źródło dostawcy przestało się aktualizować.

B2BLIX Feed przetwarza dane w kilku etapach: pobiera dane dostawcy, mapuje pola źródłowe na katalog B2BLIX, stosuje mechanizmy kontroli aktualności, wybiera produkty do eksportu, przetwarza reguły eksportu i generuje końcowy plik XML. Zmiana liczby produktów może rozpocząć się na dowolnym z tych etapów. :contentReference[oaicite:0]{index=0}

Krótka odpowiedź

Zacznij od ustalenia, na którym etapie liczba produktów zmieniła się po raz pierwszy. Sprawdź osobno źródło dostawcy, zapisany katalog B2BLIX, wygenerowany eksport i docelowy marketplace.

Nagły spadek może być spowodowany przez:

Źródło dostawcy, którego nie udało się pobrać.
Dostawcę przesyłającego niekompletną lub zmienioną strukturę XML albo JSON.
Zmianę ścieżki produktu lub mapowania pól.
Brakujące lub nieprawidłowe wartości EAN.
Zmianę stanu magazynowego produktów na zero lub usunięcie ich przez ustawienia aktualności.
Filtr eksportu lub ustawienie wyboru dostawcy wykluczające produkty.
Niekompletny lub nieprawidłowo skonfigurowany eksport XML.
Opóźnienie, problem z walidacją lub błąd importu po stronie marketplace.

Ostrzeżenie: Ustawienia dostawcy, mapowania, mechanizmy kontroli aktualności, filtry i reguły eksportu mogą wpływać na dostępność produktów, stany magazynowe, ceny i aktualizacje na marketplace. Przed zmianą ustawień produkcyjnych lub ponownym wygenerowaniem aktywnego eksportu zweryfikuj przyczynę na przykładzie wybranych produktów.

Jak może zmieniać się liczba produktów

Liczba produktów wyświetlana na poszczególnych etapach może być różna, ponieważ każdy etap odpowiada na inne pytanie.

Liczba produktów w źródle dostawcy: Ile rekordów produktów dostawca obecnie udostępnia.
Liczba produktów w katalogu B2BLIX: Ile prawidłowych i zachowanych produktów dostawców jest obecnie zapisanych.
Liczba produktów w eksporcie: Ile zapisanych produktów spełnia kryteria wyboru dostawcy, filtrów, warunków dotyczących stanu magazynowego i innych reguł wybranego eksportu.
Liczba produktów na marketplace: Ile wyeksportowanych produktów platforma zewnętrzna akceptuje, aktywuje i wyświetla.

Nie zakładaj, że niższa liczba produktów na marketplace oznacza nieudany import od dostawcy. Podobnie pomyślna synchronizacja dostawcy nie gwarantuje, że każdy zaimportowany produkt spełni warunki eksportu.

Co sprawdzić na koncie

1. Ustal, którego dostawcy lub etapu dotyczy problem

Porównaj bieżący wynik ze znanym prawidłowym okresem. Zapisz przybliżoną liczbę produktów przed zmianą i po niej.

Gdy w jednym eksporcie uwzględnionych jest kilku dostawców, wybierz co najmniej jeden EAN unikalny dla każdego dostawcy. Prześledź każdy EAN w źródle, katalogu, eksporcie i miejscu docelowym. Zwykle jest to szybsze niż przeglądanie całego katalogu.

Jeśli na przykład produkty Dostawcy A są nadal dostępne, ale unikalne produkty Dostawcy B zniknęły, w pierwszej kolejności sprawdź Dostawcę B.

2. Sprawdź konfigurację i źródło dostawcy

Potwierdź, że dostawca, którego dotyczy problem, jest włączony oraz że jego źródło główne i, jeśli dotyczy, źródła dodatkowe są nadal dostępne.

Aby sprawdzić to na koncie, otwórz Dostawcy. Informacje o ustawieniach dostawcy i procesie mapowania znajdziesz w artykule Dostawcy: dodawanie i konfigurowanie pliku danych dostawcy.

Sprawdź:

Dostawca jest włączony.
Skonfigurowany adres URL źródła nadal zwraca oczekiwany plik.
Dane uwierzytelniające lub nagłówki żądania synchronizacji nie uległy zmianie.
Dostawca nie przeniósł pliku danych pod inny adres URL.
Źródło nie jest puste, obcięte ani znacznie mniejsze niż zwykle.
Źródło nadal korzysta z oczekiwanej struktury XML lub JSON.
Skonfigurowana częstotliwość synchronizacji jest odpowiednia.
Podłączone są prawidłowe źródła główne i dodatkowe.

Pojedyncze nieudane pobranie danych dostawcy nie powoduje automatycznego usunięcia wszystkich wcześniej zapisanych produktów. B2BLIX podejmuje kolejne synchronizacje zgodnie ze skonfigurowanym harmonogramem. Jednak produkty, których nadal brakuje, mogą z czasem zostać objęte ustawieniami Wymuś zerowy stan magazynowy i Maksymalny czas od ostatniego wykrycia.

3. Sprawdź, czy dostawca zmienił strukturę pliku danych

Dostawca może nadal zwracać prawidłowy plik, jednocześnie zmieniając położenie lub nazwę pól produktów. Plik może więc wyglądać na dostępny, mimo że B2BLIX nie znajduje już oczekiwanych produktów lub wartości.

Sprawdź, czy dostawca zmienił:

Pełną ścieżkę produktu w źródle.
Pole zawierające EAN produktu przeznaczonego do sprzedaży.
Pola ceny, stanu magazynowego, tytułu, kategorii lub SKU.
Strukturę produktu i wariantów.
Identyfikatory połączeń między źródłem głównym a dodatkowym.

Szczególną uwagę zwróć na mapowanie EAN. EAN jest głównym identyfikatorem produktu w standardowym procesie B2BLIX Feed. Produkty bez użytecznego EAN nie są przetwarzane w zwykły sposób, a zmiana mapowania EAN może spowodować znaczne zmniejszenie katalogu.

Niektóre formaty dostawców zawierają jeden identyfikator na poziomie produktu głównego, a inny na poziomie wariantu. Mapowanie musi korzystać z identyfikatora reprezentującego faktycznie sprzedawany produkt. :contentReference[oaicite:1]{index=0}

4. Sprawdź, czy produkty są nadal zapisane w B2BLIX

Wyszukaj kilka EAN-ów, których dotyczy problem, w połączonym katalogu.

Aby sprawdzić to na koncie, otwórz Wszystkie produkty. Informacje o dostępnych danych znajdziesz w artykule Interfejs wszystkich produktów.

Dla każdego przykładowego produktu sprawdź:

Czy produkt jest obecny.
Jakie rekordy dostawców są dostępne dla danego EAN-u.
Czy wartości ceny i stanu magazynowego są uzupełnione.
Kiedy produkt dostawcy był ostatnio wykryty.
Czy dostępne są oczekiwane tytuł, kategoria, producent i inne wymagane dane.

Jeśli produktu nie ma w sekcji Wszystkie produkty, skup się na źródle dostawcy, ścieżce produktu, mapowaniach, walidacji EAN i ustawieniach dotyczących nieaktualnych produktów. Jeśli produkt jest tam obecny, przejdź do sprawdzania eksportu.

5. Sprawdź ustawienia Wymuś zerowy stan magazynowy i Maksymalny czas od ostatniego wykrycia

Ustawienia aktualności dostawcy określają, co dzieje się, gdy wcześniej zaimportowany produkt nie pojawia się już w nowszych danych dostawcy.

Wymuś zerowy stan magazynowy pozostawia produkt w katalogu, ale zmienia jego stan magazynowy na zero po tym, jak produkt pozostawał niewykryty przez skonfigurowany okres.
Maksymalny czas od ostatniego wykrycia określa, jak długo nieodświeżony produkt pozostaje zapisany, zanim zostanie usunięty.

Zwykle wartość Wymuś zerowy stan magazynowy powinna być dłuższa niż oczekiwany odstęp między synchronizacjami dostawcy i krótsza niż wartość Maksymalny czas od ostatniego wykrycia. Pomaga to zapobiec natychmiastowej zmianie prawidłowych produktów na stan zerowy z powodu tymczasowych opóźnień w pobieraniu danych, a jednocześnie ogranicza nieaktualną dostępność.

Przed zmianą tych wartości sprawdź, czy dostawca, którego dotyczy problem, pominął jedną synchronizację, czy też był niedostępny przez dłuższy czas. Zwiększenie ustawień przechowywania może pozostawić nieaktualne produkty w katalogu, a ich zmniejszenie może spowodować wcześniejsze usunięcie lub wyłączenie produktów.

6. Sprawdź eksport, którego dotyczy problem

Jeśli produkty istnieją w sekcji Wszystkie produkty, ale brakuje ich w wygenerowanym pliku, przejrzyj konfigurację eksportu.

Aby sprawdzić to na koncie, otwórz Eksporty. Informacje o dostępnych ustawieniach eksportu znajdziesz w artykule Eksporty: tworzenie i konfigurowanie projekcji eksportu XML.

Sprawdź:

Eksport jest włączony i generuje się zgodnie z oczekiwaniami.
Dostawca, którego dotyczy problem, jest uwzględniony w eksporcie.
Filtry eksportu nie zostały zmienione.
Produkty nie są wykluczane na podstawie EAN-u, dostawcy, producenta, kategorii, ceny, stanu magazynowego ani innego atrybutu.
Grupy filtrów AND i OR są prawidłowo ułożone.
Eksport nie wymaga dodatniego stanu magazynowego, gdy stan produktów, których dotyczy problem, został wymuszony na zero.
Oczekiwane reguły transformacji są włączone dla tego eksportu.
Szablon XML nadal zawiera wymaganą ścieżkę produktu i pola.
Wygenerowany plik XML jest kompletny i można go otworzyć.

Filtr eksportu określa, czy produkt zostanie w ogóle uwzględniony. Filtr transformacji określa tylko, czy zastosowane zostanie konkretne obliczenie lub zmiana danych. Nie traktuj tych filtrów jako tego samego rodzaju filtra.

7. Sprawdź przykładowe produkty w narzędziu Export Checker

Użyj Export Checker, aby prześledzić jeden EAN, którego dotyczy problem, w całym procesie eksportu. Powtórz sprawdzenie dla produktu, który nadal działa prawidłowo, aby porównać wyniki.

Aby sprawdzić to na koncie, otwórz Export Checker. Informacje o raporcie znajdziesz w artykule Export Checker: przegląd danych produktów i wyników eksportu.

Sprawdź, czy Export Checker pokazuje:

Oczekiwane oryginalne dane dostawcy.
Prawidłowo wybranego dostawcę.
Prawidłowe zmapowane wartości EAN-u, ceny, stanu magazynowego i wymaganej treści.
Filtr eksportu odrzucający produkt.
Regułę transformacji zmieniającą cenę, stan magazynowy lub inną wymaganą wartość.
Końcowe atrybuty wymagane przez szablon XML.
Produkt w reprezentatywnym końcowym wyniku XML.

Jeśli produkt zostanie odrzucony, narzędzie może pomóc ustalić, czy przyczyna dotyczy danych wejściowych, mapowania, wyboru produktu, filtrów czy transformacji.

8. Porównaj dane wyjściowe B2BLIX z wynikiem na marketplace

Otwórz wygenerowany plik XML i potwierdź, czy brakujące produkty są w nim obecne, mają prawidłowe pola docelowe i oczekiwany stan magazynowy.

Jeśli produktów brakuje w pliku XML, kontynuuj sprawdzanie ustawień dostawcy i eksportu w B2BLIX.
Jeśli produkty są obecne w pliku XML, ale brakuje ich na marketplace, sprawdź historię importu platformy, błędy walidacji, wymagane pola i harmonogram odświeżania.

B2BLIX kontroluje import od dostawcy, mapowania, filtry, transformacje, obliczenia i generowanie danych wyjściowych XML. Po pobraniu pliku przez platformę zewnętrzną jej walidacja, aktywacja, czas importu i publiczne wyświetlanie są kontrolowane przez tę platformę.

Najczęstsze przyczyny i ich objawy

Co obserwujesz	Obszar, który prawdopodobnie wymaga sprawdzenia
Produkty jednego dostawcy znikają zarówno z sekcji Wszystkie produkty, jak i z eksportu	Pobieranie danych dostawcy, ścieżka produktu, mapowanie pól, walidacja EAN lub ustawienia aktualności
Produkty pozostają w sekcji Wszystkie produkty, ale znikają z jednego eksportu	Wybór dostawcy w eksporcie, filtry eksportu, warunki dotyczące stanu magazynowego lub reguły właściwe dla eksportu
Produkty pozostają zapisane, ale ich stan magazynowy zmienia się na zero	Dane o stanie magazynowym dostawcy, reguły transformacji lub Wymuś zerowy stan magazynowy
Wiele produktów znika po aktualizacji formatu pliku przez dostawcę	Ścieżka produktu, mapowanie EAN, połączenie źródła lub mapowania wymaganych pól
Wygenerowany plik XML zawiera oczekiwane produkty, ale liczba produktów na marketplace jest niższa	Opóźnienie importu na marketplace, walidacja, reguły aktywacji lub przetwarzanie po stronie miejsca docelowego
Liczba zmienia się tylko w przypadku produktów bez kategorii	Mapowanie kategorii lub ustawienie Zezwalaj na produkty bez kategorii u dostawcy
Liczba produktów w eksporcie spada po zmianie filtra	Warunki filtrów oraz sposób grupowania logiki AND i OR

Przykład: eksport nagle traci produkty jednego dostawcy

Eksport zwykle zawiera około 30 000 produktów od trzech dostawców. Nagle liczba spada do około 20 000.

Wybierz jeden EAN unikalny dla każdego dostawcy.
Sprawdź wszystkie trzy EAN-y w sekcji Wszystkie produkty.
Sprawdź te same EAN-y w narzędziu Export Checker.
Otwórz wygenerowany plik XML i wyszukaj każdy EAN.

Jeśli unikalnego produktu Dostawcy B brakuje w sekcji Wszystkie produkty, sprawdź źródło, synchronizację, mapowania i ustawienia aktualności Dostawcy B.

Jeśli produkt jest obecny w sekcji Wszystkie produkty, ale brakuje go w Export Checker lub w pliku XML, sprawdź wybór dostawcy i filtry eksportu.

Jeśli wszystkie trzy EAN-y są obecne w pliku XML, ale produktów Dostawcy B brakuje na marketplace, sprawdź wynik importu na marketplace zamiast zmieniać mapowanie dostawcy.

Co zrobić dalej

Zapisz zwykłą liczbę produktów, bieżącą liczbę, eksport, którego dotyczy problem, oraz przybliżony czas wystąpienia zmiany.
Ustal, czy problem dotyczy wszystkich dostawców, czy tylko jednego.
Wybierz niewielki zestaw znanych EAN-ów, w tym co najmniej jeden unikalny produkt od każdego istotnego dostawcy.
Prześledź te EAN-y w źródle dostawcy, mapowaniu w sekcji Dostawcy, sekcji Wszystkie produkty, Export Checker, wygenerowanym pliku XML i miejscu docelowym.
Popraw wyłącznie ten etap, na którym po raz pierwszy pojawia się nieprawidłowy lub brakujący wynik.
Wygeneruj i sprawdź kontrolny eksport testowy przed zastosowaniem zmian w aktywnym kanale sprzedaży.
Po usunięciu przyczyny potwierdź, że kolejne synchronizacje dostawcy i generowanie eksportów powracają do oczekiwanej liczby produktów.