↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Завантаження даних
    4. Облік, CRM і каси

    Як підключити Odoo до Elbuz

    18 хв читанняОновлено

    Elbuz обмінюється даними з Odoo напряму через Odoo API, без файлів: каталог, залишки складів і замовлення приходять у Elbuz, а ціни, нові товари та звʼязки з постачальниками з прайсів ідуть назад в Odoo.

    Коли це знадобиться:

    • Склад і бухгалтерію ведете в Odoo — товари з варіантами, фото, атрибутами й залишками кожного складу приїдуть у каталог Elbuz.
    • Ціни рахуєте за прайсами постачальників — Elbuz відправить в Odoo лише ті ціни, що змінилися.
    • Закупівлі робите в Odoo — у вкладці «Купівля» товару зʼявляться постачальники з прайсів, їхні коди, ціни й терміни.
    • Замовлення Odoo мають бути в загальній черзі — кожне лягає документом «Замовлення покупця».

    З чого почати: створіть API-ключ в Odoo.

    Розмова з підтримкою — замість читати: навіщо це потрібно, що налаштувати і що ви отримаєте.

    Що вміє підключення Odoo

    Що саме ходить у кожен бік:

    Два шаблони на одному API-ключі: завантаження забирає з Odoo все, що Odoo веде як головна система, вивантаження віддає в Odoo те, що рахує Elbuz
    ElbuzOdooШаблон «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 і старіших) → «Зберегти» → «Перевірити підключення»
    Вкладка «Безпека» в налаштуваннях користувача Odoo: блок «API ключі» з кнопкою Create API Key
    1Вкладка «Безпека»
    2Кнопка «Create API Key»
    1. Вкладка «Безпека» вікна «Змінити мої налаштування» (аватар → My Preferences).
    2. 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, який видно лише в офісній мережі, не підключиться.

    Як підключити

    1. Створіть шаблон типу «Odoo» і в картці «Підключення» впишіть адресу, API-ключ, а для Odoo 18 і старіших — логін.
    2. Збережіть шаблон і натисніть «Перевірити підключення» — перевіряються збережені адреса й ключ. У відповідь Odoo назве вашу компанію — значить, ключ прийнято.
    3. У картці «Вибір даних для завантаження» залиште лише потрібні галочки (що вони вмикають), збережіть і запустіть.

    Що завантажувати з Odoo: галочки шаблону

    Що забирати, вирішуєте ви: у шаблоні Odoo показано лише ті галочки, які підключення справді виконує. Зняли галочку — цю частину прогін пропускає.

    ГалочкаЩо приходить
    Товарикартки товарів і варіантів (поля)
    Категоріїкатегорія товару: сайту Odoo, а без нього — внутрішня категорія Odoo; працює разом із «Товари»
    Атрибутиосі варіантів як характеристики-опції та інші атрибути; разом із «Товари» (варіанти)
    Фотоголовне фото й галерея сайту Odoo; разом із «Товари» (фото)
    Складисклади Odoo і залишок товару на кожному; без «Товари» оновлює залишки вже завантажених карток (склади)
    Замовленнязамовлення продажів документами «Замовлення покупця» (замовлення)
    Завантажувати постачальників Odoo в контрагентипостачальники в групу «Постачальник» (постачальники)
    Картка «Вибір даних для завантаження» шаблону Odoo
    1Товари
    2Склади
    3Постачальники Odoo в контрагенти
    1. Товари — завантажує каталог товарів разом із варіантами.
    2. Склади — підтягує склади Odoo та залишки по них.
    3. Постачальники Odoo потрапляють у контрагенти до групи «Постачальник».

    Порядок у прогоні: постачальники → товари → склади → замовлення. Склади йдуть після товарів, бо залишки пишуться вже в наявні картки.

    Швидкість і обсяги

    Підключення читає й пише пачками: сторінками по 500 товарів, фото — кількома паралельними запитами, ціни — пакетами по 500 одним запитом. Заміри 11.11.2026, Odoo 20 на тому самому компʼютері, що й Elbuz (без затримок мережі):

    ОпераціяОбсягЧас
    завантаження каталогу з фото3 049 товарів, 3 039 фото8 с
    повне завантаження в каталог Elbuz3 054 товари і 24 замовлення37 с; повтор — 23 с
    вивантаження всіх цін3 000 товарів22 с
    щоденне вивантаження цін3 000 товарів, змінилося 1000,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», щоб їхні варіанти не змішалися.
    Вкладка «Атрибути» картки товару Customizable Desk (White, Steel) із характеристиками Color і Legs
    1Характеристика Color
    2Характеристика Legs
    1. Color зі значенням White — перша опція варіанта, імпортована з Odoo.
    2. Legs зі значенням Steel — друга опція того самого варіанта.

    Без галочки «Атрибути» варіанти однаково стають окремими картками однієї сімʼї, але без характеристик-опцій. Тоді перемикач на сайті не зʼявиться, доки ви не позначите варіативні атрибути вручну.

    Фото товарів

    Картинки Odoo відкриваються лише після входу в Odoo, тож посилання на них Elbuz не допоможе. Тому підключення забирає сам файл через API і кладе його у ваше сховище Elbuz, а в картку записує вже власне посилання.

    • Головне фото — фото варіанта, а якщо його немає — фото товару.
    • Галерея — додаткові фото з сайту Odoo (модуль eCommerce): спершу фото варіанта, потім товару.
    • Одне фото — один файл. Спільне фото для пʼяти варіантів заливається один раз; повторний прогін без змін нічого не завантажує.

    Залишки по складах

    Галочка «Склади» робить у Elbuz дзеркало складів Odoo: кожен склад Odoo стає складом Elbuz з тією ж назвою, і на ньому лежить той залишок, що й в Odoo. Головна система для залишків — Odoo.

    • Новий склад Odoo зʼявиться в Elbuz сам при наступному прогоні.
    • Кожна зміна залишку записується в журнал руху складу як синхронізація, без документів. Повторний прогін без змін в Odoo нічого не пише.
    • Загальний залишок картки — сума по всіх складах Odoo.
    Довідник складів: склади Odoo поруч із власними складами
    1Склад YourCompany
    2Склад Kyiv WH
    1. YourCompany — склад, перенесений з Odoo.
    2. 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 немає місця — тоді йде лише короткий.

    Картка «Що вивантажувати» в шаблоні «Odoo — ціни й закупівлі»
    1Товари
    2Публікувати нові товари
    3Звʼязки з постачальниками
    4Описи та SEO
    1. Товари — вивантаження цін і залишків товарів в Odoo.
    2. Публікувати нові товари — нові товари створюються в Odoo з позначкою публікації.
    3. Звʼязки з постачальниками — вивантажується вкладка «Купівля» товару Odoo з постачальниками.
    4. Описи та 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. Без жодної з них рядок не пишеться, помилка — в журналі
    Строк постачаннячисло днів із терміну постачання прайсу
    Вкладка «Купівля» товару Odoo з постачальниками, яких туди вивантажив Elbuz
    1Вкладка «Купівля»
    2Рядки постачальників
    1. Вкладка «Купівля» картки товару Odoo.
    2. Постачальники з прайсів 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 і старіших — ще логін
    Картка «Підключення» шаблону Odoo з полями адреси, логіна й API-ключа
    1Адреса Odoo
    2Логін користувача
    3API-ключ Odoo
    4Перевірити підключення
    1. Адреса Odoo — адреса вашого Odoo, для окремої бази додайте ?db=імʼя.
    2. Логін користувача — потрібен лише для Odoo 18 і старіших версій.
    3. API-ключ Odoo — ключ, створений у налаштуваннях користувача в Odoo.
    4. Перевірити підключення — кнопка перевірки введених даних.

    Як працюють шаблони завантаження загалом — огляд завантаження даних.

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно