Jak zaprojektować główne i dodatkowe źródła dostawcy

Ten przewodnik wyjaśnia, co powinno znajdować się w głównych i dodatkowych źródłach dostawcy, jak łączyć produkty między nimi, jak wybierać harmonogramy synchronizacji oraz co się dzieje, gdy produktu brakuje w dodatkowym źródle.

Kiedy takie rozwiązanie jest przydatne

Niektórzy dostawcy udostępniają jeden kompletny plik danych produktów. Inni udostępniają dwa osobne pliki: jeden duży plik zawierający informacje o produktach oraz drugi, mniejszy plik zawierający często zmieniające się wartości, takie jak ceny i stany magazynowe.

B2BLIX Feed obsługuje oba rozwiązania. Właściwa konfiguracja zależy od tego, jakie pliki udostępnia dostawca i jakie informacje znajdują się w każdym z nich.

Krótka odpowiedź

• Użyj głównego źródła jako podstawowego katalogu dostawcy, zawierającego identyfikatory produktów, tytuły, opisy, zdjęcia, kategorie i inne szczegóły produktów.
• Użyj opcjonalnego dodatkowego źródła do lżejszych i częstszych aktualizacji, zwykle cen i ilości produktów w magazynie.
• Jeśli dostawca udostępnia tylko jedno kompletne źródło, dodaj je jako główne źródło. Dodatkowe źródło nie jest wymagane.
• Jeśli korzystasz z dwóch źródeł, muszą one zawierać stały identyfikator umożliwiający B2BLIX połączenie tego samego produktu w obu plikach.

Zmiana mapowań źródeł lub harmonogramów synchronizacji może wpłynąć na ceny, ilości produktów w magazynie oraz produkty dostępne w eksportach. Przed użyciem danych dostawcy w aktywnym kanale sprzedaży sprawdź zawartość źródeł i podgląd połączenia.

Co powinno znajdować się w każdym źródle

Dokładna zawartość zależy od dostawcy. Główne źródło nie musi zawierać każdego możliwego atrybutu, a dodatkowe źródło nie jest ograniczone dokładnie do dwóch pól. Najważniejsza różnica polega na tym, że główne źródło zwykle udostępnia podstawowe dane produktu, a dodatkowe źródło aktualizuje wybrane wartości.

Kiedy dodatkowe źródło nie jest potrzebne

Nie twórz dodatkowego źródła tylko dlatego, że taka opcja jest dostępna. Jedno źródło wystarczy, jeśli zawiera wszystkie informacje wymagane w Twoim procesie, w tym wartości, które wymagają regularnych aktualizacji.

Dodatkowe źródło zwykle nie jest potrzebne, gdy:

• Dostawca udostępnia tylko jeden link XML lub JSON.
• Główny plik danych zawiera już użyteczne szczegóły produktów, ceny i stany magazynowe.
• Dostawca aktualizuje kompletny plik wystarczająco często.
• Brakuje wiarygodnego wspólnego identyfikatora umożliwiającego połączenie drugiego pliku.

W takiej sytuacji dodaj dostępny link jako główne źródło i pozostaw dodatkowe źródło puste.

Jak produkty są łączone między dwoma źródłami

B2BLIX musi mieć możliwość określenia, któremu rekordowi w głównym źródle odpowiada dany rekord w dodatkowym źródle. Wybierz stały identyfikator obecny w obu plikach, którego wartość jest taka sama dla tego samego produktu.

Odpowiednie pola połączenia mogą obejmować:

• EAN
• ID produktu dostawcy
• SKU dostawcy lub inny stały lokalny kod produktu

Na przykład jeśli produkt ma EAN 5901234567890 w głównym źródle, dodatkowe źródło musi używać tego samego EAN dla odpowiadającego mu rekordu ceny i stanu magazynowego. Niewielkie różnice, takie jak spacje, prefiksy lub inny typ identyfikatora, mogą uniemożliwić połączenie rekordów.

Identyfikator używany do połączenia głównego i dodatkowego pliku dostawcy nie jest tym samym co obowiązująca w całym katalogu reguła identyfikacji produktu. W standardowym procesie B2BLIX Feed produkty nadal wymagają użytecznego EAN do normalnego przetwarzania i grupowania między dostawcami.

Jak wybrać harmonogramy synchronizacji

Główne i dodatkowe źródła mogą korzystać z różnych częstotliwości synchronizacji. Dzięki temu mniejszy plik cen i stanów magazynowych można pobierać częściej niż kompletny katalog.

Wybierz harmonogramy w następującej kolejności:

1. Sprawdź, czy dostawca zaleca konkretny harmonogram aktualizacji lub nakłada limity pobierania.
2. Ustaw harmonogram głównego źródła zgodnie z częstotliwością zmian treści produktów i kompletnego katalogu.
3. Ustaw harmonogram dodatkowego źródła zgodnie z częstotliwością, z jaką należy odświeżać ceny i stany magazynowe.
4. Upewnij się, że harmonogram eksportu jest odpowiedni dla harmonogramów dostawcy. Generowanie eksportu i synchronizacja z dostawcą to osobne operacje.

Jeśli dostawca nie określa limitów ani zalecanego odstępu, synchronizacja co godzinę jest praktycznym punktem wyjścia. Zmień ją dopiero po uwzględnieniu częstotliwości aktualizacji pliku przez dostawcę oraz wymaganej aktualności danych.

Pobieranie danych od dostawcy jest operacją rozliczaną według wykorzystania. Przed zwiększeniem częstotliwości synchronizacji sprawdź limity dostępu dostawcy oraz aktualne informacje o cenach B2BLIX Feed. Częstsze pobieranie nie pomoże, jeśli dostawca aktualizuje źródło rzadziej.

Co się dzieje, gdy produktu brakuje w dodatkowym źródle

Produkt znajdujący się w głównym źródle może nie mieć odpowiadającego mu rekordu w dodatkowym źródle. Dalsze działanie zależy od tego, czy główne źródło zawiera wystarczające informacje do przetworzenia tego produktu.

• Jeśli główne źródło zawiera użyteczną cenę: produkt może nadal zostać przetworzony z wykorzystaniem informacji dostępnych w głównym źródle.
• Jeśli cena powinna pochodzić wyłącznie z dodatkowego źródła: produkt nie zawiera wystarczających informacji o cenie i nie przejdzie dalej przez standardowy proces.
• Jeśli identyfikatory się nie zgadzają: B2BLIX uznaje rekordy za niepołączone, nawet jeśli wydają się opisywać ten sam produkt.

Brak połączenia nie zawsze oznacza, że produktu nie ma. Może również oznaczać, że wybrane pola połączenia zawierają różne wartości albo że jedno z pól zostało nieprawidłowo zmapowane.

Co sprawdzić na koncie

Po zalogowaniu otwórz sekcję Dostawcy aby sprawdzić istniejące konfiguracje dostawców, lub otwórz Dodaj nowego dostawcę aby skonfigurować nowe źródło. Aby dowiedzieć się więcej o polach źródła, synchronizacji i mapowaniu, przeczytaj Dodawanie i konfigurowanie pliku danych dostawcy.

1. Zweryfikuj linki do źródeł

• Upewnij się, że główne źródło otwiera się i zwraca oczekiwane dane XML lub JSON.
• Jeśli używasz dodatkowego źródła, upewnij się, że otwiera się ono osobno.
• Sprawdź, czy wymagane są dane uwierzytelniające lub nagłówki żądania.
• Nie publikuj ani nie udostępniaj prywatnych adresów URL dostawcy, danych uwierzytelniających ani nagłówków żądań.

2. Sprawdź wykrytą strukturę produktów

Podczas mapowania upewnij się, że B2BLIX zidentyfikował właściwą powtarzającą się ścieżkę produktu w każdym pliku. Podgląd powinien wyświetlać pojedyncze produkty, a nie cały dokument, grupę kategorii lub niezwiązaną sekcję.

3. Zmapuj wymagane pola

W głównym źródle sprawdź co najmniej pola wymagane w planowanym procesie, takie jak:

• EAN
• SKU lub ID produktu dostawcy
• Tytuł
• Cena
• Stan magazynowy
• Kategoria

W dodatkowym źródle zmapuj wspólny identyfikator połączenia oraz wartości, które ma aktualizować dodatkowy plik — zwykle cenę i stan magazynowy.

4. Zweryfikuj połączenie źródeł

Na etapie mapowania połączenia wybierz odpowiedni identyfikator w głównym i dodatkowym źródle. Sprawdź podgląd i statystyki części wspólnej, aby potwierdzić, że połączona została rozsądna liczba produktów.

Jeśli łączy się bardzo niewiele produktów, sprawdź, czy:

