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

Перенос заказов из интернет-магазина на 1С:Предприятие — критически важный процесс для синхронизации данных между онлайн-продажами и бухгалтерским учетом. Без правильной настройки обмена риски расхождения остатков, ошибок в отчетности и задержек обработки заказов возрастают в разы. В этой статье разберём все актуальные способы выгрузки заказов из Bitrix CMS в 1С, включая настройку модулей, обработку типичных ошибок и оптимизацию процесса для крупных магазинов.

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

Приступим к детальному разбору, начиная с подготовки систем и заканчивая тонкостями настройки для специфических версий 1С (включая 1С:УТ 11.5, 1С:КА 2.5 и 1С:ERP 2.5).

1. Подготовка систем к обмену данными

Прежде чем настраивать выгрузку, необходимо убедиться, что обе системы готовы к интеграции. В Bitrix проверьте:

• 🔹 Версию модуля Интернет-магазин (должна быть не ниже 18.0.0 для полной поддержки CommerceML 2.0).
• 🔹 Наличие прав у пользователя, под которым будет выполняться обмен (роль «Администратор» или «Менеджер интернет-магазина»).
• 🔹 Корректную настройку CRON для автоматического запуска выгрузки (если планируете использовать расписание).

В 1С требуется:

• 🔹 Установить обработку CommerceML.epf (входит в стандартную поставку конфигураций для торговли).
• 🔹 Настроить права доступа к справочникам Номенклатура, Контрагенты и Заказы покупателей.
• 🔹 Проверить наличие свободного порта для HTTP-сервиса (по умолчанию используется 8080).

Если вы работаете с облачной версией 1С, потребуется дополнительная настройка веб-сервисов через личный кабинет 1С:Fresh. Для локальных установок проверьте, что на сервере разрешён входящий трафик по протоколу HTTP/HTTPS (порт 443 для защищённого соединения).

⚠️ Внимание: Если в Bitrix используются нестандартные свойства заказов (например, дополнительные поля для юрлиц), их необходимо предварительно сопоставить с реквизитами в 1С через Настройки модуля интернет-магазина → Сопоставление свойств.

2. Настройка выгрузки через CommerceML

CommerceML — самый распространённый формат обмена между Bitrix и 1С. Он поддерживает передачу не только заказов, но и каталога товаров, остатков, цен. Для настройки выполните следующие шаги:

