Интеграция 1С-Битрикс и Akeneo: синхронизация товарного каталога

Каталог на 50 000 товаров. У каждого 20 атрибутов, 5 языков, сотни изображений. Заполнение одного товара — 15 минут. 1250 человеко-часов на весь ассортимент. Редакторы тратят дни, ошибки в данных растут. Возвраты множатся. Без PIM-системы — хаос. С интеграцией Akeneo и 1С-Битрикс мы наводим порядок: автоматическое обогащение, единый мастер данных, синхронизация.

Один из клиентов с 80 000 SKU сократил время на подготовку контента втрое. Годовая экономия — около 2 млн рублей. Но это не предел. При грамотно выстроенной архитектуре интеграции Akeneo и 1С-Битрикс можно добиться ещё большей эффективности. Экономия на ручном труде составляет до 1.5 млн рублей в год для каталога на 30 000 товаров.

Типичные проблемы каталога без PIM

Отсутствие единого источника данных. Товары разбросаны по Excel, Google Sheets, 1С. Дублируются карточки, атрибуты расходятся. Менеджеры работают с разными версиями. Конфликты неизбежны.

Локализация — головная боль. Перевод названий, описаний, SEO-текстов для 10+ языков вручную — ад. Каждый язык требует отдельной правки. Ошибки перевода множатся.

Медиа-активы. Сотни изображений привязываются руками, битые ссылки, путаница с альтернативными текстами. Синхронизация с CDN отсутствует.

Как Akeneo решает эти задачи

Типичная схема: 1С (номенклатура, цены, остатки) → Akeneo (описания, атрибуты, медиа, переводы) → Битрикс (каталог, корзина, заказы). Akeneo — мастер продуктового контента. 1С — источник SKU и цен. Битрикс — канал продаж. Направление синхронизации: Akeneo → Битрикс. Обратный поток (заказы, статистика) настраивается редко — только для аналитики.

Какие данные синхронизируем?

Набор гибкий. Базовая конфигурация: наименование, полное и краткое описание, атрибуты (бренд, вес, цвет, материал, страна происхождения), изображения, цены, остатки. Для многоязычных каталогов — локализованные версии (ru_RU → ru, en_US → en, de_DE → de). Маппинг атрибутов хранится в конфигурационном файле или HL-блоке.

Сравнение: Akeneo против расширения инфоблоков

Инфоблоки Битрикс — движок для продаж, но не для управления большим контентом. Akeneo забирает обогащение, локализацию и валидацию. Результат — каталог обновляется в 3 раза быстрее.

Как мы пишем код синхронизации?

Akeneo предоставляет REST API с OAuth 2.0. Используем Bitrix\Main\Web\HttpClient. Лимиты запросов (100/ч) обходим очередью отложенных задач. Согласно <cite>Akeneo REST API Reference</cite>, лимит — 100 запросов в час. Пример клиента:

class AkeneoClient
{
    private string $baseUrl;
    private string $token;

    public function __construct(
        string $baseUrl,
        string $clientId,
        string $secret,
        string $username,
        string $password
    ) {
        $this->baseUrl = rtrim($baseUrl, '/');
        $this->token   = $this->authenticate($clientId, $secret, $username, $password);
    }

    private function authenticate(
        string $clientId,
        string $secret,
        string $username,
        string $password
    ): string {
        $http = new \Bitrix\Main\Web\HttpClient();
        $http->setHeader('Authorization',
            'Basic ' . base64_encode($clientId . ':' . $secret));
        $http->setHeader('Content-Type', 'application/json');

        $response = $http->post(
            $this->baseUrl . '/api/oauth/v1/token',
            json_encode([
                'grant_type' => 'password',
                'username'   => $username,
                'password'   => $password,
            ])
        );

        $data = json_decode($response, true);
        return $data['access_token'] ?? throw new \RuntimeException('Akeneo auth failed');
    }

