Mapowanie towarów i kategorii między sklepem a systemem magazynowym

Gdy sklep i magazyn pokazują różne dane

Jednym z typowych objawów nieprawidłowej integracji jest różna liczba produktów w sklepie internetowym i systemie sprzedażowo-magazynowym. Towar może być widoczny w jednym miejscu, ale nie pojawiać się w drugim. Czasem produkt zostaje utworzony podwójnie, a jego stan magazynowy aktualizuje się tylko częściowo.

Problemy mogą dotyczyć także ceny, zdjęcia, opisu, dostępności albo kategorii. Sklep może przypisywać produkt do niewłaściwej grupy, a zamówienie może pomniejszać stan innej pozycji. Przy większej liczbie towarów ręczne poprawianie takich błędów staje się czasochłonne i zwiększa ryzyko kolejnych pomyłek.

Mapowanie towarów oznacza ustalenie, który produkt w sklepie odpowiada konkretnej kartotece w systemie magazynowym. Mapowanie kategorii określa natomiast, do jakiej grupy w sklepie ma trafić dana pozycja z systemu. Oba elementy muszą być spójne, ponieważ sam przesył danych bez właściwego powiązania może prowadzić do niewłaściwych aktualizacji.

Najczęstsze przyczyny niespójności

Najczęściej problem zaczyna się od różnych oznaczeń tego samego produktu. W sklepie może występować kod zapisany jako „ABC-123”, a w systemie magazynowym jako „ABC123”. Dla człowieka jest to prawdopodobnie ta sama pozycja, ale mechanizm integracji może potraktować te wartości jako dwa różne identyfikatory.

Drugą częstą przyczyną są duplikaty. Ten sam towar bywa wpisany kilka razy, ponieważ został dodany ponownie po zmianie nazwy, dostawcy albo ceny. Jeżeli duplikaty mają podobne opisy, ale różne kody, integracja nie zawsze jest w stanie samodzielnie rozpoznać właściwej kartoteki.

Problemy powstają również wtedy, gdy sklep i system magazynowy mają inną strukturę kategorii. Jedna kategoria w systemie może odpowiadać kilku kategoriom sklepu. Możliwa jest także sytuacja odwrotna, w której kilka grup magazynowych trafia do jednej kategorii sprzedażowej.

Osobną przyczyną są niejednolite zasady dla produktów wariantowych. Wariant to odrębna wersja produktu, na przykład konkretny rozmiar lub kolor. Jeśli każdy wariant nie ma własnego jednoznacznego kodu, stany mogą zostać przypisane do produktu głównego albo do niewłaściwej odmiany.

Identyfikatory, czyli podstawa poprawnego połączenia

Identyfikator jest wartością, która pozwala rozpoznać konkretny produkt w systemie. Może nim być kod towaru, symbol producenta, SKU, czyli wewnętrzne oznaczenie jednostki sprzedażowej, albo kod kreskowy EAN. W integracji trzeba ustalić, która wartość jest nadrzędna i czy jest unikalna dla każdej kartoteki.

Najbezpieczniejszy model zakłada, że każdy produkt oraz każdy wariant mają jeden niepowtarzalny identyfikator. Kod nie powinien być zmieniany zależnie od miejsca sprzedaży, nazwy kategorii ani aktualnego dostawcy. Jeżeli kod jest jednocześnie używany w zamówieniach, dokumentach magazynowych i synchronizacji, jego zmiana może zerwać istniejące powiązania.

Przed integracją sprawdzane są między innymi puste kody, powtórzenia, spacje na początku lub końcu wartości, różnice w wielkości liter oraz znaki specjalne. Warto również ustalić, czy kod kreskowy dotyczy produktu głównego, opakowania zbiorczego czy konkretnego wariantu. Sam wygląd kodu nie przesądza jeszcze o jego przeznaczeniu.

Ważne jest także określenie kierunku przepływu danych. System magazynowy może być źródłem stanów i cen, a sklep miejscem prezentacji oferty. W innym modelu część opisowa jest zarządzana w sklepie, a dane handlowe pozostają w systemie sprzedażowo-magazynowym. Bez takiego ustalenia oba systemy mogą nadpisywać sobie wartości.

Produkty z wariantami wymagają osobnych reguł

Produkt prosty występuje jako jedna kartoteka i zwykle ma jeden kod. Produkt wariantowy składa się z produktu nadrzędnego oraz odmian, które mogą różnić się kolorem, rozmiarem, pojemnością lub inną cechą. W praktyce to właśnie warianty są częstym źródłem błędnych stanów i nieprawidłowych zamówień.

