Интеграция 1С-Битрикс с внешними системами

Связываю сайт с 1С, Битрикс24, платёжными сервисами и доставкой. До разработки описываю, какие данные передавать, какая система отвечает за каждое поле и что делать при ошибке. Обмен проверяю на тестовых данных и снабжаю журналом.

cat issue.md

Когда нужна интеграция

  • Остатки на сайте не совпадают с 1С. Люди заказывают то, чего нет.
  • Заказы переносят в CRM вручную.
  • Нужной службы доставки нет среди штатных решений.
  • Обмен с 1С падает на большом каталоге, и непонятно, на каком пакете.
  • Сервис присылает вебхук, но заказ на сайте не меняет статус.

cat todo.md

Что входит

  • Обмен с 1С: товары, цены, остатки и заказы. Настраиваю штатный обмен, дописываю нестандартные поля.
  • Передача лидов и сделок в Битрикс24 из форм и заказов.
  • Подключение оплаты и доставки через API сервиса, если готового модуля нет.
  • REST-запросы и приём вебхуков с проверкой подписи, если её предоставляет сервис.
  • Уведомления и боты в Telegram и MAX по событиям сайта.
  • Сопоставление полей, внешние идентификаторы и правила повторной отправки.
  • Журнал обмена с запросом, ответом и причиной ошибки. Секретные ключи в журнал не попадают.
  • Проверка повторных запросов, недоступного API и неполного ответа.

cat boundaries.md

Что в эту работу не входит

  • Доработка 1С, CRM или другого внешнего сервиса изнутри. На той стороне нужен её специалист.
  • Оплата тарифов и получение доступов к сторонним сервисам.
  • Ручное исправление накопленных ошибок во всей базе. Такая очистка оценивается отдельно.
  • Постоянный мониторинг после запуска. Его можно включить в отдельное сопровождение.

cat result.md

Конкретный результат

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

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

cat options.md

Как выбрать способ обмена

Штатный обмен или готовый модуль

Выбираю сначала, если стандартные поля и расписание подходят. Для обмена с 1С проверяю настройки CommerceML, состав выгрузки и ограничения текущей версии.

REST и вебхуки

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

Файловый обмен

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

cat estimate.md

Сроки и стоимость

  • Настройка штатного обмена

    Объём зависит от сопоставления полей и состояния текущего обмена.

  • Интеграция через API

    Оцениваю сценарии, авторизацию, обработку ошибок и тестирование на обеих сторонах.

  • Сопровождение

    Отдельный формат для регулярного разбора сбоев и изменений API.

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

cat workflow.md

Этапы интеграции

  1. Смотрю обе стороны

    Изучаю данные сайта, документацию сервиса и текущие журналы. Проверяю тестовый доступ.

  2. Рисую схему

    Фиксирую источник каждого поля, направление, частоту обмена и реакцию на сбой.

  3. Подключаю на копии

    Пишу или настраиваю код, добавляю журнал и проверяю ответы сервиса.

  4. Тестирую сбои

    Повторный вебхук, тайм-аут, неверные данные и повторная отправка после ошибки.

  5. Запускаю

    Включаю обмен на рабочем сайте и сверяю первые операции с обеими системами.

cat requirements.md

Что понадобится от вас

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

integration --help

Вопросы об интеграциях

Обмен с 1С уже есть, но регулярно падает. С чего начать?

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

Можно передавать заказы сразу после оформления?

Да, если принимающая система предоставляет API или вебхуки. Запрос может завершиться тайм-аутом, поэтому предусматриваю журнал и повторную отправку. Перед повтором обработчик проверяет идентификатор объекта и прошлый результат, чтобы не создать дубль.

Как исключить дубли сделок и заказов?

Использую внешний идентификатор и правила поиска существующей записи. Отдельно проверяю повторный вебхук и повторную отправку одного объекта.

Что делать, если у сервиса нет тестового режима?

Сначала ограничиваю объём проверки и выбираю операции, которые можно безопасно отменить. Если API этого не позволяет, риски и порядок запуска согласую с вами до работы.

Кто исправляет ошибку на стороне 1С или CRM?

Её специалист. Я передаю запрос, ответ, время и идентификатор объекта, чтобы причину можно было найти. Со стороны сайта исправления делаю сам.

Достаточно ли готового модуля интеграции?

Да, если он поддерживает нужные поля, события и сценарии восстановления после сбоя. Проверяю это до заказа собственной разработки.

mail zelenkindev

Обсудить интеграцию

Пишите — отвечу сразу.

  • MAX

    QR-код: https://max.ru/u/f9LHodD0cOKhBt_X5KaDCt4SgZkqN6JkUnj_2fzv5KGWZyBjRqqFa8wa36E
    Наведите камеру телефона
    Открыть в MAX
  • Telegram

    QR-код: https://t.me/zelenkins
    Наведите камеру телефона
    Открыть в Telegram

man zelenkindev

Горячие клавиши

/
поиск по модулям
?
эта справка
Esc
закрыть