Связываю сайт с 1С, Битрикс24, платёжными сервисами и доставкой. До разработки описываю, какие данные передавать, какая система отвечает за каждое поле и что делать при ошибке. Обмен проверяю на тестовых данных и снабжаю журналом.
✕Остатки на сайте не совпадают с 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?
Её специалист. Я передаю запрос, ответ, время и идентификатор объекта, чтобы причину можно было найти. Со стороны сайта исправления делаю сам.
-Достаточно ли готового модуля интеграции?
Да, если он поддерживает нужные поля, события и сценарии восстановления после сбоя. Проверяю это до заказа собственной разработки.