Hepsiburada Marketplace Sync - Automatyczna aktualizacja stanów i cen przez API lub CSV

Twój sklep jest źródłem prawdy. Marketplace powinien za nim podążać.

Sprzedaż na Hepsiburada oznacza utrzymywanie trzech rzeczy w aktualnym stanie przy każdej ofercie: ceny, dostępnego zapasu i czasu wysyłki. Robiąc to ręcznie, eksportujesz arkusz każdego ranka; zapomnisz na jeden dzień i albo sprzedajesz towar, którego już nie masz, albo stoisz z ceną, której wcale nie chciałeś zaoferować. Ten moduł czyni katalog PrestaShop jedynym źródłem i przekazuje zmiany dalej.

Dwie drogi dostarczania, jeden generator wierszy

• Eksport CSV — pobierz plik z dokładnie tymi kolumnami, w dokładnie tej kolejności, jakich oczekuje importer masowy Hepsiburady, i wgraj go samodzielnie w panelu sprzedawcy.
• Listing API — wpisz swoje dane dostępowe, a moduł porozumiewa się z Hepsiburadą bezpośrednio. Skieruj crona na podany adres, a zmiany stanów i cen będą wysyłane same.

Obie drogi przechodzą przez ten sam generator wierszy, więc pobrany plik i dane wysyłane przez API zawsze się zgadzają. Jeśli kiedykolwiek zechcesz sprawdzić, co robi API, po prostu pobierz plik.

Co wysyła — a czego nie rusza

Za samą ofertę odpowiada zespół katalogowy Hepsiburady, dlatego ten moduł nigdy nie zmienia nazw produktów, opisów, zdjęć, kategorii ani atrybutów. Wysyła pola należące do sprzedawcy: cenę netto, dostępny zapas, czas wysyłki, etykiety przewoźnika i adresu, maksymalną liczbę sztuk w zamówieniu oraz typ i długość personalizacji. Nic, co należy do ich katalogu, nie zostaje nadpisane.

Zabezpieczenia, bo błędna cena kosztuje

• "Hold back" (zatrzymanie zapasu) — odejmij bufor od każdej ilości przed wysłaniem. Ustaw 2, a produkt mający 5 sztuk na stanie zostanie zaoferowany jako 3, więc zamówienie z marketplace nie sprzeda tego, co właśnie sprzedał Twój sklep.
• Mnożnik ceny — wyślij cenę sklepową bez zmian albo dolicz marżę pokrywającą prowizję marketplace. Wartości powyżej 10 są odrzucane jako literówka, zamiast trafić do publikacji.
• "Never send a price below" (nigdy nie wysyłaj ceny poniżej) — próg bezpieczeństwa. Wiersze poniżej niego są wstrzymywane i raportowane, zamiast trafić do sprzedaży z błędną kwotą.
• "Never offer more than" (nigdy nie oferuj więcej niż) — ogranicz ilość pokazywaną na marketplace niezależnie od tego, co leży w magazynie.

Produkty wyłączone lub niedostępne do zamówienia są wysyłane z zerowym stanem, a nie pomijane, dzięki czemu przestają się sprzedawać na marketplace, zamiast po cichu tracić aktualność.

Powie Ci, czego nie da się wysłać i dlaczego

Panel statusu w zakładce Getting started (pierwsze kroki) wskazuje z nazwy produkty, których to dotyczy, zamiast zostawiać Cię ze zgadywaniem: brak SKU i brak kodu magazynowego, cena wychodząca na zero, cena poniżej Twojego progu, brakująca nazwa w języku eksportu. Zduplikowane SKU są wykrywane przed wysyłką — Hepsiburada odrzuca całą paczkę, jeśli jedno pojawi się dwa razy, więc wcześniejsze wychwycenie oszczędza pełne ponowne wgranie. Pole przewoźnika jest weryfikowane wobec listy przewoźników publikowanej przez Hepsiburadę i ostrzega przy nierozpoznanej nazwie, którą ich strona w innym razie po cichu zignoruje.

Zaplanowana synchronizacja, która uczciwie raportuje

Zakładka Send (wysyłka) pokazuje adres crona zabezpieczony tokenem. Skieruj na niego crona swojego hostingu — co trzydzieści minut to typowy wybór — a domyślnie wysłane zostanie tylko to, co się zmieniło od ostatniego udanego uruchomienia; zapisy produktów i ruchy magazynowe automatycznie oznaczają oferty jako zmienione. Dodaj &mode=full, aby wysłać wszystko ponownie po tym, jak Hepsiburada odrzuciła lub zgubiła paczkę. Punkt końcowy odpowiada w formacie JSON, więc narzędzie monitorujące odróżni prawdziwą awarię od uruchomienia bez zmian, równoległe uruchomienia są odrzucane, aby powolny przebieg się nie spiętrzył, a wygenerowanie adresu na nowo natychmiast unieważnia stary, gdyby adres URL kiedyś wyciekł.

