Jak połączyć i używać feedu XML B2BLIX w Pigu

Kiedy ten poradnik jest przydatny

Skorzystaj z tego poradnika, gdy B2BLIX wygenerował plik XML dla Twoich produktów, ale nie został on jeszcze połączony z Pigu, lub gdy chcesz sprawdzić, czy połączenie działa prawidłowo.

B2BLIX i Pigu są połączone za pomocą stałego, publicznego adresu URL XML przypisanego do konkretnego konta. B2BLIX przygotowuje informacje o stanie magazynowym i cenach, natomiast w Pigu należy skonfigurować odczyt tego adresu jako źródła importu.

Krótka odpowiedź

Otwórz Ustawienia synchronizacji na swoim koncie B2BLIX i skopiuj adres wyświetlany w sekcji Twój publiczny URL.

Następnie zaloguj się na konto sprzedawcy Pigu, otwórz sekcję Produkty, wybierz Import stanów magazynowych i cen, dodaj nowe źródło importu typu Link HTTPS, wklej adres URL B2BLIX, potwierdź mapowanie pól, jeśli pojawi się taka prośba, i zapisz import.

Po wykonaniu tych czynności Pigu będzie mogło okresowo odczytywać informacje o stanie magazynowym i cenach z wygenerowanego przez B2BLIX pliku XML.

Ważne: Po zaimportowaniu i zaakceptowaniu danych przez Pigu połączenie pliku XML może wpłynąć na aktualny stan magazynowy i ceny. Przed połączeniem dużego katalogu sprawdź plik XML i zweryfikuj kilka produktów. Cena obliczona lub wyeksportowana przez B2BLIX nie musi być jeszcze aktywna, dopóki Pigu jej nie przetworzy i nie zastosuje.

Jak działa połączenie XML

Po włączeniu eksportu XML każda synchronizacja B2BLIX przebiega zasadniczo według następującego schematu:

1. B2BLIX importuje najnowsze informacje o produktach ze skonfigurowanego źródła, takiego jak Google Sheets lub inny obsługiwany feed.
2. Usługa ocenia produkty na podstawie dostępnych danych z marketplace'u, ustawień cen oraz obowiązujących limitów cen minimalnych i maksymalnych.
3. B2BLIX przygotowuje plik XML zgodny z wymaganiami Pigu, zawierający wynikowe dane o stanie magazynowym i cenach.
4. Najnowszy plik pozostaje dostępny pod stałym publicznym adresem URL XML.
5. Pigu odczytuje plik z tego adresu zgodnie ze swoim procesem importu.

Wygenerowanie pliku XML w B2BLIX nie informuje automatycznie Pigu o jego istnieniu. Należy dodać publiczny adres URL jako źródło importu na koncie Pigu.

Plik XML B2BLIX służy do aktualizacji stanów magazynowych i cen. Jeśli używasz już osobnego feedu XML do tworzenia lub utrzymywania pełnych ofert produktowych, zachowaj te feedy oddzielnie.

Sprawdź plik XML w B2BLIX przed jego połączeniem

1. Znajdź swój publiczny adres URL XML

Po zalogowaniu otwórz Ustawienia synchronizacji. Aby dowiedzieć się więcej o ustawieniach importu, eksportu, częstotliwości i publicznego adresu URL na tej stronie, przeczytaj Ustawienia synchronizacji: konfiguracja importu produktów i eksportu cen.

Znajdź sekcję Twój publiczny URL i skopiuj pełny adres. Użyj dokładnie tego adresu w Pigu. Adres powinien pozostać niezmieniony, aby Pigu mogło nadal pobierać nowo wygenerowane wersje pliku.

2. Otwórz plik XML i sprawdź jego zawartość

Otwórz publiczny adres URL w przeglądarce lub pobierz plik. Upewnij się, że plik ładuje się prawidłowo i zawiera wpisy produktów.

Sprawdź niewielką grupę produktów oraz zweryfikuj, czy ich identyfikatory, stany magazynowe i ceny są prawidłowe. Nie musisz rozumieć całej struktury XML, ale plik nie powinien być pusty ani wyświetlać błędu dostępu.

