Главное

  • Интеграция — это правила обмена, а не разовый экспорт: очереди, повторы, идемпотентность и журнал.
  • Типовые связки: сайт и 1С, сайт и маркетплейсы, оплата, CRM, склад.
  • Ошибки обмена видны в журнале, а не в переписке менеджеров.
  • Стоимость считается по составу систем и числу потоков; готовых прайсов «за интеграцию» нет.
  • Работаем с 1С, маркетплейсами и платёжными системами.

Содержание

Что входит в интеграцию?

СоставЧто делаемРезультат
АудитСущности, направления обмена, частота, владельцы данныхКарта потоков
СопоставлениеТовары, склады, контрагенты, статусыСправочники соответствий
ТранспортAPI, вебхуки, файлы, шинаРаботающий канал
ЛогикаПравила создания, обновления, отменыПредсказуемое поведение
НадёжностьОчереди, повторы, идемпотентностьОтсутствие дублей
НаблюдаемостьЖурнал, оповещения, метрикиВидимые ошибки
ПриёмкаТесты на реальных данных, регламентПередача в поддержку

Разовый экспорт не считается интеграцией: он не переживает изменение цен, возвраты и сбои сети.

Какие бывают интеграции?

Сайт и 1С

Самый частый сценарий: заказы уходят в учётную систему, остатки и цены возвращаются на сайт. Обмен строится через API, HTTP-сервисы или промежуточный слой. Детали и ограничения разобраны на странице интеграция сайта с 1С, а слой ИИ поверх учётной системы — на странице ИИ для 1С.

Сайт и маркетплейсы

Товары, цены и остатки выгружаются на площадки, заказы и статусы возвращаются обратно. Основная сложность — сопоставление номенклатуры и разные правила площадок. Сценарии Ozon, Wildberries и Авито описаны на странице интеграция с маркетплейсами.

Сайт и платёжные системы

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

CRM и каналы

CRM связывается с сайтом, телефонией, почтой и мессенджерами. Заявка должна попасть в воронку один раз, с корректным источником и ответственным. Сценарии и ограничения — на странице внедрение CRM.

Склад и учёт

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

Как строится обмен?

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

Очередь обязательна там, где система-получатель может быть недоступна: сайт не должен падать из-за 1С, а 1С — из-за маркетплейса. При сбое сообщение остаётся в очереди и повторяется по расписанию. Идемпотентность защищает от дублей: повторная отправка того же заказа не создаёт второй документ.

Версионирование API учитывается заранее: при обновлении одной стороны вторая продолжает работать. Если API меняется без версии, интеграция ломается в самый неудачный момент.

Опыт студии

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

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

Очереди и мультитенантность. Платформа работает с несколькими тенантами и фоновыми задачами. Этот опыт переносится на интеграции: изоляция данных, повторные попытки, контроль состояния.

Клиентские внедрения не заявляются без подтверждения; описанные проекты — собственные системы студии.

Этапы работ

  1. Аудит: системы, сущности, направления, частота, владельцы данных.
  2. Проектирование: карта потоков, правила, справочники соответствий.
  3. Разработка: транспорт, очереди, идемпотентность, журнал.
  4. Тесты: реальные заказы, сбои, повторные отправки, отмены.
  5. Запуск: ограниченный поток, мониторинг, оповещения.
  6. Поддержка: обновления API, разбор ошибок, изменение правил.

Сколько стоит интеграция?

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

Сопровождение считается отдельно. В него входят мониторинг обменов, разбор ошибок и обновления при изменении API. Цена без состава систем превращается в спор о границах работ, поэтому сначала аудит.

Ошибки и ограничения

Выгрузка вместо интеграции

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

Нет идемпотентности

Повторная отправка создаёт дубль заказа или документа. Ключ идемпотентности обязателен.

Нет очереди

Сбой получателя останавливает обмен, и данные теряются. Очередь с повторами решает проблему, но требует мониторинга.

Прямой доступ к таблицам

Обход бизнес-логики ломает учёт и обновления. Работать нужно через API и штатные интерфейсы.

Нет владельца данных

Если неизвестно, какая система главная для цены и остатка, интеграция закрепляет конфликт. Владелец определяется до разработки.

Частые вопросы

Что входит в интеграцию?

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

Сколько стоит и сколько занимает?

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

Можно ли связать сайт с 1С и маркетплейсами одновременно?

Да, но потоки проектируются отдельно: у каждого свой источник истины и правила. Общая очередь и журнал упрощают поддержку. Важно заранее определить, какая система главная для цены и остатка. Для каждого показателя назначается одна главная система; правило фиксируется в регламенте и проверяется.

Что будет при сбое одной из систем?

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

Как защищаетесь от дублей?

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

Работаете ли с готовыми коннекторами?

Да, если коннектор закрывает задачу и его поведение проверяемо. Если правила сложные или нужна своя логика, собирается отдельный слой. Решение принимается после аудита. Критерий — поддержка правил и предсказуемое поведение; если коннектор не поддерживает нужное правило, выбирается свой слой с журналом.

Что входит в поддержку?

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

Итоги

  • Интеграция — правила обмена, а не разовая выгрузка.
  • Очередь, повторы и идемпотентность защищают от потерь и дублей.
  • У каждого потока есть источник истины и владелец данных.
  • Ошибки должны быть видны в журнале, а не в переписке.
  • Стоимость считается по составу систем после аудита.
  • Поддержка — отдельная услуга с регламентом.

Начинать стоит с одного потока: например, заказы из сайта в 1С. Он покажет качество справочников и готовность API до расширения.

Как начать

Пришлите список систем, направление обмена и объём данных. Ответим в течение рабочего дня: какие потоки нужны, что можно проверить первым и какие данные подготовить.

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

Телефон: 8 (917) 749-78-98. Email: maksim@nabiullin.com. Офис: Уфа, ул. Ветошникова, 99, оф. 514. Работаем по России.