Powiązywanie produktów i kombinacje

Każda oferta na Hepsiburada ma swoje HepsiburadaSku. Wklej je w zakładce Hepsiburada na stronie produktu albo użyj "Link products automatically" (automatyczne powiązanie produktów), jeśli Twoje referencje w PrestaShop już odpowiadają kodom magazynowym sprzedawcy w Hepsiburada. Kombinacje są w pełni obsługiwane — każda jest powiązywana i wyceniana osobno, ponieważ Hepsiburada traktuje każdy wariant jako odrębną ofertę.

Co naprawiła wersja 2.0

Wersja 1.x zawsze wyceniała na podstawie wholesale_price, które większość sklepów pozostawia puste, przez co każda wyeksportowana cena wynosiła 0,00. Wersja 2.0 domyślnie korzysta z ceny sprzedaży, w ogóle odmawia eksportu ceny zerowej i ostrzega, gdy jako źródło wybrano cenę zakupu w katalogu, który cen zakupu nie zawiera. Wersja 1.x zapisywała też SKU przy każdym actionProductUpdate, więc dowolna inna ścieżka zapisu — zmiana stanu magazynowego, usługa sieciowa, inny moduł — po cichu je czyściła; wersja 2.0 zapisuje tylko wtedy, gdy formularz produktu faktycznie przesłał te pola. Powiązania są teraz przechowywane osobno dla każdego sklepu, zamiast jednego SKU na produkt globalnie, a ponieważ 1.x przechowywała dane dostępowe do API, lecz nigdy nie wysyłała żadnego żądania, po aktualizacji API pozostaje wyłączone, dopóki świadomie go nie włączysz.

Zgodność

PrestaShop 1.7, 8 i 9, bez nadpisań (overrides), w ośmiu językach: angielskim, francuskim, hiszpańskim, holenderskim, niemieckim, polskim, tureckim i włoskim. Zgodność z multistore — powiązania są przechowywane osobno dla każdego sklepu, więc ten sam produkt może mieć różne SKU Hepsiburada w różnych sklepach, a strona konfiguracji zawsze pokazuje, którego sklepu dotyczy. Odinstalowanie usuwa tabele i ustawienia modułu; Twoje oferty na Hepsiburada zachowują ostatnio otrzymane wartości i po prostu przestają być aktualizowane.

Najczęściej zadawane pytania

Czy potrzebuję API, czy wystarczy plik?

Jedno albo drugie. Pobierz plik CSV i wgraj go w panelu sprzedawcy albo włącz API i pozwól cronowi dostarczać zmiany. Oba sposoby dają identyczne dane.

Czy zmieni tytuły lub zdjęcia moich produktów na Hepsiburada?

Nie. Należą one do ich zespołu katalogowego. Moduł wysyła wyłącznie cenę, stan magazynowy, czas wysyłki, etykiety przewoźnika i adresu, maksymalną ilość oraz ustawienia personalizacji.

Jak zapobiec sprzedaży towaru, którego nie mam?

Ustaw ilość zatrzymywaną. Każdy stan magazynowy jest o nią pomniejszany przed wysłaniem, więc marketplace nigdy nie widzi Twoich ostatnich sztuk.

Jakich danych dostępowych wymaga API?

Danych do Listing API Hepsiburady, które nie są loginem do panelu sprzedawcy — poproś o nie Hepsiburadę. Błąd 401 oznacza błędną nazwę użytkownika lub hasło, 403 oznacza brak uprawnień do Listing API, a 404 oznacza błędny identyfikator sprzedawcy. Przycisk "Test connection" (test połączenia) pokazuje dokładny komunikat z ich strony.

Czy obsługuje kombinacje?

Tak. Każda kombinacja jest powiązywana i wyceniana osobno, ponieważ Hepsiburada traktuje każdy wariant jako własną ofertę.

Dlaczego całe moje wgranie zostało odrzucone?

Niemal zawsze z powodu zduplikowanego SKU — Hepsiburada odrzuca całą paczkę, jeśli jedno pojawi się dwa razy. Panel statusu znajduje duplikaty przed wysyłką.

Wszystkie moje ceny z 1.x eksportowały się jako zero. Czy to poprawiono?

Tak. Wynikało to z tego, że 1.x wyceniała z pola ceny zakupu, które większość sklepów pozostawia puste. Wersja 2.0 domyślnie używa ceny sprzedaży i w ogóle odmawia eksportu ceny zerowej.