Powrót do wszystkich poradników

Synchronizacja XML a API: którą metodę eksportu wybrać?

Dowiedz się, kiedy używać eksportu XML lub API, czym różnią się te metody oraz co sprawdzić przed zmianą ustawień synchronizacji B2BLIX.

Wybór właściwej metody eksportu

B2BLIX może przygotowywać zaktualizowane informacje o produktach dla marketplace'ów Pigu Group za pomocą synchronizacji XML lub API. Najlepszy wybór zależy głównie od wielkości katalogu, zakresu informacji, które muszą być aktualizowane, oraz sposobu, w jaki marketplace obecnie przetwarza dane.

Ten artykuł jest przydatny podczas konfigurowania synchronizacji, w przypadku opóźnionych aktualizacji na marketplace'ie lub gdy pojawi się prośba o zmianę metody eksportu na koncie.

Krótka odpowiedź

  • Wybierz XML, jeśli masz duży katalog lub musisz przesyłać informacje o produktach zbiorczo.
  • Wybierz API, jeśli masz mniejszy katalog i potrzebujesz bezpośrednich aktualizacji bez oczekiwania, aż Pigu pobierze plik XML.
  • Rozważ API jako rozwiązanie awaryjne, jeśli przetwarzanie XML przez Pigu jest opóźnione lub wygląda na zablokowane.

W przypadku bardzo dużych katalogów synchronizacja API może nie obsługiwać wydajnie takiej liczby produktów. W niektórych przypadkach przy dużej liczbie produktów B2BLIX może zmienić metodę na koncie z API na XML. W takiej sytuacji należy również zaktualizować odpowiednią konfigurację eksportu na koncie sprzedawcy w Pigu.

Ostrzeżenie: Zmiana metody eksportu może wpłynąć na ceny obowiązujące na platformie, stany magazynowe, godziny odbioru oraz czas pojawienia się aktualizacji na marketplace'ie. Przed wprowadzeniem zmian sprawdź bieżące ustawienia i miejsce docelowe. Cena przygotowana lub wyeksportowana przez B2BLIX nie musi być jeszcze widoczna na platformie, dopóki Pigu jej nie zaakceptuje i nie zastosuje.

Jak działa synchronizacja XML

W przypadku synchronizacji XML B2BLIX generuje feed produktowy zgodny z obsługiwanym formatem XML cen Pigu. Pigu pobiera plik po swojej stronie i przetwarza produkty zbiorczo.

Pigu zwykle sprawdza plik XML mniej więcej co jedną do dwóch godzin. Rzeczywisty czas pojawienia się zmiany na marketplace'ie może również zależeć od statusu przetwarzania po stronie Pigu.

XML jest zazwyczaj odpowiedni do:

  • Dużych katalogów produktów.
  • Zbiorczych aktualizacji na jednym lub kilku marketplace'ach.
  • Przekazywania w jednym feedzie informacji o cenach, stanach magazynowych i godzinach odbioru.
  • Kont, na których przesyłanie danych przez API nie jest wydajne przy danej liczbie produktów.

Jak działa synchronizacja API

Synchronizacja API wysyła aktualizacje bezpośrednio, bez oczekiwania na pobranie pliku XML przez Pigu. Jest zazwyczaj przeznaczona do mniejszej liczby produktów i bezpośrednich aktualizacji cen.

W niektórych konfiguracjach konta mogą być również dostępne opcje API dotyczące stanów magazynowych i godzin odbioru. Korzystaj wyłącznie z opcji dostępnych w ustawieniach synchronizacji Twojego konta.

API jest zazwyczaj odpowiednie do:

  • Mniejszych katalogów.
  • Bezpośrednich aktualizacji cen.
  • Sytuacji, w których przetwarzanie XML przez Pigu jest wyjątkowo wolne lub zablokowane.
  • Aktualizacji stanów magazynowych lub godzin odbioru, jeśli te opcje API są dostępne na koncie.

Przejście na API nie gwarantuje, że zmiana na marketplace'ie pojawi się natychmiast. Marketplace nadal sprawdza i stosuje przesłane informacje.

Porównanie XML i API

Pytanie XML API
Jak dostarczane są informacje? B2BLIX generuje plik, który pobiera Pigu. B2BLIX przesyła aktualizacje bezpośrednio.
Dla jakiej wielkości katalogu metoda jest najbardziej odpowiednia? Duże katalogi i przetwarzanie zbiorcze. Mniejsza liczba produktów.
Jak szybko dane są przetwarzane? Pigu zwykle pobiera plik co jedną do dwóch godzin, a następnie marketplace go przetwarza. Dane są przesyłane bezpośrednio, ale nadal podlegają przetwarzaniu przez marketplace.
Jakie informacje może zawierać metoda? Ceny, stany magazynowe i godziny odbioru. Przede wszystkim bezpośrednie aktualizacje cen. Stany magazynowe i godziny odbioru mogą być dostępne w zależności od ustawień konta.
Kiedy może pomóc? Gdy przesyłanie przez API nie jest wydajne przy dużej liczbie produktów. Gdy przetwarzanie XML jest opóźnione lub zablokowane.

Co sprawdzić na koncie

1. Sprawdź bieżący typ eksportu

Przed wprowadzeniem zmian sprawdź, czy na Twoim koncie jest obecnie skonfigurowany eksport XML czy API. Sprawdź również, które dodatkowe opcje aktualizacji są włączone.