Każdy wariant powinien mieć własny identyfikator, jeżeli jest osobno sprzedawany i osobno ewidencjonowany w magazynie. Kod produktu nadrzędnego nie powinien zastępować kodów odmian. W przeciwnym razie zamówienie na jeden wariant może pomniejszyć stan całej grupy albo zostać zapisane bez informacji o wybranej wersji.

Podczas przygotowania mapowania ustalane jest, czy system magazynowy przechowuje warianty jako osobne kartoteki, czy jako cechy jednej kartoteki. Cecha produktu to właściwość opisująca odmianę, na przykład kolor. Oba modele są możliwe, ale wymagają różnych ustawień po stronie integracji.

Trzeba także sprawdzić, jak przekazywane są wartości wariantów. Sklep może używać nazwy „czarny”, a system wartości „black”. Jeżeli integracja nie ma słownika tłumaczeń, czyli zestawienia odpowiadającego sobie nazw, wariant może zostać utworzony ponownie lub pozostać bez powiązania.

Kategorie nie zawsze mają układ jeden do jednego

Kategoria porządkuje ofertę według określonej cechy, na przykład rodzaju produktu. W systemie magazynowym kategorie mogą służyć głównie do zakupów, analiz lub kontroli stanów. W sklepie pełnią dodatkowo funkcję nawigacyjną i wpływają na sposób prezentowania oferty. Z tego powodu identyczne drzewa kategorii nie są konieczne, ale zasady przejścia między nimi muszą być jasne.

Najprostsze mapowanie polega na połączeniu jednej kategorii magazynowej z jedną kategorią sklepu. Bardziej złożony przypadek występuje wtedy, gdy jedna grupa magazynowa obejmuje wiele grup sprzedażowych. Wtedy potrzebne może być mapowanie na podstawie dodatkowego pola, typu produktu, marki albo ustalonego słownika.

Drzewo kategorii to hierarchiczny układ grup, w którym kategoria nadrzędna zawiera podkategorie. Przed synchronizacją trzeba określić, czy do sklepu mają być przekazywane także kategorie nadrzędne, czy tylko końcowe. Kategoria końcowa to najniższy poziom, do którego przypisywany jest konkretny produkt.

Należy unikać mapowania wyłącznie po nazwie. Dwie kategorie mogą mieć taki sam tytuł, ale znajdować się w różnych gałęziach drzewa. Bezpieczniejsze jest użycie identyfikatora kategorii oraz zapisanie reguły, która wskazuje, co ma się stać z produktem pozbawionym przypisania.

Porządkowanie kartotek przed integracją

Przed rozpoczęciem prac wykonywany jest przegląd kartotek towarowych. Kartoteka to kompletny zestaw informacji o produkcie, obejmujący między innymi nazwę, kod, jednostkę miary, stawkę podatku, cenę, stan i przypisanie do kategorii. Nie każda informacja musi być przesyłana do sklepu, ale jej znaczenie powinno być ustalone.

W pierwszej kolejności wyszukiwane są duplikaty oraz pozycje nieaktywne. Produkt wycofany ze sprzedaży nie powinien być przypadkowo ponownie publikowany tylko dlatego, że nadal znajduje się w systemie. Sprawdzane są również kartoteki bez kodu, bez kategorii albo z opisem, który nie pozwala odróżnić ich od innych produktów.

Następnie ustala się jednolite nazewnictwo. Nazwa produktu powinna opisywać towar, a cechy wariantu powinny być zapisane w przewidywalny sposób. Jednostki miary, formaty pojemności i oznaczenia rozmiarów wymagają jednej konwencji. Dzięki temu łatwiej uniknąć sytuacji, w której podobne towary są traktowane jako różne tylko z powodu odmiennego zapisu.

W ramach porządkowania można także przygotować słownik wartości. Słownik to lista dopuszczalnych odpowiedników, na przykład przypisanie nazwy „granatowy” do wartości używanej w systemie magazynowym. Takie zestawienie pomaga zachować spójność wariantów i kategorii bez ręcznego poprawiania każdego produktu po synchronizacji.

Jak przebiegają prace nad mapowaniem

Prace rozpoczynają się od ustalenia, jakie dane mają być wymieniane między sklepem a systemem sprzedażowo-magazynowym. Analizowane są źródła identyfikatorów, struktura produktów, warianty, kategorie oraz kierunki aktualizacji. Sprawdzane jest również, czy integracja ma tworzyć nowe kartoteki, czy tylko łączyć już istniejące.

