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 | Аватар в правом верхнем углу → Мои предпочтения → вкладка Безопасность → блок «Ключи API» → Create API Key. Кнопка Create API Key в русском Odoo 20 не переведена |
| Там же | Подтвердить пароль, вписать описание (например «Elbuz») и срок действия |
| Там же | Скопировать ключ — Odoo показывает его только один раз |
| Elbuz | Шаблон «Odoo» → карточка «Подключение» → адрес, ключ (и логин для Odoo 18 и более ранних) → «Сохранить» → «Проверить подключение» |
1
Вкладка «Безопасность»2
Кнопка «Create API Key»- Вкладка «Безопасность» окна «Изменить мои настройки» (аватар → «Мои предпочтения»).
- 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 — цвет варианта, опция семьи.
- Legs — ножки варианта, вторая опция семьи.
Без галочки «Атрибуты» варианты всё равно становятся отдельными карточками одного семейства, но без характеристик-опций. Тогда переключатель на сайте не появится, пока вы не отметите вариативные атрибуты вручную.
Фото товаров
Картинки 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 товары, которых там ещё нет, вместе с категорией и фото.
- Связи с поставщиками — передавать во вкладку «Покупка» карточки товара поставщиков и цены из прайсов.
- Описания и 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 — адрес вашей базы, например https://company.odoo.com; для своей базы добавьте ?db=имя.
- Логин пользователя — нужен только для Odoo 18 и более ранних версий.
- API-ключ Odoo — ключ, созданный в настройках пользователя Odoo на вкладке «Безопасность».
- Проверить подключение — проверяет адрес и ключ, ничего не загружая.
Как работают шаблоны загрузки в целом — обзор загрузки данных.
Смежные темы
- Если нужно понять, как шаблон загрузки работает с любым источником, — Загрузка данных в каталог.
- Если варианты из Odoo должны переключаться на сайте цветами и размерами — Семейства товаров.
- Если цены из Elbuz должны уходить в Odoo по расписанию — Шаблоны выгрузки.
- Если связей с поставщиками ещё нет — Подключение и загрузка прайса.
