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
- Importuje cennik Brain — nazwy, kod Brain, numer katalogowy, markę, cenę dealera, RRP, krótki opis, gwarancję, kategorię i link do produktu.
- Bierze dostępność w Twoim punkcie odbioru albo cały katalog Brain razem z produktami na zamówienie.
- Przelicza ceny dolarowe po kursie Brain, RRP zostawia w hrywnach.
- Uzupełnia pełne karty produktów — opis, wszystkie atrybuty i zdjęcia, kod kreskowy, wagę i wymiary.
- Wysyła zamówienie do Brain z dokumentu, rezerwuje towar i pobiera status.
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
- 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.
- 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”.
- 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.
| Parametr | Domyślnie | Co robi |
|---|---|---|
| „Język” | ua | język nazw, opisów i atrybutów: ua lub ru |
| „Punkt odbioru (ID)” | 29 | punkt, dla którego Brain buduje cennik i dostępność; zmień na swój |
| „Zakres cennika” | 0 | 0 — magazyn Twojego punktu, 1 — cały katalog Brain; 2 nie używaj (więcej) |
| „Importuj produkty z rabatem” | 0 | 1 — zamiast zwykłego cennika importowane są tylko przecenione produkty Brain |
| „Pełne karty produktów” | 1 | 1 — opis, atrybuty i wszystkie zdjęcia z Brain; 0 — tylko cennik (więcej) |
| „Łącz wartości parametrów” | 1 | 1 — 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)” | puste | dokąd Brain przygotowuje zamówienie; puste — ten sam punkt co dla cennika |
| „Zamówienie: waluta” | USD | waluta zamówienia w Brain: USD lub UAH |
1
Punkt odbioru (ID)2
Zakres cennika3
Pełne karty produktów4
Zamówienie: waluta- „Punkt odbioru (ID)” — ID Twojego punktu, wzięte z „Pobierz dane słownikowe”.
- „Zakres cennika” — 0 to magazyn Twojego punktu odbioru, 1 — cały katalog.
- „Pełne karty produktów” — 1 importuje z Brain opis, atrybuty i zdjęcia.
- „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 przychodzi | Rozmiar (pomiar 03.10.2026) |
|---|---|---|
| 0 | tylko produkty, które są w magazynie Twojego punktu odbioru; wszystkie dostępne | ok. 25,7 tys. pozycji, 24 MB |
| 1 | cały katalog Brain: produkty Twojego punktu plus te, które można zamówić z innych magazynów, i te, których teraz nie ma | ok. 210 tys. pozycji, 190 MB; z tego ok. 184 tys. bez dostępności |
| 2 | skrócony cennik: kod, ceny i dostępność bez nazw i marek | te 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 Brain | Pole w Elbuz | Uwagi |
|---|---|---|
Code | „Kod kontrahenta” | kod Brain (np. U0000707); według niego produkt trafia do zamówienia |
ProductID | identyfikator 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 |
CategoryID | ID kategorii z cennika | do 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.
1
Adres nazwy2
Cena w USD3
RRP w UAH4
Adres pełnego opisu- Adres nazwy — można go zapisać z nawiasami kwadratowymi lub bez nich.
- Cena w USD — cena dealera Brain jest zawsze w dolarach.
- RRP w UAH — sugerowana cena detaliczna Brain jest zawsze w hrywnach.
- 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ć
- 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. - 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.
- Zaimportuj cennik przyciskiem „Importuj”. Wiersze dziennika „Pełne karty Brain: ‹ile› z ‹ilu›” pokazują postęp wypełniania.
- Sprawdź opis, atrybuty i zdjęcia w produktach cennika.
| Dane z karty Brain | Gdzie trafiają w cenniku | Adres kolumny |
|---|---|---|
| pełny opis (ze znacznikami HTML) | „Pełny opis” | content_description |
| kod kreskowy | kod kreskowy | content_ean |
| waga, szerokość, wysokość, głębokość | „Waga”, „Szerokość”, „Wysokość”, „Długość” | content_weight, content_width, content_height, content_depth |
| wszystkie zdjęcia | zdjęcia produktu w cenniku | tag picture, osobny adres nie jest potrzebny |
| wszystkie atrybuty | atrybuty produktu w cenniku | tag 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:
- sprawdza, czy koszyk Brain jest pusty;
- wkłada do niego pozycje dokumentu według kodu Brain; takie same produkty łączą się w jeden wiersz;
- składa zamówienie na wskazany punkt i we wskazanej walucie, z komentarzem „Elbuz ‹numer dokumentu›”;
- 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.
1
Wyślij do dostawcy2
Odśwież status od dostawcy- „Wyślij do dostawcy” — koszyk, złożenie zamówienia i rezerwacja w Brain.
- „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
| Co widzisz | Dlaczego tak jest | Co 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
- Jeśli chcesz zrozumieć, co program robi z każdym źródłem przez API i gdzie wpisać dane dostępu — Jak podłączyć dostawcę przez API.
- Jeśli statusy dostępności Brain są rozpoznawane nie tak — Dostępność produktu w cenniku dostawcy.
- Jeśli karty przyszły, a atrybuty nie pasują do Twoich atrybutów — Atrybuty produktów.
- Jeśli zamówienie u dostawcy trzeba jeszcze zebrać z zamówień klientów — Zamówienie u dostawcy.