    public function getProducts(int $page = 1, int $limit = 100): array
    {
        $http = new \Bitrix\Main\Web\HttpClient();
        $http->setHeader('Authorization', 'Bearer ' . $this->token);

        $response = $http->get(
            $this->baseUrl . '/api/rest/v1/products'
            . '?page=' . $page . '&limit=' . $limit
            . '&with_attribute_options=true'
        );

        return json_decode($response, true)['_embedded']['items'] ?? [];
    }

    public function getMediaFile(string $code): string
    {
        $http = new \Bitrix\Main\Web\HttpClient();
        $http->setHeader('Authorization', 'Bearer ' . $this->token);
        return $http->get($this->baseUrl . '/api/rest/v1/media-files/' . $code . '/download');
    }
}

<?php
return [
    'description' => 'DETAIL_TEXT',
    'short_description' => 'PREVIEW_TEXT',
    'brand' => 'BRAND',
    'weight' => 'WEIGHT',
    'color' => 'COLOR',
    'material' => 'MATERIAL',
    'care_instructions' => 'CARE',
    'country_of_origin' => 'COUNTRY_ORIGIN',
];

Пошаговая интеграция: от аудита до деплоя

1. Аудит текущего каталога: список товаров, атрибутов, разделов. Рекомендации по маппингу.
2. Настройка REST API Akeneo: создание клиента, получение токена, тестовый запрос.
3. Разработка модуля синхронизации: агент, маппинг, логика обновления (включая медиа).
4. Реализация инкрементального режима: фиксация времени последней синхронизации.
5. Тестирование на выборке товаров: проверка корректности данных, ошибок, производительности.
6. Документация и обучение: описание агента, команды ручного запуска, инструкция для админа.

Инкрементальный режим: эффективный подход

Для 50 000+ SKU полная синхронизация каждый раз — убийца производительности. Инкрементальный режим тянет только изменённые с момента последней синхронизации. Это снижает нагрузку на Akeneo и Битрикс. Агент запускается по расписанию:

function syncAkeneoProductsAgent(): string
{
    $lastSync = \Bitrix\Main\Config\Option::get('akeneo_sync', 'last_sync', '');
    $client   = new AkeneoClient(
        AKENEO_URL, AKENEO_CLIENT_ID, AKENEO_SECRET,
        AKENEO_USER, AKENEO_PASSWORD
    );

    $mapping    = include '/local/config/akeneo-mapping.php';
    $syncTime   = date('c');
    $page       = 1;

    do {
        $products = $client->getProducts($page, 100);
        foreach ($products as $akeneoProduct) {
            syncSingleProduct($akeneoProduct, $mapping, $client);
        }
        $page++;
    } while (count($products) === 100);

    \Bitrix\Main\Config\Option::set('akeneo_sync', 'last_sync', $syncTime);

    return __FUNCTION__ . '();';
}

function syncSingleProduct(array $product, array $mapping, AkeneoClient $client): void
{
    $sku     = $product['identifier'];
    $enabled = $product['enabled'];

    $existing = CIBlockElement::GetList(
        [],
        ['IBLOCK_ID' => CATALOG_IBLOCK_ID, 'PROPERTY_CML2_ARTICLE' => $sku]
    )->Fetch();

    $el     = new CIBlockElement();
    $fields = [
        'IBLOCK_ID' => CATALOG_IBLOCK_ID,
        'ACTIVE'    => $enabled ? 'Y' : 'N',
        'NAME'      => getAkeneoValue($product['values']['name'] ?? [], 'ru_RU'),
    ];

    $properties = [];
    foreach ($mapping as $akeneoCode => $bitrixCode) {
        $value = getAkeneoValue($product['values'][$akeneoCode] ?? [], 'ru_RU');
        if ($value !== null) {
            if (in_array($bitrixCode, ['DETAIL_TEXT', 'PREVIEW_TEXT', 'NAME'])) {
                $fields[$bitrixCode] = $value;
            } else {
                $properties[$bitrixCode] = $value;
            }
        }
    }

    if ($existing) {
        $el->Update($existing['ID'], $fields);
        CIBlockElement::SetPropertyValuesEx($existing['ID'], CATALOG_IBLOCK_ID, $properties);
    } else {
        $fields['IBLOCK_SECTION_ID'] = resolveCategoryId($product['categories'][0] ?? null);
        $newId = $el->Add($fields);
        if ($newId) {
            CIBlockElement::SetPropertyValuesEx($newId, CATALOG_IBLOCK_ID, $properties);
        }
    }
}

