Интеграции сайта с 1С, CRM, оплатами и API

Какие интеграции обычно нужны

На живом сайте интеграция редко ограничивается одним запросом к API. Нужно проверить поля, обязательные значения, UTM-метки, дубли, статусы, ошибки, таймауты, повторы и уведомления. Иначе заявка может выглядеть отправленной на сайте, но так и не дойти до менеджера.

• передача заявок и заказов в CRM или Битрикс24;
• обмен товарами, ценами, остатками и статусами с 1С;
• подключение оплат, доставок, SMS, email и вебхуков;
• интеграция с внутренними API, личными кабинетами и складскими системами;
• логирование обменов, повторная отправка и диагностика сбоев.

Что проверяю перед подключением

Перед разработкой важно понять, где именно рождаются данные и куда они должны попасть. Для формы это поля, согласия, файлы, защита от спама и событие отправки. Для каталога — идентификаторы товаров, свойства, цены, остатки, торговые предложения и правила обновления. Для CRM — статусы, ответственный, источник, UTM и обработка дублей.

Если интеграция уже есть, но заявки теряются, сначала полезно пройти диагностику по цепочке. Я описал такой подход в статье почему не приходят заявки с сайта на 1С-Битрикс.

Как снизить риск потери данных

1. Сохранять заявку на стороне сайта до отправки во внешнюю систему.
2. Фиксировать ответ API, ошибку, время запроса и ключевые поля.
3. Настроить понятные уведомления о сбоях, а не только успешную отправку.
4. Продумать повторную отправку и защиту от дублей.
5. Проверить сценарии после запуска: форма, CRM, почта, статусы, UTM, мобильная версия.

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

Что нужно для оценки интеграции

Для нормальной оценки нужны не только название CRM или 1С. Важно понимать, какие данные передаются, в каком направлении, как часто, что считается успешной отправкой и что делать при ошибке. Если есть документация API, тестовый доступ, пример запроса или выгрузка полей, это ускоряет работу.

Для форм полезно заранее описать обязательные поля, файлы, согласия, UTM-метки и правила защиты от дублей. Для заказов — статусы, состав заказа, оплату, доставку и логику обновления данных после изменений во внешней системе.

Где интеграция чаще всего ломается

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

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

Что проектируется до написания кода

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

Связь с заявками, оплатой и каталогом

Интеграция почти всегда затрагивает соседние части сайта. Форма должна передать заявку в CRM, каталог — получить цены и остатки, заказ — поменять статус после оплаты, а менеджер — увидеть понятную ошибку, если обмен не прошел. Поэтому перед работой полезно проверить не только API-документацию, но и текущую структуру инфоблоков, свойства заказа, почтовые события и обработчики.

Если проблема уже проявилась на сайте, начните со статьи почему не приходят заявки с сайта на 1С-Битрикс или чек-листа онлайн-оплаты на 1С-Битрикс. Если нужна новая логика, интеграция обычно идет вместе с доработкой сайта на 1С-Битрикс.

Что остается после внедрения

Хорошая интеграция должна быть проверяемой. После работы должны быть понятны URL и события, которые участвуют в обмене, формат данных, место логирования, правила повторной отправки и список тестов, которыми можно подтвердить результат. Это особенно важно, если через месяц нужно будет разобраться, почему конкретная заявка, заказ или товар не дошли до внешней системы.

Интеграции в опубликованных проектах

В интернет-магазине Crocotari была реализована интеграция с 1С, а в проекте конного клуба «Релакс» — подключена онлайн-касса. Это два разных контура: обмен товарными данными и платежная инфраструктура. До разработки полезно отдельно определить источники данных, статусы и обработку ошибок; типовые риски разобраны в материалах про обмен 1С с Битрикс и интеграцию сайта с CRM.

FAQ по интеграциям

Можно ли сначала сделать простую отправку заявки, а логи добавить потом?

Можно, но лучше хотя бы базовое логирование делать сразу. Без логов сложно понять, где пропала заявка: на сайте, в почте, в CRM или во внешнем API.

Что важнее: отправка в CRM или сохранение на сайте?

Для надежности лучше сохранять заявку на сайте и отдельно отправлять её дальше. Тогда при сбое внешнего сервиса данные не теряются.

Почему интеграция с 1С стоит дороже простой формы?

В обмене с 1С обычно больше сущностей и правил: товары, цены, остатки, заказы, статусы, идентификаторы, ошибки и повторы. Это нужно проектировать, а не просто отправлять один запрос.