Jak przygotować, przetestować i połączyć eksport marketplace’u

Ten przewodnik wyjaśnia zalecany sposób uruchamiania eksportu B2BLIX Feed bez zastępowania istniejącego feedu, zanim nowe dane wyjściowe zostaną sprawdzone.

Kiedy ten przewodnik jest przydatny

Skorzystaj z tego przewodnika, gdy przygotowujesz nowy eksport B2BLIX Feed dla marketplace’u, sklepu internetowego, porównywarki cen lub innego systemu przyjmującego dane produktów w formacie XML.

Jest to szczególnie ważne podczas zastępowania istniejącego feedu. Nowy eksport powinien najpierw odtwarzać wymaganą selekcję produktów, ceny, stany magazynowe i pola docelowe. Należy go przetestować, zanim zewnętrzna platforma zacznie z niego korzystać.

Krótka odpowiedź

Utwórz osobny eksport dla danego miejsca docelowego, skonfiguruj jego dostawców, filtry, reguły cenowe, transformacje i szablon XML, a następnie wygeneruj eksport bez natychmiastowego łączenia go z działającą platformą.

Przetestuj kilka reprezentatywnych produktów w narzędziu Export Checker, sprawdź wygenerowany XML i potwierdź, że dane wyjściowe spełniają wymagania miejsca docelowego. Połącz URL eksportu dopiero wtedy, gdy wyniki będą stabilne i zrozumiałe.

Ostrzeżenie: Połączenie nieprzetestowanego eksportu może wpłynąć na aktualne ceny produktów, dostępność zapasów, wybór produktów i oferty na marketplace’ach. Sprawdź wygenerowany XML przed zastąpieniem istniejącego feedu lub włączeniem automatycznych aktualizacji marketplace’u.

Jak działa proces eksportu

B2BLIX najpierw importuje dane dostawców i mapuje je do wspólnego katalogu produktów. Następnie eksport tworzy niezależny widok tego katalogu dla określonego miejsca docelowego.

Każdy eksport może korzystać z własnych:

• dostawców i wyboru produktów
• filtrów eksportu
• domyślnych marż lub współczynników dostawców
• reguł transformacji danych
• atrybutów właściwych dla danego miejsca docelowego
• struktury XML
• harmonogramu generowania

Oznacza to, że ten sam przetworzony katalog dostawców może być używany dla kilku miejsc docelowych. Na przykład eksport dla marketplace’u może mieć inne ceny, tytuły, reguły stanów magazynowych i filtry produktów niż eksport przygotowany dla własnej strony internetowej.

Wygenerowany XML to dane wyjściowe przygotowane przez B2BLIX. Zewnętrzna platforma osobno decyduje, kiedy pobierze plik, jak zweryfikuje dane oraz czy produkty zostaną zaakceptowane lub opublikowane.

1. Potwierdź gotowość danych dostawcy

Przed utworzeniem eksportu dla marketplace’u potwierdź, że wymagane dane dostawcy zostały prawidłowo zaimportowane.

• Sprawdź, czy wymagani dostawcy są włączeni, a ich pliki źródłowe są dostępne.
• Zweryfikuj kraj dostawcy, walutę, sposób traktowania VAT, język treści i jednostkę masy.
• Potwierdź, że właściwe pola źródłowe są zmapowane jako EAN, cena, stan magazynowy, tytuł i kategoria.
• Sprawdź, czy reprezentatywne produkty mają prawidłowe wartości EAN.
• Przejrzyj relacje kategorii, jeśli miejsce docelowe wymaga prawidłowych kategorii.
• Potwierdź, że pierwsza synchronizacja dostawcy została zakończona i produkty są widoczne w katalogu.

Produkt bez prawidłowego EAN nie trafia do standardowego procesu przetwarzania produktów B2BLIX. Jeśli brakuje produktów, przed analizowaniem samego eksportu sprawdź mapowanie EAN.

Aby sprawdzić konfigurację dostawcy na swoim koncie, otwórz Dostawcy.
Aby poznać ustawienia dostawcy i proces mapowania, przeczytaj Dodawanie i konfigurowanie feedu dostawcy.

2. Utwórz eksport dla konkretnego miejsca docelowego

Utwórz osobny eksport dla marketplace’u lub innego miejsca docelowego. Unikaj zmieniania działającego eksportu produkcyjnego, gdy nowa konfiguracja jest jeszcze testowana.

