Elbuz обмінюється даними з Odoo напряму через Odoo API, без файлів: каталог, залишки складів і замовлення приходять у Elbuz, а ціни, нові товари та звʼязки з постачальниками з прайсів ідуть назад в Odoo.
Коли це знадобиться:
- Склад і бухгалтерію ведете в Odoo — товари з варіантами, фото, атрибутами й залишками кожного складу приїдуть у каталог Elbuz.
- Ціни рахуєте за прайсами постачальників — Elbuz відправить в Odoo лише ті ціни, що змінилися.
- Закупівлі робите в Odoo — у вкладці «Купівля» товару зʼявляться постачальники з прайсів, їхні коди, ціни й терміни.
- Замовлення Odoo мають бути в загальній черзі — кожне лягає документом «Замовлення покупця».
З чого почати: створіть API-ключ в Odoo.
Розмова з підтримкою — замість читати: навіщо це потрібно, що налаштувати і що ви отримаєте.
Що вміє підключення Odoo
- Переносить товари в каталог — назву, артикул, штрихкод, ціну, вагу, описи, категорію; кожен варіант — окремою карткою.
- Збирає варіанти в сімʼю і розкладає кольори, розміри та інші осі варіантів у характеристики-опції.
- Забирає фото разом із галереєю сайту Odoo, навіть якщо картинки в Odoo закриті входом.
- Дзеркалить склади — залишок кожного товару на кожному складі Odoo.
- Приймає замовлення продажів і заводить постачальників Odoo в контрагенти.
- Вивантажує в Odoo ціни, нові товари з фото й категорією, за бажанням — описи, SEO та основні дані, а також звʼязки з постачальниками.
Що саме ходить у кожен бік:
- Запит або дія
- Примітка
Що потрібно від Odoo: адреса й API-ключ
Elbuz підключається до Odoo від імені користувача Odoo за його API-ключем. Потрібні три значення:
- Адреса Odoo — як у браузері, наприклад
https://company.odoo.com. Якщо на сервері кілька баз, додайте до адреси назву бази:https://erp.company.com/?db=main. Для Odoo Online база береться з адреси сама. - API-ключ — створюється в Odoo, вставляється в поле «API-ключ Odoo».
- Логін користувача — лише для Odoo 18 і старіших. Odoo 19 і новіші працюють тільки за ключем, поле лишайте порожнім.
Версію Odoo вказувати не треба: Elbuz сам визначає, чи підтримує сервер новий протокол Odoo 19+, і переходить на старий для Odoo 14–18.
Де взяти API-ключ: крок за кроком
| Де | Що зробити |
|---|---|
| Odoo | Аватар у правому верхньому куті → My Preferences → вкладка Безпека → блок «API ключі» → Create API Key. В українському Odoo 20 ці два пункти лишаються англійською |
| Там само | Підтвердити пароль, вписати опис (наприклад «Elbuz») і строк дії |
| Там само | Скопіювати ключ — Odoo показує його лише раз |
| Elbuz | Шаблон «Odoo» → картка «Підключення» → адреса, ключ (і логін для Odoo 18 і старіших) → «Зберегти» → «Перевірити підключення» |
1
Вкладка «Безпека»2
Кнопка «Create API Key»- Вкладка «Безпека» вікна «Змінити мої налаштування» (аватар → My Preferences).
- Create API Key створює ключ; Odoo покаже його один раз. Вище — уже створений ключ «elbuz» з позначкою RPC і строком дії.
В Odoo 20 ключ живе не довше трьох місяців. Коли строк мине, завантаження й вивантаження зупиняться з помилкою «Invalid apikey». Поставте собі нагадування: створіть новий ключ і впишіть його в обидва шаблони до кінця строку.
Заведіть в Odoo окремого користувача, наприклад «Elbuz», з правами на продажі, склад і закупівлі. Так видно, які зміни зробила інтеграція, а доступ легко відкликати, не чіпаючи нікого з людей.
У хмарному Odoo Online зовнішній API доступний лише на тарифі Custom. На тарифах One App Free і Standard Odoo запити не прийме. Odoo на власному сервері чи на Odoo.sh такого обмеження не має.
Odoo має бути доступний з інтернету. Elbuz працює в хмарі й не ходить у внутрішні мережі: сервер Odoo, який видно лише в офісній мережі, не підключиться.
Як підключити
- Створіть шаблон типу «Odoo» і в картці «Підключення» впишіть адресу, API-ключ, а для Odoo 18 і старіших — логін.
- Збережіть шаблон і натисніть «Перевірити підключення» — перевіряються збережені адреса й ключ. У відповідь Odoo назве вашу компанію — значить, ключ прийнято.
- У картці «Вибір даних для завантаження» залиште лише потрібні галочки (що вони вмикають), збережіть і запустіть.
Що завантажувати з Odoo: галочки шаблону
Що забирати, вирішуєте ви: у шаблоні Odoo показано лише ті галочки, які підключення справді виконує. Зняли галочку — цю частину прогін пропускає.
| Галочка | Що приходить |
|---|---|
| Товари | картки товарів і варіантів (поля) |
| Категорії | категорія товару: сайту Odoo, а без нього — внутрішня категорія Odoo; працює разом із «Товари» |
| Атрибути | осі варіантів як характеристики-опції та інші атрибути; разом із «Товари» (варіанти) |
| Фото | головне фото й галерея сайту Odoo; разом із «Товари» (фото) |
| Склади | склади Odoo і залишок товару на кожному; без «Товари» оновлює залишки вже завантажених карток (склади) |
| Замовлення | замовлення продажів документами «Замовлення покупця» (замовлення) |
| Завантажувати постачальників Odoo в контрагенти | постачальники в групу «Постачальник» (постачальники) |
1
Товари2
Склади3
Постачальники Odoo в контрагенти- Товари — завантажує каталог товарів разом із варіантами.
- Склади — підтягує склади Odoo та залишки по них.
- Постачальники Odoo потрапляють у контрагенти до групи «Постачальник».
Порядок у прогоні: постачальники → товари → склади → замовлення. Склади йдуть після товарів, бо залишки пишуться вже в наявні картки.
Швидкість і обсяги
Підключення читає й пише пачками: сторінками по 500 товарів, фото — кількома паралельними запитами, ціни — пакетами по 500 одним запитом. Заміри 11.11.2026, Odoo 20 на тому самому компʼютері, що й Elbuz (без затримок мережі):
| Операція | Обсяг | Час |
|---|---|---|
| завантаження каталогу з фото | 3 049 товарів, 3 039 фото | 8 с |
| повне завантаження в каталог Elbuz | 3 054 товари і 24 замовлення | 37 с; повтор — 23 с |
| вивантаження всіх цін | 3 000 товарів | 22 с |
| щоденне вивантаження цін | 3 000 товарів, змінилося 100 | 0,8 с |
На вашому Odoo час залежить від його сервера й тарифу, але співвідношення те саме: вивантажувати щоразу весь прайс не потрібно, Elbuz сам відсіює незмінені ціни. Кнопка «Зупинити» в журналі обриває завантаження каталогу й замовлень після поточної сторінки.
Що переноситься в картку
Кожен варіант товару Odoo стає окремою карткою Elbuz. Odoo-товар без варіантів — одна картка.
| Дані Odoo | Поле картки в Elbuz |
|---|---|
| назва (у варіанта — з атрибутами, наприклад «Стіл (Білий, Сталь)») | Назва |
| внутрішній код (Internal Reference) | Артикул |
| штрихкод | Штрихкод (лише цифри) |
| ціна продажу варіанта | Ціна |
| кількість у наявності (з модулем «Склад») | Залишок; відʼємний стає нулем |
| вага | Вага |
| опис для продажу | Короткий опис |
| опис для сайту Odoo, SEO-заголовок і опис | Повний опис, мета-заголовок, мета-опис |
| активний і відмітка «Продажі» | Активність: вимкнено, якщо товар не можна продавати |
Кожна картка отримує незмінний ключ — номер товару в Odoo. За ним Elbuz упізнає товар при кожному наступному прогоні, навіть якщо в Odoo змінили назву чи артикул. Тому два різні товари Odoo з однаковою назвою лишаються двома картками, а не склеюються в одну.
Товар, який створило в Odoo вивантаження з Elbuz, при завантаженні впізнається як ваша наявна картка: другої картки не буде.
Що робить повторний прогін із вашими правками
Прогін повертає в картку те, що зараз в Odoo: назву, артикул, штрихкод, ціну, залишок, активність, описи. Порожнє поле Odoo ваше значення не стирає. Товари, які створило в Odoo вивантаження Elbuz, завантаження пропускає: їхні ціну й залишок веде Elbuz. Закріпити ціну — «Фіксована ціна» в картці (огляд завантаження).
Фото й атрибути заливаються лише під час створення картки. У вже заведеної прогін їх не оновлює: змінили фото в Odoo — у Elbuz воно не зміниться.
Товар, видалений чи архівований в Odoo, у Elbuz лишається як був: прогін забирає лише наявні товари і нічого не вимикає. Картки Odoo знаходяться у вікні «Товари» за колонкою «Джерело: код» (odoo).
Варіанти, атрибути й фото
Варіанти одного товару Odoo збираються в сімʼю товарів: у всіх однакова «Назва родини (варіації)» — назва товару Odoo. На сайті вони перемикаються кнопками кольорів і розмірів, кожен зі своєю ціною, фото й залишком.
- Осі варіантів (колір, розмір, матеріал ніжок…) приходять характеристиками-опціями — за ними й перемикаються варіанти.
- Атрибути Odoo без варіантів приходять звичайними характеристиками; кілька значень — через крапку з комою.
- Два різні товари Odoo з варіантами й однаковою назвою отримують родину з номером товару-шаблону Odoo в кінці, наприклад «Футболка #101», щоб їхні варіанти не змішалися.
1
Характеристика Color2
Характеристика Legs- Color зі значенням White — перша опція варіанта, імпортована з Odoo.
- Legs зі значенням Steel — друга опція того самого варіанта.
Без галочки «Атрибути» варіанти однаково стають окремими картками однієї сімʼї, але без характеристик-опцій. Тоді перемикач на сайті не зʼявиться, доки ви не позначите варіативні атрибути вручну.
Фото товарів
Картинки Odoo відкриваються лише після входу в Odoo, тож посилання на них Elbuz не допоможе. Тому підключення забирає сам файл через API і кладе його у ваше сховище Elbuz, а в картку записує вже власне посилання.
- Головне фото — фото варіанта, а якщо його немає — фото товару.
- Галерея — додаткові фото з сайту Odoo (модуль eCommerce): спершу фото варіанта, потім товару.
- Одне фото — один файл. Спільне фото для пʼяти варіантів заливається один раз; повторний прогін без змін нічого не завантажує.
Залишки по складах
Галочка «Склади» робить у Elbuz дзеркало складів Odoo: кожен склад Odoo стає складом Elbuz з тією ж назвою, і на ньому лежить той залишок, що й в Odoo. Головна система для залишків — Odoo.
- Новий склад Odoo зʼявиться в Elbuz сам при наступному прогоні.
- Кожна зміна залишку записується в журнал руху складу як синхронізація, без документів. Повторний прогін без змін в Odoo нічого не пише.
- Загальний залишок картки — сума по всіх складах Odoo.
1
Склад YourCompany2
Склад Kyiv WH- YourCompany — склад, перенесений з Odoo.
- Kyiv WH — ще один склад Odoo; поруч — власні склади, як-от центральний склад.
Без модуля «Склад» (Inventory) в Odoo немає ні складів, ні кількостей: журнал прогону покаже помилку для складів, товари завантажаться без залишку.
Вести рух товару документами Elbuz на складах-дзеркалах не варто: наступний прогін поверне залишок з Odoo. Свої склади Elbuz і їхні документи підключення не чіпає.
Замовлення продажів і постачальники
Кожне замовлення продажів Odoo лягає в Elbuz документом «Замовлення покупця» з номером Odoo (наприклад S00042). Повторний прогін не заводить друге замовлення, а оновлює наявне: статус (якщо ви не змінили його вручну), оплату й доставку, дописує порожні контакти й адресу. Рядки й суму документа він не перезаписує: змінили склад замовлення в Odoo — у Elbuz лишиться попередній.
| В Odoo | У документі Elbuz |
|---|---|
| рядок товару | рядок документа, привʼязаний до картки; ціна — з податком і знижкою рядка |
| рядок доставки | сума доставки (не товарний рядок) |
| розділи й примітки замовлення | не переносяться |
| покупець | імʼя, email, телефон |
| адреса доставки | місто, країна, індекс, адреса; немає окремої — береться адреса покупця |
| примітка й номер замовлення клієнта | коментар документа |
| стан і статус рахунку | статус замовлення й оплати — для зіставлення статусів |
Сума документа дорівнює підсумку замовлення в Odoo разом із податком. Перший прогін забирає всі замовлення продажів, разом із пропозиціями (чернетками) і скасованими — їхній стан видно в статусі; наступні — лише змінені після попереднього. Замовлення, змінені в останню секунду попереднього прогону, приходять ще раз і просто оновлюються.
Постачальники Odoo в контрагентах
Галочка «Завантажувати постачальників Odoo в контрагенти» заводить постачальників Odoo в Elbuz у групу «Постачальник»: назву, email, телефони, сайт, податковий номер, країну, місто, адресу, індекс і коментар.
- Постачальником вважається партнер Odoo з ознакою постачальника (зʼявляється з модулями «Купівлі» чи «Бухгалтерія»). Без неї — ті, хто вказаний у закупівельних цінах товарів.
- Контактні особи всередині компанії окремими постачальниками не стають.
- Контрагент шукається за назвою. Якщо він уже є, прогін його не змінює: ваші правки в картці контрагента вціліють.
Що вивантажувати в Odoo
Вивантаження — окремий шаблон «Odoo» у вікні «Вивантаження даних» з тими ж адресою й ключем. Що передавати, вирішують галочки картки «Що вивантажувати»:
| Галочка | Що робить в Odoo |
|---|---|
| Товари | оновлює ціну привʼязаних товарів — лише тих, у кого вона змінилася (ціни варіантів) |
| Публікувати нові товари | створює товари, яких в Odoo ще немає: назва, ціна, артикул, штрихкод, вага, короткий опис |
| Категорії | новому товару ставить категорію, створюючи її в Odoo за шляхом |
| Фото | новому товару передає головне фото |
| Звʼязки з постачальниками | заповнює вкладку «Купівля» (докладно); увімкнено за замовчуванням |
| Описи та SEO | привʼязаним товарам передає короткий опис в опис для продажу, повний — в опис товару на сайті Odoo, а також SEO-заголовок і мета-опис; вимкнено за замовчуванням |
| Основні дані (назва, артикул, штрихкод, вага) | оновлює ці поля привʼязаних товарів; назву — лише товарам без варіантів, бо у варіантів вона спільна на шаблон; вимкнено за замовчуванням |
Порожнє поле в Elbuz значення в Odoo не стирає, і передаються лише поля, що змінилися. Без модуля «Сайт» повному опису в Odoo немає місця — тоді йде лише короткий.
1
Товари2
Публікувати нові товари3
Звʼязки з постачальниками4
Описи та SEO- Товари — вивантаження цін і залишків товарів в Odoo.
- Публікувати нові товари — нові товари створюються в Odoo з позначкою публікації.
- Звʼязки з постачальниками — вивантажується вкладка «Купівля» товару Odoo з постачальниками.
- Описи та SEO — вивантаження описів і SEO-полів товарів.
Привʼязаним вважається товар, який прийшов завантаженням із тієї самої бази Odoo або вже створений цим вивантаженням. Повторно такий товар не створюється, а товар з іншої бази Odoo за привʼязаний не береться. Окремої галочки «лише змінене» в Odoo немає: Elbuz сам порівнює ціни з Odoo й надсилає тільки змінені.
Ціни варіантів
В Odoo 20 кожен варіант має власну ціну, і Elbuz пише її кожному. В Odoo 18 і старіших ціна спільна на товар-шаблон, а варіант відрізняється лише надбавкою атрибута. Тому там Elbuz пише базову ціну шаблону, якщо ваші варіанти без надбавки коштують однаково; якщо по-різному — ціни цього шаблону пропускає, а журнал покаже, скільки таких шаблонів.
- Залишки в Odoo не пишуться. Odoo веде склад сам, а Elbuz бере залишки з нього.
- Фото й категорія передаються лише новим товарам; у наявних в Odoo їх не змінено.
- Дубль штрихкоду в одному з нових товарів не зупиняє решту: Odoo відмовить лише цьому товару, причина буде в журналі.
Звʼязки з постачальниками у вкладці «Купівля»
Elbuz знає, у яких постачальників є кожен товар каталогу, — зі звʼязаних прайсів. Галочка «Звʼязки з постачальниками» переносить це в Odoo, у стандартну вкладку «Купівля» картки товару: один товар — стільки рядків, скільки в нього постачальників.
| Рядок «Купівлі» в Odoo | Звідки |
|---|---|
| Постачальник | постачальник прайсу; немає в Odoo — створюється компанією-постачальником |
| Код і назва товару постачальника | артикул і назва товару в прайсі |
| Ціна й валюта | ціна прайсу у валюті постачальника, якщо ця валюта активна в Odoo; інакше — у вашій базовій, якщо активна вона; інакше — перерахована за курсом Elbuz у валюту компанії Odoo. Без жодної з них рядок не пишеться, помилка — в журналі |
| Строк постачання | число днів із терміну постачання прайсу |
1
Вкладка «Купівля»2
Рядки постачальників- Вкладка «Купівля» картки товару Odoo.
- Постачальники з прайсів Elbuz: ціна в їхній валюті або перерахована, строк постачання.
- Без змін — без запису. Рядок, що вже збігається, не переписується; змінені оновлюються пакетами по 500.
- Звʼязок, знятий у Elbuz, зникає і в Odoo — але лише в ваших постачальників, тобто тих, у кого є прайс у Elbuz, і лише для товарів, що потрапили в це вивантаження.
- Рядки постачальників, заведених тільки в Odoo, не чіпаються. Ваші закупники можуть вести там своїх постачальників поруч.
Назва контрагента в Elbuz і партнера в Odoo мають збігатися. Інакше в Odoo зʼявиться друга компанія з назвою з Elbuz, а звʼязки ляжуть на неї.
Сценарії
Склад і бухгалтерія в Odoo, продажі й прайси в Elbuz
Завантаження за розкладом: «Товари», «Атрибути», «Склади». Вивантаження: «Товари» (ціни) і «Звʼязки з постачальниками». Залишки приходять з Odoo, ціни йдуть в Odoo з прайсів.
Закупники працюють в Odoo
Вивантаження лише з галочкою «Звʼязки з постачальниками». У вкладці «Купівля» кожного товару — актуальні постачальники, їхні ціни й строки.
Переїзд з Odoo в Elbuz
Одне завантаження з усіма галочками, разом із постачальниками й замовленнями. Фото, сімʼї варіантів, категорії й історія продажів переїдуть разом із товарами.
Замовлення Odoo в загальній черзі
Окремий шаблон завантаження лише з галочкою «Замовлення», поставлений на розклад: замовлення Odoo стоять поруч із замовленнями сайту й маркетплейсів.
Новинки з прайсів одразу в Odoo
Вивантаження з «Публікувати нові товари», «Категорії» й «Фото»: товар, що зʼявився в каталозі Elbuz, створиться в Odoo з фото й місцем у дереві категорій.
Що робити, коли Odoo не підключається
| Що видно | Причина | Що зробити |
|---|---|---|
| «Invalid apikey» | ключ прострочений, відкликаний або скопійований не повністю | створіть новий ключ в Odoo (як) і впишіть в обидва шаблони |
| «Odoo < 19: login is required» | Odoo 18 чи старіший працює за логіном і ключем | заповніть поле «Логін користувача» |
| «login or API key rejected» | логін не того користувача, якому належить ключ, або не та база | перевірте логін; базу вкажіть в адресі через ?db= |
| «blocked: private or reserved address» | Odoo в локальній мережі, не з інтернету | відкрийте доступ до Odoo з інтернету за доменом |
| «Odoo: помилка API — stock.warehouse» | в Odoo немає модуля «Склад» | встановіть модуль або зніміть галочку «Склади» |
| «Odoo: помилка вивантаження product.supplierinfo» | у користувача Odoo, якому належить ключ, немає прав на закупівельні ціни | дайте йому права на закупівлі або зніміть галочку «Звʼязки з постачальниками»; вкладку «Купівля» в картці видно з модулем «Купівлі» |
| товари без фото | галочку «Фото» ввімкнули після першого прогону | фото доходять лише до нових карток; уже наявним додайте фото в Elbuz або видаліть картки й повторіть |
Часті запитання
Чи можна вивантажувати замовлення з Elbuz в Odoo?
Ні. Замовлення ходять лише з Odoo в Elbuz (замовлення продажів).
Чи оновлює Elbuz залишки в Odoo?
Ні. Головна система для складу — Odoo, Elbuz лише дзеркалить його залишки (залишки по складах).
Які версії Odoo підтримуються?
Odoo 14–20: Community, Enterprise, Odoo.sh і Odoo Online на тарифі Custom; перевірено на Odoo 18 і 20. Для Odoo 18 і старіших потрібен ще логін (що потрібно).
Видалив товар в Odoo — чому він лишився в Elbuz?
Прогін забирає лише наявні товари й нічого не вимикає. Зайву картку вимкніть чи видаліть у вікні «Товари» (повторний прогін).
Чи можна підключити кілька баз Odoo?
Так, по шаблону на кожну. Картки різних баз не плутаються: ключ товару містить ознаку бази.
Чи передаються характеристики товару в Odoo?
Ні. Вивантаження передає ціну, а новим товарам — назву, артикул, штрихкод, вагу, опис, категорію й фото (що вивантажувати).
Товар у кількох категоріях сайту Odoo — куди він потрапить?
У найглибшу з них. Інші категорії сайту не переносяться (галочки).
Де це і хто має доступ
- Меню
- Довідники → Операції → Завантаження даних (з Odoo) і Вивантаження даних (в Odoo)
- Шаблон
- новий шаблон → тип «Odoo»; один шаблон — одна база Odoo
- Право доступу
- вікна «Завантаження даних» і «Вивантаження даних» у «Правах груп»
- Підготувати
- адресу Odoo, API-ключ; для Odoo 18 і старіших — ще логін
1
Адреса Odoo2
Логін користувача3
API-ключ Odoo4
Перевірити підключення- Адреса Odoo — адреса вашого Odoo, для окремої бази додайте ?db=імʼя.
- Логін користувача — потрібен лише для Odoo 18 і старіших версій.
- API-ключ Odoo — ключ, створений у налаштуваннях користувача в Odoo.
- Перевірити підключення — кнопка перевірки введених даних.
Як працюють шаблони завантаження загалом — огляд завантаження даних.
Суміжні теми
- Якщо треба зрозуміти, як шаблон завантаження поводиться з будь-яким джерелом, — Завантаження даних у каталог.
- Якщо варіанти з Odoo мають перемикатися на сайті кольорами й розмірами — Родини товарів.
- Якщо ціни з Elbuz мають їхати в Odoo за розкладом — Шаблони вивантаження.
- Якщо звʼязків з постачальниками ще немає — Підключення й завантаження прайсу.
