1С Битрикс · 9 мин чтения

Каталог товаров Битрикс24: цены, разделы и загрузка из 1С

Каталог товаров Битрикс24 это справочник позиций в CRM, из которого менеджеры собирают товарные строки в сделках, предложениях и счетах. Пока в нём несколько десятков позиций, его ведут руками. Когда цены и остатки живут в 1С, главный вопрос другой: в какой системе хозяин данных и как сделать так, чтобы менеджер не правил одну и ту же цену в двух местах. Ниже я разбираю, как раскладываю разделы, что делаю с типами цен и НДС, какие способы загрузки из 1С бывают и где на практике всё ломается.

Товарный каталог CRM: что в нём хранится и кто ведёт данные

Позиция каталога это набор полей: название, артикул, раздел, цена, валюта, ставка НДС, единица измерения, описание и картинки. Строка товара в сделке берёт значения из каталога в момент добавления и дальше живёт своей жизнью, поэтому правка цены в каталоге, как правило, не переписывает уже созданные сделки и счета. Для истории это удобно, но ошибку в цене приходится ловить до того, как менеджеры начали её использовать.

Первое решение, которое я фиксирую в проекте, это мастер-система. Вариантов три:

  • 1С ведёт данные. Цены, остатки и разделы приходят обменом, а в Битрикс24 каталог только читают. Правки руками затрутся при следующем обмене.
  • Битрикс24 ведёт данные. Каталог небольшой и меняется редко, 1С в схеме не участвует.
  • Смешанная схема. Номенклатура и цены идут из 1С, а описания и картинки для коммерческих предложений дописывают в Битрикс24. Работает только если обмен не перезаписывает эти поля, и такое разделение я проверяю на тестовой выгрузке.

Второй момент: набор возможностей каталога зависит от версии (облако или коробка) и от тарифа. Складской учёт, число типов цен и доступные способы обмена с 1С отличаются, поэтому справку по конкретной лицензии я смотрю до начала работ. Если тариф ещё не выбран, разумнее решить его раньше, чем строить обмен. С подбором лицензии Битрикс24 под конкретную задачу я помогаю до того, как в каталог загружена первая позиция.

Разделы каталога и вариации товаров

Дерево разделов я строю по тому, как менеджер ищет товар, а не по тому, как номенклатуру группирует бухгалтерия. В 1С папок может быть шесть уровней, а менеджеру в сделке нужны два-три: он вводит название или артикул и выбирает из списка. Мой ориентир такой: не глубже трёх уровней, в разделе не больше нескольких сотен позиций, в названиях никаких служебных префиксов вроде «Х_Архив».

При обмене по CommerceML группы из 1С приходят в файле import.xml вместе с товарами. Поэтому глубину дерева лучше сократить в самой 1С или заранее договориться, какие группы вообще выгружаются на портал.

Отдельная тема это вариации. Футболка в пяти размерах и четырёх цветах должна быть одним товаром с вариациями, а не двадцатью отдельными позициями. В 1С это характеристики номенклатуры, в выгрузке они приходят в offers.xml как предложения. Как именно они лягут в вариации каталога, я проверяю на тестовой выгрузке из 10-20 позиций до полной загрузки: перезапустить маленький тест дешевле, чем чистить двадцать тысяч созданных позиций.

Артикул и внешний код играют разные роли. Артикул нужен менеджеру, внешний код (идентификатор из 1С) нужен обмену. Сопоставление идёт по идентификатору, а не по названию. Если каталог до обмена наполняли руками, при первой загрузке появятся дубли: система не знает, что «Кабель ВВГ 3х2,5» в каталоге и в 1С это одна и та же позиция. Выхода два: очистить каталог перед первым обменом или проставить вручную созданным позициям внешний код из 1С.

Бесплатный материал

🎁 Полезный скрипт в подарок

Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.

Без спама. Отписка в 1 клик.

Типы цен, валюта и НДС в товарном каталоге

В 1С типов цен обычно несколько: розничная, оптовая, закупочная, цена для партнёров. В offers.xml они приходят блоком типов цен, а у каждого предложения есть цены с идентификатором типа. Как типы из 1С легли на типы цен каталога, я проверяю отдельно, потому что перепутанные типы дают неправильные суммы во всех новых счетах.

