Разработка интеграций через REST API Битрикс24 в Темиртау

Обсуждение и показы идут по видеосвязи, переписка в мессенджерах, задачи и правки ведём в общем списке — видно, что сделано и что в работе.

Оценку даём до старта и разбиваем проект на этапы: после каждого можно остановиться или изменить план, а не платить за всё авансом.

Договор по законодательству Казахстана, оплата по безналичному расчёту или через Kaspi, акты и счета-фактуры электронные.

В Темиртау Битрикс24 чаще всего внедряют сервисные компании, которые обслуживают комбинат и смежные производства: ремонт оборудования, поставки, монтаж, охрана труда, транспорт. Задача обычно не в красивой воронке, а в том, чтобы заявка от заказчика, наряд бригаде, акт и счёт жили в одной системе, а не в переписке и таблицах. Через REST API мы связываем портал с сайтом, почтой, складским учётом и учётной системой, чтобы данные вводились один раз. Всё остальное — надстройка над этим порядком.

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

Отдельно проговариваем доступы. Данные по договорам с комбинатом и по подрядным работам чувствительны, поэтому права выдаём точечно, ключи храним вне репозитория, а обмен ведём по защищённому каналу. Логируем каждый обмен: без журнала разбираться, почему наряд не создался, придётся вручную. Перед запуском проверяем обмен на тестовом портале и договариваемся, кто со стороны заказчика принимает работу и по каким сценариям. Сценарии описываем письменно.

Складские и учётные системы — чтобы остатки и отгрузки были видны в сделке.

Логистику и службы доставки — статусы заказов приходят в карточку автоматически.

Платёжные сервисы и банк — подтверждение оплаты без ручной сверки выписки.

И отраслевые системы: медицинские, производственные, транспортные — там, где у бизнеса своя специфика.

На лимитах: платформа ограничивает частоту запросов, и наивная реализация упирается в них на первом же массовом обмене.

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

И на молчаливых падениях: без логов и уведомлений об обрыве обмена узнают через неделю, когда расходятся цифры. Мы закрываем эти три вещи в каждом проекте.