Почему путаница возникает ещё на этапе брифа
Заказчик формулирует задачу: «Нужно связать сайт с 1С, чтобы товары и заказы ходили автоматически». В голове у него один «программист по 1С», который «сделает всё». На практике специалистов два, и они работают в разных технологических средах.
Корень путаницы — в названиях. В марте 2007 года фирма «1С» и компания «Битрикс» объявили о создании совместного предприятия «1С-Битрикс» с равным участием сторон 50/50. Продукт «Битрикс: Управление сайтом» был переименован в «1С-Битрикс: Управление сайтом». То есть общее слово «1С» в двух названиях — это следствие сделки, а не общий стек технологий и не один и тот же исполнитель.
Дальше путаницу закрепляет само слово «1С». В разговоре оно означает три разные вещи: компанию-разработчика, платформу «1С:Предприятие» и конкретную конфигурацию — например, «Управление торговлей» с установленным модулем обмена. Когда заказчик говорит «у нас 1С», он почти никогда не уточняет, какая именно конфигурация, какой релиз и типовая ли она. А для оценки работ это ключевые вопросы.
Фраза «интеграция с 1С» звучит как одна задача, хотя внутри неё минимум четыре:
- сформировать выгрузку в учётной системе;
- доставить её на сайт по протоколу;
- принять и разложить данные так, чтобы каталог, цены и остатки действительно работали;
- отдать заказы обратно и корректно обновлять их состояние.
Первая задача — зона 1С-программиста. Остальные три — зона разработчика сайта. Когда зоны не разделены, начинается перетягивание каната: 1С-ник говорит «в базе всё есть, я выгружаю», веб-разработчик отвечает «в XML этого поля нет, мне нечего показать». Обе фразы могут быть правдой одновременно.
Два стека, два языка, две среды
Разница не в квалификации, а в инструментах. Я не смогу быстро починить учётную систему, а 1С-программист не сможет быстро починить компонент каталога — и это нормально.
| Признак | Программист 1С | Программист 1С-Битрикс |
|---|---|---|
| Среда | «1С:Предприятие», конфигуратор | Веб-сервер, PHP, MySQL, файловая структура сайта |
| Язык | Встроенный язык 1С | PHP, JavaScript, SQL, HTML/CSS |
| Основные объекты | Справочники, документы, регистры, планы обмена | Инфоблоки, свойства, торговые предложения, компоненты, события |
| Что считает «данными» | Проведённый документ и записи в регистрах | Элемент инфоблока, цену, остаток, заказ |
| Где ищет причину сбоя | Журнал регистрации, журнал обменов и ошибок, отборы выгрузки | Ответ скрипта обмена, файлы выгрузки, логи PHP и веб-сервера |
| Что ломается после обновлений | Обновление типовой конфигурации | Обновление модулей CMS и версии PHP |
| Единица работы с идентификаторами | GUID объекта | Внешний код XML_ID |
Последняя строка — не формальность. Именно на ней держится вся интеграция: 1С оперирует GUID, сайт хранит этот GUID как внешний код. Пока эта связка стабильна, обмен обновляет товары. Как только GUID меняется — на сайте появляется новый товар вместо обновления старого.
Граница ответственности: мастер-система для каждого поля
Главное правило, которое снимает большинство споров: у каждого данного есть одна мастер-система — та, где значение создаётся и редактируется. Остальные получают копию и не имеют права её «поправлять».
| Данные | Мастер-система | Кто отвечает за корректность |
|---|---|---|
| Номенклатура, наименования, артикулы, штрихкоды | 1С | 1С-программист формирует состав и значения; разработчик сайта принимает и раскладывает в каталог |
| Характеристики (варианты товара) | 1С | 1С-программист выгружает предложения; разработчик сайта настраивает инфоблок торговых предложений |
| Цены | 1С | 1С-программист выгружает нужные виды цен по соглашению; разработчик сайта сопоставляет внешние коды типов цен |
| Остатки и резервы | 1С | 1С-программист выгружает количество по складам; разработчик сайта включает складской учёт и показывает доступное количество |
| Фото и файлы товаров | 1С, если ведутся в учёте | 1С-программист передаёт файлы в пакете; разработчик сайта сохраняет и обрабатывает изображения |
| Структура разделов каталога | Решается на проекте | Владелец структуры; второй не перестраивает её вручную |
| Заказ, оформленный покупателем | Сайт | Разработчик сайта создаёт заказ и отдаёт его полностью |
| Состав заказа после обработки менеджером | 1С | 1С-программист ведёт документ; сайт принимает изменения |
| Оплаты и отгрузки | 1С | 1С-программист проводит документы; разработчик сайта обновляет состояние заказа |
| Контрагенты и договоры | 1С | Только 1С-программист |
| Контент, страницы, баннеры, SEO-поля, URL, редиректы | Сайт | Только разработчик сайта |
| Скидки, купоны, промо-механики | Решается на проекте | Один владелец расчёта, иначе сумма в корзине и в счёте разойдётся |
Две строки я специально оставил «решается на проекте» — это и есть настоящие предметы переговоров. Если скидки считает сайт, а 1С пересчитывает их по своим правилам, покупатель увидит одну сумму, а в счёте получит другую.
И ещё один факт, который нужно проговорить с заказчиком до старта: правки товаров на сайте не регистрируются в 1С как изменения. В официальной документации это описано прямо: удаление или редактирование товаров на сайте никак не фиксируется в 1С, при обмене выгружаются изменения, сделанные именно в 1С с момента последней выгрузки. Поэтому «мы поправили описание в админке, а после обмена всё вернулось» — это не баг, это следствие того, кто мастер.
Кто инициирует обмен: 1С — клиент, сайт — сервер
В штатном обмене инициатором всегда выступает «1С:Предприятие». Это зафиксировано в описании протокола на сайте фирмы «1С» и не зависит от направления данных.
1С обращается к служебному скрипту на сайте /bitrix/admin/1c_exchange.php и ведёт с ним диалог короткими HTTP-запросами. Авторизация — HTTP Basic, логин и пароль берутся из настроек обмена в 1С. Параметр type задаёт направление, mode — шаг. Сайт отвечает простым текстом: success, progress или failure с описанием ошибки. Если произошла необрабатываемая ошибка уровня ядра продукта или SQL-запроса, сайт вернёт HTML — и 1С покажет невнятное «получен неизвестный статус импорта».
Из коробки работают четыре вида обмена:
type=catalog— товары, разделы, свойства, торговые предложения, типы цен, склады, остатки;type=reference— пользовательские справочники, которые на сайте становятся highload-блоками;type=sale— заказы в обе стороны, а также контрагенты и пользователи.
Отсюда два практических вывода, которые я всегда проговариваю: расписание живёт в 1С, а не в админке сайта; и если ночью «ничего не приехало», первым делом смотрят, запускался ли обмен в 1С.
Важная оговорка, чтобы не создавать миф. Асимметрия — свойство штатного механизма. У платформы «1С:Предприятие» есть автоматически формируемый REST-интерфейс на протоколе OData версии 3.0, который позволяет сторонним системам читать и менять данные 1С по HTTP. В такой схеме инициатором может быть сайт. Но это уже другая технология и отдельная разработка, а не галочка в настройках.
Диалог по каталогу: пошагово
mode=checkauth. 1С передаёт логин и пароль. Сайт отвечает тремя строками:success, имя cookie, значение cookie. Все последующие запросы 1С отправляет с этой cookie. В обмене каталогом сайт дополнительно возвращаетtimestamp— время начала сеанса, которое понадобится на шаге деактивации.mode=init. Сайт сообщает две вещи:zip=yesилиzip=no(умеет ли распаковывать архивы) иfile_limit— максимальный размер файла в байтах за один запрос. Если файл больше, 1С обязана разделить его на фрагменты.mode=file&filename=<имя>. Содержимое файла или его части передаётся в теле POST. Сайт дописывает контент в файл с указанным именем и отвечаетsuccess. Запросов может быть много.mode=import&filename=<имя>. Самый долгий шаг. Сайт обрабатывает порцию и отвечаетprogressсо статусом, 1С повторяет тот же запрос — и так доsuccess. Внутри этого одного шага сайт выполняет целый набор операций: распаковка архива, создание временных таблиц, чтение файла в них, индексация, импорт метаданных, импорт разделов, пересчёт дерева, импорт товаров, завершение. Прогресс хранится в сессии, поэтому «сброшенная» сессия означает начало импорта с первого шага.mode=deactivate×tamp=<время>. Сайт деактивирует товары и разделы, не затронутые в текущем сеансе: время последнего изменения сравнивается сtimestamp, полученным при авторизации. Шаг выполняется только при полной выгрузке; при выгрузке изменений его нет.mode=complete. Служебное завершение процедуры импорта.
Условный вид диалога:
GET /bitrix/admin/1c_exchange.php?type=catalog&mode=checkauth
success
<имя cookie>
<значение cookie>
GET /bitrix/admin/1c_exchange.php?type=catalog&mode=init
zip=yes
file_limit=<размер в байтах>
POST /bitrix/admin/1c_exchange.php?type=catalog&mode=file&filename=import.xml
success
GET /bitrix/admin/1c_exchange.php?type=catalog&mode=import&filename=import.xml
progress
<текущий статус обработки>
Файлы обмена сайт складывает в служебный каталог загрузок — по умолчанию /upload/1c_catalog/. Именно там лежит доказательная база для любого спора «чья ошибка».
Диалог по заказам
Здесь данные отдаёт сайт, но инициатор тот же — 1С.
mode=checkauthиmode=init— авторизация и согласованиеzipиfile_limit.mode=query— 1С просит заказы, сайт формирует и отдаёт XML в формате CommerceML 2.mode=success— 1С подтверждает, что заказы успешно получены и записаны.mode=file&filename=<имя>— теперь уже 1С загружает на сайт файл с изменениями по заказам. Сайт отвечаетsuccess, в следующих строках могут быть замечания по загрузке.
Что происходит с заказом по пути — это то, что заказчики узнают обычно уже после запуска:
- при передаче в 1С заказу присваивается категория «Заказ с сайта», записываются номер и дата, с которыми он оформлен на сайте;
- контрагент ищется по ИНН или по наименованию — в зависимости от настроек загрузки;
- договор ищется среди существующих договоров клиента с признаком ведения взаиморасчётов по заказам; если ни один не найден — создаётся новый;
- загружаются все свойства заказа, переданные с сайта; они ищутся в 1С по наименованию, и если свойства с таким наименованием нет — оно создаётся автоматически с типом строка или число;
- заказ может модифицироваться в 1С, и эти изменения выгружаются на сайт;
- состояния по оплате и отгрузке передаются на сайт только при полном выполнении операции — полной оплате и полной отгрузке. До этого момента заказ считается неоплаченным и неотгруженным;
- если в 1С пытаются изменить заказ, по которому уже прошла оплата или отгрузка, на сайт он как изменённый не загрузится, и пользователь получит сообщение.
Два последних пункта объясняют самые частые претензии: «клиент внёс предоплату, а в личном кабинете всё ещё не оплачено» и «менеджер поправил заказ в 1С, а на сайте старая сумма». Это не поломка, это правила протокола. Их нужно знать до того, как обещать заказчику «всё будет синхронно».
Что лежит в файлах обмена и почему это важно для разделения работ
Формат — CommerceML 2, XML-стандарт обмена коммерческой информацией. Вторая редакция стандарта была принята решением совета директоров НП «Стандарты электронного обмена информацией» 9 декабря 2003 года; партнёрство ликвидировано в 2011 году, после чего более поздние редакции XSD и логическое описание схемы публикует «1С», сохраняя преемственность. Схема версионируется: в реальных выгрузках встречаются атрибуты ВерсияСхемы вроде 2.08 и 2.09, пространства имён — urn:1C.ru:commerceml_2 и urn:1C.ru:commerceml_210.
Данные распределены по файлам:
| Файл | Что содержит |
|---|---|
import.xml | Разделы, товары, группы маркировки, размеры, типы цен, склады, свойства товаров, единицы измерения |
offers.xml | Торговые предложения и их свойства |
prices.xml | Цены предложений |
rests.xml | Остатки предложений |
documents.xml | Документы, в том числе заказы |
contragents.xml | Контрагенты |
references.xml | Пользовательские справочники, которые на сайте становятся элементами highload-блоков |
Модуль обмена выгружает архив со структурой: корневой import.xml с разделами, типами цен, складами и единицами измерения; папка с файлами товаров, предложений, цен и остатков; папка со свойствами товаров и предложений; references.xml для справочников. Папку с картинками рекомендуется называть import_files.
Три вещи из документации, которые прямо влияют на работу:
Порядок важен. При пакетной выгрузке информация, на которую ссылается объект, должна быть уже загружена: к моменту загрузки товаров на сайте должны быть группы, свойства и единицы измерения, а к моменту загрузки предложений — товары.
Имена файлов рекомендуется делать уникальными, добавляя случайное значение перед расширением — это повышает безопасность передачи. Поэтому в каталоге обмена вы видите import_0a1b2c.xml, а не просто import.xml.
Сопоставление идёт по внешнему коду. Разделы и товары из XML сопоставляются с существующими на сайте по XML_ID, свойства и их значения — по GUID свойства и GUID значения. Если объекта с таким XML_ID нет, он создаётся; если есть — сравниваются поля. При включённой опции контрольных сумм неизменившийся товар только «отмечается» и пропускается: значение берётся из узла <НомерВерсии>, а если узла нет — вычисляется контрольная сумма по данным товара. Это главный механизм ускорения повторных обменов.
При импорте метаданных сайт создаёт служебные свойства каталога с префиксом CML2_ — например, CML2_ARTICLE для артикула и CML2_BAR_CODE для штрихкода. Разработчик сайта решает, какие из них показывать в карточке, какие вывести в фильтр, а какие скрыть. Само это не делается.
Отдельно стоит знать, куда попадают описания из 1С — от этого напрямую зависит контент карточки и SEO:
| Узел CommerceML | Куда попадает на сайте |
|---|---|
<Описание> | Подробное описание товара |
<ОписаниеВФорматеHTML> в значениях реквизитов | Описание товара в формате HTML |
<Полное наименование> в значениях реквизитов | Анонс товара |
<Картинка> | Изображения; первый элемент считается основной картинкой |
<ОписаниеФайла> | Описание файла или картинки в формате адрес#описание |
<Вес>, <Ширина>, <Длина>, <Высота> | Габариты и вес товарной позиции |
Если заказчик хочет, чтобы описания для поиска писались на сайте, а не приезжали из учёта, — это надо решить до первого обмена и зафиксировать в таблице мастер-систем. Иначе SEO-тексты будут регулярно затираться выгрузкой.
Ещё деталь, которая объясняет «лишнюю позицию» в заказах: доставка передаётся служебной позицией с идентификатором ORDER_DELIVERY и наименованием «Доставка заказа», с признаком вида номенклатуры «Услуга».
Модуль обмена в 1С: почему 7.x и 8.x — это разный бюджет поддержки
Клиентская часть протокола уже написана. Для торговых конфигураций выпускается модуль обмена, который устанавливается в саму 1С, а не на сайт. Модули разработаны для «Управление торговлей», «Комплексная автоматизация», «ERP Управление предприятием», «Управление нашей фирмой», «Управление производственным предприятием»; отдельно есть модуль для «Розницы».
Разница между поколениями принципиальная, и она про стоимость владения, а не про удобство.
Версии 7.x встраиваются в конфигурацию. Порядок установки по документации такой: сделать архивную копию базы, открыть конфигурацию, включить возможность изменения через «Настройку поддержки», выбрав для нужных объектов «Объект поставщика редактируется с сохранением поддержки», выполнить сравнение-объединение с файлом .cf, подключить подсистему обмена, сохранить конфигурацию и обновить конфигурацию базы данных, затем обновить данные информационной базы. Пользователям нужно добавить роль по работе с БУС. Есть и жёсткие требования совместимости: модули 6.5.x и 7.x работают только с версией модуля sale не ниже 17.0.1, а соответствие со службами доставки — не ниже 17.0.21. Развитие и обновление старых версий 7.0.x, включая исправление ошибок, прекращено.
Версии 8.x подключаются как расширение конфигурации. Установка: архивная копия базы, запуск в монопольном режиме, затем «Администрирование → Печатные формы, отчёты и обработки → Расширения», кнопка «Добавить», выбор файла .cfe, снятие флага «Безопасный режим» и перезапуск сеанса. Код типовой конфигурации не меняется. Раздел настроек видят администратор и пользователи с правом «(1С-Битрикс: Управление сайтом) Администратор». Если используется распределённая информационная база, модуль ставится в подчинённый узел.
Модули привязаны к конкретным решениям: например, 8.0.x «Интернет-магазин + 1С» предназначен для «Розницы» ред. 2.3, а для «Управление торговлей» ред. 11.5 в документации описан модуль 8.1.x.
Вывод для заказчика простой: если вам предлагают поставить 7.x на типовую конфигурацию, вы покупаете не только настройку, но и будущую работу при каждом обновлении учёта. Для новых проектов я прошу сторону 1С использовать ветку 8.x.
Зона ответственности 1С-программиста
Чтобы не было ощущения, что «на сайте всё делают, а в 1С только галочку ставят», — вот реальный объём работ на стороне учёта.
Состав и структура выгрузки. Каждый выгружаемый каталог — это отдельный инфоблок на сайте. Для каждого каталога настраиваются свои параметры, отборы по выгружаемой информации и, при необходимости, пользовательское дерево групп: оно позволяет собрать на сайте свою структуру разделов, не меняя иерархию номенклатуры в 1С, и включить один товар в несколько групп.
Тонкая настройка по вкладкам. На вкладке товаров включаются выгрузка самих товаров, картинок и файлов, значений свойств, штрихкодов, планируемой даты поступления. Там же задаются соответствия полей номенклатуры полям XML — в какое поле выгружается какая информация; служебные поля XML редактировать нельзя, а значения могут задаваться в том числе по произвольному алгоритму. Именно так на сайт попадают поля, которых нет в типовой выгрузке. На вкладке предложений отдельно включаются характеристики. На вкладке свойств выбирается, какие свойства выгружать; списочные можно отправлять в highload-справочники, а строковые и числовые — выгружать как справочник.
Остатки и цены. Остатки выгружаются только по указанным складам; есть отдельные флаги «Выгружать остатки по магазинам» (в разрезе складов) и «Выгружать остатки с учётом резерва». Цены выгружаются только по указанным прайсам. Если сайт должен показывать «В наличии» с учётом резерва, а не физическое наличие, — это начинается здесь, а не в шаблоне карточки.
Обязательные условия в самой базе. В 1С должны существовать виды номенклатуры «Товар» и «Услуга» — без них обмен падает с ошибкой «Не удалось найти вид номенклатуры». Реквизит «вид номенклатуры» у выгружаемых позиций должен быть именно «Товар». Если в конфигурации обязательны к заполнению реквизиты контрагента — группа доступа, регион доставки, основная форма оплаты — заказ не загрузится: 1С не сможет создать контрагента.
Отборы, а не выбор полей. Классическая ошибка: на вкладке выгрузки товаров отмечают поля, думая, что выбирают состав выгрузки. Настраивается именно фильтр, и если поле отмечено, значение фильтра должно быть задано. Иначе получается «Изменения товаров не зарегистрированы. Выгрузка товаров не произведена».
Расписание и контроль. Обмен запускается вручную или по расписанию на стороне 1С; в модуле есть журнал обменов, журнал ошибок и зарегистрированные изменения. Если база файловая, а не клиент-серверная, автоматический запуск по расписанию нужно проверять отдельно — иначе получается «обмен работает, только когда бухгалтер открыл 1С».
Картинки. Они выгружаются при первой полной выгрузке, а дальше — только новые и изменённые. Если первая выгрузка прошла без картинок, в модуле есть принудительная полная выгрузка изображений. Это зона 1С, не сайта.
Зона ответственности разработчика 1С-Битрикс
Моя часть работы, даже когда доступа к конфигуратору 1С нет.
Проверка редакции. Форма «Интеграция с 1С» недоступна в редакциях «Старт» и «Стандарт». В «Малом бизнесе» доступен только один вид цены и невозможно разнести остатки по складам: импорт данных по складам возвращает ошибку, если складов больше разрешённого. Несколько типов цен — начиная с «Бизнес». Это проверяется первым делом, иначе окажется, что принимать данные нечем или некуда.
Настройки на стороне сайта. Форма находится в «Магазин → Настройки → Интеграция с 1С» и содержит четыре закладки: «Каталог», «Экспорт каталога», «Заказы», «Профили обмена». Ключевое, что я задаю там:
- тип инфоблока и привязка вновь создаваемых инфоблоков к сайтам;
- загрузка предложений (характеристик) в отдельный инфоблок;
- опция «Цены только в инфоблоке торговых предложений» — для товаров без характеристик будет создано одно предложение, в котором и хранится цена;
- интервал одного шага в секундах и размер единовременно загружаемой части файла;
- сжатие ZIP и контрольные суммы элементов для оптимизации обновления каталога;
- что делать с товарами и с группами, отсутствующими в файле импорта: удалить, деактивировать или ничего не делать;
- обработка изображений: генерация картинки анонса и изменение детальной с ограничением по ширине и высоте, либо приоритет настроек самого инфоблока.
Права доступа. Загрузку каталога разрешают конкретным группам пользователей — опция «Разрешить загрузку группам пользователям»; для заказов есть аналогичная «Группы, пользователям которых разрешена выгрузка». Служебная учётная запись под обмен — отдельная, не администратор сайта: её логин и пароль лежат в настройках 1С и используются автоматически.
Символьные коды и URL. В настройках есть транслитерация символьного кода из названия — отдельно при добавлении и отдельно при обновлении элемента или раздела. Вторая опция означает, что переименование товара в 1С поменяет символьный код на сайте, а вместе с ним и URL страницы. Для проекта с поисковым трафиком это критично: либо транслитерация при обновлении выключается, либо делается карта редиректов. Это решение принимается на стороне сайта и должно быть согласовано до первого обмена.
Привязка свойств к разделам. Выгружаются только те свойства, которые указаны в настройках обмена в 1С, и они не привязываются к разделам инфоблоков автоматически — это делается вручную на сайте. Отсюда типичная картина: свойства приехали, а в фильтре и в карточке их нет.
Кеш. В настройках есть управление сбросом тегированного кеша инфоблока: после каждой операции, в конце каждого шага импорта, после окончания импорта или не сбрасывать вовсе. Последний вариант означает, что информация на сайте не обновляется, даже когда импорт прошёл успешно. Выбор здесь — это баланс между скоростью витрины и свежестью цен.
Отдача заказов. На закладке «Заказы» задаются: сайт, заказы которого выгружать; префикс номера заказа; выгружать только оплаченные или только с разрешённой доставкой; начиная с какого статуса выгружать; менять ли статусы заказов по информации из 1С; в какой статус переводить заказ при получении отгрузки; какие платёжные системы подставлять для наличных, безналичных и эквайринговых оплат; какая служба доставки подставляется в новые заказы; создавать ли документы оплаты и доставки из 1С. Если условия отбора не совпадают с реальной воронкой, часть заказов никогда не уедет в учёт — и выглядеть это будет как «1С не забирает заказы».
Профили обмена. Эта закладка отвечает за поля экспорта заказа и настраивается отдельно для каждого типа плательщика; туда же добавляются дополнительные реквизиты, которые попадут в реквизиты заказа в 1С. Поля «Наименование» и «Полное Наименование» критичны: без корректных соответствий обмен заказами падает с ошибкой «Поле объекта не обнаружено».
Несколько обменов с разными настройками. Штатная форма — не единственный вариант. Можно создать собственные страницы и разместить на них компоненты «Импорт каталога из 1С» (bitrix:catalog.import.1c), «Экспорт каталога в 1с» (bitrix:catalog.export.1c), «Экспорт заказов в 1С:Предприятие» (bitrix:sale.export.1c), задать им разные параметры и указать адреса этих страниц в настройках 1С. Так, например, разные каталоги 1С разводятся по разным типам инфоблоков. Для групп, которым разрешён обмен, уровень доступа к странице должен быть не ниже «Чтение», остальным доступ закрывается. И важная деталь: при собственных настройках нужно снять флаг «Переходить в режим правки сайта без перезагрузки страницы» в персональных настройках интерфейса, иначе обращения 1С будут некорректными.
Кастомная логика. Импорт каталога выдаёт события начала и успешного завершения, на которые можно повесить обработчики. Простой пример из официальной документации: чтобы у приехавших товаров включался количественный учёт, в init.php добавляют обработчик события добавления продукта, который выставляет соответствующий флаг. Более серьёзные задачи решаются собственной страницей обмена с кастомным компонентом и наследованием класса импорта — так меняют логику разбора, не правя файлы ядра.
Логи и мониторинг. Обмен умеет «тихо отвалиться». Нужен журнал сеансов и уведомление ответственному, иначе о проблеме узнаёт покупатель.
Разработчик Битрикса не обязан уметь конфигурировать 1С. Он обязан уметь прочитать XML, сказать, чего в нём не хватает, и корректно обработать то, что пришло.
Серая зона: как за пять минут понять, чья это ошибка
Самая частая причина конфликтов — не техника, а отсутствие процедуры. Я использую простое правило: точка разделения — файл выгрузки. Он лежит на сайте, его можно открыть и посмотреть.
Алгоритм:
- Берём конкретный товар или заказ, а не «всё сломалось».
- Находим файл выгрузки в каталоге обмена и открываем.
- Ищем нужный идентификатор и нужное поле.
- Делаем вывод:
| Что видно в файле | Диагноз | Чья зона |
|---|---|---|
| Товара нет вообще | Не попал в отбор выгрузки | 1С |
| Товар есть, поле пустое или неверное | Не заполнено в учёте | 1С |
| Поле есть и значение верное, но на сайте пусто | Не сопоставлено или не обработано при импорте | Сайт |
| Значение верное и в файле, и в админке, но не на витрине | Шаблон, кеш, права, привязка свойств к разделам | Сайт |
| Файл не пришёл или пришёл битым | Обмен не запускался или прервался | 1С, затем сервер и сеть |
| В ответе сайта HTML вместо текста | Необрабатываемая ошибка ядра или SQL, нехватка памяти | Сайт |
| Товар задвоился | Изменился идентификатор в 1С | 1С |
Полезно ещё валидировать XML по схеме CommerceML: формальная проверка сразу показывает, нарушена структура или нет, и снимает спор «формат неправильный» — «формат правильный».
Типовые сбои: что проверять до боевого обмена
Ниже — то, что описано в официальном разделе «Типичные ошибки и проблемы» курса по интеграции, плюс то, что видно из механики протокола.
Авторизация не работает. Частая причина — PHP в режиме CGI, при котором данные HTTP-авторизации не доходят до скрипта. Проверяется по phpinfo(), обходится правилами mod_rewrite и разбором заголовка авторизации; если не помогло — вопрос к хостинг-провайдеру.
Нет прав на импорт. В ответе приходит «У Вас нет прав для импорта каталога» — значит, служебный пользователь не входит в группы, которым разрешена загрузка, либо закрыт доступ к странице обмена.
Смена идентификатора сессии. Проактивная защита меняет ID сессии, а шаг импорта хранится в сессии. В результате 1С не находит свой шаг и импорт начинается заново — обмен выглядит «медленным» или бесконечным. Лечится отключением смены идентификатора сессии для обмена.
Расхождение времени серверов. Если время на сервере базы данных и на веб-сервере расходится больше чем на 10 минут, обмен не пройдёт: нужно настроить часовые пояса.
Нехватка памяти на изображениях. Ответ сервера с сообщением о превышении допустимого объёма памяти при масштабировании картинок — это memory_limit. Варианты: увеличить лимит или отключить выгрузку картинок и передать их отдельно.
Файл «обрезается» по пути. Ответ вида «DB query error» или пустой файл импорта часто означает, что файл теряет целостность при передаче — например, через прокси-сервер. Проверяют передачу без прокси и отключают ZIP-сжатие, чтобы исключить проблему с распаковкой.
Антивирус или файрвол на машине с 1С. Блокируют отправку файла, обмен падает на шаге передачи.
Включённая индексация инфоблока. Замедляет импорт; на время обмена индексацию элементов, разделов и свойств можно отключить.
Названия свойств и справочников. Название свойства не должно начинаться с цифры — иначе ошибка импорта метаданных. Название справочника должно начинаться с буквы и состоять из латинских букв и цифр.
Один тип цены в «Малом бизнесе». Если в выгрузке больше одного вида цены, импорт метаданных падает с прямым сообщением о ограничении редакции. Нужно настроить отбор по конкретному соглашению в 1С и сверить внешний код типа цены с кодом на сайте.
Параллельные обмены. Обмен должен идти строго в один поток. Если две 1С или одна 1С шлют запросы одновременно, они мешают друг другу: типичный симптом — ошибка об отсутствии временной таблицы.
Копия базы «перехватывает» обмен. Развернули копию 1С для тестов — и изменения с сайта перестали приходить в рабочую базу, потому что уходят в копию. Решение — сменить пароль пользователя обмена, чтобы копия перестала авторизовываться.
Деактивация после обрыва. Шаг деактивации сравнивает время изменения с временем начала сеанса и скрывает то, что не было затронуто. При полной выгрузке, которая не дошла до конца, это риск скрыть часть витрины. Опцию «что делать с отсутствующими в файле» включают осознанно и проверяют на тестовом контуре, а не на боевом каталоге.
Отдельная задача: структура каталога в 1С не годится для сайта
Это встречается чаще, чем хотелось бы: в справочнике номенклатуры — учётная иерархия, а покупателю нужна совсем другая навигация. Ломать учёт ради сайта нельзя, поэтому есть три рабочих подхода, и все они обсуждаются до старта.
Пользовательское дерево групп в модуле обмена. В 1С создаётся своя структура групп для выгрузки, товар можно включить в несколько групп, иерархия номенклатуры при этом не меняется. Дерево привязывается к каталогу по его идентификатору, его можно сохранить в файл и загрузить обратно. Самый дешёвый вариант, и он на стороне 1С.
Прайс-лист как прокси. В 1С создаётся прайс-лист, в нём — нужные секции, а сотрудник добавляет в них ссылки на позиции номенклатуры. На сайт уходит структура прайс-листа, а не справочника. Тоже сторона 1С.
Отдельный инфоблок-классификатор на сайте. Приехавшая из 1С структура живёт в служебном инфоблоке, а «человеческие» разделы создаются отдельно и связываются с ней свойством-привязкой к разделам, в том числе множественной. Это уже моя работа, и она даёт максимальную свободу: SEO-структура, посадочные страницы, свои тексты и метаданные живут независимо от учёта.
Выбор влияет и на бюджет, и на то, кто потом отвечает за навигацию. Поэтому в таблице мастер-систем строка «структура разделов» должна быть заполнена конкретным именем, а не «по ситуации».
Когда CommerceML не подходит: заказные схемы обмена
CommerceML — правильный выбор для массовой выгрузки каталога и типового обмена заказами. Он плохо подходит для точечных операций в реальном времени: «остаток вот этой позиции сейчас», «персональная цена этого клиента», «статус документа сию минуту».
Здесь важно не путать продукты. Готового публичного REST-интерфейса с генерацией вебхуков, как в Битрикс24, в «1С-Битрикс: Управление сайтом» нет. API у CMS есть, но внешний HTTP-интерфейс для партнёров — это либо собственная разработка, либо готовое решение из Маркетплейса.
Со стороны 1С возможностей больше, чем «выгрузка в XML»:
- Штатный REST-интерфейс на OData 3.0. Платформа автоматически формирует интерфейс для всего прикладного решения; после публикации на веб-сервере сторонние системы читают, создают, меняют и удаляют данные по HTTP, ответы — Atom/XML или JSON. Доступны справочники, документы, регистры, их реквизиты и часть методов: проведение документа, старт бизнес-процесса, остатки и обороты. При чтении и записи выполняются обычные проверки прав и вызываются обработчики событий, кроме проверки заполнения. Важное ограничение: реализована только серверная часть — клиентскую часть для обращения к чужим сервисам делают средствами работы с HTTP.
- Собственные HTTP-сервисы в конфигурации — когда нужен свой контракт, а не универсальный доступ к объектам.
- Обмен справочниками (
type=reference) — недооценённый штатный способ расширить интеграцию: данные приезжают в highload-блоки, где у них есть полный набор событий. Так решают задачи, для которых в каталоге нет аналога: персональные цены и скидки, бонусы, данные для личного кабинета партнёра. Ограничения тоже надо знать: 1С может только создавать справочник и поля, но не удалять их, а типы полей ограничены строкой, булевым значением, датой и числом.
Варианты и когда их выбирать:
| Схема | Когда уместна | Что учитывать |
|---|---|---|
| Штатный обмен CommerceML | Каталог, цены, остатки, заказы, контрагенты; поддерживаемая торговая конфигурация | Максимум готового, минимум разработки |
| Обмен справочниками в highload-блоки | Сущности без аналога в каталоге: персональные цены, бонусы, данные ЛК | Штатный механизм, но ограниченная схема полей |
| Собственный эндпоинт на сайте плюс OData или HTTP-сервис в 1С | Точечные запросы в реальном времени | Разработка с двух сторон, нужна версионность контракта |
| Файловый обмен в согласованном формате | Нетиповая 1С, простой ассортимент, обмен раз в сутки | Формат придётся описать и поддерживать вручную |
| Промежуточный слой или очередь сообщений | Несколько систем: 1С, CRM, склад, маркетплейсы | Дороже на старте, дешевле в поддержке |
Говорю прямо: заказной обмен снимает ограничения протокола, но добавляет то, что в CommerceML уже готово, — авторизацию, повторы, идемпотентность, пошаговость, контроль версий формата и мониторинг. Если это не заложено, самописный обмен хуже типового. Поэтому решение «уйдём от штатного обмена» я принимаю только вместе со стороной 1С и только под конкретное требование, которое штатный механизм не закрывает.
Что делать, если в команде только один специалист
Ситуация «нужен и сайт, и 1С, а исполнитель один» встречается постоянно. Рабочие варианты:
Разделить по файлу. 1С-программист кладёт выгрузку в согласованное место, разработчик сайта забирает и импортирует. Граница ответственности физическая: файл не пришёл или битый — сторона 1С; пришёл корректный, но не разобрался — сторона сайта. Работает даже когда специалисты не общаются напрямую.
Нанять 1С-интегратора на настройку, а не на разработку. Если конфигурация нетиповая, дешевле один раз оплатить корректную настройку выгрузки, чем месяцами компенсировать её костылями на сайте. Это не «лишний подрядчик», это способ не переписывать приёмник после каждого обновления учёта.
Промежуточный формат под ваши возможности. Разработчик сайта пишет приёмник под оговорённый CSV или JSON, 1С-программисту достаточно выгрузить данные в этом формате. Минус: формат живёт вне стандарта, и его нужно документировать, иначе через год никто не вспомнит, что означает колонка flag_2.
Один универсальный специалист. На небольшом проекте это удобно: одна точка ответственности, не нужно быть арбитром. Но проверяйте обе компетенции отдельно: «знаю 1С» и «делал обмен с Битриксом» — разные утверждения, и портфолио сайтов не подтверждает опыт в учётной системе.
Чего делать не стоит: поручать 1С-программисту «заодно доделать сайт», а веб-разработчику — «заодно поправить конфигурацию». Именно так появляются правки типовой конфигурации, которые потом мешают обновлениям, и самописные импортёры, которые плодят дубли.
Договорённости, которые снимают конфликты
Провалы интеграции чаще организационные, чем технические. Минимальный набор, который я считаю обязательным:
1. Таблица мастер-систем. По каждому объекту: где создаётся, где редактируется, куда передаётся и что делать при конфликте — перезаписать, проигнорировать или остановить обмен с ошибкой. Без последнего столбца таблица не работает.
2. Контракт формата. Перечень полей: реквизит в 1С, узел или свойство на сайте, тип, обязательность, пример значения, поведение при пустом значении. Отдельно — как формируются характеристики и как считается скидка. Этот документ превращает спор в проверку по пункту.
3. Тестовый контур. Копия сайта и копия базы 1С, с отдельным пользователем обмена, чтобы копия не перехватывала боевые запросы. Первый обмен — всегда там.
4. Регламент запуска. Один поток, понятное расписание, ответственный за то, что задание действительно выполняется. Никаких параллельных обменов «чтобы быстрее».
5. План приёмки. Не «интеграция работает», а измеримые проверки.
6. Регламент поддержки. Кто получает уведомление о сбое, кто смотрит первым, за какое время реагирует, кто оплачивает перенастройку после обновления конфигурации. Последний пункт стоит проговорить отдельно: обновления 1С — регулярное событие, а не форс-мажор.
Чек-лист приёмки обмена
По нему я сдаю интеграцию и его же советую требовать от любого подрядчика:
- количество товаров и торговых предложений на сайте совпадает с составом выгрузки;
- у выборки позиций совпадают наименование, артикул, штрихкод, характеристики;
- описания и анонсы попали в нужные поля, SEO-тексты, которые ведутся на сайте, не затёрты;
- символьные коды и URL не изменились там, где не должны были; для изменённых есть редиректы;
- цены каждого типа сверены с 1С, внешние коды типов цен совпадают;
- остатки сверены по каждому складу; проверены позиция с нулевым остатком и позиция в резерве;
- изображения на месте, включая варианты товара; проверена позиция с несколькими фото — основная выбрана верно;
- свойства привязаны к разделам и работают в фильтре;
- повторный обмен не создаёт дублей; с включёнными контрольными суммами он заметно быстрее первого;
- переименование товара в 1С меняет наименование на сайте, а не создаёт новый товар;
- позиция, удалённая из выгрузки, ведёт себя согласно договорённости — скрыта, удалена или оставлена;
- обрыв сеанса не приводит к массовой деактивации товаров;
- тестовый заказ уходит в 1С полностью: товары, количества, цены, доставка отдельной позицией, скидки, контакты, дополнительные реквизиты;
- в 1С заказ находится по нужному контрагенту и договору, свойства заказа не потерялись;
- заказ не выгружается повторно после подтверждения;
- полная оплата и полная отгрузка из 1С меняют состояние заказа на сайте и в личном кабинете, письмо покупателю уходит; частичная оплата ведёт себя так, как описано в протоколе, и это согласовано с заказчиком;
- после импорта витрина показывает свежие цены и остатки — кеш сбрасывается по выбранной схеме;
- обмен проходит по расписанию без ручного запуска, ночью и в выходные, строго в один поток;
- сбой обмена приводит к уведомлению ответственному, а не к тишине в логе.
Пока эти пункты не пройдены, фраза «обмен настроен» ничего не значит.
Где проверить самому
Я не прошу верить на слово — всё вышеописанное есть в открытых первоисточниках:
- «Протокол обмена с сайтом» и стандарт CommerceML 2 — на сайте фирмы «1С», в разделе технологий обмена данными и интеграции:
v8.1c.ru; - учебный курс «Интеграция с 1С» — на портале для разработчиков
dev.1c-bitrix.ru: установка модулей 7.x и 8.x, настройки со стороны 1С и со стороны сайта, типичные ошибки, особенности редакции «Малый бизнес»; - справка по форме «Магазин → Настройки → Интеграция с 1С» и описание файлов
import.xml,offers.xml,prices.xml,rests.xml— там же, в документации по интернет-магазину; - описание REST-интерфейса платформы «1С:Предприятие» — на
v8.1c.ru.
Названия пунктов меню и состав опций зависят от версии продукта и редакции, поэтому на конкретном проекте я всегда сверяюсь с той сборкой, которая стоит у заказчика, а не с чужим скриншотом из интернета.
Что нужно, чтобы оценить работу по вашему проекту
Чтобы разговор был предметным, мне нужны вводные:
- конфигурация 1С, её релиз, типовая или доработанная;
- база файловая или клиент-серверная, где размещена, есть ли доступ из интернета;
- поколение модуля обмена: 7.x или 8.x;
- количество товаров, характеристик, видов цен, складов; нужны ли резервы;
- что должно ехать на сайт: только каталог или ещё изображения, файлы, справочники, контрагенты;
- что должно ехать обратно: заказы, оплаты, отгрузки, статусы;
- кто мастер по описаниям, SEO-полям и структуре разделов;
- требуемая частота обмена и допустимое расхождение по остаткам;
- редакция «1С-Битрикс: Управление сайтом» и текущее состояние сайта;
- кто ведёт сторону 1С и можно ли связаться с ним напрямую.
По этим ответам сразу видно, укладываемся ли мы в штатный обмен или нужна заказная схема, и где спрятана основная трудоёмкость. Почти всегда она не в «связать две системы», а в характеристиках, складах, скидках, нестандартных полях и в том, кто владеет контентом карточки.
Я занимаюсь сайтами на «1С-Битрикс»: создаю их с нуля, дорабатываю функционал, собираю каталог и корзину так, чтобы они корректно принимали данные учёта, и делаю веб-сторону интеграции — приём каталога, отдачу заказов, обновление состояний, работу с URL и редиректами, логи и оповещения. Со стороны 1С работаю в связке с вашим 1С-программистом: даю контракт формата, показываю, чего не хватает в выгрузке, и проверяю результат по чек-листу, а не на глаз.
Если сайт уже есть и обмен «вроде работает, но не так» — начнём с диагностики: посмотрю файлы выгрузки и ответы скрипта обмена и скажу, на чьей стороне проблема. Если сайта ещё нет — спроектируем структуру каталога под вашу 1С сразу, чтобы не переделывать после первого обмена и не терять поисковый трафик на смене URL. Напишите, какая у вас конфигурация и что должно передаваться, — разберу задачу и честно скажу, где будут сложности именно в вашем случае.
Комментарии
Оставить комментарийКомментариев пока нет. Будьте первым.
Оставить комментарий
Комментарий появится после проверки модератором.