Як підключити Brain за API: обсяг прайсу, повні картки товарів і бронь

Що вміє інтеграція з Brain

• Завантажує прайс Brain — назви, код Brain, артикул, бренд, ціну дилера, РРЦ, короткий опис, гарантію, категорію й посилання на товар.
• Бере наявність свого пункту видачі або весь каталог Brain разом із товарами під замовлення.
• Перераховує доларові ціни за курсом Brain, РРЦ лишає в гривнях.
• Заповнює повні картки товарів — опис, усі характеристики й фото, штрихкод, вагу й габарити.
• Відправляє замовлення в Brain з документа, бронює товар і підтягує статус.

Код і назва категорії Brain приходять у кожному товарі, їх зіставляють із вашими категоріями як у будь-якого прайсу (зіставлення категорій).

Де це і хто має доступ

Меню

Довідники → Обробка прайс-листів → Список прайс-листів

Нове джерело Brain

майстер нового джерела, крок «Звідки» → плитка «API» → BRAIN

Доступ і параметри запиту

картка джерела, секція «Джерело» → «Налаштування параметрів API»

Відправка замовлення

документ «Замовлення постачальнику» → «Відправити постачальнику»

Право доступу

вікно «Список прайс-листів» і «Налаштування завантаження: файл із прайс-листом»; для замовлення — редагування документів

Підготувати

логін і пароль порталу Brain з правами керівника компанії

Що потрібно від Brain: вхід керівника й пункт видачі

1. Логін і пароль оптового порталу Brain. Окремого ключа для API немає, але Brain пускає в API тільки обліковий запис з правами керівника (адміністратора) компанії. Прав менше — попросіть адміністратора вашої компанії на порталі або менеджера Brain.
2. Номер свого пункту видачі. Від нього залежить, яка наявність прийде. Шукати номер на порталі не треба — після підключення його покаже кнопка «Отримати довідкові дані».
3. IP-адресу передавати не обовʼязково. Якщо менеджер Brain попросить адресу, звідки йтимуть запити, — вона у вікні параметрів доступу (де саме).

Які параметри запиту Brain задати

У майстрі нового джерела на кроці «Звідки» оберіть плитку «API» і BRAIN у списку. Адресу https://api.brain.com.ua/, формат XML і колонки програма ставить сама (що робить привʼязка). У «Логін» і «Пароль (токен)» впишіть дані порталу Brain.

Далі натисніть «Отримати довідкові дані»: Brain покаже пункти видачі й служби доставки з ID, склади й валюти з курсами. ID свого пункту впишіть у «Пункт видачі (ID)». Нічого в Brain ця кнопка не створює.

1

Пункт видачі (ID)

2

Обсяг прайсу

3

Повні картки товарів

4

Замовлення: валюта

1. Пункт видачі (ID) — ID свого пункту з «Отримати довідкові дані».
2. Обсяг прайсу — 0: склад вашого пункту, 1: увесь каталог.
3. Повні картки товарів — 1: опис, характеристики й фото з Brain.
4. Замовлення: валюта — валюта замовлення в Brain.

У джерел, підключених раніше, «Мова» може стояти ru, а «Повні картки товарів» — 0: старим джерелам картки самі не вмикаються, бо перше заповнення займає кілька хвилин.

Скільки каталогу брати: «Обсяг прайсу» і наявність

«Обсяг прайсу» — не фільтр «лише в наявності», а вибір, скільки каталогу віддає Brain. Ми перевірили всі три значення на тому самому пункті видачі:

• 0 — для магазину, який продає те, що можна забрати зі свого пункту.
• 1 — коли ви продаєте й товари під замовлення: вони прийдуть зі статусом «Немає на складі», завантаження триватиме довше.
• 2 як основне джерело не годиться: без назв товар не показати й не зіставити з каталогом.

Наявність

Наявність Brain віддає атрибутом Available: 0 — товару немає, 1, 2 або 3 — товар є. Це градація, а не штуки: точної кількості в прайсі Brain немає. Стандартні статуси розпізнають ці значення без налаштувань: від 1 — «В наявності», 0 — «Немає на складі».

Кількість у таких товарів умовна: статус «В наявності» додає до 1–3 свою «Кількість за замовч.», і виходить, наприклад, 101–103. Потрібна однакова кількість для всіх — вимкніть у статусі визначення кількості за числом (докладніше).

Наявність привʼязана до пункту видачі. Якщо в прайсі наявність не того міста — перевірте «Пункт видачі (ID)».

Що приходить у прайсі Brain

Прайс Brain — XML-файл, де всі значення товару стоять в атрибутах тегу <product>. Програма запитує в Brain посилання на файл і скачує його; якщо сервер Brain 10 хвилин не віддає даних, скачування обривається (коли прайс не приїхав).

