Elbuz pobiera z Twojej strony na Horoshop działy, produkty z cenami, stanami i opisami w obu językach oraz zamówienia klientów — przez Horoshop API, bez plików. Strona zostaje witryną, a cenniki, narzuty, magazyn i marketplace’y prowadzisz w Elbuz.
Kiedy to się przyda:
- Katalog prowadzisz na stronie — Elbuz trzyma jego kopię z drzewem działów, polami SEO i zdjęciami.
- Zamówienia ze strony trzeba obsługiwać razem z innymi — trafiają jako dokumenty z klientem i pozycjami.
- Ceny liczysz w Elbuz — formuła pola przelicza je na wierzchu cen przywiezionych ze strony.
Od czego zacząć: utwórz użytkownika API w panelu administracyjnym Horoshop i wpisz go w szablon „API - CMS Horoshop”.
Co potrafi połączenie z Horoshop
- Działy — drzewo kategorii strony z nazwami w dwóch językach.
- Produkty — ceny, stany, opisy, pola SEO, zdjęcia, modyfikacje według kodu produktu nadrzędnego.
- Aktualizacja — ponowny przebieg znajduje produkt po kodzie produktu i aktualizuje go bez duplikatów.
- Zamówienia — z klientem, dostawą, płatnością i pozycjami.
Kierunek odwrotny — aktualizację kart na stronie z Elbuz — wykonuje osobny szablon eksportu: eksport katalogu na Horoshop.
Czego potrzeba od Horoshop
| Pole w szablonie | Co wpisać |
|---|---|
| Link () | Adres API Twojej strony — domena sklepu z /api/ na końcu |
| Login | Login użytkownika API utworzonego w panelu administracyjnym Horoshop |
| Hasło | Jego hasło |
Login i hasło tworzy się w panelu administracyjnym Horoshop: «Налаштування» → «Адміни» (Ustawienia → Administratorzy). Załóż osobnego użytkownika do integracji, a nie używaj swojego konta administratora — taki dostęp łatwiej odwołać i wydać ponownie.
Horoshop zwraca nazwy i opisy w językach włączonych na stronie. Żeby przyszła wersja ukraińska, język ukraiński musi być w słowniku języków Twojego konta Elbuz. Sprawdź to przed pierwszym importem.
Horoshop wydaje tymczasowy klucz dostępu na około dziesięć minut, a Elbuz pobiera go sam przed każdą operacją. Dlatego błąd autoryzacji prawie zawsze oznacza błędny adres, login lub hasło, a nie „przeterminowany token”.
Opis integracji po stronie platformy: API Horoshop — jak włączyć dostęp i jakie funkcje obsługuje Twoja wersja.
Jak połączyć krok po kroku
- Utwórz szablon typu „API - CMS Horoshop”, wpisz adres API, login i hasło.
- Formularz zapisuje się sam, przycisku zapisu nie ma — uruchom import ręcznie.
- Sprawdź, czy drzewo działów zbudowało się jak na stronie, i porównaj kilka produktów: cenę, stan, opisy w obu językach.
W karcie „Co importować” działa jedno pole wyboru — „Zamówienia”. Działy, produkty i zdjęcia połączenie pobiera zawsze. „Importuj zdjęcia”, „Importuj atrybuty”, „Uzupełniaj słownik producentów” i „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku” nie wpływają na przebieg: producentów dodaje on sam, atrybutów nie importuje, niczego nie usuwa.
Co trafia do karty produktu
Najpierw działy, potem produkty
Najpierw Elbuz pobiera działy strony z zagnieżdżeniem i nazwami po rosyjsku i ukraińsku i buduje z nich drzewo kategorii. Istniejące działy są aktualizowane, nowe dodawane, hierarchia strony zostaje zachowana. Dopiero potem importują się produkty — stronami po 500, aż się skończą.
Pola produktu
| Dane Horoshop | Pole produktu w Elbuz |
|---|---|
| kod produktu | Kod produktu — główny klucz dopasowania |
| kod produktu nadrzędnego | Powiązanie modyfikacji w rodzinę wariantów |
| dział katalogu | Kategoria |
| nazwa, nazwa modyfikacji | Nazwa (po rosyjsku i ukraińsku) |
| nazwa dla Rozetki | Osobne pole nazwy dla marketplace’u |
| marka | Producent |
| kod producenta (), | MPN i kod kreskowy |
| cena i stara cena, waluta | Cena, stara cena |
| dostępność, ilość | Status dostępności i stan |
| krótki opis i opis | Krótki opis, opis (w dwóch językach) |
| tytuł SEO, słowa kluczowe, opis, | Pola SEO (w dwóch językach) |
| przyjazny adres URL i link do produktu | Adres produktu na stronie |
| zdjęcia | Zdjęcia (jako linki do zdjęć ze strony) |
Po kodzie produktu produkt jest rozpoznawany przy ponownych importach i po nim modyfikacje łączą się z produktem głównym. Kody produktów na stronie muszą być unikalne i niezmienne: zmieniony kod to dla Elbuz nowy produkt, a stara karta zostaje.
Cechy produktów z Horoshop nie są importowane: API zwraca wartości, ale nie czytelne nazwy cech, więc nie da się z tego zbudować tabeli atrybutów. Potrzebujesz cech — uzupełnij je w Elbuz albo pobierz z cennika dostawcy lub feedu producenta.
Co ponowny import robi z Twoimi zmianami
Kolejne uruchomienie szuka produktu po kodzie produktu: jeśli znajdzie — aktualizuje, jeśli nie — tworzy. To, co przyszło ze strony, jest nadpisywane, reszta zostaje Twoja.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
| Pole karty w Elbuz | Co robi z nim kolejny przebieg |
|---|---|
| Cena, stara cena | Nadpisuje wartością ze strony; w karcie z flagą „Stała cena” nie zmienia |
| Ilość | Nadpisuje ilością ze strony |
| Status dostępności | Nadpisuje: nazwę dostępności ze strony Elbuz szuka w swoim słowniku statusów i na listach słów kluczowych; jeśli nie rozpozna — ustawia status oznaczony w słowniku jako „Dostępny” |
| Aktywność karty | Ustawia zgodnie z widocznością produktu na stronie: ukryty na stronie produkt — karta w Elbuz staje się nieaktywna |
| Nazwa, w obu językach | Nadpisuje nazwą ze strony, a dla modyfikacji — nazwą modyfikacji |
| Krótki opis i opis | Nadpisuje |
| Tytuł SEO, słowa kluczowe, opis SEO, H1 | Nie zmienia. Te pola wypełniają się tylko przy tworzeniu karty — dalej są Twoje |
| Dział produktu | Nadpisuje działem strony; lista kategorii produktu przed zapisem jest czyszczona i budowana od nowa. Jeśli działu strony nie ma w drzewie, dział i lista kategorii zostają bez zmian |
| Producent, MPN, kod kreskowy, adres na stronie | Nadpisuje, jeśli na stronie pole jest wypełnione; pusta wartość ze strony nie kasuje Twojej |
| Zdjęcia | Dodaje linki, których w karcie jeszcze nie było; istniejących zdjęć nie usuwa. Do karty z flagą „Nie aktualizuj zdjęć” nowych linków nie dodaje |
- „Nie aktualizuj” w karcie — przebieg w ogóle jej nie zmienia: ani ceny, ani ilości, ani tekstów, ani działu, ani zdjęć.
- „Stała cena” — cena i stara cena zostają Twoje, reszta się aktualizuje.
- Formuła pola z flagą „Stosuj przy imporcie katalogu bazowego ze źródeł zewnętrznych” w oknie „Formuły pól” liczy się na końcu każdego importu, w kroku „Aktualizacja wartości na podstawie formuł” — na wierzchu przywiezionych danych.
Czyja wartość zostanie, gdy do pola piszą dwa źródła
Priorytetu źródeł nie ma: import z Horoshop, aktualizacja katalogu z cennika i ręczna zmiana piszą do jednego pola, a zostaje wartość tego, kto zadziałał ostatni (co nadpisze ponowny przebieg). Jeśli ceny liczysz z cennika, a katalog co noc przychodzi ze strony, w karcie będzie cena strony — dopóki eksport nie odda stronie Twojej albo karta nie zostanie zabezpieczona.
Eksport wysyła na stronę tylko pola oznaczone „Aktualizować” (eksport na Horoshop). Reszta zostaje po stronie strony, a kolejny import przywiezie ją z powrotem.
Własne drzewo działów i usuwanie działów
Każdy import przywraca działom nazwy i miejsce w drzewie ze strony. Zmieniasz nazwę działu lub go przenosisz w Elbuz — przebieg przywróci stan ze strony. Tak samo z produktami: karta przeniesiona do Twojej kategorii wróci do działu strony. Żeby produkt leżał w Twoim dziale, taki dział musi być też na stronie.
Razem z działem usuwane są wszystkie produkty, dla których jest on główny, z opisami, zdjęciami, atrybutami i przyjaznymi adresami URL. Najpierw opróżnij dział, potem go usuń. Wiersze zaimportowanych zamówień zostają z własną nazwą, kodem produktu, ceną i ilością — znika tylko przejście do karty.
Jak pobierać zamówienia ze strony
Zaznacz pole „Zamówienia” w karcie „Co importować”. Katalog importuje się jak dotąd, zamówienia dochodzą osobnym krokiem na końcu.
1
Pole wyboru Zamówienia- Zamówienia — włącza import zamówień ze strony.
| Dane Horoshop | Pole dokumentu w Elbuz |
|---|---|
| numer zamówienia | Numer dokumentu (po nim zamówienie jest rozpoznawane ponownie) |
| data złożenia | Data zamówienia |
| imię odbiorcy | Imię i nazwisko (wiersz dzielony na dwie części) |
| e-mail i telefon | E-mail, telefon |
| identyfikator klienta na stronie | Powiązanie kontrahenta ze źródłem |
| miasto i adres dostawy | Adres dostawy |
| sposób dostawy, koszt dostawy | Rodzaj dostawy, cena dostawy |
| sposób płatności | Sposób płatności |
| znacznik płatności | Status płatności „Opłacono” |
| status zamówienia | Status dokumentu (przez dopasowanie) |
| komentarz klienta | Opis zamówienia |
| kwota i waluta | Kwota dokumentu, waluta |
| pozycje: kod produktu, nazwa, cena, ilość, kwota | Wiersze dokumentu |
- Statusy, sposoby płatności i usługi dostawy Horoshop zwraca własnymi kodami. Dopasuj je przyciskami w karcie „Powiązane ustawienia” — osobne tabele dla statusów zamówienia, dostawy, płatności i sposobów płatności. Niedopasowany status przychodzi jako „Nowy”, status płatności — „Oczekiwanie”; opłacone zamówienie od razu dostaje „Opłacono”.
- Klient jest szukany po e-mailu, telefonie i identyfikatorze na stronie; jeśli się nie znajdzie — zakładany jest nowy kontrahent. Zamówienie bez e-maila i telefonu trafia na „Odbiorcę końcowego”.
- Pozycje znajdują karty po kodzie produktu, a także po zapamiętanym powiązaniu karty ze stroną — bez przeszukiwania po nazwie.
- Już zaimportowane zamówienie nie jest nadpisywane: duplikatu nie ma, ale zmiany ze strony też do niego nie docierają.
- Okno wyboru — filtra po dacie w API Horoshop nie ma, więc pierwsze uruchomienie pobiera całą historię, a kolejne — od poprzedniego importu z zapasem dwunastu godzin.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Co zaimportowane zamówienie robi ze stanem
Nic. Zamówienie trafia jako niezatwierdzony dokument „Zamówienie klienta”: ilość się nie zmienia, rezerwacja nie jest zakładana, rozchodu nie ma, dopóki menedżer nie zatwierdzi dokumentu.
- Rezerwacja liczy się tylko dla zatwierdzonych zamówień i przy włączonej ewidencji magazynowej.
- Rezerwację zdejmuje status końcowy — „Zrealizowano”, „Zakończono”, „Wydano”, „Anulowano”, „Odrzucono”, „Zwrócono” i podobne.
- Fizycznie towar zdejmuje z magazynu dokument WZ (wydanie zewnętrzne).
- Import zmienia w karcie tylko „Liczbę sprzedaży” — przelicza się ona ze wszystkich zamówień klientów.
Aktualizacja według harmonogramu
Sprawdzony szablon ustawia się w harmonogramie — jak działa harmonogram źródeł API. Duży katalog importuje się zauważalnie dłużej niż marketplace: każda strona z 500 produktów niesie opisy i pola SEO.
Rozmiary przebiegu
- Produkty i zamówienia są pobierane stronami po 500, dopóki strona sklepu zwraca niepustą stronę. Limitu nie ma.
- Na odpowiedź strony Elbuz czeka do pięciu minut, na połączenie — do minuty. Jeśli się nie doczeka — pobieranie przerywa się z błędem, a przebieg idzie dalej z tym, co zdążyło przyjść.
- Eksport na stronę idzie paczkami po 1000 produktów.
- Okno można zamknąć: przebieg i dziennik działają w Centrum operacji, tam też jest przycisk „Stop”.
- Według harmonogramu naraz działa jeden import; zajęty cron anuluje przebieg wierszem „Anulowano import według harmonogramu, przyczyna - trwa import innego szablonu (konflikt przetwarzania danych).”
Co się stanie po wyłączeniu szablonu
Przełącznik „Aktywny” / „Wyłączony” w nagłówku szablonu decyduje tylko o tym, czy szablon weźmie harmonogram i przycisk „Importuj wszystkie szablony”. Adres, login, dopasowania, ustawienia eksportu i zaimportowane dane zostają. Przycisk „Importuj” w formularzu działa też w wyłączonym szablonie.
1
Plakietka Aktywny2
Przycisk historii uruchomień- Plakietka Aktywny — włącza i wyłącza szablon w harmonogramie.
- Przycisk historii uruchomień — otwiera historię przebiegów.
Usunięcie szablonu też nie kasuje danych: znikają sam szablon i jego harmonogram, a produkty, działy, kontrahenci i zamówienia zostają z oznaczeniem źródła.
Jak sprawdzić, że przebieg się udał
Dziennik działa w Centrum operacji. Wiersze nazywają bieżący krok:
- „Pobieranie listy kategorii” → „Dodawanie kategorii produktów” → „Aktualizacja kategorii produktów” → „Aktualizacja kluczy kategorii”;
- „Pobieranie listy produktów” → „Pobieranie produktów, pozycje: 1 - 500” → „Ustalanie producentów produktów” → „Ustalanie dostępności produktów”;
- „Dodawanie produktów” → „Aktualizacja produktów” → „Importowanie zdjęć produktów”;
- „Aktualizacja wartości na podstawie formuł” → „Sprawdzanie integralności danych” → „Indeksowanie produktów”;
- „Import danych zakończony!” i „Czas trwania”.
Liczb „utworzono, zaktualizowano, pominięto” dla katalogu dziennik nie podaje: „Łącznie zaimportowano: 500” to górny limit strony. Liczby są tylko dla zamówień: „Pobrano zamówień: N” i „Łącznie zaimportowano zamówień: M” — ile utworzono dokumentów.
Wynik dla katalogu sprawdza się w danych:
- kolumna „Ostatni import” na liście szablonów — kiedy był przebieg i ile trwał;
- przycisk „Historia uruchomień” w nagłówku szablonu — poprzednie przebiegi z ich statusami;
- kolumny „Źródło: nazwa” i „Data aktualizacji” w tabeli produktów — których kart dotknął przebieg.
Scenariusze
Katalog prowadzisz na stronie, w Elbuz potrzebna jest jego kopia
Co włączyć. Szablon „API - CMS Horoshop” z adresem API, loginem i hasłem, bez pola „Zamówienia”, oraz harmonogram.
Efekt. Każdy przebieg aktualizuje drzewo działów, potem produkty: nowe karty — z polami SEO i zdjęciami, istniejące — z ceną, ilością, dostępnością, nazwą i opisami ze strony, poza kartami z „Nie aktualizuj”. Cechy nie przyjdą, produkty znikające ze strony nie zostaną usunięte z Elbuz, produkt bez działu w drzewie nie dostanie karty.
Pobierać zamówienia ze strony do Elbuz
Co włączyć. Pole „Zamówienia” i dopasowanie statusów zamówienia oraz sposobów płatności w karcie „Powiązane ustawienia”.
Efekt. Po katalogu przebieg pobiera zamówienia: pierwszy — całą historię, dalej — z zapasem dwunastu godzin. Nowe zamówienie staje się dokumentem „Zamówienie klienta” na znalezionego lub nowego kontrahenta. Już zaimportowane się nie zaktualizuje; niedopasowany status przyjdzie jako „Nowy”.
Ceny liczysz w Elbuz, a katalog co noc przychodzi ze strony
Co włączyć. W oknie „Formuły pól” — formułę ceny z flagą „Stosuj przy imporcie katalogu bazowego ze źródeł zewnętrznych”.
Efekt. Przebieg zapisze cenę strony, a w kroku „Aktualizacja wartości na podstawie formuł” formuła ją przeliczy. Żeby cena wybranej karty się nie zmieniała — flaga „Stała cena”.
Import uruchomiony w złym momencie — zatrzymać
Co kliknąć. „Stop” w Centrum operacji.
Efekt. Do końca pobierania stron produkty zostaną bez zmian; działy, które już przyszły, nie wrócą do poprzedniego stanu (przerwanie przebiegu).
Co zrobić, gdy import poszedł nie tak
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Błąd autoryzacji w API. Sprawdź adres strony, login i hasło.” | Brak /api/ na końcu adresu, błędny login albo wyłączony dostęp do API na stronie |
Sprawdź właśnie w tej kolejności (czego potrzeba). Wiersz „Import danych zakończony!” na końcu dziennika nie oznacza sukcesu |
| Nie pojawiły się nowe produkty | Działy nie przyszły: produkt bez działu w drzewie jest pomijany bez komunikatu | Uruchom ponownie; jeśli się powtórzy — sprawdź w dzienniku odpowiedź strony na zapytanie o działy |
| Duplikaty kart | Na stronie zmieniono kody produktów | Usuń stare karty ręcznie (kod produktu to klucz) |
| „Błąd pobierania katalogu produktów” | Zerwało się połączenie ze stroną | Uruchom jeszcze raz (przerwanie przebiegu) |
Jeśli przebieg przerwał się w połowie
Najpierw działy — zapisują się od razu. Potem produkty: strony składają się w pliku tymczasowym i trafiają do katalogu jednym krokiem po ostatniej. Na końcu — zamówienia. Ogólne zasady — w przeglądzie.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
- „Stop” podczas pobierania stron — produkty się nie zmienią: zatrzymanie jest sprawdzane przed każdą stroną i przed zapisem. W dzienniku „Operacja przerwana przez użytkownika!”, operacja jest żółta, formuły, sprawdzanie integralności i indeksowanie się nie wykonują, „Ostatni import” się nie aktualizuje. Działy zostają zaktualizowane.
- Zerwanie połączenia ze stroną — przyjęte strony i tak trafiają do katalogu; w dzienniku „Błąd pobierania katalogu produktów” i odpowiedź strony.
- Przebieg sam się zakończył (przekroczony czas, restart serwera) — z produktów nie zapisuje się nic.
Powtórka jest bezpieczna: plik tymczasowy zaczyna się od zera, produkty są dopasowywane po kodzie produktu, zamówienia nie tworzą się drugi raz.
Jeśli zaimportowano nie to
Kopii „jak było” import nie robi (ogólne zasady wycofywania).
- Znaleźć zmienione — filtr w tabeli produktów po „Źródło: nazwa” i „Data aktualizacji”.
- Cofnąć zbiorczo można tylko własne zmiany zbiorcze: zbiorcza zmiana pola i wyszukiwanie z zamianą dają przycisk „Cofnij” dla ostatnich pięciu operacji nie starszych niż doba. Na import to nie działa.
Najczęstsze pytania
Co wpisać w pole linku?
Adres API strony: domenę sklepu z /api/ na końcu. Login i hasło — użytkownika z «Налаштування» → «Адміни» (Ustawienia → Administratorzy) w panelu administracyjnym Horoshop.
Dlaczego nie zaimportowały się cechy produktów?
API Horoshop zwraca wartości cech bez czytelnych nazw, więc nie da się zbudować tabeli atrybutów. Pozostałe pola przychodzą w całości.
Co się stanie, jeśli zmienię kod produktu na stronie?
Produkt przyjdzie jako nowy, a stara karta zostanie bez pary: kod produktu to główny klucz dopasowania i powiązania modyfikacji.
Produkt zniknął ze strony — czy zostanie usunięty także w Elbuz?
Nie, import z Horoshop niczego nie usuwa. Produkty ukryte na stronie stają się w Elbuz nieaktywne, a całkiem usunięte zostają bez zmian.
Czy można nie importować zdjęć?
Nie, pole „Importuj zdjęcia” na Horoshop nie wpływa. Nowych zdjęć do wybranej karty nie dodasz, ustawiając w niej flagę „Nie aktualizuj zdjęć”.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych → szablon typu „API - CMS Horoshop”
- Uprawnienia
- okno „Import” w „Uprawnieniach grup”
- Przygotuj
- adres strony, login i hasło użytkownika API
1
Pole adresu API2
Pole Login3
Pole Hasło- Adres API — adres Horoshop API sklepu.
- Login — login użytkownika API.
- Hasło — hasło użytkownika API.
Powiązane tematy
- Jeśli ceny i dostępność z Elbuz trzeba oddać z powrotem na stronę — eksport katalogu na Horoshop.
- Jeśli ponowny przebieg nadpisuje Twoje zmiany — przegląd importu danych.
- Jeśli zamówienie przypisało się do niewłaściwego klienta — import zamówień przez API.
