Ustawienia synchronizacji: konfiguracja importu produktów i eksportu cen

Do czego służy strona ustawień synchronizacji

Strona ustawień synchronizacji łączy dane produktów z procesem obliczeń i eksportu B2BLIX. Określa, gdzie znajdują się produkty, w jakim formacie zapisane są dane źródłowe, jak często dane powinny być przetwarzane oraz gdzie mają być dostarczane obliczone wyniki.

Sprzedawca zwykle otwiera tę stronę po wstępnej konfiguracji konta i monitorowania. B2BLIX potrzebuje zarówno danych z obserwacji marketplace’ów, jak i własnych danych produktów, aby oceniać produkty zgodnie z ustawieniami BuyBox.

Źródło powinno zawierać produkty, które mają być przetwarzane przez B2BLIX. Produkty są zwykle identyfikowane za pomocą kodów EAN i mogą zawierać ceny, stany magazynowe, ceny minimalne i maksymalne, godziny odbioru oraz wartości właściwe dla poszczególnych marketplace’ów.

Ważne: Synchronizacja i monitorowanie marketplace’ów to odrębne procesy. Monitorowanie zbiera bieżące informacje z marketplace’ów. Synchronizacja importuje plik produktów, wykonuje obliczenia na podstawie dostępnych obserwacji i ustawień oraz przygotowuje wybrany wynik.

Co można zrobić na tej stronie

• Wprowadzić adres URL, z którego B2BLIX ma pobierać dane produktów.
• Wybrać XML, CSV lub Google Spreadsheets jako format źródła.
• Podać opcjonalne dane uwierzytelniania podstawowego dla chronionego źródła.
• Wybrać częstotliwość uruchamiania procesu synchronizacji.
• Wybrać XML lub jedną z obsługiwanych metod eksportu przez API.
• Włączyć lub wyłączyć tryb rabatowy.
• Zapisać konfigurację synchronizacji.
• Uruchomić synchronizację natychmiast, bez oczekiwania na kolejny zaplanowany interwał.
• Skopiować spersonalizowany publiczny adres URL XML po wybraniu eksportu XML.
• Sprawdzić rozpoznane atrybuty importu i ich alternatywne nazwy.

Główne pola i elementy sterujące

Ustawienia importu

Data source URL

Wprowadź bezpośredni adres URL, z którego B2BLIX może pobrać plik produktów. Adres musi pozostać dostępny w czasie uruchamiania zaplanowanej synchronizacji.

Sprawdź, czy adres URL:

• otwiera się prawidłowo;
• zwraca właściwe dane produktów, a nie stronę logowania lub stronę internetową;
• zawiera produkty, które mają być przetwarzane przez B2BLIX;
• nie wygasa po krótkim czasie;
• korzysta z tego samego formatu, który wybrano w polu data format.

Jeśli adres URL jest chroniony uwierzytelnianiem podstawowym, wprowadź wymagany login i hasło w opcjonalnych polach uwierzytelniania.

Dostęp do arkuszy Google: W przypadku korzystania z arkusza Google udostępnij go z uprawnieniami tylko do wyświetlania dla każdego, kto ma link. B2BLIX musi mieć możliwość odczytu arkusza bez logowania się do Twojego konta Google. Nie przyznawaj publicznych uprawnień do edycji.

Data format

Wybierz format zgodny ze źródłem:

• XML: Użyj tego formatu, gdy źródło udostępnia produkty jako uporządkowane elementy XML.
• CSV: Użyj tego formatu dla tekstowego pliku tabelarycznego zawierającego jeden produkt w każdym wierszu.
• Google spreadsheets: Użyj tego formatu, gdy informacje o produktach są przechowywane we współdzielonym arkuszu Google.

Wybranie niewłaściwego formatu może uniemożliwić poprawną interpretację źródła, nawet jeśli sam adres URL jest dostępny.

Częstotliwość synchronizacji

Wartość sync interval określa, jak często B2BLIX wykonuje pełną procedurę synchronizacji:

1. Pobiera najnowsze dane produktów ze źródła.
2. Dopasowuje i ocenia zaimportowane produkty.
3. Oblicza ceny zgodnie ze skonfigurowanymi regułami BuyBox i limitami bezpieczeństwa.
4. Przygotowuje wyjściowy plik XML lub wynik API.

Dostępne interwały:

• Nigdy
• 30 minut
• 1 godzina
• 2 godziny
• 3 godziny