Мои правила для цен:

  • Закупочную цену в каталог CRM не загружаю вообще. Менеджер видит поля товара в сделке, и маржа не должна быть у него перед глазами.
  • Менеджеру хватает того типа цены, по которому он выставляет счёт: чаще розничной, в B2B оптовой. Если у клиента несколько уровней цен, завожу под них отдельные типы, а не оставляю менеджеру считать скидку в уме.
  • Валюту храню исходную. Если товар в 1С оценён в юанях или евро, я не пересчитываю его в рубли в файле выгрузки: цена устареет при первом движении курса. Надёжнее пересчитывать уже в сделке по курсам, заданным на портале.
  • Ставку НДС беру из 1С, а не из памяти: ставки меняются законодательно, и зашитая вручную цифра рано или поздно расходится с учётом.

Самая частая ошибка с НДС выглядит так: 1С отдаёт цену с НДС, а в каталоге у товара стоит признак «НДС не включён в цену», и счёт получается больше на сумму налога. Я проверяю это на трёх позициях с разными ставками: считаю сумму строки руками и сравниваю с тем, что показала сделка. Тем же способом ловлю округление. 1С может хранить цену с четырьмя знаками после запятой, а счёт считать по двум, и на строке с количеством в тысячу единиц копейки уже заметно расходятся.

Загрузка из 1С в каталог: способы обмена и подводные камни

Какие способы бывают

На практике я выбираю из четырёх вариантов, и выбор определяется тем, где живёт каталог и как часто он меняется.

Способ Что переносит Кто запускает Когда беру
Импорт из файла (CSV или Excel) Товары и цены из подготовленной таблицы Человек, вручную Стартовая загрузка и небольшие каталоги
Обмен по CommerceML Разделы, товары, цены, остатки; заказы идут в обратную сторону 1С, по расписанию или вручную Каталог живёт в 1С и меняется каждый день
REST API со своим скриптом То, что описано в скрипте, включая нестандартные поля Cron или событие Нестандартная выгрузка, прайсы поставщиков
Готовое приложение из маркетплейса По описанию приложения По настройкам приложения Типовая связка, если версия 1С совпадает с заявленной

Про CommerceML стоит сказать подробнее, потому что именно тут больше всего путаницы. Файлы отправляет учётная система, а принимающая сторона их принимает, а не забирает по расписанию сама. Последовательность запросов из документации модуля «Интернет-магазин»: авторизация (type=catalog&mode=checkauth), инициализация (mode=init), отправка import.xml, отправка offers.xml, импорт товаров, импорт остатков. Точка входа на стороне сайта: /bitrix/admin/1c_exchange.php. На шаге инициализации принимающая сторона сообщает, принимает ли она архив zip и какой размер порции файла допустим, а большие выгрузки 1С режет на части по этому лимиту.

Оговорка: это описание коробочного модуля. Применима ли такая же схема к вашему порталу, зависит от версии (облако или коробка) и от тарифа, и выяснить это нужно первым делом, до того как программист 1С начнёт настраивать план обмена.

Что ломается на первой загрузке

  1. Дубли. Внешние коды вручную созданных позиций не совпадают с идентификаторами из 1С, и рядом с каждой старой позицией появляется новая.
  2. Товар есть, а цены и остатков нет. Товары и предложения идут разными файлами, поэтому import.xml мог дойти, а offers.xml нет. Смотрю журнал обмена и порядок шагов, а не сам каталог.
  3. Структура не обновляется. Если группы в 1С переставили, обмен по изменениям может не поднять всё дерево. После таких правок запускаю полную выгрузку.
  4. Правки руками пропадают. Поля, которые приходят из 1С, перезаписываются при следующем обмене. Заранее договариваюсь, какие поля закрыты для ручного редактирования, и говорю об этом менеджерам.

Проверка каталога после импорта

После каждой тестовой загрузки я прохожу один и тот же список:

  • сверяю число товаров по выгружаемым группам в 1С и в каталоге;
  • беру 20 случайных позиций и сравниваю название, артикул, раздел, цену и НДС;
  • открываю три позиции с вариациями и смотрю, что размеры и цвета не превратились в отдельные товары;
  • создаю тестовую сделку с этими позициями и сверяю итоговую сумму с 1С;
  • запускаю обмен второй раз без изменений в 1С: если число позиций выросло, значит, где-то не совпали внешние коды.

Автоматизация каталога через REST API: лимиты и синхронизация с прайсами

Стандартного обмена бывает мало. Типичные случаи: поставщик присылает прайс в Excel раз в сутки, наценка считается по правилам, которых нет в 1С, остатки надо подтягивать из отдельного склада. Тогда я пишу скрипт, который ходит в REST API портала через входящий вебхук. Права (scope) задаются именно у входящего вебхука, поэтому под скрипт создаю отдельный вебхук только с доступом к каталогу, а не с правами администратора.

