Limity eksportu API, interwały i opóźnienia w przypadku dużych katalogów

Dlaczego aktualizacje cen przez API mogą trwać dłużej?

Ten artykuł dotyczy sytuacji, gdy B2BLIX obliczył nowe ceny, ale zmiany pojawiają się w Pigu, 220.lv, Kaup24.ee lub HobbyHall.fi później, niż oczekiwano.

Szybkość publikowania przez API zależy między innymi od liczby przetwarzanych produktów. Mały katalog można zazwyczaj obsługiwać częściej niż katalog zawierający dziesiątki lub setki tysięcy produktów.

Krótka odpowiedź

B2BLIX automatycznie dostosowuje interwał eksportu API do łącznej liczby produktów na koncie. W miarę powiększania się katalogu system może stosować dłuższy interwał, aby eksport mógł zostać bezpiecznie przetworzony i mieścił się w limitach API marketplace'u.

Liczba produktów jest uwzględniana łącznie dla wszystkich połączonych marketplace'ów Pigu Group, a nie osobno dla każdego marketplace'u.

Jeśli katalog stanie się zbyt duży dla obsługiwanego procesu publikowania przez API, B2BLIX może przełączyć dane wyjściowe z powrotem na XML. Wyniki obliczeń XML mogą być nadal prawidłowe, nawet jeśli publikowanie przez API na żywo jest opóźnione lub niedostępne dla całego katalogu.

Obliczona lub przygotowana cena nie musi być jeszcze widoczna na marketplace'ie. Cena staje się aktywna dopiero po jej wyeksportowaniu, zaakceptowaniu i zastosowaniu przez marketplace. Przed założeniem, że obliczona cena została pomyślnie opublikowana, sprawdź raport synchronizacji.

Jak limity żądań API wpływają na eksport

Pigu stosuje limity żądań dla swojego API. Na przykład w dokumentacji API opisano limit 500 żądań na 10 sekund dla procesu aktualizacji ofert.

B2BLIX przestrzega limitów API marketplace'u. Oznacza to, że usługa nie może wysłać nieograniczonej liczby aktualizacji produktów jednocześnie, nawet gdy wiele cen jest gotowych do publikacji.

Limity te pomagają chronić usługę marketplace'u przed nadmiernym ruchem. Nie oznaczają, że każde konto może zawsze publikować 500 zmian produktów co 10 sekund. Rzeczywisty czas przetwarzania może również zależeć od wielkości katalogu, liczby marketplace'ów, czasu odpowiedzi API marketplace'u oraz liczby aktualizacji oczekujących w kolejce publikowania.

Limity API marketplace'u mogą się zmieniać. Aktualną dokumentację API Pigu należy traktować jako wiarygodne źródło najnowszego limitu żądań.

Jak wielkość katalogu zmienia interwał eksportu

B2BLIX wykorzystuje zakresy liczby produktów do określenia odpowiedniego interwału eksportu API. Dokładne wewnętrzne progi nie są publikowane, ponieważ mogą być dostosowywane wraz ze zmianami usługi i integracji z marketplace'ami.

W praktyce proces działa następująco:

Mniejszy katalog może korzystać z krótszego interwału eksportu API.
Gdy łączna liczba produktów wzrasta, B2BLIX automatycznie wybiera dłuższy interwał.
Łączna liczba obejmuje produkty ze wszystkich połączonych marketplace'ów Pigu Group.
Przetworzenie każdej kolejki publikowania w bardzo dużych katalogach może wymagać więcej czasu.
Jeśli katalog przekroczy obsługiwaną liczbę produktów dla API, dane wyjściowe mogą zostać zmienione na XML.

Dłuższy interwał nie musi oznaczać błędu. Może być oczekiwanym skutkiem przetwarzania większej liczby produktów przy jednoczesnym przestrzeganiu limitów API.

Co sprawdzić na swoim koncie

1. Potwierdź bieżącą metodę eksportu

Sprawdź, czy na koncie skonfigurowano publikowanie cen przez API, czy generowanie danych wyjściowych XML. Sprawdź również skonfigurowaną częstotliwość synchronizacji i ustawienia aktualizacji.

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.

Przed zmianą metody lub częstotliwości eksportu sprawdź, ile produktów zawiera obecnie źródło oraz czy to samo źródło obejmuje produkty dla kilku marketplace'ów.

