Каталог товаров Битрикс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С, и рядом с каждой старой позицией появляется новая.
- Товар есть, а цены и остатков нет. Товары и предложения идут разными файлами, поэтому
import.xmlмог дойти, аoffers.xmlнет. Смотрю журнал обмена и порядок шагов, а не сам каталог. - Структура не обновляется. Если группы в 1С переставили, обмен по изменениям может не поднять всё дерево. После таких правок запускаю полную выгрузку.
- Правки руками пропадают. Поля, которые приходят из 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 вызовов, паузах между пакетах и повторе при ошибке.