Главное
- Интеграция — это правила обмена, а не разовый экспорт: очереди, повторы, идемпотентность и журнал.
- Типовые связки: сайт и 1С, сайт и маркетплейсы, оплата, CRM, склад.
- Ошибки обмена видны в журнале, а не в переписке менеджеров.
- Стоимость считается по составу систем и числу потоков; готовых прайсов «за интеграцию» нет.
- Работаем с 1С, маркетплейсами и платёжными системами.
Содержание
Что входит в интеграцию?
| Состав | Что делаем | Результат |
|---|---|---|
| Аудит | Сущности, направления обмена, частота, владельцы данных | Карта потоков |
| Сопоставление | Товары, склады, контрагенты, статусы | Справочники соответствий |
| Транспорт | API, вебхуки, файлы, шина | Работающий канал |
| Логика | Правила создания, обновления, отмены | Предсказуемое поведение |
| Надёжность | Очереди, повторы, идемпотентность | Отсутствие дублей |
| Наблюдаемость | Журнал, оповещения, метрики | Видимые ошибки |
| Приёмка | Тесты на реальных данных, регламент | Передача в поддержку |
Разовый экспорт не считается интеграцией: он не переживает изменение цен, возвраты и сбои сети.
Какие бывают интеграции?
Сайт и 1С
Самый частый сценарий: заказы уходят в учётную систему, остатки и цены возвращаются на сайт. Обмен строится через API, HTTP-сервисы или промежуточный слой. Детали и ограничения разобраны на странице интеграция сайта с 1С, а слой ИИ поверх учётной системы — на странице ИИ для 1С.
Сайт и маркетплейсы
Товары, цены и остатки выгружаются на площадки, заказы и статусы возвращаются обратно. Основная сложность — сопоставление номенклатуры и разные правила площадок. Сценарии Ozon, Wildberries и Авито описаны на странице интеграция с маркетплейсами.
Сайт и платёжные системы
Оплата требует не только кнопки, но и обработки статусов: платёж прошёл, отменён, возвращён. Обязательны идемпотентность и проверка подписи уведомлений. Механика разобрана на странице интеграция с платёжными системами.
CRM и каналы
CRM связывается с сайтом, телефонией, почтой и мессенджерами. Заявка должна попасть в воронку один раз, с корректным источником и ответственным. Сценарии и ограничения — на странице внедрение CRM.
Склад и учёт
Складские системы связываются с сайтом и 1С по остаткам и резервам. Важно разделять доступный остаток и физический, иначе витрина продаёт то, чего нет. Правила резерва фиксируются до разработки.
Как строится обмен?
Обмен строится как набор независимых потоков. У каждого — свой источник истины, частота, правило повтора и журнал.
Очередь обязательна там, где система-получатель может быть недоступна: сайт не должен падать из-за 1С, а 1С — из-за маркетплейса. При сбое сообщение остаётся в очереди и повторяется по расписанию. Идемпотентность защищает от дублей: повторная отправка того же заказа не создаёт второй документ.
Версионирование API учитывается заранее: при обновлении одной стороны вторая продолжает работать. Если API меняется без версии, интеграция ломается в самый неудачный момент.
Опыт студии
Интеграция контентного конвейера с CMS. Внутренний проект: материалы выгружаются в CMS с переносом изображений и метаданных. Задача не сводится к «выгрузить файл»: нужно сопоставить сущности, не потерять метаданные и не создать дублей.
External API платформы. Платформа отдаёт данные по ключу; доступ ограничен, действия журналируются. Тот же принцип используется в клиентских связках: минимум прав и видимый след.
Очереди и мультитенантность. Платформа работает с несколькими тенантами и фоновыми задачами. Этот опыт переносится на интеграции: изоляция данных, повторные попытки, контроль состояния.
Клиентские внедрения не заявляются без подтверждения; описанные проекты — собственные системы студии.
Этапы работ
- Аудит: системы, сущности, направления, частота, владельцы данных.
- Проектирование: карта потоков, правила, справочники соответствий.
- Разработка: транспорт, очереди, идемпотентность, журнал.
- Тесты: реальные заказы, сбои, повторные отправки, отмены.
- Запуск: ограниченный поток, мониторинг, оповещения.
- Поддержка: обновления API, разбор ошибок, изменение правил.
Сколько стоит интеграция?
Готового прайса «за интеграцию» нет: стоимость зависит от числа систем, потоков, правил и требований к надёжности. Ориентиры по опубликованным сценариям указаны на страницах интеграций с 1С, маркетплейсами и платёжными системами. После аудита составляется смета с перечнем работ.
Сопровождение считается отдельно. В него входят мониторинг обменов, разбор ошибок и обновления при изменении API. Цена без состава систем превращается в спор о границах работ, поэтому сначала аудит.
Ошибки и ограничения
Выгрузка вместо интеграции
Файл по расписанию не обрабатывает отмены, возвраты и изменения цен. Через месяц данные расходятся, и никто не знает, где правда. Нужны правила и журнал.
Нет идемпотентности
Повторная отправка создаёт дубль заказа или документа. Ключ идемпотентности обязателен.
Нет очереди
Сбой получателя останавливает обмен, и данные теряются. Очередь с повторами решает проблему, но требует мониторинга.
Прямой доступ к таблицам
Обход бизнес-логики ломает учёт и обновления. Работать нужно через API и штатные интерфейсы.
Нет владельца данных
Если неизвестно, какая система главная для цены и остатка, интеграция закрепляет конфликт. Владелец определяется до разработки.
Частые вопросы
Что входит в интеграцию?
Аудит систем и сущностей, проектирование потоков, разработка обмена, очереди и журнал, тесты на реальных данных и регламент поддержки. Стоимость зависит от состава систем и числа правил. Разовый экспорт интеграцией не считается. Проверка включает повторные отправки и отмены до запуска. Это обязательная часть приёмки.
Сколько стоит и сколько занимает?
Цена считается по составу систем и потоков, готового прайса нет. Ориентиры — на страницах конкретных интеграций. Срок зависит от готовности API и качества справочников; после аудита фиксируется график. Готовый коннектор может сократить срок и стоимость, но требует проверки на ваших правилах.
Можно ли связать сайт с 1С и маркетплейсами одновременно?
Да, но потоки проектируются отдельно: у каждого свой источник истины и правила. Общая очередь и журнал упрощают поддержку. Важно заранее определить, какая система главная для цены и остатка. Для каждого показателя назначается одна главная система; правило фиксируется в регламенте и проверяется.
Что будет при сбое одной из систем?
Сообщение остаётся в очереди и повторяется по расписанию. Ошибка фиксируется в журнале и вызывает оповещение. Сайт и учётная система не блокируют друг друга. Оповещение приходит ответственному, а не в общий чат; он разбирает инцидент и фиксирует причину, чтобы устранить её, а не искать виноватых.
Как защищаетесь от дублей?
Ключом идемпотентности и проверкой состояния перед созданием документа. Повторная отправка того же заказа не создаёт второй. Тесты включают повторные отправки и отмены. Проверка на дубли повторяется после запуска на тестовом контуре и на копии боевых данных перед обновлением и после отката.
Работаете ли с готовыми коннекторами?
Да, если коннектор закрывает задачу и его поведение проверяемо. Если правила сложные или нужна своя логика, собирается отдельный слой. Решение принимается после аудита. Критерий — поддержка правил и предсказуемое поведение; если коннектор не поддерживает нужное правило, выбирается свой слой с журналом.
Что входит в поддержку?
Мониторинг обменов, разбор ошибок, обновления при изменении API и правки правил. Поддержка не входит в стоимость проекта и считается отдельно. Регламент реакции согласуется заранее. Отдельно фиксируются часы на доработки; работы сверх регламента оцениваются по факту и согласуются заранее отдельной сметой.
Итоги
- Интеграция — правила обмена, а не разовая выгрузка.
- Очередь, повторы и идемпотентность защищают от потерь и дублей.
- У каждого потока есть источник истины и владелец данных.
- Ошибки должны быть видны в журнале, а не в переписке.
- Стоимость считается по составу систем после аудита.
- Поддержка — отдельная услуга с регламентом.
Начинать стоит с одного потока: например, заказы из сайта в 1С. Он покажет качество справочников и готовность API до расширения.
Как начать
Пришлите список систем, направление обмена и объём данных. Ответим в течение рабочего дня: какие потоки нужны, что можно проверить первым и какие данные подготовить.
Что войдёт в оценку: системы и их API, сущности и правила, частота обмена, требования к надёжности и владельцы данных.
Телефон: 8 (917) 749-78-98. Email: maksim@nabiullin.com. Офис: Уфа, ул. Ветошникова, 99, оф. 514. Работаем по России.