Podczas wstępnej konfiguracji sprawdź:

• tytuł i status eksportu
• dostawców uwzględnionych w eksporcie
• domyślną marżę lub współczynnik dostawcy
• kategorie i producentów, którzy powinni zostać uwzględnieni
• filtry produktów
• przypisane reguły transformacji
• atrybuty XML i strukturę produktów wymaganą przez miejsce docelowe
• częstotliwość generowania eksportu

Aby utworzyć lub sprawdzić eksport, otwórz Eksporty.
Aby poznać dostępne ustawienia eksportu, przeczytaj Tworzenie i konfigurowanie projekcji eksportu XML.

3. Dodaj tylko reguły wymagane dla tego miejsca docelowego

Reguły transformacji mogą zmieniać istniejące wartości produktów lub tworzyć dodatkowe wartości na potrzeby eksportu. Na przykład reguła może obliczać cenę sprzedaży, ustawiać pole czasu dostawy, korygować stan magazynowy, przygotowywać tytuł właściwy dla danego miejsca docelowego lub tworzyć osobną cenę dla konkretnego kraju.

Przed włączeniem reguły sprawdź:

• które produkty powinny spełniać warunki reguły
• czy reguła zmienia istniejący atrybut, czy tworzy nowy
• priorytet reguły w porównaniu z innymi aktywnymi regułami
• czy po spełnieniu warunków reguły przetwarzanie powinno być kontynuowane
• czy reguła jest włączona dla właściwego eksportu

Pierwszą konfigurację testową utrzymuj w miarę prostą. Bardziej złożone reguły cenowe, dotyczące treści lub konkretnych dostawców dodaj dopiero po sprawdzeniu podstawowego eksportu.

Aby utworzyć lub sprawdzić reguły przetwarzania, otwórz Reguły transformacji danych.
Aby poznać warunki, transformacje i priorytety, przeczytaj Reguły transformacji danych.

4. Przetestuj reprezentatywne produkty

Nie oceniaj eksportu wyłącznie na podstawie łącznej liczby produktów. Wybierz kilka numerów EAN reprezentujących ważne części katalogu i sprawdź je indywidualnie.

Przydatna grupa testowa może obejmować:

• standardowy produkt od każdego uwzględnionego dostawcy
• produkt dostarczany przez więcej niż jednego dostawcę
• produkt objęty transformacją cenową
• produkt znajdujący się blisko granicy filtra
• produkt ze stanem magazynowym równym zero
• produkt z ważnej kategorii lub od ważnego producenta
• produkt ze przetłumaczoną lub przekształconą treścią

Dla każdego numeru EAN sprawdź oryginalne dane dostawcy, wybranego dostawcę, zmapowane atrybuty, filtry, obliczenia, zastosowane transformacje, wartości końcowe i reprezentatywne dane wyjściowe XML.

Aby przetestować produkty na swoim koncie, otwórz Export Checker.
Szczegółowe informacje o raporcie na poziomie produktu znajdziesz w artykule Export Checker: przegląd danych produktów i wyników eksportu.

5. Sprawdź cały wygenerowany XML

Kontrole na poziomie produktu potwierdzają sposób przetwarzania poszczególnych produktów, ale należy również sprawdzić cały wygenerowany plik.

Sprawdź, czy:

• XML otwiera się w całości i nie jest ucięty.
• dokument ma oczekiwaną ścieżkę produktów i strukturę.
• obecne są wymagane pola miejsca docelowego.
• ceny i stany magazynowe używają oczekiwanego formatu.
• plik zawiera rozsądną liczbę produktów.
• nie ma produktów, które powinny zostać wykluczone.
• produkty, które powinny zostać uwzględnione, mają dodatni stan magazynowy i prawidłowo wypełnione wymagane pola.
• na wyjściu nie pozostały żadne prywatne wartości testowe ani tymczasowe wartości zastępcze.

Technicznie poprawny plik XML nie gwarantuje automatycznie akceptacji przez każdy marketplace. Nazwy pól, wymagane wartości, reguły kategorii i struktura produktów muszą również odpowiadać aktualnym wymaganiom importu danego miejsca docelowego.

6. Połącz sprawdzony eksport z miejscem docelowym

