↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak podłączyć dostawcę przez API

    5 min czytaniaZaktualizowano

    Elbuz pobiera produkty, ceny i dostępność bezpośrednio z serwisu dostawcy — bez pliku, który ktoś musi wystawić lub wysłać. Dla dwudziestu dostawców integrację napisaliśmy sami, od Ciebie — login i hasło.

    Kiedy to się przyda:

    • Dostawca jest na liście gotowych integracji — kolumny są zmapowane z góry, nie ma kroku mapowania kolumn.
    • Dostawca prosi o IP do białej listy — adres serwera Elbuz jest podany w oknie parametrów dostępu.
    • Potrzebujesz tylko swojego magazynu lub punktu odbioru — ID wstawia się do parametrów zapytania.
    • Potrzebujesz parametrów produktów i zdjęć — część integracji oddaje je razem z cennikiem.

    Od czego zacząć: kreator nowego źródła → krok „Skąd” → kafelek „API” → Twój dostawca.

    Co potrafi podłączenie przez API

    • Dwadzieścia gotowych integracji — dostawcy z Ukrainy, Mołdawii, Kazachstanu, Słowacji i międzynarodowi.
    • Mapowanie z góry — adres serwera, format i kolumny wstawiają się same.
    • Parametry dostępu — login, hasło i adres IP do białej listy w jednym oknie.
    • Parametry zapytania — język katalogu, magazyn, zakres cennika, kursy walut.
    • Dane słownikowe dostawcy — listy magazynów, kategorii i marek z .

    Którzy dostawcy podłączają się przez API

    Gotowa integracja przez API to moduł, który napisaliśmy dla konkretnego dostawcy. Pliku tu w ogóle nie ma: program łączy się z serwisem dostawcy i pobiera produkty, ceny i dostępność bezpośrednio. Od Ciebie potrzebne są tylko login i hasło.

    Obecnie takich integracji jest dwadzieścia i są dostępne na każdym koncie. Wybiera się je tylko w kreatorze, na kroku „Skąd”: kafelek „API”, pod nim podtytuł „Gotowe integracje przez API” i objaśnienie — „Dostawcy, których API obsługujemy sami — wybierz właściwego, następnie podasz parametry dostępu.” Na liście widać nazwę, kraj i domenę dostawcy.

    KrajDostawcy
    MiędzynarodowiBigBuy, vidaXL, Yukatel
    KazachstanAl-Style, ComPortal
    MołdawiaAccent, dmlink.md, eMag, Ultra
    SłowacjaPHOENIX Zdravotnícke zásobovanie
    UkrainaAntey, artline.ua, BRAIN, DC Link, ELKO, ERC, MTI, Omega, Yug-Contract (Юг-Контракт), Unik Trade (Юник Трейд)

    Kolejność w tabeli jest taka sama jak na ekranie: grupy krajów idą według wewnętrznego kodu kraju, a nie alfabetycznie według nazwy, dlatego największa grupa — ukraińska — jest ostatnia. Nazwa kraju wyświetla się w języku interfejsu, a każdy kraj tworzy dokładnie jedną grupę.

    Kreator nowego źródła, krok „Skąd”: wybrany kafelek „API”, a pod nim lista gotowych integracji przez API
    1Kafelek „API”
    2Wiersz dostawcy z krajem i domeną
    3Objaśnienie pod podtytułem
    1. Kafelek „API” przełącza krok na gotowe integracje.
    2. Każdy wiersz pokazuje nazwę dostawcy, jego kraj i domenę strony.
    3. Objaśnienie mówi, że to dostawcy, których API obsługuje platforma, więc wpisujesz tylko parametry dostępu.

    Kilka integracji ma osobne artykuły:

    • ERC — jak importować stany tylko z potrzebnego magazynu.
    • Brain — pełne karty produktów z opisem i zdjęciami, wysyłanie zamówień.
    • DC Link — pełne karty produktów i rezerwacja z dokumentu.
    • Yug-Contract — zdjęcia, pełne karty produktów i zamówienia z rezerwacją.

    Co robi program, gdy wybierasz integrację

    Gdy wybierasz dostawcę z listy, program robi za Ciebie cztery rzeczy:

    • wstawia adres serwera API;
    • ustawia właściwy format cennika;
    • tworzy listę parametrów zapytania;
    • z góry mapuje adresy kolumn — kod produktu, nazwę, cenę, RRP, dostępność, kategorię.

    Dlatego w kreatorze dla API nie ma trzeciego kroku: kolumn jest już zrobione, nie ma czego sprawdzać. Zamiast tabeli kolumn kreator od razu otwiera okno parametrów dostępu.

    Powiązanie integracji robi się raz i na zawsze. Przełączyć źródła z jednego API na inne w interfejsie nie można — nawet jeśli dostawcę wybrano przez pomyłkę przed chwilą. Wyjście jest jedno: utworzyć nowe źródło i wybrać właściwą integrację w kreatorze.

    Jak wpisać dostępy i IP do białej listy

    Okno nazywa się „Ustawienia parametrów dostępu do API”, w nagłówku jest nazwa integracji i domena dostawcy. Później otworzysz je przyciskiem „Ustawienia parametrów API” w sekcji „Źródło”. W środku są trzy karty.

    „Dostęp” — „Adres serwera API”, „Login” i „Hasło (token)”. Adres jest już wstawiony, od Ciebie potrzebne są tylko dane logowania wydane przez dostawcę. Wszystko zapisuje się automatycznie.

    Pod polami jest wiersz „Adres IP serwera Elbuz Jumper, który należy przekazać dostawcy, aby nadał dostęp:” i sam adres IPv4. Jeśli dostawca prosi o Twój do białej listy swojego API — bierz go właśnie stąd: zapytania do API idą z serwera Elbuz, a nie z Twojego komputera czy biura, więc adres Twojego dostawcy internetu się nie nada.

    „Parametry zapytania” — co i jak pobierać: język katalogu, magazyn, filtry. To tabela z kolumnami „Parametr”, „Wartość” i „Opis”; zmiana wartości zapisuje się od razu. Jeśli dostawca nie ma dodatkowych parametrów, będzie tam napisane „To API nie ma dodatkowych parametrów zapytania.”

    „Dane słownikowe dostawcy” — przycisk „Pobierz dane słownikowe”. Pobiera od dostawcy listy magazynów, kategorii i marek razem z ich ID, żeby można było wstawić te ID do parametrów zapytania.

    W nagłówku okna jest przycisk „Importuj”: zapisuje dostępy i uruchamia import. Uruchamia go nie w sobie, lecz w oknie listy źródeł — więc gdy jest zamknięte, zobaczysz „Otwórz okno «Cenniki dostawców» i uruchom import źródła.”

    Jak ustawić parametry zapytania

    Każdy dostawca ma swoje parametry. Kilka przykładów, żeby było jasne, o co chodzi:

    Okno ustawień dostępu do API: tabela parametrów zapytania i karta danych słownikowych dostawcy
    1Kolumna „Parametr”
    2Kolumna „Wartość”
    3Przycisk „Pobierz dane słownikowe”
    1. Kolumna „Parametr” mówi, o co program pyta dostawcę.
    2. Kolumna „Wartość” zawiera wartość każdego parametru; zapisuje się zaraz po edycji.
    3. Przycisk pobiera listy słownikowe dostawcy (magazyny, kategorie, marki) z ich ID.
    DostawcaParametrDomyślnieCo oznacza
    ERC„Kod języka”uajęzyk katalogu; możliwe wartości ru, ua, ru-ru, uk-ua
    ERC„Importuj kursy walut”1pobieraj kurs dostawcy razem z cenami
    ERC„Link do API do importu atrybutów i zdjęć”pustelink z tokenem do osobnego serwisu parametrów i zdjęć, przykład: https://api.erc.ua/api/erc/wares.xml?token=; bez niego cennik przychodzi bez parametrów i dodatkowych zdjęć
    BRAIN„Punkt odbioru (ID)”29magazyn, którego dostępność pokazywać
    BRAIN„Zakres cennika”00 — tylko magazyn wybranego punktu odbioru; 1 — cały katalog dostawcy
    DC Link„Importuj kursy walut”1to samo co w ERC

    Parametr „Zakres cennika” w BRAIN wygląda niewinnie, ale jedynka zamiast zera oznacza „oddaj cały katalog”. Opis parametru mówi o tym wprost i ostrzega: to nie jest filtr „tylko dostępne”. Cennik rośnie od tego wielokrotnie — do setek tysięcy pozycji. Jeśli nie masz pewności, zostaw wartość domyślną.

    Cennik przez API się zaimportował, a parametrów i zdjęć nie ma. W ERC parametry, opis i dodatkowe zdjęcia przychodzą drugim zapytaniem — z linku z parametru „Link do API do importu atrybutów i zdjęć”.

    Jeśli token w tym linku jest błędny lub nieaktualny, import się nie zatrzymuje: ceny i dostępność przychodzą, a parametry i zdjęcia są pomijane. W dzienniku źródła pojawia się wiersz „Błąd API dostawcy: atrybuty i zdjęcia nie zostały zaimportowane (sprawdź token w «Link do API do importu atrybutów i zdjęć»)” z odpowiedzią serwisu po dwukropku. Poproś dostawcę o nowy token i wstaw link z nim do tego parametru; jak złożyć link — w artykule o ERC.

    Jeśli taka zmiana już przeszła, zbędne pozycje usuwa następny import — kolejność działań w sekcji „Jeśli sposób ustawiono z błędem”.

    Skąd wziąć ID magazynu lub punktu odbioru

    Przycisk „Pobierz dane słownikowe” nie działa we wszystkich integracjach: spośród dwudziestu aktywnych słownika nie ma dziewięć — ERC, DC Link, Yug-Contract, BigBuy, Antey, vidaXL, artline.ua, dmlink.md i PHOENIX. Okno pisze wtedy wprost: „Ta integracja nie ma danych słownikowych: dostawca nie udostępnia list magazynów, kategorii ani innych wartości parametrów zapytania. Uzupełnij parametry ręcznie według dokumentacji dostawcy.” ID magazynu lub punktu odbioru trzeba wtedy uzyskać od samego dostawcy.

    Część integracji oddaje więcej niż cennik: kategorie dostawcy, parametry produktów albo zdjęcia — przychodzą osobnymi plikami obok cennika. A ERC i DC Link przy włączonym parametrze „Importuj kursy walut” przekazują też swój kurs, który trafia do cen.

    W dzienniku przebiegu pracę przez API widać po wierszach „Łączenie z serwerem API” i „Otrzymano plik: ‹rozmiar› MB”. Jeśli dostawca odmówił, w dzienniku pojawi się „Błąd API dostawcy: ‹przyczyna›” — po dwukropku jest dosłowna odpowiedź dostawcy i to ją trzeba przeczytać.

    Scenariusze

    Potrzebna dostępność tylko z własnego punktu odbioru BRAIN

    Co zrobić. W kreatorze nowego źródła na kroku „Skąd” — kafelek „API”, na liście „Gotowe integracje przez API” — BRAIN. W oknie „Ustawienia parametrów dostępu do API” wpisz „Login” i „Hasło (token)”, kliknij „Pobierz dane słownikowe” i znajdź swój punkt na liście punktów odbioru. Jego ID wpisz w „Punkt odbioru (ID)”, „Zakres cennika” zostaw na 0.

    Efekt. Cennik przychodzi z magazynu wybranego punktu odbioru. Kolumny są już zmapowane, osobnego kroku mapowania kolumn nie ma.

    Czego nie będzie. Bez ID punktu odbioru cennik w ogóle nie jest pobierany. „Zakres cennika” 1 nie filtruje „tylko dostępne”, tylko oddaje cały katalog dostawcy. Pomylić się z integracją można tylko raz: przełączyć źródła na inną się nie da, można jedynie utworzyć nowe. Pozostałe ustawienia Brain — w artykule o integracji z Brain.

    W kreatorze wybrano nie tego dostawcę

    Co zrobić. Utwórz nowe źródło i w kreatorze na kroku „Skąd” wybierz właściwą integrację. Błędne źródło wyłącz lub usuń.

    Efekt. Nowe źródło dostaje adres serwera, format i mapowanie kolumn właściwego dostawcy.

    Czego nie będzie. Przełączyć istniejącego źródła na inną integrację w interfejsie nie można.

    Co zrobić, gdy cennik przez API nie przychodzi

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    „Błąd API dostawcy: ‹przyczyna›” Dostawca odmówił; tekst po dwukropku to jego dosłowna odpowiedź Najczęściej to błędny login lub hasło albo dostawca nie dodał naszego adresu IP do dozwolonych (o parametrach dostępu)
    „Otwórz okno «Cenniki dostawców» i uruchom import źródła.” Kliknięto „Importuj” w oknie parametrów API, a okno listy źródeł jest zamknięte Otwórz listę źródeł i uruchom import stamtąd (o parametrach dostępu)
    „Wybierz dostawcę z listy gotowych API” W kreatorze wybrano typ „API”, ale nie zaznaczono dostawcy na liście: żadna nie jest powiązana ze źródłem Wybierz wiersz na liście „Gotowe integracje przez API” (o integracjach)

    Najczęstsze pytania

    Czy można przełączyć źródło na inną integrację przez API?

    Nie. Powiązanie integracji zapisuje się raz i w interfejsie nie da się go zmienić. Jeśli wybrano nie tego dostawcę, utwórz nowe źródło i wybierz właściwą integrację w kreatorze.

    Potrzebnego dostawcy nie ma wśród gotowych integracji. Co robić?

    Umów się na plik: bezpośredni link, wiadomość z załącznikiem albo dostęp do . Te sposoby działają z każdym dostawcą — sposoby pobierania cennika.

    Dostawca prosi o nasz IP do dostępu do API. Skąd go wziąć?

    Z okna „Ustawienia parametrów dostępu do API”, karta „Dostęp”, wiersz „Adres IP serwera Elbuz Jumper…”. Nie podawaj IP swojego komputera ani biura: z API łączy się serwer Elbuz.

    Cennik ERC importuje się bez parametrów i zdjęć. Co robić?

    Sprawdź token w parametrze „Link do API do importu atrybutów i zdjęć”. Jeśli jest nieaktualny, ceny przychodzą, a parametry i zdjęcia są pomijane. Poproś o nowy token — o ERC.

    Przycisk „Pobierz dane słownikowe” nic nie daje. Dlaczego?

    Dziewięć integracji nie ma słownika: dostawca nie udostępnia list magazynów i kategorii. ID magazynu lub punktu odbioru trzeba wtedy uzyskać od dostawcy — o danych słownikowych.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Przetwarzanie cenników → Lista cenników
    Wybór integracji
    kreator nowego źródła, krok „Skąd” → kafelek „API”
    Parametry API
    sekcja „Źródło” → „Ustawienia parametrów API”
    Uprawnienia
    okno „Lista cenników” oraz „Ustawienia importu” i „…Plik z cennikiem”
    Przygotuj
    login i hasło (token) od dostawcy; czasem ID magazynu lub punktu odbioru

    Jak przejść kreator nowego źródła — w artykule Jak przejść kreator podłączenia źródła.

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo