Mapowanie parametrów przy integracji z Erli – jak uniknąć odrzuconych ofert

Oferty, których nie da się kupić – co oznaczają problemy z kupowalnością

Na Erli zamiast klasycznego odrzucenia oferty częściej spotkasz produkt, który istnieje w panelu, ale nie jest kupowalny. API zwraca wtedy w polu buyableProblems listę przyczyn. Dokumentacja wymienia m.in. problemy z dostawą, stanem magazynowym, aktywnością, kategorią, obrazkami, brakiem ceny lub ceną poza dopuszczalnym zakresem, warunkami sprzedaży, blokadą, stanem produktu, tłumaczeniami, nazwą, brakiem stawki VAT oraz nieaktywnym rynkiem. Kilka z nich wynika bezpośrednio z mapowania.

Pole buyableProblems to najlepsze narzędzie diagnostyczne przy dużych katalogach. Jeśli integracja lub system multichannel potrafi je pobrać i pokazać, od razu widzisz, ile produktów ma problem z kategorią, a ile z dostawą czy VAT. Bez tego zostaje ręczne przeglądanie produktów w panelu. Szerzej o tym, jak działa połączenie z platformą, piszemy w tekście Erli API – co można zautomatyzować.

Stawka VAT a kategoria

Z dziennika zmian API wynika, że wyszukiwarka kategorii zwraca stawki VAT dozwolone w danej kategorii, także w podziale na rynki. To oznacza, że błędne przypisanie kategorii może skutkować problemem ze stawką VAT – produkt z kategorii objętej obniżoną stawką trafia do kategorii, w której dozwolona jest tylko stawka podstawowa, albo odwrotnie. Przy produktach spożywczych, książkach czy artykułach dziecięcych warto sprawdzić to szczególnie uważnie.

Mapowanie parametrów krok po kroku

Niezależnie od tego, czy integrujesz Erli przez system multichannel, wtyczkę sklepu czy własne API, proces przygotowania mapowania wygląda podobnie. Najlepiej przeprowadzić go na próbce produktów, zanim wyślesz cały katalog.

1. Uporządkuj kategorie w sklepie – jedna kategoria sklepu powinna odpowiadać jednemu typowi produktu, a nie mieszać np. kubków, czajników i noży.

2. Wybierz źródło danych – własne kategorie sklepu, identyfikatory Allegro albo bezpośrednio słowniki Erli.

3. Pobierz listę atrybutów dla kluczowych kategorii Erli – zwróć uwagę na atrybuty wymagane, typy, jednostki i liczbę wartości.

4. Porównaj wartości słownikowe – kolory, materiały, rozmiary i marki w sklepie z wartościami w słowniku platformy.

5. Ujednolić jednostki i formaty liczb – rozdziel liczbę i jednostkę, ujednolić separator dziesiętny.

6. Wyślij próbkę produktów – po jednym lub kilka z każdej kategorii.

7. Sprawdź przypisania w panelu i problemy z kupowalnością – popraw mapowanie, zanim wyślesz resztę katalogu.

8. Wyślij cały katalog i monitoruj problemy – szczególnie przez pierwsze dni po imporcie.