Для товаров, разделов и цен в документации есть методы группы catalog. Часть старых методов CRM помечена в справке как устаревшая, например crm.deal.get с рекомендацией использовать crm.item.get. Поэтому перед началом работы я проверяю пометку DEPRECATED у тех методов, на которые собираюсь опираться, и новый код пишу на актуальных.

Основная сложность здесь не в самих методах, а в лимитах. По документации на момент написания статьи это выглядит так, но пороги вендор меняет, поэтому сверяйтесь со справкой:

  • Лимит работает по принципу «дырявого ведра». Когда счётчик превышает порог, следующий запрос блокируется со статусом 503 и кодом QUERY_LIMIT_EXCEEDED.
  • Для тарифов кроме «Энтерпрайз» это 2 запроса в секунду при пороге 50, для «Энтерпрайз» 5 запросов в секунду при пороге 250.
  • Лимит считается по IP: несколько приложений на одном сервере делят один лимит на общий портал.
  • Метод batch принимает до 50 вызовов в одном HTTP-запросе. Он сокращает число запросов, но не отменяет ограничение по ресурсоёмкости.
  • Списочные методы отдают по 50 записей, дальше идёт обход через start и признак next в ответе.
  • Второй лимит про суммарное время выполнения методов: при превышении приходит статус 429 и код OPERATION_TIME_LIMIT, а накопленное время видно в ключе time.operating в ответе.

Для прикидки: обновить 5000 цен по одному запросу на товар это 5000 запросов, при 2 запросах в секунду около 42 минут. Через batch по 50 вызовов это 100 запросов, около 50 секунд по числу запросов. Реальное время будет больше из-за лимита на ресурсоёмкость, поэтому в скрипте я делаю паузы, читаю time.operating и при ответе 429 или 503 жду и повторяю пакет, а не сыплю ошибками в лог.

Запускать такой скрипт для обычной задачи я предпочитаю как PHP-обработчик по cron на том же хостинге, где живёт сайт клиента: отдельный сервер не нужен. Если у клиента уже развёрнут n8n, ту же синхронизацию можно собрать сценарием, но n8n это отдельный сервер: его надо настроить, обновлять, продлевать сертификат и оплачивать помесячно, на обычном хостинге сайта он не запустится. Поэтому вариант с n8n я предлагаю вторым и только когда сервер уже есть.

Первичный разбор структуры каталога и схемы обмена я оформляю как консультацию, от 3 000 ₽. Стоимость самого проекта называю после разбора, потому что она зависит от версии портала, состояния 1С и объёма каталога.

Условия и возможности Битрикс24 и 1С меняются, поэтому перед запуском я уточняю их в документации самих сервисов.

Частые вопросы

Можно ли вести каталог товаров Битрикс24 без 1С?

Можно. Если позиций немного и цены меняются редко, хватает ручного ввода и импорта из файла. Обмен с 1С начинает окупаться, когда цены и остатки меняются каждый день и правка в двух местах превращается в источник ошибок в счетах.

Почему после обмена с 1С в каталоге появились дубли?

Чаще всего причина в том, что каталог наполняли вручную до обмена. Сопоставление идёт по внешнему коду из 1С, а не по названию, и у ручных позиций этот код другой или пустой. Исправляется очисткой каталога перед первой выгрузкой либо проставлением внешних кодов вручную созданным товарам.

Какую цену из 1С загружать в каталог?

Ту, по которой менеджер выставляет счёт: обычно розничную, в B2B оптовую. Закупочную цену в каталог CRM я не загружаю, чтобы маржа не оказалась в поле зрения каждого менеджера. Если типов цен несколько, соответствие типов 1С и каталога проверяю на тестовой выгрузке отдельным шагом.

Что будет, если обновлять тысячи товаров через REST?

Портал не упадёт, но вы упрётесь в лимиты: при превышении порога придёт статус 503 и код QUERY_LIMIT_EXCEEDED, а при большом накопленном времени выполнения статус 429 и код OPERATION_TIME_LIMIT. Решение состоит в пакетах через batch по 50 вызовов, паузах между пакетах и повторе при ошибке.

Есть задача?

Обсудим вашу задачу

Оставьте заявку — обсудим объём работ и следующий шаг.

Продолжая пользование настоящим сайтом Вы выражаете своё согласие на обработку Ваших персональных данных (файлов куки) с использованием Yandex.Metrika.
Понятно