Zmiana tego interwału synchronizacji sama w sobie nie jest płatna. Monitorowanie marketplace’ów i związane z nim koszty użytkowania są konfigurowane oddzielnie.

Strategie oparte na ostatniej opublikowanej cenie

Zwróć szczególną uwagę na interwał podczas korzystania ze strategii odwołującej się do ostatniej opublikowanej lub ostatniej obliczonej ceny.

Na przykład reguła „ostatnia opublikowana cena plus krok” może powodować kolejną podwyżkę przy każdym uruchomieniu synchronizacji. Przy interwale wynoszącym jedną godzinę krok może zostać zastosowany raz na godzinę. Przy interwale 30-minutowym może zostać zastosowany dwa razy w ciągu godziny.

Ta kwestia nie dotyczy w taki sam sposób strategii, które nie wykorzystują ostatniej opublikowanej ceny jako danych wejściowych.

Ustawienia eksportu

XML

Opcja XML tworzy plik produktów uporządkowany zgodnie z obsługiwaną strukturą XML cen Pigu. Plik jest dostępny za pośrednictwem spersonalizowanego publicznego adresu URL.

Adres URL jest przeznaczony do zachowania stałości dla danego konta. Każda pomyślna synchronizacja odświeża dane dostępne pod tym adresem, zamiast tworzyć nowy adres.

XML jest zalecaną opcją domyślną dla wielu sprzedawców. Szczególnie dobrze sprawdza się w przypadku dużych katalogów, ponieważ B2BLIX przygotowuje jeden plik do pobrania przez marketplace, zamiast wysyłać osobne żądanie aktualizacji dla każdego produktu.

XML nie publikuje danych samodzielnie: Wygenerowanie pliku XML B2BLIX nie łączy go automatycznie z kontem sprzedawcy Pigu. Wygenerowany adres HTTPS należy skonfigurować jako właściwe źródło importu cen i stanów magazynowych w interfejsie sprzedawcy Pigu.

Po połączeniu źródła XML ogólny przebieg wygląda następująco:

1. B2BLIX pobiera źródło zgodnie z wybranym interwałem synchronizacji.
2. B2BLIX oblicza wynik i odświeża plik XML.
3. Pigu pobiera plik XML zgodnie z własnym harmonogramem importu.
4. Pigu przetwarza i stosuje zaakceptowane aktualizacje.

Interwał synchronizacji B2BLIX i interwał importu Pigu są niezależne. Odświeżenie pliku XML nie oznacza, że cena na marketplace została już zmieniona.

API

Standardowa opcja API planuje przesyłanie obliczonych aktualizacji cen za pośrednictwem obsługiwanej integracji z Pigu.

W przypadku tej opcji B2BLIX przesyła odpowiednie pola cen sprzedaży. Marketplace może potrzebować dodatkowego czasu na przetworzenie, zanim zaakceptowane zmiany staną się widoczne.

API with stock and collection hours

Opcja API (with stock and collection hours) przesyła szerszy zestaw aktualizacji produktów. Oprócz informacji o cenach obejmuje stany magazynowe i dane dotyczące godzin odbioru, jeśli są obsługiwane i dostępne w danych źródłowych.

Używaj tej opcji tylko wtedy, gdy dane importu zawierają dokładne wartości stanów magazynowych i godzin odbioru oraz gdy zamierzasz przesyłać je za pośrednictwem B2BLIX.

Duże katalogi: W przypadku katalogu, który może wygenerować bardzo dużą liczbę aktualizacji, zdecydowanie zalecany jest XML. Krótki interwał synchronizacji w połączeniu z dziesiątkami tysięcy aktualizacji API może spowodować rozpoczęcie kolejnej synchronizacji, zanim wszystkie wcześniejsze aktualizacje zostaną przetworzone.

Tryb rabatowy

Pigu obsługuje cenę standardową i cenę po rabacie. B2BLIX określa je jako cenę przed rabatem i cenę po rabacie.

Gdy tryb rabatowy jest wyłączony

Obliczona cena B2BLIX jest umieszczana w obu polach wynikowych:

• Cena przed rabatem: cena obliczona
• Cena po rabacie: cena obliczona

Oznacza to przedstawienie obliczonej wartości jako regularnej ceny sprzedaży, a nie jako osobnego rabatu.

Gdy tryb rabatowy jest włączony