2. Sprawdź najnowszy raport synchronizacji

Raport synchronizacji pomaga odróżnić obliczanie od publikowania. Sprawdź, czy ostatnie uruchomienie zostało zakończone, ile produktów przetworzono oraz czy podczas eksportu zgłoszono ostrzeżenia lub błędy.

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

3. Sprawdź jeden produkt, którego dotyczy problem

Jeśli opóźnienia dotyczą tylko niektórych cen, sprawdź konkretny EAN w narzędziu Sprawdzanie produktów. Pomoże to potwierdzić obliczoną cenę oraz najnowszy znany status eksportu tego produktu.

Aby sprawdzić to na koncie, otwórz Sprawdzanie produktów.
Aby dowiedzieć się więcej o wyświetlanych tam danych produktu, obliczeniach i informacjach o eksporcie, przeczytaj Sprawdzanie produktów: przegląd danych produktów, obliczeń cen i eksportów.

Najczęstsze przyczyny wolniejszego publikowania przez API

Łączny katalog się powiększył. Produkty ze wszystkich połączonych marketplace'ów wpływają na wielkość używaną do wyboru interwału eksportu.
Podczas tej samej synchronizacji zmieniła się duża liczba cen. Większa liczba zmian tworzy większą kolejkę publikowania.
API marketplace'u przetwarza aktualizacje wolniej. B2BLIX musi oczekiwać na odpowiedzi API marketplace'u i przestrzegać jego limitów żądań.
Eksport API jest nadal w toku. Obliczenia mogły zostać zakończone, zanim każda przygotowana aktualizacja została opublikowana.
Dane wyjściowe zostały przełączone na XML. W przypadku katalogu przekraczającego obsługiwaną liczbę produktów dla API zamiast bezpośredniego publikowania przez API może być używany XML.
Sprawdzono tylko aktywną cenę na marketplace'ie. Sprawdź Raporty synchronizacji i narzędzie Sprawdzanie produktów, aby ustalić, czy opóźnienie wystąpiło podczas obliczania, eksportu czy zastosowania ceny przez marketplace.

Przykład

Sprzedawca importuje produkty dla 220.lv, Pigu.lt i Kaup24.ee. Połączony katalog jest znacznie większy niż liczba produktów w dowolnym pojedynczym marketplace'ie.

B2BLIX kończy obliczenia BuyBox i przygotowuje zaktualizowane ceny. Ponieważ połączony katalog jest duży, eksport API korzysta z dłuższego interwału przetwarzania, a aktualizacje są publikowane w kolejce. Dlatego niektóre aktywne ceny na marketplace'ach mogą nadal wyświetlać poprzednią wartość, podczas gdy późniejsze produkty są wciąż przetwarzane.

Sprzedawca powinien najpierw sprawdzić najnowszy Raport synchronizacji. W przypadku pojedynczego opóźnionego produktu może następnie użyć narzędzia Sprawdzanie produktów, aby porównać jego obliczoną cenę ze statusem eksportu.

Co zrobić dalej

Otwórz Ustawienia synchronizacji i potwierdź, czy wybrane dane wyjściowe to API czy XML.
Sprawdź łączną liczbę produktów ze wszystkich marketplace'ów uwzględnionych w źródle.
Otwórz najnowszy Raport synchronizacji i sprawdź wyniki przetwarzania oraz eksportu.
Użyj narzędzia Sprawdzanie produktów dla jednego lub większej liczby EAN-ów, których dotyczy problem.
Nie zmieniaj wielokrotnie ustawień synchronizacji, gdy istniejący duży eksport może być nadal przetwarzany.
Jeśli dane wyjściowe XML są prawidłowe, ale publikowanie przez API pozostaje stale opóźnione dla bardzo dużego katalogu, skontaktuj się z B2BLIX, aby omówić, czy odpowiednia może być dedykowana konfiguracja dla dużych wolumenów.

Zgłaszając utrzymujące się opóźnienie, podaj przybliżoną łączną liczbę produktów, marketplace'y, których dotyczy problem, czas właściwej synchronizacji oraz kilka przykładowych EAN-ów. Nie podawaj haseł do kont ani danych uwierzytelniających API.