Aby sprawdzić, jak B2BLIX odczytuje źródło i przygotowuje dane wyjściowe, otwórz Tester synchronizacji. Szczegółowe informacje o obsługiwanych polach i strukturze źródła znajdziesz w poradniku Tester synchronizacji i struktura pliku Google Sheets.

3. Sprawdź kilka kodów EAN w narzędziu Sprawdzanie produktów

Aby zweryfikować pojedyncze produkty, otwórz Sprawdzanie produktów. Informacje o sekcjach dotyczących danych produktów, obliczeń i eksportu znajdziesz w poradniku Sprawdzanie produktów: przegląd danych produktów, obliczeń cen i eksportów.

Sprawdź kilka reprezentatywnych kodów EAN, w tym produkty o różnych cenach, stanach magazynowych lub dostępne na różnych marketplace'ach. Przed włączeniem importu do Pigu dla całego katalogu sprawdź obliczony wynik i wyeksportowane dane XML.

Jak dodać feed XML B2BLIX w Pigu

1. Zaloguj się na konto sprzedawcy Pigu.
2. Otwórz sekcję Produkty.
3. Otwórz menu Import w lewym górnym obszarze strony.
4. Wybierz Import stanów magazynowych i cen.
5. Wybierz Źródło importu. Jeśli ta opcja nie jest od razu widoczna, otwórz menu z trzema kropkami i wybierz ją z tego menu.
6. Wybierz Link HTTPS jako typ źródła.
7. Wklej pełny publiczny adres URL XML B2BLIX.
8. Sprawdź mapowanie atrybutów XML, jeśli Pigu poprosi o przyporządkowanie importowanych pól do atrybutów Pigu.
9. Kliknij Potwierdź lub zapisz źródło importu.

Po potwierdzeniu Pigu będzie wiedzieć, skąd pobierać plik ze stanami magazynowymi i cenami. Kolejne synchronizacje B2BLIX aktualizują zawartość dostępną pod tym samym adresem URL, dlatego nie powinno być konieczne zastępowanie adresu po każdej synchronizacji.

Jakie dane zawiera plik XML

Wygenerowany plik XML bazuje na informacjach o produktach zaimportowanych do B2BLIX. W zależności od źródła i konfiguracji może zawierać między innymi:

• EAN lub GTIN używany do identyfikacji produktu.
• SKU używany jako wewnętrzny identyfikator produktu.
• Informacje o stanie magazynowym lub dostępności.
• Ceny dla poszczególnych marketplace'ów.
• Obliczone ceny, jeśli dostępne jest obliczenie ceny B2BLIX.
• Dodatkowe obsługiwane pola marketplace'u dostarczone przez źródło importu.

Jeśli nie można zmienić ceny produktu na podstawie dostępnych informacji, w eksporcie może on pozostać bez zmian zamiast otrzymać nowo obliczoną cenę.

Dlaczego SKU i EAN mogą być identyczne

Jeśli źródło nie zawiera kolumny sku, B2BLIX używa obowiązkowej wartości ean jako zastępczego SKU. W takiej sytuacji identyczne wartości SKU i EAN w pliku XML są prawidłowym wynikiem.

Aby przesyłać osobne SKU, dodaj kolumnę sku do Google Sheet lub innego importowanego feedu produktowego. Po następnej udanej synchronizacji ta wartość powinna pojawić się w wygenerowanym pliku XML.

Dlaczego może brakować pola dotyczącego konkretnego marketplace'u

Plik XML może zawierać wyłącznie obsługiwane informacje o produktach, które są dostępne w źródle lub zostały utworzone w skonfigurowanym procesie B2BLIX.

Jeśli na przykład brakuje wymaganego pola, takiego jak collectionhours_*, najpierw dodaj odpowiednie pole do oryginalnego Google Sheet lub feedu danych. Następnie uruchom kolejną synchronizację albo poczekaj na jej wykonanie i sprawdź nowo wygenerowany plik XML.

Najczęstsze przyczyny problemów z połączeniem