W kolejnym etapie przygotowywane są reguły mapowania. Reguła może wskazywać, że produkt jest rozpoznawany po kodzie SKU, wariant po osobnym kodzie, a kategoria po identyfikatorze z ustalonym słownikiem. Dla wyjątków ustala się sposób postępowania, na przykład zatrzymanie synchronizacji danego produktu zamiast automatycznego utworzenia duplikatu.

Przed uruchomieniem pełnej wymiany wykonywana jest synchronizacja testowa. Synchronizacja to kontrolowane przesłanie danych między systemami. Wyniki są porównywane pod kątem liczby produktów, kodów, wariantów, kategorii, cen i stanów. Szczególną uwagę zwraca się na zamówienie testowe, ponieważ pozwala sprawdzić, czy właściwa pozycja zostaje odjęta z magazynu.

Po weryfikacji można uruchomić synchronizację właściwą i obserwować komunikaty błędów. Log, czyli zapis przebiegu operacji, pomaga ustalić, czy problem dotyczy brakującego identyfikatora, niezgodnej kategorii, błędnego formatu danych czy niedostępnej kartoteki. Ustalone mapowanie powinno zostać opisane, aby późniejsze zmiany nie były wykonywane przypadkowo.

Co można sprawdzić samodzielnie

Samodzielnie można przygotować listę produktów występujących w obu systemach i porównać ich kody. Warto zaznaczyć duplikaty, produkty bez identyfikatora, pozycje wycofane oraz towary z niepełnymi kategoriami. Można również sprawdzić kilka wariantów tego samego produktu i potwierdzić, czy każdy ma odrębny kod.

Dobrym przygotowaniem jest spisanie oczekiwań dotyczących źródła danych. Należy określić, gdzie zarządzane są stany, gdzie zmieniane są opisy, które ceny mają być wysyłane do sklepu oraz czy produkty bez kategorii mogą być publikowane. Takie ustalenia ograniczają późniejsze spory o to, który system ma pierwszeństwo.

Nie należy jednak masowo zmieniać kodów produktów bez kopii danych i bez wiedzy o istniejących zamówieniach. Nie powinno się także usuwać kartotek tylko po to, aby zmniejszyć liczbę pozycji. Usunięcie może zerwać historię sprzedaży albo uniemożliwić rozpoznanie starszych zamówień.

Nie zaleca się uruchamiania pełnej synchronizacji po pojedynczej poprawce bez sprawdzenia jej skutków. Bezpieczniej wykonać test na ograniczonej grupie towarów, a następnie porównać wynik ze stanem wyjściowym. Jeżeli integracja nie pozwala na test kontrolowany, konfiguracja powinna być przeanalizowana przed pierwszym pełnym przesłaniem danych.

Błędy wynikające z pośpiechu

Jednym z błędów jest uznanie, że zgodna nazwa produktu wystarczy do jego rozpoznania. Nazwa może się zmienić, zawierać literówkę albo występować przy kilku kartotekach. Podstawą powinien być jednoznaczny identyfikator, a nazwa może pełnić funkcję pomocniczą.

Innym błędem jest traktowanie produktu nadrzędnego i wariantów jako jednej pozycji. Taki model może działać przy prezentacji oferty, ale nie musi odpowiadać ewidencji magazynowej. Jeżeli warianty mają oddzielne stany, muszą być również oddzielnie rozpoznawane w procesie synchronizacji.

Często pomijane jest także mapowanie produktów już istniejących w sklepie. W efekcie integracja tworzy nowe rekordy zamiast połączyć je z obecnymi. Powstają wtedy duplikaty, a część historii sprzedaży pozostaje przy starej pozycji.

Ryzykowne jest również jednoczesne zmienianie struktury kategorii, kodów, opisów i ustawień synchronizacji. Gdy pojawi się błąd, trudno ustalić jego przyczynę. Zmiany powinny być wprowadzane etapami, z zapisem zakresu i wyniku każdej operacji.

Kiedy problem nie dotyczy samego mapowania

Nie każda rozbieżność oznacza błędne połączenie produktów. Czasem przyczyną jest opóźnienie kolejki synchronizacyjnej, czyli listy danych oczekujących na przetworzenie. Innym razem dane są prawidłowo zmapowane, ale integracja nie ma uprawnień do odczytu albo zapisu określonego pola.

