↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak podłączyć Brain przez API: zakres cennika, pełne karty produktów i rezerwacja

    7 min czytaniaZaktualizowano

    Elbuz sam pobiera z Brain B2B cennik z ceną dealera, RRP i dostępnością w Twoim punkcie odbioru, a w razie potrzeby — pełne karty produktów.

    Kiedy to się przyda:

    • Sprzedajesz to, co można odebrać z Twojego punktu Brain — do cennika trafiają tylko produkty dostępne w tym punkcie.
    • Produkty mają trafiać do katalogu od razu z opisem i zdjęciami — karty Brain wypełniają się w kilka minut, a potem tylko się uzupełniają.
    • Sprzedajesz też produkty na zamówienie — przychodzi cały katalog Brain.
    • Zamówienie u dostawcy trzeba przekazać do Brain — program wkłada produkty do koszyka Brain, składa zamówienie i rezerwuje towar.

    Od czego zacząć: weź login kierownika firmy na portalu Brain.

    Co potrafi integracja z Brain

    Kod i nazwa kategorii Brain przychodzą w każdym produkcie; dopasowuje się je do Twoich kategorii jak w każdym cenniku (dopasowanie kategorii).

    Czego potrzeba od Brain: login kierownika i punkt odbioru

    1. Login i hasło do portalu hurtowego Brain. Osobnego klucza do nie ma, ale Brain wpuszcza do API tylko konto z uprawnieniami kierownika (administratora) firmy. Masz mniejsze uprawnienia — poproś administratora Twojej firmy na portalu albo menedżera Brain.
    2. Numer Twojego punktu odbioru. Od niego zależy, jaka dostępność przyjdzie. Nie musisz szukać numeru na portalu — po podłączeniu pokaże go przycisk „Pobierz dane słownikowe”.
    3. Adresu IP nie trzeba przekazywać. Jeśli menedżer Brain poprosi o adres, z którego będą szły zapytania — jest w oknie parametrów dostępu (gdzie dokładnie).

    Jakie parametry zapytania Brain ustawić

    W kreatorze nowego źródła na kroku „Skąd” wybierz kafelek „API” i BRAIN z listy. Adres https://api.brain.com.ua/, format i kolumny program ustawia sam (co robi powiązanie). W pola „Login” i „Hasło (token)” wpisz dane z portalu Brain.

    Następnie kliknij „Pobierz dane słownikowe”: Brain pokaże punkty odbioru i firmy kurierskie z , magazyny i waluty z kursami. ID swojego punktu wpisz w „Punkt odbioru (ID)”. Ten przycisk niczego w Brain nie tworzy.

    ParametrDomyślnieCo robi
    „Język”uajęzyk nazw, opisów i atrybutów: ua lub ru
    „Punkt odbioru (ID)”29punkt, dla którego Brain buduje cennik i dostępność; zmień na swój
    „Zakres cennika”00 — magazyn Twojego punktu, 1 — cały katalog Brain; 2 nie używaj (więcej)
    „Importuj produkty z rabatem”01 — zamiast zwykłego cennika importowane są tylko przecenione produkty Brain
    „Pełne karty produktów”11 — opis, atrybuty i wszystkie zdjęcia z Brain; 0 — tylko cennik (więcej)
    „Łącz wartości parametrów”11 — atrybuty o tej samej nazwie stają się jednym: „Gniazdo: 1156 / 2011 / AM4” zamiast trzech wierszy „Gniazdo”; 0 — każda wartość w osobnym wierszu, jak w Brain
    „Separator wartości parametrów”/znak między połączonymi wartościami; dla przecinka lub średnika spacja stawiana jest tylko po znaku: „INTEL, AMD”
    „Zamówienie: punkt odbioru / dostawa (ID)”pustedokąd Brain przygotowuje zamówienie; puste — ten sam punkt co dla cennika
    „Zamówienie: waluta”USDwaluta zamówienia w Brain: USD lub UAH
    Karta „Parametry zapytania” w oknie ustawień dostępu do API źródła Brain
    1Punkt odbioru (ID)
    2Zakres cennika
    3Pełne karty produktów
    4Zamówienie: waluta
    1. „Punkt odbioru (ID)” — ID Twojego punktu, wzięte z „Pobierz dane słownikowe”.
    2. „Zakres cennika” — 0 to magazyn Twojego punktu odbioru, 1 — cały katalog.
    3. „Pełne karty produktów” — 1 importuje z Brain opis, atrybuty i zdjęcia.
    4. „Zamówienie: waluta” — waluta, w której zamówienie jest składane w Brain.

    W źródłach podłączonych wcześniej „Język” może mieć wartość ru, a „Pełne karty produktów” — 0: w starych źródłach karty nie włączają się same, bo pierwsze wypełnienie zajmuje kilka minut.

    Ile katalogu pobierać: „Zakres cennika” i dostępność

    „Zakres cennika” to nie filtr „tylko dostępne”, lecz wybór, jaką część katalogu przekazuje Brain. Sprawdziliśmy wszystkie trzy wartości na tym samym punkcie odbioru:

    WartośćCo przychodziRozmiar (pomiar 03.10.2026)
    0tylko produkty, które są w magazynie Twojego punktu odbioru; wszystkie dostępneok. 25,7 tys. pozycji, 24 MB
    1cały katalog Brain: produkty Twojego punktu plus te, które można zamówić z innych magazynów, i te, których teraz nie maok. 210 tys. pozycji, 190 MB; z tego ok. 184 tys. bez dostępności
    2skrócony cennik: kod, ceny i dostępność bez nazw i marekte same 210 tys.
    • 0 — dla sklepu, który sprzedaje to, co można odebrać z własnego punktu.
    • 1 — gdy sprzedajesz też produkty na zamówienie: przyjdą ze statusem „Brak w magazynie”, a import potrwa dłużej.
    • 2 nie nadaje się na główne źródło: bez nazw produktu nie da się pokazać ani dopasować do katalogu.

    Dostępność

    Dostępność Brain przekazuje w atrybucie Available: 0 — produktu nie ma, 1, 2 lub 3 — produkt jest. To gradacja, a nie sztuki: dokładnej ilości w cenniku Brain nie ma. Standardowe statusy rozpoznają te wartości bez ustawień: od 1 — „Dostępny”, 0 — „Brak w magazynie”.

    Ilość takich produktów jest umowna: status „Dostępny” dodaje do 1–3 swoją „Domyślna ilość” i wychodzi na przykład 101–103. Potrzebujesz jednakowej ilości dla wszystkich — wyłącz w statusie ustalanie ilości z liczby (więcej).

    Dostępność jest powiązana z punktem odbioru. Jeśli w cenniku jest dostępność z innego miasta — sprawdź „Punkt odbioru (ID)”.

    Co przychodzi w cenniku Brain

    Cennik Brain to plik XML, w którym wszystkie wartości produktu są w atrybutach tagu <product>. Program prosi Brain o link do pliku i go pobiera; jeśli serwer Brain przez 10 minut nie przekazuje danych, pobieranie zostaje przerwane (gdy cennik nie dotarł).

    Kolumny, które powiązanie mapuje samo:

    Atrybut BrainPole w ElbuzUwagi
    Code„Kod kontrahenta”kod Brain (np. U0000707); według niego produkt trafia do zamówienia
    ProductIDidentyfikator produktu w cenniku, a także „Kod kreskowy JAN”liczbowy ID Brain; według niego dobierane są pełne karty
    Article„Kod producenta”
    Name„Nazwa”
    Vendor„Producent”
    PriceUSD„Cena”cena dealera, zawsze w dolarach
    RetailPrice„Cena sugerowana (RRP)”cena detaliczna, zawsze w hrywnach
    Available„Status dostępności (z cennika)”0 — brak, 1–3 — jest (dostępność)
    Description„Krótki opis”krótka lista parametrów w jednym wierszu
    Warranty„Gwarancja”w miesiącach
    CategoryIDID kategorii z cennikado dopasowania kategorii
    URL„Link do produktu (URL)”strona produktu na portalu hurtowym

    Pozostałe atrybuty — Model, CategoryName, Country, UKTVED, RecommendedPrice, DayDelivery (za ile dni produkt będzie w Twoim punkcie), Bonus — weźmiesz dowolnym wolnym wierszem kolumn: wpisz nazwę atrybutu w „Adres kolumny”. Adres można zapisać samą nazwą (Name) albo w nawiasach kwadratowych ([Name]).

    Zdjęć i pełnego opisu w cenniku Brain nie ma przy żadnej wartości „Zakres cennika” — przychodzą tylko w pełnych kartach.

    Tabela kolumn źródła Brain z adresami kolumn i walutami
    1Adres nazwy
    2Cena w USD
    3RRP w UAH
    4Adres pełnego opisu
    1. Adres nazwy — można go zapisać z nawiasami kwadratowymi lub bez nich.
    2. Cena w USD — cena dealera Brain jest zawsze w dolarach.
    3. RRP w UAH — sugerowana cena detaliczna Brain jest zawsze w hrywnach.
    4. Adres pełnego opisu — pełny opis z karty produktu Brain.

    Cena w dolarach, RRP w hrywnach i kurs Brain

    Cena dealera PriceUSD w Brain jest zawsze w dolarach, a RRP RetailPrice — zawsze w hrywnach. W sekcji „Kolumny” w wierszu „Cena” musi być waluta USD, a w wierszu „Cena sugerowana (RRP)” — UAH. Wielowalutowość nie jest potrzebna. W cenniku Brain jest atrybut DDP, ale nie oznacza on waluty: u produktów z DDP 0 i 1 cena i tak jest w dolarach. Nie myl z ERC — tam tag ddp właśnie mówi, w jakiej walucie jest cena.

    W wierszu „Cena sugerowana (RRP)” jest USD. Wtedy RRP w hrywnach mnoży się przez kurs i cena detaliczna wychodzi kilkadziesiąt razy wyższa. Ustaw UAH. Nowe źródła Brain mapują się poprawnie same; błąd zdarza się w źródłach podłączonych wcześniej.

    Kurs Brain. Jeśli w karcie źródła, w bloku „Struktura XML”, włączone jest „Pobieraj kursy walut z pliku (tag currencies)”, przed każdym importem program bierze z Brain kurs hrywny bezgotówkowej i ustawia go dolarowym wierszom „Cena” i „Cena sugerowana (RRP)”. W dzienniku — „Kurs USD od dostawcy: ‹liczba›”.

    Po odznaczeniu tej opcji w kolumnach zostanie ostatni kurs Brain; zmień go ręcznie albo w słowniku walut.

    Jak otrzymać pełne karty produktów Brain

    Opis, atrybuty i zdjęcia Brain przekazuje nie w cenniku, lecz osobną metodą. Program pobiera je tak, żeby import nie ciągnął się godzinami:

    • Paczkami po tysiąc produktów na zapytanie: pierwsze wypełnienie 25 tysięcy kart — ok. 4–5 minut (pomiar 03.10.2026).
    • Osobno od cennika. Przycisk „Importuj” nie usuwa kart, więc kolejny import nie zaczyna od zera.
    • Tylko różnicę: produkty, których jeszcze nie ma wśród zapisanych kart, i te, które Brain oznaczył jako zmienione. Zwykle to minuta; sam przebieg z kartami jest dłuższy o ok. półtorej minuty na 25 tys. produktów.
    • Tylko dla dostępnych produktów. Produkt na zamówienie dostanie kartę, gdy tylko pojawi się w magazynie.

    Jak włączyć

    1. Włącz karty: w parametrach zapytania w wierszu „Pełne karty produktów” wpisz 1. Osobny klucz nie jest potrzebny: karty pobierane są tym samym loginem i hasłem.
    2. Opcjonalnie — jak pokazywać atrybuty: wiersze „Łącz wartości parametrów” i „Separator wartości parametrów”. Po zmianie po prostu zaimportuj cennik jeszcze raz, karty nie pobierają się od nowa.
    3. Zaimportuj cennik przyciskiem „Importuj”. Wiersze dziennika „Pełne karty Brain: ‹ile› z ‹ilu›” pokazują postęp wypełniania.
    4. Sprawdź opis, atrybuty i zdjęcia w produktach cennika.
    Dane z karty BrainGdzie trafiają w cennikuAdres kolumny
    pełny opis (ze znacznikami HTML)„Pełny opis”content_description
    kod kreskowykod kreskowy content_ean
    waga, szerokość, wysokość, głębokość„Waga”, „Szerokość”, „Wysokość”, „Długość”content_weight, content_width, content_height, content_depth
    wszystkie zdjęciazdjęcia produktu w cennikutag picture, osobny adres nie jest potrzebny
    wszystkie atrybutyatrybuty produktu w cennikutag param, osobny adres nie jest potrzebny

    Adresy dla kart są zmapowane we wszystkich źródłach Brain, także w starych; własnych adresów w tych wierszach program nie zmienia. Przełączniki „Pobieraj atrybuty” i „Pobieraj zdjęcia” (sekcja „Produkty”, blok „Jakie dane importować”) włączają się same razem z kartami. Plik w dzienniku („Otrzymano plik: …”) z kartami jest kilka razy większy — tak ma być.

    Przy dodawaniu produktu z cennika do katalogu bazowego karta przychodzi wypełniona, a atrybuty są dopasowywane do Twoich atrybutów (atrybuty produktów, zdjęcia produktów). Nie wszystkie produkty Brain mają opis — w naszym pomiarze ok. 7 na 10. Zaślepki zdjęć Brain („brak zdjęcia”) program odrzuca. Po zmianie „Język” karty w innym języku wypełniają się od nowa, jak za pierwszym razem.

    Jak wysłać zamówienie do Brain i zarezerwować towar

    Zamówienie u dostawcy utworzone w Elbuz na kontrahenta Brain wysyła się do Brain z dokumentu. Ustawienia to wiersze „Zamówienie: punkt odbioru / dostawa (ID)” i „Zamówienie: waluta” w parametrach zapytania; program bierze je z pierwszego aktywnego źródła API kontrahenta dokumentu.

    Co się dzieje po kliknięciu

    Otwórz dokument „Zamówienie do dostawcy”, kliknij „Wyślij do dostawcy” i potwierdź: Brain dostaje prawdziwe zamówienie. Dalej program za jednym razem:

    1. sprawdza, czy koszyk Brain jest pusty;
    2. wkłada do niego pozycje dokumentu według kodu Brain; takie same produkty łączą się w jeden wiersz;
    3. składa zamówienie na wskazany punkt i we wskazanej walucie, z komentarzem „Elbuz ‹numer dokumentu›”;
    4. rezerwuje towar. Termin rezerwacji ustala Brain — zwykle do następnego dnia, data przychodzi w komunikacie.

    Numer zamówienia Brain zapisuje się w dokumencie, status od dostawcy — „Rezerwacja”, a wynik — w komunikacie i historii dokumentu. Wysyłkę, dostawę do klienta i dropshipping obsługuje się na portalu Brain.

    Okno zamówienia u dostawcy z rozwiniętym menu strzałki pod przyciskiem „Wyślij do dostawcy”
    1Wyślij do dostawcy
    2Odśwież status od dostawcy
    1. „Wyślij do dostawcy” — koszyk, złożenie zamówienia i rezerwacja w Brain.
    2. „Odśwież status od dostawcy” — typ i stan zamówienia w Brain.

    Dlaczego program zatrzymuje się na niepustym koszyku

    Koszyk w Brain jest jeden na całe konto i wspólny z portalem. Produkty, które już w nim leżą, trafiłyby do Twojego zamówienia, dlatego program niczego nie wkłada i pokazuje „Koszyk Brain zawiera już produkty — złóż zamówienie lub wyczyść koszyk na portalu Brain i wyślij ponownie”. Koszyka nie rusza.

    Jeśli Brain odmówi na etapie koszyka lub składania zamówienia, program czyści koszyk. Znika to, co właśnie włożył — oraz produkt, który ktoś w tych sekundach dodał na portalu.

    Kiedy nic nie zostaje wysłane

    • pozycja nie ma kodu Brain — produkt nie jest dopasowany do cennika Brain; nazwy takich pozycji są w komunikacie (dopasowanie produktów);
    • w dokumencie nie ma pozycji z ilością większą od zera;
    • Brain nie przyjął loginu lub hasła z ustawień źródła;
    • koszyk Brain nie jest pusty.
    • Ponowne kliknięcie nie tworzy duplikatu. Jeśli numer zamówienia Brain jest już w dokumencie, ponowne kliknięcie pyta o stan istniejącego: „Zamówienie zostało już wysłane do Brain — nie utworzono ponownie” albo „Nie znaleziono w Brain zamówienia o tym numerze”.
    • Rezerwacja się nie udała — zamówienie istnieje. Komunikat „Nie udało się zarezerwować (…) — zarezerwuj zamówienie na portalu Brain”, status od dostawcy — „Utworzono”.

    Status od Brain

    Status nie odświeża się sam — tylko pozycją „Odśwież status od dostawcy” w menu obok przycisku wysyłki. Brain odpowiada typem i stanem rozdzielonymi ukośnikiem, na przykład „Бронь / Обробка” (rezerwacja / przetwarzanie) albo „Відвантаження / Обробка” (wysyłka / przetwarzanie).

    Scenariusze

    Dodawać produkty Brain do katalogu od razu z opisem i zdjęciami

    Co zrobić. „Pełne karty produktów” = 1, import źródła, a potem dodawanie produktów z cennika do katalogu bazowego jak zwykle.

    Efekt. Nowe produkty w katalogu dostają opis, atrybuty i zdjęcia z Brain. Kolejne importy aktualizują ceny i dostępność i dobierają karty tylko dla nowych i zmienionych produktów.

    Sprzedawać też produkty na zamówienie

    Co zrobić. „Zakres cennika” = 1. Aby widzieć, za ile dni produkt będzie w punkcie, wpisz DayDelivery w wolny wiersz kolumn.

    Efekt. W cenniku jest cały katalog Brain: dostępne w Twoim punkcie — „Dostępny”, pozostałe — „Brak w magazynie”. Plik jest kilka razy większy, a import dłuższy.

    Przejść na inny punkt odbioru

    Co zrobić. „Pobierz dane słownikowe” → ID nowego punktu → „Punkt odbioru (ID)”. Zamówienia też tam — zostaw „Zamówienie: punkt odbioru / dostawa (ID)” puste albo wpisz to samo ID. Uruchom import.

    Efekt. Cennik i dostępność — dla nowego punktu. Zapisane karty nie przepadają: nie zależą od punktu.

    Co zrobić, gdy cennik Brain nie dotarł albo przyszedł pusty

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    Import przechodzi, a w cenniku jest zero produktów Adresy kolumn bez nawiasów w poprzedniej wersji nie odczytywały atrybutów Brain Uruchom import jeszcze raz; jeśli produktów nadal nie ma — sprawdź „Zakres cennika” (nie 2) i dziennik (co przychodzi)
    RRP w cenniku jest kilkadziesiąt razy za wysoka W wierszu „Cena sugerowana (RRP)” jest USD, a RRP Brain jest w hrywnach Ustaw UAH (cena, RRP i kurs)
    Produkty bez nazw i marek „Zakres cennika” = 2 — skrócony cennik Ustaw 0 lub 1 (zakres cennika)
    Brak zdjęć i atrybutów „Pełne karty produktów” = 0 albo produkt jest niedostępny Ustaw 1 i uruchom import (pełne karty)
    „Nie otrzymano pełnych kart Brain (…) — cennik jest importowany z wcześniej zapisanymi kartami” Brain odrzucił zapytanie o karty, na przykład przez limit zapytań Nic: cennik się zaimportował, nowe karty dojdą następnym razem
    „Błąd API dostawcy: sid empty Incorrect login or password” Błędny login lub hasło albo konto nie ma uprawnień kierownika firmy Sprawdź dane z portalu Brain (czego potrzeba od Brain)
    „Koszyk Brain zawiera już produkty…” przy wysyłaniu zamówienia We wspólnym koszyku Brain leżą cudze pozycje Złóż zamówienie lub wyczyść koszyk na portalu Brain i wyślij ponownie
    „Pozycje bez kodu Brain…” Produkt z dokumentu nie jest dopasowany do cennika Brain Dopasuj produkt do cennika Brain (dopasowanie produktów)

    Gdy cennik nie dotarł: co pisze dziennik

    Jeśli Brain odmówił albo plik się nie pobrał, w dzienniku importu pojawi się „Błąd API dostawcy: …” z przyczyną:

    • „sid empty Incorrect login or password” — błędny login lub hasło;
    • „Brain price download failed: …” — plik się nie pobrał;
    • „targetID empty” — nie wypełniono „Punkt odbioru (ID)”.

    We wszystkich tych przypadkach przebieg idzie na poprzednim pliku: produkty w cenniku aktualizują się wczorajszymi danymi (dlaczego tak).

    Najczęstsze pytania

    Czy przycisk „Importuj” usuwa zapisane karty Brain?

    Nie. Opis, atrybuty i zdjęcia są przechowywane osobno od cennika, a nowy import ich nie usuwa, tylko uzupełnia o nowe i zmienione w Brain produkty.

    Dlaczego ilość produktu Brain to 101 albo 103?

    Brain podaje nie sztuki, lecz gradację 1–3, a status „Dostępny” dodaje do niej „Domyślna ilość”. Jak ustawić jednakową ilość — w sekcji dostępność.

    Dlaczego RRP z Brain jest taka wysoka?

    RRP Brain jest zawsze w hrywnach. Jeśli w wierszu „Cena sugerowana (RRP)” sekcji „Kolumny” jest USD, kwota w hrywnach mnoży się przez kurs. Ustaw UAH.

    Czy można importować z Brain tylko wybrane marki lub kategorie?

    Po stronie Brain — nie. Zbędne produkty odfiltrujesz już w Elbuz regułami ignorowania.

    Czy można wysłać towar z zamówienia Brain albo obsłużyć dropshipping z Elbuz?

    Nie. Program doprowadza zamówienie do rezerwacji; wysyłkę i dostawę do klienta obsługuje się na portalu Brain.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Przetwarzanie cenników → Lista cenników
    Nowe źródło Brain
    kreator nowego źródła, krok „Skąd” → kafelek „API” → BRAIN
    Dostęp i parametry zapytania
    karta źródła, sekcja „Źródło” → „Ustawienia parametrów API”
    Wysyłka zamówienia
    dokument „Zamówienie do dostawcy” → „Wyślij do dostawcy”
    Uprawnienia
    okno „Lista cenników” i „Ustawienia importu: plik z cennikiem”; do zamówienia — edycja dokumentów
    Przygotuj
    login i hasło do portalu Brain z uprawnieniami kierownika firmy

    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