Cena źródłowa i cena obliczona są przechowywane oddzielnie:

• Cena przed rabatem: pierwotna przesłana cena standardowa
• Cena po rabacie: nowa obliczona cena B2BLIX

Ten tryb jest przeznaczony do sytuacji, w których obliczona cena ma być przedstawiona jako rabat od przesłanej ceny standardowej. Przed użyciem tego trybu w aktywnym eksporcie sprawdź, czy obliczona cena jest odpowiednia w odniesieniu do ceny pierwotnej.

Ostrzeżenie dotyczące cen aktywnych: Zmiana typu eksportu lub trybu rabatowego może zmienić pola cen przesyłane do marketplace. Przed zastosowaniem konfiguracji dla całego katalogu sprawdź małą grupę testową, ceny minimalne i maksymalne oraz wynikowy eksport.

Struktura pliku importu

Pliki CSV i arkusze Google zwykle zawierają jeden produkt w każdym wierszu, a rozpoznane atrybuty są używane jako nagłówki kolumn.

W przypadku źródeł XML produkty powinny być przedstawione za pomocą powtarzających się elementów product, item lub row. Rozpoznane atrybuty umieszcza się wewnątrz każdego elementu produktu.

<item>
<ean>1234567890123</ean>
<price>24.99</price>
<min>22.00</min>
<max>28.00</max>
</item>

Tabela atrybutów systemowych na stronie zawiera zaakceptowane nazwy pól i ich alternatywy. Nie oznacza to, że każdy wymieniony atrybut musi być dostarczony w każdej konfiguracji. Wymagane pola zależą od produktów, marketplace’ów, konfiguracji limitów cenowych i wybranej metody eksportu.

Atrybuty rozpoznawane przez system

Zasada dotycząca godzin odbioru: Domyślna wartość collectionhours dotyczy wyłącznie eksportów XML. Jeśli dla Łotwy, Litwy, Estonii lub Finlandii wymagane są inne wartości, podaj odpowiednie atrybuty właściwe dla marketplace’u. Nie łącz wartości domyślnej z wartościami godzin odbioru właściwymi dla poszczególnych marketplace’ów.

Bezpieczne korzystanie ze strony

1. Przygotuj małe źródło testowe. Zacznij od ograniczonej liczby produktów, a nie od całego katalogu.
2. Sprawdź identyfikację produktów. Upewnij się, że każdy produkt ma prawidłowy EAN oraz że wartości EAN nie zostały przesunięte, skrócone ani zmienione przez formatowanie arkusza.
3. Zweryfikuj limity cenowe. Sprawdź minimalne i maksymalne ceny na poziomie produktu, zanim zezwolisz na eksport obliczonych wyników.
4. Przetestuj dostęp do źródła. Potwierdź, że adres URL jest osiągalny, a wybrany format odpowiada rzeczywistemu plikowi. Jeśli jest dostępny, możesz użyć testera synchronizacji.
5. Wybierz odpowiedni interwał. Weź pod uwagę, jak często zmienia się źródło oraz czy któraś ze strategii cenowych korzysta z ostatniej opublikowanej ceny.
6. Starannie wybierz wynik. Użyj XML do weryfikacji lub integracji marketplace’u opartej na pliku. Wybierz opcję API tylko wtedy, gdy jesteś gotowy na przesłanie wybranych pól za pośrednictwem integracji.
7. Sprawdź tryb rabatowy. Potwierdź, czy obliczona cena ma być zwykłą ceną, czy ceną po rabacie.
8. Zapisz ustawienia. Kliknij Update settings.
9. Uruchom ręczną synchronizację. Kliknij Run sync, gdy potrzebujesz natychmiastowego testu z użyciem zapisanej konfiguracji.
10. Sprawdź wynik. Przed rozszerzeniem konfiguracji na cały katalog sprawdź wygenerowany plik XML lub wynik API oraz powiązany raport synchronizacji.

Przypomnienie dotyczące bezpieczeństwa: Obliczona cena, wyeksportowana cena lub przesłana aktualizacja API nie musi być aktualną ceną na marketplace. Marketplace musi jeszcze otrzymać, zaakceptować i zastosować aktualizację.

Co dzieje się po zapisaniu ustawień

Po kliknięciu Update settings B2BLIX przeprowadza podstawową walidację i zapisuje konfigurację na potrzeby przyszłych uruchomień synchronizacji.

Zapisanie formularza nie musi od razu uruchomić synchronizacji. Przy następnym wybranym interwale B2BLIX:

1. pobierze źródło z zapisanego adresu URL;
2. zinterpretuje je przy użyciu wybranego formatu danych;
3. przetworzy zaimportowane produkty z użyciem bieżących ustawień BuyBox;
4. zastosuje dostępne minimalne i maksymalne limity cenowe;
5. przygotuje wynik XML lub API;
6. zapisze informacje o uruchomieniu w raportach synchronizacji.

Użyj Run sync, jeśli chcesz natychmiast rozpocząć ten proces.

W przypadku eksportu XML wygenerowany plik zostanie odświeżony pod tym samym spersonalizowanym publicznym adresem URL. W przypadku eksportu API obsługiwane aktualizacje zostaną zaplanowane do przesłania za pośrednictwem integracji.

Najczęstsze błędy

• Użycie adresu URL strony zamiast adresu URL danych. Źródło musi zwracać dane produktów, a nie stronę internetową wyświetlającą lub opisującą plik.
• Wybór niewłaściwego formatu. Źródło CSV należy skonfigurować jako CSV, źródło XML jako XML, a arkusz Google jako Google spreadsheets.
• Pozostawienie prywatnego arkusza Google. B2BLIX nie może pobrać arkusza, który wymaga osobistego logowania do Google.
• Przyznanie uprawnień do edycji arkusza Google. Wymagane są tylko uprawnienia do wyświetlania. Publiczne uprawnienia do edycji stwarzają niepotrzebne ryzyko.
• Brakujące lub nieprawidłowe wartości EAN. Produkty mogą nie zostać prawidłowo dopasowane, jeśli EAN-y są nieobecne lub nieprawidłowe.
• Użycie nierozpoznanych nazw kolumn. Porównaj nagłówki źródła z tabelą atrybutów systemowych i obsługiwanymi alternatywami.
• Połączenie domyślnych i właściwych dla marketplace’u godzin odbioru. W razie potrzeby użyj domyślnej wartości XML albo oddzielnych wartości dla poszczególnych krajów.
• Niewłaściwe zrozumienie trybu rabatowego. Włączenie tego trybu oddziela pierwotną cenę standardową od obliczonej ceny po rabacie.
• Wybór bardzo krótkiego interwału przy strategii opartej na ostatniej opublikowanej cenie. Strategia może stosować skonfigurowany krok częściej, niż oczekujesz.
• Użycie eksportu API dla wyjątkowo dużego zestawu aktualizacji. Przetworzenie dużej liczby pojedynczych aktualizacji może potrwać dłużej niż wybrany interwał synchronizacji.
• Oczekiwanie, że adres URL XML automatycznie opublikuje ceny. Najpierw należy skonfigurować go jako źródło importu na koncie sprzedawcy Pigu.
• Założenie, że zapisanie ustawień uruchamia synchronizację. Poczekaj na kolejny zaplanowany interwał lub użyj Run sync.

Przykładowy przypadek użycia

Sprzedawca przechowuje dane produktów w arkuszu Google. Arkusz zawiera kolumny EAN, SKU, bieżąca cena, cena minimalna, cena maksymalna i stan magazynowy.

1. Sprzedawca udostępnia arkusz z uprawnieniami tylko do wyświetlania dla każdego, kto ma link.
2. Wkleja adres URL arkusza do pola data source URL.
3. Wybiera Google spreadsheets jako format danych.
4. Pozostawia pola uwierzytelniania podstawowego puste.
5. Wybiera interwał synchronizacji 1 hour.
6. Wybiera XML jako typ eksportu.
7. Włącza discount mode, ponieważ zaimportowana cena standardowa powinna pozostać ceną przed rabatem, a wynik B2BLIX powinien zostać wyeksportowany jako cena po rabacie.
8. Klika Update settings, a następnie Run sync.
9. Sprawdza wynik synchronizacji i wygenerowany plik XML na podstawie małego katalogu testowego.
10. Po potwierdzeniu cen i limitów kopiuje Your public URL do odpowiedniej konfiguracji importu cen i stanów magazynowych przez HTTPS na swoim koncie sprzedawcy Pigu.

Od tego momentu B2BLIX odświeża plik XML zgodnie z wybranym interwałem synchronizacji. Pigu pobiera i przetwarza plik zgodnie z własnym harmonogramem.