Колонки, які привʼязка розмічає сама:

Інші атрибути — Model, CategoryName, Country, UKTVED, RecommendedPrice, DayDelivery (за скільки днів товар буде на вашому пункті), Bonus — беруться будь-яким вільним рядком колонок: впишіть назву атрибута в «Адреса стовпця». Адресу можна писати і просто назвою (Name), і в квадратних дужках ([Name]).

Фото й повного опису в прайсі Brain немає за жодного значення «Обсяг прайсу» — вони приходять тільки повними картками.

Ціна в доларах, РРЦ у гривнях і курс Brain

Ціна дилера PriceUSD у Brain завжди в доларах, а РРЦ RetailPrice — завжди в гривнях. У секції «Колонки» в рядку «Ціна» має стояти валюта USD, у рядку «Ціна РРЦ» — UAH. Мультивалюта не потрібна: атрибут DDP у прайсі Brain валюту не позначає — співвідношення РРЦ до ціни однакове в товарів з DDP 0 і 1.

Курс Brain. Якщо в картці джерела, блок «Структура XML», увімкнено «Брати курс валют із файлу (тег currencies)», перед кожним завантаженням програма бере в Brain курс безготівкової гривні й ставить його доларовим рядкам «Ціна» і «Ціна РРЦ». У журналі — «Курс USD від постачальника: ‹число›».

Вимкнули галку — у колонках лишиться останній курс Brain, змініть його вручну або в довіднику валют.

Як отримати повні картки товарів Brain

Опис, характеристики й фото Brain віддає не в прайсі, а окремим методом. Програма бере їх так, щоб завантаження не тягнулося годинами:

• Пачками по тисячі товарів за запит: перше заповнення 25 тисяч карток — близько 4–5 хвилин (замір 03.10.2026).
• Окремо від прайсу. Кнопка «Завантажити» картки не стирає, тож наступне завантаження не починає з нуля.
• Тільки різницю: товари, яких ще немає серед збережених карток, і ті, що Brain позначив зміненими. Зазвичай це хвилина; сам прогон з картками довший приблизно на півтори хвилини на 25 тис. товарів.
• Тільки для товарів у наявності. Товар під замовлення отримає картку, щойно зʼявиться на складі.

Як увімкнути

1. Увімкніть картки: у параметрах запиту в рядку «Повні картки товарів» впишіть 1. Окремого ключа не треба: картки беруться тим самим логіном і паролем.
2. За бажанням — як показувати характеристики: рядки «Обʼєднувати значення характеристик» і «Розділювач значень характеристик». Змінили — просто завантажте прайс ще раз, картки заново не качаються.
3. Завантажте прайс кнопкою «Завантажити». Рядки журналу «Повні картки Brain: ‹скільки› з ‹скільки›» показують хід заповнення.
4. Перевірте опис, характеристики й фото в товарах прайсу.

Адреси для карток розмічені в усіх джерелах Brain, і в старих теж; власні адреси в цих рядках програма не змінює. Перемикачі «Завантажувати атрибути» і «Завантажувати фото» (секція «Товари», блок «Які дані завантажувати») вмикаються самі разом із картками. Файл у журналі («Отримано файл: …») з картками в кілька разів більший — так і має бути.

Під час додавання товару з прайсу в базовий каталог картка приходить заповненою, а характеристики зіставляються з вашими атрибутами (характеристики товарів, фото товарів). Опис мають не всі товари Brain — у нашому замірі близько 7 з 10. Фото-заглушки Brain («немає фото») програма відкидає. Змінили «Мова» — картки іншою мовою заповнюються заново, як уперше.

Як відправити замовлення в Brain і забронювати товар

Замовлення постачальнику, створене в Elbuz на контрагента Brain, відправляється в Brain з документа. Налаштування — рядки «Замовлення: пункт видачі / доставка (ID)» і «Замовлення: валюта» в параметрах запиту; програма бере їх з першого активного API-джерела контрагента документа.

Що відбувається після натискання

Відкрийте документ «Замовлення постачальнику», натисніть «Відправити постачальнику» і підтвердіть: Brain отримує справжнє замовлення. Далі програма за один раз:

1. перевіряє, що кошик Brain порожній;
2. кладе в нього позиції документа за кодом Brain; однакові товари складаються в один рядок;
3. оформлює замовлення на вказаний пункт і у вказаній валюті, з коментарем «Elbuz ‹номер документа›»;
4. бронює товар. Термін броні визначає Brain — зазвичай до наступного дня, дата приходить у повідомленні.

Номер замовлення Brain записується в документ, статус від постачальника — «Бронь», результат — у повідомленні й історії документа. Відвантаження, доставку покупцю й дропшип оформлюють на порталі Brain.

1

Відправити постачальнику

2

Оновити статус від постачальника