Aby sprawdzić to na koncie, otwórz Ustawienia synchronizacji. Aby dowiedzieć się więcej o polach na tej stronie, przeczytaj Ustawienia synchronizacji: konfiguracja importu produktów i eksportu cen.

Formularz Ustawień synchronizacji z ustawieniami importu, częstotliwości, eksportu, trybu rabatów i aktualizacji
Użyj strony Ustawienia synchronizacji, aby przed zmianą metody synchronizacji sprawdzić wybrany typ eksportu oraz dostępne opcje cen, stanów magazynowych, godzin odbioru i aktualizacji.

2. Sprawdź wielkość katalogu

Weź pod uwagę łączną liczbę wysyłanych produktów oraz liczbę uwzględnionych marketplace'ów. Katalog, który działa sprawnie przez API dla jednego marketplace'u, może stać się zbyt duży, gdy te same produkty są przetwarzane na kilku marketplace'ach.

Jeśli katalog zawiera dziesiątki tysięcy produktów, XML jest zwykle bardziej odpowiednią metodą zbiorczego dostarczania danych.

3. Sprawdź, jakie informacje muszą być aktualizowane

Potwierdź, czy musisz przesyłać:

  • Tylko ceny.
  • Ceny i stany magazynowe.
  • Ceny, stany magazynowe i godziny odbioru.

XML może zawierać wszystkie te wartości w wygenerowanym feedzie. W przypadku API przed jego wybraniem sprawdź, które elementy sterujące są dostępne na Twoim koncie.

4. Jeśli używasz XML, sprawdź publiczny adres URL feedu

Synchronizacja XML wymaga, aby Pigu pobierało właściwy publiczny adres URL B2BLIX. Jeśli typ eksportu został zmieniony z API na XML, upewnij się, że adres XML został również skonfigurowany po stronie Pigu.

Spersonalizowany adres XML jest dostępny w sekcji Ustawienia synchronizacji, gdy skonfigurowany jest eksport XML.

5. Sprawdź najnowszy wynik synchronizacji

Po uruchomieniu synchronizacji sprawdź, czy produkty zostały przetworzone i czy eksport został pomyślnie przygotowany. Pomoże to odróżnić problem z eksportem B2BLIX od opóźnienia, które wystąpiło po wysłaniu danych do Pigu.

Aby sprawdzić to na koncie, otwórz Raporty synchronizacji. Aby dowiedzieć się więcej o statusach raportów i podsumowaniach produktów, przeczytaj Raporty synchronizacji: przegląd importu, obliczania BuyBox i wyników eksportu.

Typowe sytuacje

Masz bardzo duży katalog

Użyj XML, gdy przesyłanie danych przez API nie jest wydajne przy danej liczbie produktów. Jest to szczególnie istotne, gdy dziesiątki tysięcy produktów są synchronizowane na kilku marketplace'ach.

Pigu nie przetwarza pliku XML

Jeśli eksport XML został wygenerowany prawidłowo, ale jego przetwarzanie przez Pigu jest opóźnione lub zablokowane, API może służyć jako alternatywa do bezpośrednich aktualizacji. Najpierw sprawdź najnowszy Raport synchronizacji i potwierdź, że plik XML został wygenerowany pomyślnie.

Potrzebujesz uwzględnić w eksporcie stany magazynowe i godziny odbioru

XML może zawierać informacje o stanach magazynowych i godzinach odbioru razem z cenami. API może również oferować te elementy sterujące w niektórych konfiguracjach, ale należy potwierdzić, że są widoczne i włączone w Ustawieniach synchronizacji.

Metoda eksportu zmieniła się automatycznie

W niektórych przypadkach przy dużej liczbie produktów B2BLIX może zmienić metodę z API na XML, ponieważ katalog jest zbyt duży, aby przesyłanie danych przez API było wydajne. W takiej sytuacji zaktualizuj odpowiednią konfigurację na koncie sprzedawcy w Pigu, aby Pigu rozpoczęło pobieranie feedu XML.

Przykład

Sprzedawca synchronizuje około 30 000 produktów na trzech marketplace'ach. Przesyłanie danych przez API staje się nieodpowiednie przy takiej liczbie produktów, dlatego eksport zostaje zmieniony na XML.

Sprzedawca powinien następnie otworzyć Ustawienia synchronizacji, skopiować podany adres URL XML, skonfigurować ten adres na koncie Pigu i sprawdzić kolejny Raport synchronizacji. Pigu pobierze i przetworzy produkty zbiorczo, zamiast otrzymywać tysiące pojedynczych aktualizacji API.

Co dalej

  1. Otwórz Ustawienia synchronizacji i potwierdź bieżący typ eksportu.
  2. Sprawdź łączną liczbę produktów oraz uwzględnione marketplace'y.
  3. Sprawdź, czy potrzebujesz tylko cen, czy również stanów magazynowych i godzin odbioru.
  4. Jeśli używasz XML, potwierdź, że Pigu ma właściwy publiczny adres URL feedu.
  5. Uruchom kolejną synchronizację lub poczekaj na jej wykonanie, a następnie sprawdź wynik w Raportach synchronizacji.
  6. Sprawdź ograniczony zestaw produktów, zanim zaczniesz korzystać z nowej metody dla całego katalogu.