Elbuz sam wysyła do sklepu Horoshop ceny, dostępność i opisy produktów przez Horoshop API — bez plików i linków: aktualizuje istniejące karty i zakłada nowe.
Kiedy to się przyda:
- Ceny i dostępność prowadzisz w Elbuz — przebieg szablonu przenosi je do sklepu, opisów nie trzeba ruszać.
- Katalog przyszedł z tego sklepu — produkty trafiają do swoich kategorii według ID kategorii.
- Masz własne nazwy statusów dostępności — do sklepu idzie tekst, który ustawisz dla każdego statusu.
- Produkty mają modyfikacje — w sklepie łączą się w jedną kartę z produktem głównym.
Od czego zacząć: utwórz szablon „CMS Horoshop API” i wpisz dane dostępu do API sklepu.
Co potrafi eksport do Horoshop
- Bezpośrednia wymiana przez API — Elbuz sam zapisuje zmiany w kartach sklepu, nikomu nie trzeba przekazywać pliku.
- Własna lista pól — do sklepu idzie tylko to, co zaznaczysz: choćby sama cena i dostępność.
- Wyszukiwanie produktu po kodzie SKU — istniejąca karta się aktualizuje, brakująca zostaje założona.
- Kategoria jako ścieżka lub ID — produkt trafia do kategorii, która już jest w sklepie.
- Dostępność jako słowo — typowe statusy tłumaczą się same, własne ustawiasz tekstem.
- Przebieg próbny — pokazuje zapytanie do sklepu, niczego nie wysyłając.
Jak podłączyć sklep
Połączenie opiera się na adresie sklepu i parze login–hasło. Sklep musi być dostępny w chwili przebiegu: Elbuz łączy się z nim bezpośrednio.
| Pole w szablonie | Co wpisać |
|---|---|
| Link do API | adres API Twojego sklepu — domena sklepu z /api/ na końcu |
| Login | login użytkownika API utworzonego w panelu administracyjnym Horoshop |
| Hasło | jego hasło |
Użytkownika API zakłada się po stronie sklepu: panel administracyjny Horoshop → «Налаштування» → «Адміни» (Ustawienia → Administratorzy). Jeśli import katalogu z tego sklepu jest już skonfigurowany, użyj tych samych danych dostępu.
Horoshop wydaje tymczasowy klucz dostępu na około dziesięć minut. Elbuz pobiera go sam przed każdym pakietem produktów. Dlatego błąd autoryzacji w dzienniku prawie zawsze oznacza nieprecyzyjny adres, login lub hasło, a nie „przeterminowany klucz”.
Które produkty trafiają do sklepu
Ten szablon potrafi jedno: produkty. Nie tworzy ani nie zmienia nazw kategorii w sklepie — pole „Kategorie” nie ma tu na nic wpływu. Kategoria musi już istnieć w sklepie.
Z pozostałych pól wyboru karty na wymianę wpływa tylko „Atrybuty” — cechy produktu. Pól „Zdjęcia”, „Opcje”, „Sklepy”, „Magazyny”, „Zamówienia” sterownik Horoshop nie czyta: zdjęcia na przykład idą osobnym polem listy.
Do przebiegu trafiają produkty, które przeszły filtr szablonu: znacznik eksportu w karcie, aktywna kategoria z dozwolonym eksportem, sklep w polu „Sklep” i zakładka „Ograniczenie eksportu (filtr)”. Produkt bez takiej kategorii nie trafia nigdzie. Więcej — Gdzie ustawia się filtr produktów.
Pole „Eksportować tylko nowe dane” wybiera produkty bez znacznika „Wyeksportowano”. Szablon Horoshop stawia go wszystkim produktom każdego wysłanego pakietu, więc z zaznaczonym polem kolejny przebieg wyśle tylko to, czego jeszcze nie było w sklepie. Znacznik jest wspólny dla wszystkich szablonów eksportu.
Lista pól: co dokładnie trafia do sklepu
Zestaw pól układasz sam. Przycisk „Ustawienia eksportu pól” w karcie szablonu otwiera listę, w której każde pole ma pole wyboru „Aktualizować”. W nowym szablonie włączone są trzy pola: „Cena”, „Status dostępności” i „Kategoria”.
- Kod SKU idzie zawsze. To klucz, po którym sklep znajduje produkt, więc Elbuz włącza to pole sam.
- Pole językowe pociąga za sobą główne. Włączysz opis po ukraińsku — włącza się też samo pole opisu. Tak samo z nazwą, polami SEO i nazwą modyfikacji.
- Pusty wiersz nie przeszkadza. Wiersz bez pola i bez formuły jest pomijany.
Nazwy produktu, opisu i pól SEO występują parami — osobno po rosyjsku («Наименование RU», «Описание полное RU» — nazwa i pełny opis) i osobno po ukraińsku. Włączaj te języki, które naprawdę są w katalogu: pusta wersja ukraińska trafi do sklepu pusta.
Modyfikacji nie zakłada się osobno: Elbuz wstawia kod SKU produktu głównego w pole „ID produktu głównego”. W nowym szablonie to pole jest wyłączone — bez niego modyfikacje pojadą jako zwykłe produkty.
1
Pole „Aktualizować”2
Pole API: article3
Formuła źródła kodu SKU- Pole „Aktualizować” pokazuje, które pola trafiają do sklepu.
- Pole API article to klucz, po którym sklep znajduje produkt.
- Formuła bierze kod SKU z pola wewnętrznego kodu SKU produktu.
Stan produktu
Pole «Состояние товара» (stan produktu) przekazuje do sklepu stan z karty produktu: „Nowy” → New, „Przeceniony” i „Używany” → Used, „Odnowiony” → Refurbished. W szablonie jest wyłączone: zaznacz dla niego „Aktualizować”, jeśli sprzedajesz w sklepie towary przecenione lub używane. Skąd bierze się stan — Stan produktu.
Sprawdź źródło kodu SKU
Wiersz, który sklep nazywa article, to klucz: po nim sklep szuka produktu i decyduje, czy zaktualizować kartę, czy założyć drugą.
- W nowym szablonie wiersz nazywa się „ID produktu (ciąg UUID)”. Trafia tam kod SKU sklepu, gdy katalog zaimportowano z tego sklepu — nic nie trzeba zmieniać.
- W starszym szablonie wiersz może brać „Kod (SKU) producenta”, który w kartach ze sklepu częściej jest pusty. Wpisz w kolumnie „Formuła” tego wiersza
{Produkt BC: ID produktu (ciąg UUID)}.
Często bierze się {Produkt BC: Kod (SKU) wewnętrzny} — pokrywa się z kodem SKU sklepu, dopóki w sklepie nie wypełniono osobnego pola „kod SKU do wyświetlania”. Dla takich produktów wartości się rozejdą i pojadą jako nowe. Przebieg próbny pokaże, co trafiło do article: pusta lub cudza wartość da duplikat.
Kolumna „Formuła”
Zamiast gotowego pola możesz wstawić wyrażenie: pole produktu według nazwy kolumny, makra {Produkt BC: Nazwa pola} i funkcje w rodzaju REPLACE czy CONCAT_WS. Najczęściej formułę stosuje się do kategorii.
Formuła jest wstawiana do zapytania do katalogu. Jeśli się nie złoży, w dzienniku pojawi się „Błąd pobierania produktów!” — i żaden produkt nie pojedzie, dopóki jej nie poprawisz.
Cechy produktu
Pole „Atrybuty” dodaje do zapytania cechy produktu: kod atrybutu → wartość, osobno dla każdego języka. W słowniku atrybutów muszą być kody; pusty kod Elbuz uzupełni sam transliteracją nazwy. Sprawdź kody przed pierwszym przebiegiem: kod zmieniony później sklep uzna za nową cechę.
Jak produkt trafia do właściwej kategorii
Gdy katalog przyszedł ze sklepu przez import, razem z kategoriami produktów w Elbuz pojawiły się kategorie techniczne — „Strona główna”, „Katalog produktów”, „Kontakty”, „O nas”. Przez to ścieżka do kategorii produktu może wyglądać tak:
Strona główna / Katalog produktów / AGD / Pralki
A sklep oczekuje ścieżki od korzenia katalogu:
AGD / Pralki
W pierwszym wariancie sklep szuka kategorii „Strona główna” i jej nie znajduje: produkt nie zostaje założony albo trafia nie tam, gdzie trzeba. Uwagi sklepu do poszczególnych produktów widać w dzienniku (przebieg), a ścieżkę najprościej sprawdzić przebiegiem próbnym.
Co program robi sam
Elbuz w ogóle nie wysyła pola, gdy ścieżka w całości pokrywa się z kategorią techniczną: Главная / Каталог товаров, Каталог товаров, Главная lub Каталог. Poziomu technicznego na początku dłuższej ścieżki program nie usuwa — robi to formuła w wierszu „Kategoria”:
TRIM(REPLACE({Produkt BC: Kategoria}, "Mój sklep / Katalog produktów /", ""))
Wstaw własne nazwy poziomów — dokładnie tak, jak stoją w ścieżce, razem z separatorem.
1
Pole API: parent2
Formuła, która ucina zbędne poziomy kategorii- Pole API parent przenosi ścieżkę do kategorii sklepu.
- Formuła odcina zbędne górne poziomy ścieżki kategorii.
Pewniejszy sposób: przekazywać ID kategorii
API Horoshop przyjmuje zamiast ścieżki ID kategorii, a dokumentacja Horoshop zaleca ten sposób jako podstawowy. Na liście pól nazywa się on «Категория ID UUID» (ID kategorii); dla kategorii, które przyszły ze sklepu, jest tam ID kategorii w sklepie.
Wszystkie potrzebne kategorie przyszły ze sklepu — włącz pole z ID i wyłącz „Kategorię”. Masz kategorie założone w Elbuz ręcznie — zostaw ścieżkę z formułą.
Kategoria założona w Elbuz ręcznie nie ma ID w sklepie. Dla nowego produktu w takiej kategorii załóż kategorię w sklepie albo zostaw „Kategorię” ze ścieżką i wyłącz pole z ID. ID ma pierwszeństwo przed ścieżką, a z cudzym ID sklep będzie szukał kategorii, której nie ma.
Dostępność idzie jako słowo
Pole „Status dostępności” przekazuje do sklepu nie liczbę, lecz słowo. Typową nazwę statusu Elbuz zastępuje krótkim słowem, które rozumie sklep. Za typowe uznaje się:
- rosyjskie В наличии, Нет в наличии, Ожидание 2-3 дня, Предзаказ, Под заказ (dostępny, niedostępny, oczekiwanie 2–3 dni, przedsprzedaż, na zamówienie);
- ukraińskie В наявності, Немає в наявності, Немає на складі, Під замовлення, Під замовлення 2-3 дні, Очікування 2-3 дні (dostępny, niedostępny, brak w magazynie, na zamówienie, na zamówienie 2–3 dni, oczekiwanie 2–3 dni).
Dla własnych nazw ustaw tekst w oknie „Ustawienia aktualizacji według dostępności produktu” — trafi do sklepu zamiast typowego słowa. Ustawienia działają dla danego szablonu i są czytane tylko z wierszy z włączoną „Aktywnością ustawienia”; kolumny „Ilość” i „Aktywność produktu na stronie” na ten eksport nie wpływają.
Tekstu nie ustawiono, a nazwa nie jest typowa — do sklepu pójdzie nazwa statusu z Elbuz bez zmian. Ilości stanu to pole nie przekazuje.
- Початок або кінець
- Розвилка: далі шлях залежить від відповіді
Dostępność w Horoshop się nie aktualizuje: co sprawdzić
Dostępność idzie w jedną stronę — z Elbuz do sklepu — i tylko przebiegiem szablonu. Sprawdzaj po kolei:
- Czy jest szablon eksportu. W „Eksporcie danych” musi być szablon typu „CMS Horoshop API”. Szablon importu z Horoshop nie wysyła dostępności do sklepu.
- Czy był przebieg. Sklep niczego nie pobiera sam: sprawdź datę ostatniego przebiegu i jego wynik.
- Czy pole jest włączone. W wierszu „Status dostępności” listy pól musi być zaznaczone „Aktualizować”.
- Czy status zmienił się w Elbuz. Do sklepu idzie status, a nie ilość: ilość zero przy statusie „Dostępny” da „dostępny”.
- Czy produkt przeszedł filtr. Produkty, które nie przeszły filtra, odpadają bez komunikatu.
- Czy nie odsiało ich pole „Eksportować tylko nowe dane”. Odznacz je i uruchom przebieg.
- Czy sklep rozpoznał produkt. Różny kod SKU w Elbuz i w sklepie — zaktualizuje się inna karta (źródło kodu SKU).
- Czy sklep nie odrzucił wartości. Wiersz „Horoshop przyjął pakiet z uwagami” — na przykład własna nazwa statusu, której sklep nie zna: ustaw dla niej tekst.
Jak sprawdzić i uruchomić eksport
Przycisk z kolbą w nagłówku szablonu otwiera okno „Sprawdzenie szablonu eksportu”. Wykonuje ono przebieg dla jednego produktu i pokazuje dane katalogu oraz zapytanie do serwisu — to samo, które poszłoby do Horoshop. Nic nie jest wysyłane: sprawdzenie zatrzymuje się przed połączeniem ze sklepem. Możesz podać produktu; bez niego zostanie wzięty pierwszy, który przechodzi filtr.
Zwróć uwagę na trzy rzeczy: czy poprawnie złożyła się ścieżka do kategorii, czy nie ma pustych pól, które powinny być wypełnione, i czy wybrano właściwy produkt.
1
Adres zapytania2
Wartości wysyłane do produktu- Adres zapytania — dokładnie tam zostałyby wysłane dane.
- Wartości — kod SKU, cena i dostępność, które trafiłyby do produktu.
Uruchamianie ręczne i według harmonogramu — jak we wszystkich szablonach: Uruchamianie ręczne i według harmonogramu.
Przebieg: pakiety, dziennik, błędy
Produkty trafiają do sklepu pakietami po tysiąc; po każdym w dzienniku pojawia się wiersz „Wyeksportowane wiersze 1000 z …”. Produkt z pustym kodem SKU nie jest wysyłany — na końcu dziennik podaje, ile takich pominięto.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
- Sklep odpowiedział błędem — eksport zatrzymuje się na tym pakiecie i zapisuje odpowiedź sklepu w dzienniku.
- Sklep przyjął pakiet z uwagami — przebieg idzie dalej, w dzienniku pomarańczowy wiersz „Horoshop przyjął pakiet z uwagami, produktów: N.” i do dwudziestu kodów SKU z tekstem sklepu.
Pakiety wysłane przed błędem są w sklepie już zastosowane. Elbuz nie pamięta, co było w sklepie przed przebiegiem. Dlatego listę pól i przebieg próbny sprawdź przed pierwszym prawdziwym uruchomieniem. Zepsute dane naprawia się ruchem w drugą stronę: popraw wartości w Elbuz, zostaw na liście pól tylko zepsute i wyeksportuj jeszcze raz.
Ponowny eksport
Każdy przebieg szuka produktu w sklepie po kodzie SKU. Znalazł — karta jest aktualizowana zaznaczonymi polami; nie znalazł — sklep zakłada nową i do tego w zestawie pól muszą być nazwa i kategoria. Dlatego ponowne uruchomienie po przerwaniu jest bezpieczne: zamiast duplikatów będzie aktualizacja.
Zmieniony kod SKU to dla sklepu inny produkt: założy nową kartę, a stara zostanie ze starymi cenami. Pilnuj, by kody SKU były unikalne i niezmienne — i w Elbuz, i w sklepie.
Produkt, który przestał przechodzić filtr, zostaje w sklepie taki, jaki był: polecenia „usuń produkt” ta wymiana nie ma.
Scenariusze
Aktualizować w sklepie tylko ceny i dostępność
Zadanie: nazwy, opisy i kategorie w sklepie są prowadzone ręcznie, a z Elbuz mają iść tylko cena i dostępność.
Co włączyć: w karcie szablonu — pole „Produkty”; w oknie „Ustawienia eksportu pól” pole „Aktualizować” tylko w wierszach „Cena” i „Status dostępności”. Wiersz „Kategoria” w nowym szablonie jest włączony — odznacz go również.
Efekt: sklep dostanie kod SKU, cenę i słowo dostępności; kod SKU Elbuz dodaje sam. Nowych kart tak nie założysz: potrzebują nazwy i kategorii. Bez pola „Produkty” przebieg nie wyśle niczego.
Własne nazwy statusów dostępności
Zadanie: statusy dostępności w Elbuz mają własne nazwy, a sklep ma pokazywać swoje słowa.
Co włączyć: pole „Aktualizować” w wierszu „Status dostępności”; w oknie „Ustawienia aktualizacji według dostępności produktu” dla każdego statusu — tekst w kolumnie „Nazwa na stronie (w pliku)” i znacznik „Aktywność ustawienia”.
Efekt: do sklepu pójdzie wpisany tekst, nawet jeśli nazwa statusu jest typowa. Status bez tekstu i bez typowej nazwy pójdzie nazwą z Elbuz bez zmian.
Modyfikacje mają złożyć się w jedną kartę
Zadanie: modyfikacje produktów mają stać się w sklepie wariantami produktu głównego, a nie osobnymi kartami.
Co włączyć: pole „Aktualizować” w wierszu „ID produktu głównego”. Produkt główny też musi przechodzić filtr szablonu.
Efekt: modyfikacja dostanie w tym polu kod SKU produktu głównego. Jeśli produkt główny nie trafia do eksportu, pole nie jest wysyłane i modyfikacja pojedzie jako zwykły produkt. Samemu produktowi głównemu to pole nie jest wysyłane.
Katalog przyszedł ze sklepu — kategorie według ID
Zadanie: katalog zaimportowano z tego samego sklepu, a produkty mają trafiać do swoich kategorii bez poprawiania ścieżki formułą.
Co włączyć: pole „Aktualizować” w wierszu «Категория ID UUID» i odznaczyć je w wierszu „Kategoria”.
Efekt: sklep dostanie ID kategorii, które przyszło razem z kategorią. Poziomy techniczne „Strona główna / Katalog produktów” na nic nie wpływają. Kategoria założona w Elbuz ręcznie takiego ID w sklepie nie ma.
Co zrobić, gdy sklep się nie zaktualizował
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Błąd autoryzacji w dzienniku | Nieprecyzyjny adres API (brak /api/ na końcu), błędny login albo dostęp do API wyłączony po stronie sklepu |
Sprawdzaj w tej kolejności: adres → login i hasło → ustawienia dostępu w Horoshop (połączenie) |
| Produkty nie są zakładane albo trafiają do złej kategorii | W ścieżce kategorii zostały poziomy techniczne sklepu — „Strona główna / Katalog produktów / …” | Sprawdź ścieżkę przebiegiem próbnym; usuń zbędne poziomy formułą albo przekazuj ID kategorii (kategoria) |
| „Horoshop: pominięto produktów bez kodu SKU: N” | Te produkty mają pustą kolumnę, z której brany jest kod SKU — bez niego sklep nie znajdzie produktu | Wskaż w wierszu kodu SKU inne źródło formułą albo uzupełnij kod SKU w kartach (źródło kodu SKU) |
| „Horoshop przyjął pakiet z uwagami, produktów: N.” | Sklep przyjął pakiet, ale ma uwagi do wymienionych kodów SKU — tekst stoi obok kodu | Popraw w tych produktach to, na co wskazuje sklep, i uruchom eksport ponownie (przebieg) |
| Produkty się nie zaktualizowały, w dzienniku nie ma błędów | Produkt nie przeszedł filtra: znacznik eksportu, kategoria, filtr szablonu | Sprawdź znaczniki w karcie produktu i filtr szablonu (które produkty trafiają) |
| W sklepie pojawił się drugi produkt o tej samej nazwie | Sklep nie rozpoznał produktu: do article trafiła cudza wartość albo kod SKU w Elbuz zmieniono |
Przebiegiem próbnym sprawdź, co trafia do article, zmień źródło pola; zbędną kartę w sklepie usuń ręcznie |
| „Błąd pobierania produktów!” | Nie złożyła się formuła na liście pól — zapytanie do katalogu się nie wykonało | Popraw formułę i uruchom ponownie; sklep niczego przy tym nie dostał (kolumna „Formuła”) |
| Cechy produktu nie pojawiły się w sklepie | Pole „Atrybuty” jest odznaczone albo atrybuty mają puste kody | Zaznacz pole i sprawdź kody w słowniku atrybutów (cechy produktu) |
| Modyfikacja nie powiązała się z produktem głównym | Pole „ID produktu głównego” jest wyłączone — w nowym szablonie nie ma zaznaczenia | Zaznacz dla niego „Aktualizować” i wyeksportuj ponownie (modyfikacje) |
Najczęstsze pytania
Czy trzeba coś przekazać do Horoshop — plik albo link?
Nie. Wymiana idzie bezpośrednio przez API sklepu: Elbuz sam łączy się z nim w chwili przebiegu.
Czy Elbuz utworzy kategorie w sklepie?
Nie. Szablon tworzy i aktualizuje tylko produkty, a kategoria musi już istnieć w sklepie. Produktu, którego kategorii w sklepie nie ma, sklep nie przyjmie.
Czy można wycofać błędny eksport?
Nie. Elbuz nie zapisuje, co było w sklepie przed przebiegiem. Popraw wartości u siebie, zostaw na liście pól te, które się zepsuły, i wyeksportuj jeszcze raz.
Czy Elbuz założy produkt, którego nie ma w sklepie?
Tak, kartę tworzy sklep według kodu SKU. Do tego na liście pól muszą być włączone nazwa i kategoria.
Skąd Elbuz bierze kod SKU, po którym sklep szuka produktu?
Z kolumny w wierszu pola article. W nowym szablonie to „ID produktu (ciąg UUID)”; w starszym źródło zmienia się formułą (źródło kodu SKU).
Czy cechy produktu trafiają do sklepu?
Tak, jeśli zaznaczone jest pole „Atrybuty”. Wartości są przekazywane według kodów atrybutów, osobno dla każdego języka.
W ścieżce kategorii stoi „Strona główna / Katalog produktów”. Co z tym zrobić?
To kategorie sklepu, które przyszły podczas importu katalogu. Zbędny poziom usuwa formuła w polu „Kategoria” albo zastąpienie ścieżki ID kategorii (kategoria).
Co zrobić, jeśli przebieg przerwał się na błędzie?
Sprawdź w dzienniku odpowiedź sklepu. Pakiety wysłane przed przerwaniem są już zastosowane — usuń przyczynę i uruchom ponownie: kolejny przebieg zaktualizuje te same produkty, a nie założy duplikatów.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Eksport danych
- Utwórz
- dodaj szablon → typ Horoshop
- Skonfiguruj
- karta szablonu: „Połączenie”, pola wyboru, przycisk „Ustawienia eksportu pól”
- Uprawnienia
- okno „Eksport danych”; dla karty — „Szczegółowa konfiguracja szablonu eksportu”
- Przygotuj
- użytkownika API w panelu administracyjnym Horoshop
Szablon eksportu i szablon importu to dwa różne rekordy z różnymi adresami API, nawet dla jednego sklepu. Tworzenie szablonu, harmonogram, historia uruchomień i dziennik są wspólne dla wszystkich typów — Szablony eksportu.
1
Link do API2
Login do API3
Plakietka statusu- Link do API — adres API sklepu Horoshop, do którego wysyłane są dane.
- Login — użytkownik API, jako który łączy się eksport.
- Plakietka statusu — pokazuje, że szablon jest aktywny.
Powiązane tematy
- Jeśli katalog lub zamówienia trzeba pobrać ze sklepu do Elbuz — Import katalogu i zamówień z Horoshop.
- Jeśli trzeba skonfigurować harmonogram, filtr albo odczytać dziennik — Szablony eksportu.
- Jeśli formuła na liście pól się nie składa — Formuły pól.