1. Активируйте обмен в Bitrix:

   Перейдите в Магазин → Настройки → Интеграция с 1С. Укажите:

   • 📌 Тип обмена: «CommerceML 2.0»
   • 📌 Адрес сайта 1С: URL веб-сервиса (например, https://ваш-сервер:8080/ws/exchange.1cws)
   • 📌 Логин/пароль: данные пользователя 1С с правами на обмен

Убедитесь, что в 1С созданы все необходимые справочники|Проверьте права пользователя на запись в папку обмена|Отключите антивирус для папки обмена (во избежание блокировки файлов)|Создайте резервную копию баз 1С и Bitrix-->

После настройки запустите тестовый обмен. В Bitrix это делается через кнопку Выгрузить заказы в разделе интеграции. В 1С проверьте журнал обмена (Администрирование → Журнал регистрации) на наличие ошибок.

3. Альтернативные способы выгрузки заказов

Если CommerceML не подходит (например, из-за специфической конфигурации 1С или ограничений хостинга), рассмотрите альтернативные методы:

3.1. Выгрузка через API

Для современных версий 1С:ERP или 1С:УТ 11.5 можно использовать REST API. В Bitrix настройте вебхук на событие OnSaleOrderSaved, который будет отправлять данные заказа в 1С по API.

Пример кода для обработчика в Bitrix:

// Пример отправки заказа в 1С через API
$orderData = [
'number' => $order->getField('ACCOUNT_NUMBER'),
'date' => $order->getField('DATE_INSERT')->toString(),
'client' => $order->getPropertyCollection()->getItemByOrderPropertyId(1)->getValue(), // ФИО
'items' => array_map(function($item) {
return [
'product_id' => $item->getField('PRODUCT_ID'),
'quantity' => $item->getField('QUANTITY'),
'price' => $item->getField('PRICE')
];
}, $order->getBasket()->getBasketItems())
];

$response = \Bitrix\Main\Web\HttpClient::post('https://1c-api.example.com/orders', [
'json' => $orderData,
'auth' => ['login', 'password']
]);

3.2. Обмен через CSV/Excel

Для небольших магазинов подойдёт ручная выгрузка заказов в CSV с последующим импортом в 1С через обработку Универсальный обмен данными. В Bitrix экспорт настраивается в Магазин → Заказы → Экспорт.

Важно: при таком методе требуется ручное сопоставление колонок (например, ID заказа → Номер документа, Email покупателя → Контрагент.Эл.почта).

3.3. Прямое подключение к базе данных

Для высоконагруженных систем возможна настройка прямого доступа 1С к базе Bitrix через ODBC. Этот метод требует:

• 🔹 Настройки прав доступа к БД MySQL (или PostgreSQL для Bitrix24)
• 🔹 Создания внешнего источника данных в 1С (Администрирование → Внешние источники данных)
• 🔹 Написания запросов на языке 1С для выборки заказов

⚠️ Внимание: Прямое подключение к БД Bitrix не рекомендуется для облачных версий из-за ограничений хостинга. Также этот метод требует глубоких знаний SQL и структуры таблиц Bitrix (например, b_sale_order, b_sale_basket).

4. Настройка фильтров и статусов заказов

По умолчанию в 1С выгружаются все заказы, включая тестовые и отменённые. Чтобы избежать засорения базы, настройте фильтрацию:

В Bitrix:

1. Перейдите в Магазин → Настройки → Настройки модуля интернет-магазина → Интеграция с 1С.
2. В разделе Фильтр заказов укажите статусы, которые нужно выгружать (например, только «Оплачен» и «Отгружен»).
3. Добавьте исключения для заказов с меткой «Тестовый» или суммой 0 руб.

В 1С:

• 🔹 Сопоставьте статусы Bitrix со статусами документов в 1С через обработку CommerceML.epf.
• 🔹 Настройте автоматическое создание Заказа покупателя или Реализации товаров в зависимости от статуса.

Для сложных сценариев (например, когда один статус в Bitrix должен порождать несколько действий в 1С) используйте Бизнес-процессы 1С. Настройте их в разделе Администрирование → Бизнес-процессы.

5. Автоматизация и расписание обмена

Ручная выгрузка заказов подходит только для небольших магазинов. Для автоматизации настройте:

5.1. CRON-задания в Bitrix

Добавьте задачу в Панель управления → Настройки → Настройки модулей → Агент CRON:

# Выгрузка заказов в 1С каждый час
0     php /path/to/bitrix/modules/sale/1c_exchange.php --type=sale --mode=export

5.2. Регламентные задания в 1С

В конфигураторе создайте регламентное задание (Администрирование → Поддержка и обслуживание → Регламентные задания) с параметрами:

• 🔹 Периодичность: Каждые 30 минут
• 🔹 Действие: «Обмен с сайтом (загрузка заказов)»
• 🔹 Условие: «Если есть новые файлы в папке обмена»

Для облачных версий 1С (1С:Fresh) используйте Вебхуки. Настройте их в личном кабинете на сайте 1С, указав URL вашего Bitrix-сайта для обратной связи.

6. Решение типичных проблем

Даже при правильной настройке могут возникать ошибки. Рассмотрим самые распространённые:

6.1. Дублирование заказов

Причина: в 1С не настроено сопоставление по уникальному идентификатору (например, ID заказа из Bitrix).

Решение:

1. В обработке CommerceML.epf проверьте, что поле ИдЗаказа сопоставлено с ACCOUNT_NUMBER из Bitrix.
2. Добавьте в 1С правило: «Если заказ с таким ИдЗаказа уже существует, обновить его, а не создавать новый».

0     php /path/to/bitrix/modules/sale/1c_exchange.php --type=sale --mode=export --limit=100

// Получение сделки из Bitrix24
$deal = CRest::call('crm.deal.get', ['id' => $dealId]);

// Отправка в 1С
$response = \Bitrix\Main\Web\HttpClient::post('https://1c-api.example.com/deals', [
'json' => [
'deal_id' => $deal['ID'],
'client' => $deal['CONTACT_ID'],
'amount' => $deal['OPPORTUNITY'],
'stage' => $deal['STAGE_ID']
]
]);