• Adres URL został wygenerowany, ale nie został dodany w Pigu. B2BLIX nie może sprawić, że Pigu odczyta plik XML, dopóki adres URL nie zostanie skonfigurowany jako źródło importu Pigu.
• Wybrano niewłaściwy typ importu w Pigu. Użyj procesu importu stanów magazynowych i cen, zamiast traktować feed B2BLIX jako kompletny feed katalogu produktów.
• Nie ukończono mapowania pól XML. Jeśli Pigu wymaga mapowania atrybutów, sprawdź je i potwierdź przed zapisaniem źródła.
• Publiczny adres URL został nieprawidłowo skopiowany. Otwórz wklejony adres URL osobno i upewnij się, że ładuje oczekiwany plik XML.
• W oryginalnym źródle produktów brakuje wymaganej wartości. Dodaj pole do Google Sheet lub feedu używanego przez B2BLIX, a nie bezpośrednio do wygenerowanego pliku XML.
• SKU i EAN są takie same. Zwykle oznacza to, że nie podano osobnego SKU. Jeśli wymagane są osobne wartości, dodaj pole sku.
• Nowa synchronizacja nie została jeszcze ukończona. Publiczny plik odzwierciedla wynik wygenerowany przez synchronizację. Przed oczekiwaniem zmienionych danych sprawdź ostatnie wykonanie synchronizacji.
• Pigu nie przetworzyło jeszcze najnowszego pliku. Plik XML może już zawierać nową wartość, podczas gdy na marketplace'ie nadal wyświetlana jest wcześniejsza cena.

Jak zweryfikować zakończoną aktualizację

Najpierw otwórz adres URL pliku XML i potwierdź obecność oczekiwanego produktu oraz ceny. Następnie sprawdź ten sam EAN w narzędziu Sprawdzanie produktów, aby przejrzeć wynik obliczeń i eksportu.

Możesz również otworzyć Raporty synchronizacji. Wyjaśnienie statusów raportów i szczegółów przetwarzania znajdziesz w poradniku Raporty synchronizacji: przegląd wyników importu, obliczeń BuyBox i eksportu.

Te czynności pomogą Ci ustalić, na którym etapie proces został przerwany:

• Jeśli wartości brakuje w pliku XML, sprawdź dane źródłowe B2BLIX i wynik synchronizacji.
• Jeśli wartość jest obecna w pliku XML, ale nie ma jej w Pigu, sprawdź źródło importu Pigu, mapowanie i status przetwarzania.
• Jeśli wartość jest wyświetlana w narzędziu Sprawdzanie produktów, ale różni się od oczekiwanej, przed wprowadzeniem zmian sprawdź zaimportowane dane produktu, limity cen i wybrane ustawienia cen.

Przykład

Źródło zawiera produkt o kodzie EAN 4770000000001, SKU ABC-101, stanie magazynowym 5 oraz wymaganych informacjach o cenie.

Podczas synchronizacji B2BLIX ocenia produkt i przygotowuje obliczoną cenę EUR 19.99. Wygenerowany plik XML zawiera EAN, SKU, stan magazynowy oraz wyeksportowaną cenę.

Po połączeniu adresu URL XML B2BLIX w Pigu Pigu pobiera plik i może zastosować aktualizację stanu magazynowego oraz ceny. Do czasu przetworzenia importu przez Pigu na marketplace'ie może być nadal widoczna wcześniejsza wartość.

Co zrobić dalej

1. Potwierdź, że eksport XML jest skonfigurowany w Ustawieniach synchronizacji B2BLIX.
2. Otwórz publiczny adres URL XML i sprawdź niewielką próbkę produktów.
3. Sprawdź te same kody EAN w narzędziu Sprawdzanie produktów.
4. Dodaj adres URL w Pigu w sekcji Produkty → Import stanów magazynowych i cen.
5. Wykonaj wymagane mapowanie pól i potwierdź źródło importu.
6. Sprawdź pierwszą zakończoną synchronizację i import w Pigu, zanim rozszerzysz proces na większy katalog.

Jeśli to możliwe, zacznij od ograniczonej grupy produktów. Przed poleganiem na feedzie dla całego katalogu sprawdź limity cen minimalnych i maksymalnych, stany magazynowe, wyeksportowane ceny oraz wyniki na marketplace'ach.