↑↓ выборEnter открытьEsc закрыть

    1. Elbuz

    Как подключить Odoo к Elbuz

    17 мин чтенияОбновлено

    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Аватар в правом верхнем углу → Мои предпочтения → вкладка Безопасность → блок «Ключи API» → Create API Key. Кнопка Create API Key в русском Odoo 20 не переведена
    Там жеПодтвердить пароль, вписать описание (например «Elbuz») и срок действия
    Там жеСкопировать ключ — Odoo показывает его только один раз
    ElbuzШаблон «Odoo» → карточка «Подключение» → адрес, ключ (и логин для Odoo 18 и более ранних) → «Сохранить» → «Проверить подключение»
    Вкладка «Безопасность» в настройках пользователя Odoo: блок API-ключей с кнопкой Create API Key
    1Вкладка «Безопасность»
    2Кнопка «Create API Key»
    1. Вкладка «Безопасность» окна «Изменить мои настройки» (аватар → «Мои предпочтения»).
    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», чтобы их варианты не смешались.
    Характеристики товара-варианта: цвет и ножки
    1Color
    2Legs
    1. Color — цвет варианта, опция семьи.
    2. Legs — ножки варианта, вторая опция семьи.

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

    Фото товаров

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

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

    Остатки по складам

    Галочка «Склады» делает в Elbuz зеркало складов Odoo: каждый склад Odoo становится складом Elbuz с тем же названием, и на нём лежит тот же остаток, что и в Odoo. Главная система для остатков — Odoo.

    • Новый склад Odoo появится в Elbuz сам при следующем прогоне.
    • Каждое изменение остатка записывается в журнал движения склада как синхронизация, без документов. Повторный прогон без изменений в Odoo ничего не пишет.
    • Общий остаток карточки — сумма по всем складам Odoo.
    Справочник складов: три склада Odoo
    1YourCompany
    2Kyiv 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. Связи с поставщиками — передавать во вкладку «Покупка» карточки товара поставщиков и цены из прайсов.
    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
    1Адрес Odoo
    2Логин пользователя
    3API-ключ Odoo
    4Проверить подключение
    1. Адрес Odoo — адрес вашей базы, например https://company.odoo.com; для своей базы добавьте ?db=имя.
    2. Логин пользователя — нужен только для Odoo 18 и более ранних версий.
    3. API-ключ Odoo — ключ, созданный в настройках пользователя Odoo на вкладке «Безопасность».
    4. Проверить подключение — проверяет адрес и ключ, ничего не загружая.

    Как работают шаблоны загрузки в целом — обзор загрузки данных.

    Смежные темы

    Статья оказалась полезной?

    Не хватает функции? Напишите нам.

    Мы добавим её бесплатно, если она пригодится и другим.

    Если это нужно только вам — договоримся отдельно.

    Содержание статьи

    Предложить доработку

    Попробовать бесплатно