Jeżeli produkt ma właściwy kod, ale nie pojawia się w sklepie, należy sprawdzić status publikacji, dostępność, widoczność oraz reguły eksportu. Towar może być poprawnie powiązany, lecz wyłączony z wysyłki. Jeżeli stan magazynowy jest poprawny, ale klient widzi inną informację, problem może dotyczyć warstwy prezentacji albo cache, czyli tymczasowej pamięci przechowującej wcześniejszy wynik.

Nieprawidłowa cena może wynikać z reguł cennika, promocji albo zaokrągleń, a nie z identyfikatora. Błąd przy zamówieniu może natomiast dotyczyć jednostek miary, rezerwacji towaru lub statusu płatności. Przed zmianą mapowania warto ustalić, na którym etapie dane przestają być zgodne.

Czy integracja obejmuje program księgowy?

Integracja opisywana w tym artykule dotyczy sklepu oraz systemu sprzedażowo-magazynowego. Jej zadaniem jest uporządkowanie produktów, kategorii, wariantów, stanów i danych potrzebnych do obsługi sprzedaży. Nie oznacza to automatycznego połączenia sklepu z programem księgowym albo kadrowym.

Programy takie jak Rewizor, Rachmistrz, Płatnik i Gratyfikant nie są w tym zakresie łączone ze sklepem. Mogą funkcjonować w innym obiegu dokumentów, ale ich obecność nie zmienia zasad mapowania towarów między sklepem a systemem magazynowym.

Co dzieje się z danymi podczas zlecenia prac?

Najpierw ustalany jest zakres systemów i danych objętych analizą. W razie potrzeby przygotowywana jest kopia konfiguracji oraz eksport kartotek, aby można było porównać stan przed zmianą i po jej wykonaniu. Nie powinno się przekazywać więcej danych, niż jest potrzebne do diagnozy i konfiguracji.

Domyślnie nie jest potrzebne hasło klienta. Dostęp może zostać zorganizowany w sposób ograniczony do ustawień integracji albo przekazany na czas wykonywania określonych czynności. Jeżeli wymagane są dane poufne, na życzenie możliwe jest bezpłatne przygotowanie NDA, czyli umowy o zachowaniu poufności.

W zależności od zakresu prace mogą być prowadzone podczas wizyty serwisanta albo w trybie door-to-door, w którym kierowca odbiera i zwraca sprzęt. Przy wizycie serwisanta dojazd jest bezpłatny, natomiast praca jest zawsze płatna. Model obsługi dobiera się do rodzaju konfiguracji i dostępu do środowiska.

Ile trwa uporządkowanie mapowania?

Czas zależy od liczby kartotek, liczby wariantów, stanu kategorii oraz sposobu działania użytej integracji. Samo powiązanie kilku prostych grup może być szybkie, natomiast duplikaty, niespójne kody i rozbudowane drzewa kategorii wymagają dodatkowej analizy.

Naprawa lub konfiguracja jest z reguły wykonywana do 3 dni. Przyspieszanie i czyszczenie może zostać wykonane do 24 godzin, jeśli zakres danych i dostęp do systemów pozwalają przeprowadzić prace bez dodatkowych ustaleń. Ten czas dotyczy wykonania uzgodnionego zakresu, a nie oczekiwania na odpowiedzi dostawcy zewnętrznej integracji.

Po zakończeniu prac warto zaplanować kontrolę pierwszych synchronizacji. Należy sprawdzić nowe produkty, zmienione warianty, kategorie oraz zamówienia. Większość usterek usuwana jest podczas pierwszej wizyty, ale rozbieżności wynikające z danych dostarczanych później mogą wymagać osobnego sprawdzenia.

Podsumowanie zasad bezpiecznego mapowania

Poprawne mapowanie zaczyna się od jednoznacznych identyfikatorów, a nie od samego uruchomienia połączenia. Każdy wariant powinien być rozpoznawalny, kategorie powinny mieć ustalone odpowiedniki, a kartoteki przed synchronizacją muszą zostać oczyszczone z duplikatów i niejasnych wpisów.

Najważniejsze jest także wskazanie systemu źródłowego dla poszczególnych danych. Gdy wiadomo, skąd pobierany jest stan, cena, opis i kategoria, łatwiej uniknąć wzajemnego nadpisywania informacji. Testowa synchronizacja, zapis reguł i kontrola logów pozwalają szybciej wykryć problem, zanim obejmie całą ofertę.