• Po obu stronach wybrano ten sam typ identyfikatora.
• Wartości identyfikatorów mają ten sam format.
• Podgląd pokazuje porównywalne produkty z obu plików.
• Dostawca nie użył różnych systemów SKU w obu źródłach.
• Identyfikator jest unikalny i stały, a nie jest tytułem, kategorią ani inną zmienną wartością.

Typowe problemy z projektowaniem źródeł

Oba pliki dodano jako osobnych dostawców

Jeśli pliki opisują katalog tego samego dostawcy, a jeden z nich służy wyłącznie do aktualizowania drugiego, powinny być zwykle skonfigurowane jako główne i dodatkowe źródło w ramach jednej konfiguracji dostawcy. Utworzenie dwóch niezależnych konfiguracji dostawcy nie utworzy zamierzonego połączenia źródeł.

Dodatkowe źródło nie zawiera szczegółów produktów

To często jest prawidłowe. Dodatkowe źródło może zawierać tylko identyfikator, cenę i stan magazynowy. Pełny tytuł, opis, zdjęcia i kategorię można nadal pobierać z głównego źródła.

Do połączenia użyto tytułu produktu

Tytuły produktów nie są wiarygodnymi polami połączenia, ponieważ ich treść, interpunkcja, język i formatowanie mogą się zmieniać. Zamiast tego użyj EAN, ID produktu dostawcy lub stałego SKU dostawcy.

Harmonogramy źródeł są identyczne bez praktycznego powodu

Duży plik katalogu może nie wymagać pobierania tak często jak mały plik z aktualizacjami stanów magazynowych. Korzystaj z zaleceń dostawcy i rzeczywistej częstotliwości aktualizacji każdego pliku, zamiast automatycznie przypisywać ten sam harmonogram.

Połączony rekord dodatkowy nie zawiera ceny

Połączenie rekordów nie tworzy brakującej wartości. Jeśli produkt wymaga ceny z dodatkowego źródła, sprawdź, czy wybrana ścieżka ceny zawiera prawidłową wartość w podglądzie mapowania.

Przykład

Dostawca udostępnia dwa pliki:

• catalog.xml zawiera 40 000 produktów z EAN, SKU, tytułami, opisami, zdjęciami, kategoriami, cenami i stanami magazynowymi.
• updates.xml zawiera EAN, aktualną cenę i aktualny stan magazynowy dla 35 000 produktów.

Sprzedawca konfiguruje catalog.xml jako główne źródło, a updates.xml jako dodatkowe źródło. Jako pole połączenia wybiera EAN, ponieważ występuje on w obu plikach.

W przypadku produktu znajdującego się w obu plikach pełne informacje o produkcie pochodzą z głównego źródła, a często aktualizowana cena i stan magazynowy — z dodatkowego źródła. Jeśli produktu brakuje w dodatkowym pliku, ale główny plik zawiera prawidłową cenę, produkt może nadal zostać przetworzony z wykorzystaniem tej ceny. Jeśli główny plik nie zawiera ceny, a oczekiwanego rekordu dodatkowego brakuje, produkt nie ma wymaganych danych cenowych i zostaje pominięty.

Co zrobić dalej

1. Potwierdź, czy dostawca udostępnia jedno kompletne źródło, czy osobne źródło katalogu i źródło aktualizacji.
2. Dodaj kompletny katalog jako główne źródło.
3. Dodaj dodatkowe źródło tylko wtedy, gdy ma jasno określone zastosowanie związane z aktualizacjami.
4. Znajdź stałe pole, które występuje w obu plikach i ma w nich zgodne wartości.
5. Zmapuj struktury głównego i dodatkowego źródła oraz sprawdź wartości w ich podglądach.
6. Sprawdź statystyki połączenia przed zapisaniem mapowania.
7. Wybierz harmonogramy synchronizacji na podstawie zaleceń dostawcy, częstotliwości aktualizacji plików i wymaganej aktualności danych.
8. Przetestuj zaimportowane produkty przed użyciem dostawcy w aktywnym eksporcie.

Dobrze zaprojektowane połączenie źródeł zapewnia dostępność kompletnych danych produktów, a jednocześnie umożliwia sprawne odświeżanie cen i stanów magazynowych. Najważniejsze elementy to wiarygodny wspólny identyfikator, prawidłowe mapowania pól oraz wystarczające dane awaryjne w głównym źródle na wypadek braku rekordu w źródle dodatkowym.