1. Відправити постачальнику — кошик, оформлення, бронь у Brain.
2. Оновити статус від постачальника — тип і стан замовлення в Brain, напр. «Бронь / Обробка».

Чому програма зупиняється на непорожньому кошику

Кошик у Brain один на весь обліковий запис і спільний з порталом. Товари, які там уже лежать, потрапили б у ваше замовлення, тому програма нічого не кладе й показує «У кошику Brain уже є товари — оформіть або очистіть їх на порталі Brain і надішліть ще раз». Кошик вона не чіпає.

Коли нічого не відправляється

• у позиції немає коду Brain — товар не зіставлений з прайсом Brain; назви таких позицій є в повідомленні (зіставлення товарів);
• у документі немає позицій з кількістю більше нуля;
• Brain не прийняв логін або пароль з налаштувань джерела;
• кошик Brain не порожній.

• Повтор не створює дубль. Якщо номер замовлення Brain уже є в документі, повторне натискання запитує стан наявного: «Замовлення вже відправлено в Brain — повторно не створено» або «Замовлення з цим номером у Brain не знайдено».
• Бронь не вдалася — замовлення є. Повідомлення «Забронювати не вдалося (…) — забронюйте замовлення на порталі Brain», статус від постачальника — «Створено».

Статус від Brain

Статус сам не оновлюється — тільки пунктом «Оновити статус від постачальника» в меню біля кнопки відправки. Brain відповідає типом і станом через скісну риску, наприклад «Бронь / Обробка» або «Відвантаження / Обробка».

Сценарії

Додавати товари Brain у каталог одразу з описом і фото

Що зробити. «Повні картки товарів» = 1, завантаження джерела, далі — додавання товарів з прайсу в базовий каталог, як звичайно.

Що вийде. Нові товари в каталозі отримують опис, характеристики й фото з Brain. Наступні завантаження оновлюють ціни й наявність і добирають картки лише для нових і змінених товарів.

Продавати й товари під замовлення

Що зробити. «Обсяг прайсу» = 1. Щоб бачити, за скільки днів товар буде на пункті, впишіть DayDelivery у вільний рядок колонок.

Що вийде. У прайсі весь каталог Brain: наявні на вашому пункті — «В наявності», інші — «Немає на складі». Файл у кілька разів більший, завантаження довше.

Перейти на інший пункт видачі

Що зробити. «Отримати довідкові дані» → ID нового пункту → «Пункт видачі (ID)». Замовлення теж туди — залиште «Замовлення: пункт видачі / доставка (ID)» порожнім або впишіть той самий ID. Запустіть завантаження.

Що вийде. Прайс і наявність — під новий пункт. Збережені картки не пропадають: вони не залежать від пункту.

Що робити, коли прайс Brain не приїхав або прийшов порожнім

Коли прайс не приїхав: що пише журнал

Якщо Brain відмовив або файл не скачався, у журналі завантаження зʼявиться «Помилка API постачальника: …» з причиною:

• «sid empty Incorrect login or password» — неправильний логін чи пароль;
• «Brain price download failed: …» — файл не скачався;
• «targetID empty» — не заповнено «Пункт видачі (ID)».

У всіх цих випадках прогін іде на попередньому файлі: товари прайсу оновлюються вчорашніми даними (чому так).

Часті запитання

Чи стирає кнопка «Завантажити» збережені картки Brain?

Ні. Опис, характеристики й фото зберігаються окремо від прайсу, і нове завантаження їх не видаляє, а тільки доповнює новими й зміненими в Brain товарами.

Чому кількість товару Brain 101 або 103?

Brain віддає не штуки, а градацію 1–3, і статус «В наявності» додає до неї «Кількість за замовч.». Як зробити кількість однаковою — у розділі наявність.

Чому РРЦ з Brain така велика?

РРЦ Brain завжди в гривнях. Якщо в рядку «Ціна РРЦ» секції «Колонки» стоїть USD, гривнева сума множиться на курс. Поставте UAH.

Чи можна завантажувати з Brain тільки певні бренди чи категорії?

На боці Brain — ні. Зайве відсікають уже в Elbuz правилами ігнорування.

Чи можна відвантажити замовлення Brain або оформити дропшип з Elbuz?

Ні. Програма доводить замовлення до броні; відвантаження й доставку покупцю оформлюють на порталі Brain.

Суміжні теми

• Якщо треба зрозуміти, що програма робить з будь-яким джерелом за API і де вписати доступи, — Як підключити постачальника за API.
• Якщо статуси наявності Brain розпізнаються не так, — Наявність товару в прайсі постачальника.
• Якщо картки прийшли, а характеристики не лягають у ваші атрибути, — Характеристики товарів.
• Якщо замовлення постачальнику ще треба зібрати з замовлень покупців, — Замовлення постачальнику.