[#tip] Zacznij od kategorii, które odpowiadają za największą część sprzedaży w innych kanałach. Dopracowanie mapowania dla dziesięciu najważniejszych kategorii zwykle daje więcej niż powierzchowne przypisanie wszystkich. Rzadkie kategorie możesz dopracować w drugim etapie.

Warianty a parametry

Atrybuty mają też znaczenie przy łączeniu produktów w grupy wariantowe. W API Erli pole externalVariantGroup wskazuje, które atrybuty różnicują warianty, np. kolor i rozmiar. Słownik atrybutów informuje, czy dany atrybut może tworzyć wariant i czy wszystkie warianty muszą mieć tę samą wartość, np. tę samą markę. Jeśli różnicujący atrybut nie zostanie poprawnie zmapowany, warianty mogą rozpaść się na osobne oferty albo połączyć niepoprawnie. Szczegóły opisaliśmy w tekście Warianty produktów na Erli.

Ręczne poprawki a synchronizacja – zamrożone pola

Dokumentacja API Erli opisuje mechanizm, o którym warto wiedzieć przed pierwszą ręczną poprawką. Ręczna edycja produktu w panelu sprzedawcy powoduje zamrożenie pola, a zamrożone pola nie są zmieniane przez API. W edycji produktu w panelu są oznaczone ikonką. To chroni ręcznie dopracowane opisy czy uzupełnione atrybuty przed nadpisaniem przez integrację, ale ma też drugą stronę: jeśli poprawisz parametr ręcznie, a później zmienisz go w systemie źródłowym, zmiana nie trafi na Erli.

• Poprawiaj dane u źródła – w sklepie lub systemie multichannel, a nie w panelu Erli, jeśli chcesz zachować pełną synchronizację.

• Ręcznie edytuj tylko świadomie – np. gdy jeden produkt wymaga wyjątkowego opisu lub atrybutu.

• Prowadź listę ręcznych zmian – żeby wiedzieć, które produkty nie aktualizują się automatycznie.

• Unikaj wymuszania nadpisania – dokumentacja odradza zdejmowanie zamrożeń, bo nadpisuje ręczne poprawki.

[#uwaga] Produktów na Erli nie da się usunąć przez API – dokumentacja zaleca oznaczanie ich jako nieaktywnych. Jeśli w trakcie testów wyślesz produkty z błędnym mapowaniem, nie znikną one z panelu. Dlatego próbne importy rób na niewielkiej, dobrze opisanej próbce, a nie na całym katalogu.

Tytuły, opisy i najważniejsze cechy

Mapowanie dotyczy nie tylko kategorii i atrybutów. API Erli przyjmuje nazwę produktu o długości od 3 do 150 znaków, opis w formie sekcji z tekstem i obrazkami albo w HTML, a także pole najważniejszych cech, w którym można przesłać do 10 pozycji. Opis w HTML musi spełniać kilka reguł: znaczniki pisane małymi literami i bez atrybutów, nagłówki zawierające wyłącznie tekst oraz ograniczone zagnieżdżanie. Szablony opisów z innych kanałów, pełne stylów i klas, mogą wymagać uproszczenia.

Dobrze zmapowane parametry wspierają też widoczność. Kupujący zawężają wyniki filtrami, które opierają się na atrybutach, więc produkt bez koloru czy rozmiaru może nie pojawić się w przefiltrowanych wynikach. O przygotowaniu treści oferty piszemy w tekście Opis i parametry produktu na Erli, a o doborze kategorii – w artykule Kategorie na Erli.

Import z Allegro a parametry

Jeśli Twój katalog jest dobrze opisany na Allegro, przesłanie kategorii i parametrów z identyfikatorami Allegro może znacząco skrócić mapowanie. Dokumentacja Erli wskazuje, że platforma utrzymuje aktualne przypisania z kategorii i atrybutów Allegro. Nie zwalnia to jednak z kontroli: część parametrów może nie mieć odpowiednika albo wymagać uzupełnienia. Jak przygotować dane na Allegro, opisaliśmy w tekście Parametry oferty na Allegro, a o przenoszeniu asortymentu piszemy w artykule Import ofert z Allegro na Erli.

Mapowanie w systemie multichannel

Większość sprzedawców łączy Erli ze sklepem przez system multichannel. Wtedy część mapowania odbywa się po stronie tego systemu: przypisanie kategorii, wybór parametrów, ich wartości i jednostek. Dobrze ustawiony katalog produktów w systemie multichannel to podstawa, bo z niego dane trafiają nie tylko na Erli, ale też do innych kanałów. Konfigurację i typowe problemy integracji Erli z Base opisaliśmy w tekście BaseLinker Erli, a jeśli potrzebujesz pomocy we wdrożeniu samego systemu – sprawdź wdrożenie i obsługę Base.

Przy dużych katalogach opłaca się też ustalić zasady prowadzenia danych w źródle: jeden format jednostek, jeden słownik kolorów, obowiązkowe pola dla każdego nowego produktu. Każdy nowy produkt dodany zgodnie z tymi zasadami trafi na Erli bez dodatkowej pracy, a nowe kategorie będą wymagały jedynie jednorazowego mapowania.

Warto też wyznaczyć osobę odpowiedzialną za jakość danych produktowych. W wielu firmach katalog uzupełniają różne osoby – zakupy, marketing, magazyn – a każda zapisuje parametry trochę inaczej. Jedna osoba, która pilnuje słowników, jednostek i kompletności pól, a raz w tygodniu przegląda listę produktów z problemami na Erli, zwykle wystarcza, żeby utrzymać porządek nawet przy kilku tysiącach pozycji.

Najczęściej zadawane pytania

Czy przy integracji z Erli trzeba używać kategorii Erli?

Nie zawsze. Według dokumentacji API można przesłać własne kategorie i atrybuty ze sklepu, a następnie przypisać je w panelu rozpoznawania kategorii i atrybutów. Można też przesłać identyfikatory z Allegro albo bezpośrednio z Erli.

Dlaczego produkt wysłany przez API nie jest widoczny na Erli?

Kod 202 oznacza tylko przyjęcie danych do przetwarzania. Produkt może mieć problemy z kategorią, obrazkami, dostawą, VAT lub warunkami sprzedaży. Sprawdź pole buyableProblems albo stan produktu w panelu. Zmiany mogą też pojawić się z opóźnieniem do 20 minut.

Jakie typy parametrów obsługuje Erli?

Słownik atrybutów rozróżnia typy number, range, dictionary i string. Atrybut może mieć określone jednostki, zakres, precyzję, maksymalną liczbę wartości oraz informację, czy jest wymagany i czy tworzy wariant.

Dlaczego moje poprawki z systemu nie trafiają na Erli?

Najczęściej dlatego, że pole zostało wcześniej edytowane ręcznie w panelu Erli i jest zamrożone. Zamrożone pola nie są zmieniane przez API. Status zamrożeń jest widoczny w panelu i w API.

Czy mogę usunąć błędnie zaimportowane produkty?

Według dokumentacji API produktów nie da się usunąć – należy oznaczyć je jako nieaktywne. Dlatego testowe importy warto robić na małej próbce produktów.

Czy parametry wpływają na widoczność oferty?

Tak. Kupujący zawężają wyniki filtrami opartymi na atrybutach, więc produkt bez wymaganych lub kluczowych parametrów może nie pojawić się w przefiltrowanych wynikach, nawet jeśli jest kupowalny.

Podsumowanie

Parametry przy integracji z Erli decydują o tym, czy oferty są kupowalne, widoczne w filtrach i poprawnie połączone w warianty. Kluczem jest świadomy wybór źródła danych, sprawdzenie atrybutów wymaganych, słowników i jednostek, testowy import na małej próbce oraz regularne monitorowanie problemów z kupowalnością. Poprawiaj dane u źródła, a nie w panelu, i traktuj mapowanie jako fundament, na którym opiera się cała sprzedaż w kanale.

Jeśli chcesz uporządkować mapowanie kategorii i parametrów przed startem lub po problemach z importem, wdrażamy i obsługujemy sprzedaż na Erli – sprawdź zakres obsługi sprzedaży na Erli.