Gdy eksport zostanie wygenerowany wielokrotnie z uzyskiwaniem stabilnych wyników, skopiuj URL eksportu podany dla tej projekcji i dodaj go do zewnętrznej platformy.

Podczas zastępowania istniejącego feedu:

1. Zapisz kopię poprzedniej konfiguracji feedu lub jego URL.
2. Ponownie wygeneruj nowy eksport B2BLIX.
3. Wykonaj końcową kontrolę cen, stanów magazynowych, liczby produktów i wymaganych pól.
4. Zastąp URL feedu na koncie miejsca docelowego.
5. Potwierdź, że miejsce docelowe prawidłowo pobiera i przetwarza plik.
6. Po zakończeniu importu sprawdź kilka produktów w miejscu docelowym.

Ważne: Synchronizacja dostawcy i generowanie eksportu korzystają z niezależnych harmonogramów. Nowo zaktualizowany plik dostawcy może nie pojawić się na marketplace’ie, dopóki nie zakończą się synchronizacja dostawcy, generowanie eksportu i pobieranie pliku przez marketplace.

Najczęstsze przyczyny problemów podczas uruchamiania

Produkt jest dostępny w B2BLIX, ale brakuje go w eksporcie

Produkt mógł zostać usunięty przez filtr eksportu, mieć zerowy stan magazynowy, nie mieć wymaganej zmapowanej wartości lub nie spełniać warunku właściwego dla danego miejsca docelowego. Sprawdź EAN produktu w narzędziu Export Checker.

Produkt znajduje się w XML, ale nie ma go na marketplace’ie

Potwierdź, że XML zawiera prawidłowe pola miejsca docelowego i dodatni stan magazynowy. Jeśli wyeksportowany wynik jest poprawny, przyczyną może być harmonogram importu marketplace’u, proces walidacji, wymagania dotyczące kategorii lub reguły aktywacji produktów.

Wyeksportowana cena nie jest oczekiwaną ceną

Sprawdź pierwotną zmapowaną cenę dostawcy, współczynnik dostawcy, aktywne reguły transformacji, priorytety reguł oraz ewentualny rabat na poziomie eksportu. Wybór dostawcy może również opierać się na końcowej cenie po transformacji, a nie na najniższej surowej cenie dostawcy.

Eksport zawiera mniej produktów, niż oczekiwano

Sprawdź, czy stany magazynowe produktów nie zmieniły się na zero, czy dostawca został odświeżony, czy filtr eksportu nie usunął rekordów oraz czy nie brakuje wymaganych danych. Porównaj reprezentatywne numery EAN od każdego dostawcy, zamiast opierać się wyłącznie na łącznej liczbie produktów.

Miejsce docelowe nie może odczytać feedu

Otwórz wygenerowany XML i potwierdź, że plik jest kompletny, a jego struktura odpowiada wymaganiom miejsca docelowego. Podczas naprawiania nieprawidłowego pola, reguły lub struktury XML przetestuj małą i prostą konfigurację.

Przykładowa kontrola przed uruchomieniem

Załóżmy, że eksport marketplace’u obejmuje trzech dostawców. Jeden testowy produkt jest dostępny u dwóch dostawców z tym samym numerem EAN.

• Dostawca A oferuje niższą cenę surową, ale ma wyższy współczynnik dostawcy.
• Dostawca B oferuje wyższą cenę surową, ale otrzymuje niższą marżę.
• Aktywna transformacja dodaje stałą kwotę do produktów w tej kategorii.

Export Checker powinien pokazać, który dostawca wygrywa po zastosowaniu skonfigurowanych reguł cenowych, a także końcową cenę sprzedaży, wyeksportowany stan magazynowy i wynikowe pola XML. Potwierdź ten wynik przed połączeniem eksportu z marketplace’em.

Co dalej

1. Potwierdź, że mapowania dostawców i wymagane wartości EAN są prawidłowe.
2. Utwórz osobny eksport dla miejsca docelowego.
3. Rozpocznij od prostych filtrów i transformacji.
4. Przetestuj reprezentatywne numery EAN w narzędziu Export Checker.
5. Sprawdź cały wygenerowany XML.
6. Połącz URL eksportu dopiero wtedy, gdy dane wyjściowe będą stabilne.
7. Zweryfikuj pierwszy import w miejscu docelowym i sprawdź kilka aktywnych produktów.
8. Stopniowo rozszerzaj eksport po zrozumieniu początkowego procesu.