function getAkeneoValue(array $values, string $locale): mixed
{
    foreach ($values as $entry) {
        if (($entry['locale'] === $locale || $entry['locale'] === null)
            && $entry['scope'] === null) {
            return $entry['data'];
        }
    }
    return null;
}

Изображения скачиваются и сохраняются как MORE_PHOTO через CFile::MakeFileArray. Используем тегированное кэширование — повторно не загружаем уже скачанные файлы.

Как избежать дублирования данных?

Дублирование может возникать при повторном запуске агента, если товар частично не синхронизирован. Чтобы этого избежать, мы используем проверку по unique-идентификатору (CML2_ARTICLE) и блокируем повторную синхронизацию того же товара в течение одного запуска. Также логируем все операции и делаем дедупликацию по идентификатору Akeneo.

Что делать при ошибках синхронизации?

Все ошибки логируются в журнал событий Битрикс. Мы подключаем мониторинг и отправку уведомлений администратору. При необходимости доступен механизм повторного запуска синхронизации для конкретных товаров через админ-панель. Клиент всегда может отследить статус последней синхронизации.

Синхронизация категорий: рекурсивный алгоритм

Иерархия категорий Akeneo синхронизируется в разделы инфоблока. Рекурсивно создаём разделы через CIBlockSection::Add. Соответствие akeneo_code ↔ IBLOCK_SECTION_ID храним в HL-блоке. Учитываем логику ACTIVE и SORT.

Сроки и стоимость

Стоимость рассчитывается индивидуально после аудита. Свяжитесь с нами — оценим проект в течение двух рабочих дней.

Что входит в работу

Почему выбирают нас

Мы — команда с 10+ летним опытом разработки на 1С-Битрикс и Битрикс24. Сертифицированные специалисты. Выполнили более 50 проектов по интеграции PIM-систем. Гарантируем стабильную работу синхронизации и оперативную поддержку. Закажите интеграцию под ключ — получите надёжное решение для вашего каталога. Свяжитесь с нами для аудита вашего ассортимента.

В отличие от стандартной интеграции через CommerceML, которая ограничена номенклатурой и ценами, интеграция Akeneo через REST API позволяет передавать богатые атрибуты, медиа и переводы.

CommerceML: почему стандартный обмен — и спасение, и ловушка

Стандартный обмен через CommerceML 2.0 на типовой «Управлении торговлей» или «Комплексной автоматизации» заводится за день-два. Товары, цены, остатки, заказы — всё через XML-файлы по расписанию. Для магазина на 3 000 позиций с парой обновлений в сутки этого хватает с запасом. Но как только каталог перерастает 30 000 SKU, начинаются проблемы: интеграция 1С с Битрикс на больших объёмах требует нестандартных решений.

Почему CommerceML тормозит на каталогах свыше 100 000 товаров?

bitrix_1c_exchange.php генерирует XML на стороне Битрикса, 1С забирает и парсит. На больших каталогах парсер активно пишет во временную таблицу b_xml_tree — MySQL может встать колом. Мы видели проект, где стандартный обмен 180 000 товаров занимал 6 часов и полностью блокировал сервер: ни админка, ни фронт не открывались. Решение — инкрементальный обмен. В настройках узла обмена на стороне 1С ставим «Выгружать только изменённые» и разбиваем выгрузку на пакеты по 500–1000 элементов. На стороне Битрикса — кастомный обработчик, который не пересоздаёт b_xml_tree каждый раз, а работает через CIBlockXMLFile::ReadXMLToDatabase() с контролем порций. Каталог в 200 000 SKU обновляется за 8–12 минут.

Ещё один подводный камень — EXTERNAL_ID. При повторном импорте Битрикс сопоставляет элементы инфоблоков по внешнему коду. Если в 1С товар удалён и создан заново с новым GUID, на сайте появляется дубль — со старыми отзывами на одной карточке и нулевыми на другой. Лечится жёсткой привязкой по артикулу через кастомный обработчик события OnBeforeIBlockElementAdd.

Как избежать дублей при повторном импорте?

Привязываем товары не по GUID, а по артикулу. Проверка на уникальность выполняется до записи в инфоблок — дубликаты исключаются даже после пересоздания номенклатуры в 1С. На одном проекте с 50 000 товаров такая схема предотвратила появление 300 дублей в месяц и сэкономила контент-менеджерам около 20 часов ручной чистки.

Кастомные конфигурации 1С: когда CommerceML пасует

«У нас типовая конфигурация» — говорит каждый второй клиент, а потом мы открываем базу и видим 200 кастомных обработок, переименованные реквизиты и самописные документы реализации. CommerceML работает с фиксированной структурой XML. Если в 1С изменили состав реквизитов номенклатуры или добавили нестандартный документ — обмен молча пропускает эти данные. Или падает с непонятной ошибкой в журнале регистрации 1С, а в Битрикс ничего не пишется.

В таких случаях делаем кастомную выгрузку. На стороне 1С пишем обработку, которая формирует JSON (парсить быстрее, отлаживать проще) и отправляет через REST API Битрикса. Полный контроль: какие поля берём, как трансформируем, что делаем при конфликте. Для тяжёлых случаев — D7 API с прямой работой через \Bitrix\Catalog\ProductTable и \Bitrix\Sale\Order.

Когда нужен кастомный REST вместо CommerceML?

Кастомный REST оправдан при:

• нестандартных реквизитах номенклатуры;
• множественных типах цен (розница, опт, дилерская, акционная, региональная, валютная) — стандартный обмен передаёт только один тип;
• мультискладе с разными остатками и необходимостью выбора склада на сайте.

Цены, остатки и мультисклад

Стандартный обмен умеет передавать один тип цены. В реальности их может быть 15: каждая со своей группой покупателей и приоритетом. Маппинг между ценовыми группами 1С и группами пользователей Битрикса — отдельная инженерная задача. Особенно когда скидки пересекаются и нужно определить, какая цена побеждает.

Мультисклад добавляет ещё один слой: товар есть на складе в Москве, нет в Питере, и «под заказ» в Новосибирске. На сайте нужно показать наличие по каждой точке, подключить выбор пункта самовывоза и рассчитать доставку от ближайшего склада, где товар физически есть. Стандартный модуль складского учёта Битрикс (catalog.store) справляется с отображением, но логику «откуда отгружать» пишем отдельно. Для одного производственного холдинга мы реализовали кастомный агрегатор остатков, который за 2 секунды рассчитывал баланс по 8 складам — это сократило количество ошибок отгрузки на 80%.

Заказы и документооборот

Заказ с сайта улетает в 1С, формируется реализация, товар резервируется. Статусы возвращаются обратно. Главный нюанс — частичная отгрузка: клиент заказал 5 позиций, 3 есть на складе, 2 придут через неделю. 1С формирует два документа реализации. Битрикс из коробки не умеет разбивать один заказ на несколько отгрузок — дорабатываем обработчик OnSaleOrderSaved, который создаёт дочерние заказы и синхронизирует статусы по каждому.

