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 odpowiedniej metody eksportu

B2BLIX może przygotowywać zaktualizowane informacje o produktach dla marketplace’ów Pigu Group, korzystając z synchronizacji XML lub API. Najlepszy wybór zależy przede wszystkim 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 w marketplace’ach lub gdy poproszono Cię o zmianę metody eksportu na koncie.

Krótka odpowiedź

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

W przypadku bardzo dużych katalogów synchronizacja API może nie obsługiwać tej liczby danych wystarczająco wydajnie. W niektórych przypadkach związanych z dużą liczbą produktów B2BLIX może przełączyć konto z API na XML. Jeśli tak się stanie, należy również zaktualizować odpowiednią konfigurację eksportu na koncie sprzedawcy w Pigu.

Ostrzeżenie: Zmiana metody eksportu może wpłynąć na aktualne ceny, stany magazynowe, godziny odbioru oraz czas pojawiania się aktualizacji w marketplace’ach. Przed wprowadzeniem zmian sprawdź bieżące ustawienia i miejsce docelowe. Cena przygotowana lub wyeksportowana przez B2BLIX nie musi być jeszcze widoczna w marketplace, 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 zazwyczaj sprawdza plik XML mniej więcej co jedną–dwie godziny. Rzeczywisty czas pojawienia się zmiany w marketplace może również zależeć od statusu przetwarzania po stronie Pigu.

XML jest ogólnie odpowiedni do:

  • Dużych katalogów produktów.
  • Zbiorczych aktualizacji w jednym lub kilku marketplace’ach.
  • Przekazywania w jednym feedzie informacji o cenach, stanach magazynowych i godzinach odbioru.
  • Kont, na których dostarczanie danych przez API nie jest wydajne ze względu na liczbę produktów.

Jak działa synchronizacja API

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

Niektóre konfiguracje kont mogą również udostępniać opcje API dla stanów magazynowych i godzin odbioru. Korzystaj wyłącznie z opcji dostępnych w ustawieniach synchronizacji Twojego konta.

API jest ogólnie odpowiednie do:

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

Przełączenie na API nie gwarantuje, że zmiana w marketplace pojawi się natychmiast. Marketplace nadal weryfikuje 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 zazwyczaj pobiera plik co jedną–dwie godziny, 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 dostarczanie danych przez API nie jest wydajne przy dużej liczbie produktów. Gdy przetwarzanie XML jest opóźnione lub zatrzymane.

Co sprawdzić na koncie

1. Sprawdź bieżący typ eksportu

Przed wprowadzeniem zmian potwierdź, czy Twoje konto jest obecnie skonfigurowane do korzystania z XML czy API. Sprawdź również, które dodatkowe opcje aktualizacji są włączone.

Aby sprawdzić to na swoim koncie, otwórz Ustawienia synchronizacji. Aby poznać znaczenie pól na tej stronie, przeczytaj Ustawienia synchronizacji: konfiguracja importu produktów i eksportu cen.

Formularz ustawień synchronizacji z opcjami importu, częstotliwości, eksportu, trybu rabatów i aktualizacji
Skorzystaj ze 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 w kilku marketplace’ach.

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

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

Potwierdź, czy musisz wysyłać:

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

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

4. Jeśli korzystasz z 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ę również, że adres XML został 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 swoim koncie, otwórz Raporty synchronizacji. Aby poznać statusy raportów i podsumowania produktów, przeczytaj Raporty synchronizacji: przegląd importu, obliczeń BuyBox i wyników eksportu.

Typowe sytuacje

Masz bardzo duży katalog

Użyj XML, gdy dostarczanie danych przez API nie jest wydajne przy takiej liczbie produktów. Jest to szczególnie istotne, gdy dziesiątki tysięcy produktów są synchronizowane w 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 zatrzymane, API może być użyte jako alternatywa do bezpośrednich aktualizacji. Najpierw sprawdź najnowszy Raport synchronizacji i potwierdź, że plik XML został pomyślnie wygenerowany.

Potrzebujesz stanów magazynowych i godzin odbioru w eksporcie

XML może zawierać informacje o stanach magazynowych i godzinach odbioru wraz z cenami. API może również udostępniać te opcje 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 związanych z dużą liczbą produktów B2BLIX może przełączyć się z API na XML, ponieważ katalog jest zbyt duży, aby dostarczanie danych przez API było wydajne. W takiej sytuacji zaktualizuj odpowiednią konfigurację na koncie sprzedawcy w Pigu, aby Pigu zaczęło pobierać feed XML.

Przykład

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

Następnie sprzedawca powinien 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 zrobić dalej

  1. Otwórz Ustawienia synchronizacji i potwierdź bieżący typ eksportu.
  2. Sprawdź łączną liczbę produktów i uwzględnione marketplace’y.
  3. Potwierdź, czy potrzebujesz tylko cen, czy również stanów magazynowych i godzin odbioru.
  4. Jeśli korzystasz z XML, upewnij się, że Pigu ma prawidłowy publiczny adres URL feedu.
  5. Uruchom kolejną synchronizację lub zaczekaj 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.