Документы в личном кабинете — счета, акты, накладные из 1С — отдаём через REST, PDF генерируется на стороне 1С и кэшируется на CDN. Покупатель скачивает не из 1С напрямую (это убило бы сервер), а из кэша.

Рекомендация CommerceML: пакетный импорт с контролем порций снижает нагрузку на MySQL и исключает блокировки (источник: Wikipedia).

Мониторинг: не «настроил и забыл»

Обмен может сломаться тихо: скрипт отработал, ошибок в логе нет, но 200 товаров не обновились из-за невалидного UTF-8 в названии. Или 1С поменяла формат даты в очередном обновлении — все цены пришли нулевыми.

Минимальный набор, который ставим на каждом проекте:

• Алерт в Telegram, если время обмена выросло в 3+ раза от среднего.
• Проверка расхождения остатков: скрипт сравнивает b_catalog_product.QUANTITY с тем, что отдаёт 1С, и оповещает при дельте больше 5 %.
• Дашборд: последняя синхронизация, количество обработанных позиций, очередь, ошибки.

Для проектов с высокой нагрузкой добавляем асинхронные очереди на Redis или RabbitMQ. Обмен не блокирует веб-сервер, данные не теряются при кратковременном падении 1С. На одном интернет-магазине с оборотами 2 млн заказов в год мы внедрили такую схему — время восстановления после сбоев сократилось с 3 часов до 10 минут.

Связка с Битрикс24 для автоматизации документооборота

Если кроме сайта есть корпоративный портал на Битрикс24 — связываем и его. Контрагенты из CRM летят в 1С, счета из 1С появляются в карточке сделки. Менеджер видит дебиторку и взаиморасчёты, не переключаясь между окнами. Закрыли сделку — документы сформировались сами.

Оплата поступила в 1С → логист получает задачу на отгрузку в Битрикс24. Товар отгружен → менеджер видит уведомление. Автоматические задачи по событиям из 1С — через вебхуки Битрикс24 REST API. Такая связка сокращает ручной ввод на 70% и исключает забытые отгрузки.

Как мы настраиваем интеграцию: пошаговый процесс

1. Аудит конфигурации 1С. Смотрим структуру справочников, документов, реквизитов. Выявляем кастомные доработки. Оцениваем объём данных (количество SKU, заказов, складов).
2. Проектирование схемы обмена. Согласовываем набор данных: товары, цены, остатки, заказы, документы. Определяем интервал синхронизации и механизм — CommerceML или кастомный REST.
3. Настройка стандартного обмена. Настраиваем CommerceML, пакетный режим, привязку по артикулу. Проверяем корректность передачи данных на тестовом каталоге.
4. Расширенная интеграция. Для сложных конфигураций пишем кастомные обработчики на стороне 1С и Битрикса. Подключаем мультисклад, множественные цены, частичную отгрузку.
5. Мониторинг и гарантия. Устанавливаем алерты, дашборд, документацию. Обучаем операторов. После запуска — гарантийная поддержка.

Сроки и что входит в работу

Результат работы включает: документированную схему обмена, настроенные сценарии синхронизации, дашборд мониторинга, обучение операторов и гарантийную поддержку после запуска. Стоимость рассчитывается индивидуально — она зависит от сложности конфигурации 1С, объёма каталога и необходимой степени автоматизации. Оценим ваш проект за 1 день — пишите, обсудим. Закажите интеграцию — получите стабильный обмен за 1–2 недели.

Мы провели более 50 интеграций 1С для интернет-магазинов и производственных компаний. Средний опыт команды — 7 лет, у нас есть сертифицированные специалисты 1С-Битрикс. Наш опыт гарантирует, что обмен не сломается в первый же месяц и будет стабильно работать годами. Например, на проекте с каталогом 50 000 товаров автоматизация обмена сэкономила клиенту около 200 000 рублей в год на операционных затратах.

Свяжитесь с нами для бесплатного аудита вашей конфигурации 1С — найдём узкие места и предложим оптимальное решение.