Интеграция двух систем по API и webhook
Менеджер переносит заказ с сайта в CRM или складскую программу, а затем вручную обновляет статус? Свяжем две системы по API и webhook: данные будут передаваться автоматически, а результат обработки возвращаться обратно. Добавим защиту от дублей, повторы и журнал, по которому сотрудник найдёт нужную операцию и причину ошибки.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Сотрудник копирует клиента, заказ, позиции, сумму или документ из одного кабинета в другой и периодически ошибается в реквизитах.
- Нужно впервые связать две системы: передавать новые записи, изменения и отмены, а итог обработки возвращать сотруднику или клиенту.
- Внешний сервис присылает webhook — уведомление об изменении, но на сайте ещё нет обработчика, который проверяет его и обновляет нужную запись.
- Для нового обмена нужен журнал, связывающий бизнес-операцию с запросом API и показывающий причину остановки.
Что именно мы сделаем
Разбираем реальный путь одной операции и отмечаем, какая система отвечает за каждый реквизит и статус.
Сопоставляем методы API, поля, справочники, идентификаторы и правила авторизации обеих сторон.
Реализуем передачу, webhook или опрос по расписанию, защиту от дублей, повторы и понятные ошибки.
Прогоняем обычную операцию, изменение, отмену, временный сбой и повторную доставку события.
Передаём работающую интеграцию, карту данных, журнал и инструкцию для сотрудника и разработчика.
Что входит в стоимость
69 900 ₽ за всю работу
Фиксированная цена покрывает один законченный рабочий поток между двумя системами: передачу нужных данных, обратные статусы, проверку и запуск. Повторы, защита от дублей, журнал и инструкция уже входят в эту работу. Перед началом определим передаваемые объекты и действия; небольшие связанные уточнения включены в стоимость.
Что будет готово
Передадим вам
- Рабочая интеграция двух систем с передачей выбранного объекта, обратными статусами и безопасной повторной обработкой.
- Карта API, полей, справочников и состояний, а также журнал операций с поиском по внутреннему и внешнему идентификатору.
- Протокол контрольных сценариев, инструкция сотруднику и техническая памятка по доступам, ошибкам и перезапуску обмена.
Перед сдачей проверим
- Контрольная операция создаётся в системе-получателе один раз, содержит ожидаемые поля и возвращает статус в исходную систему.
- Повтор одинакового webhook сохраняет одну операцию, временная ошибка обрабатывается очередью, а постоянная ошибка появляется в понятном журнале.
- Сверка выбранной тестовой выборки подтверждает совпадение идентификаторов, сумм и итоговых состояний в обеих системах.
Как это выглядит на практике
Заказ проходит от сайта до склада и возвращает статус покупателю
Типичная ситуация: интернет-магазин и складская программа пока работают отдельно. Оператор переносит состав заказа и адрес вручную, а покупатель ждёт, пока сотрудник обновит статус отгрузки на сайте.
- 01
Интернет-магазин принимает заказ, а оператор раньше переносил позиции и адрес в складскую систему, после чего вручную менял статус на сайте.
- 02
Интеграция проверяет товары и адрес, создаёт отгрузку с единым ключом операции и сохраняет внешний номер рядом с заказом.
- 03
Склад отправляет webhook о сборке и отгрузке; повторное уведомление узнаётся по ключу и обновляет ту же запись без дубля.
- 04
Покупатель видит актуальный статус, а оператор открывает журнал только для строк с неизвестным товаром или адресом, требующим уточнения.
Что понадобится для работы
Для выполнения работы
- Названия двух систем, документация API и примеры данных. После обсуждения подготовим тестовые аккаунты и способ безопасного доступа.
- Путь одной рабочей операции: что запускает передачу, какие поля обязательны и какие статусы должны вернуться при изменении, отмене или ошибке.
- Сотрудник — владелец процесса, технические контакты поставщиков и подходящее время для контрольной синхронизации.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 66 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Можно связать сайт с любой CRM или складской системой?
Да, если обе стороны предоставляют API, webhook, файл обмена либо другой документированный интерфейс. До разработки проверим нужные методы и покажем, какие данные реально можно передавать и возвращать.
Что делать, если у одной системы нет webhook?
Настроим инкрементальный опрос по времени, курсору или изменённым идентификаторам. Он забирает только новые данные, а периодическая сверка помогает обнаружить пропущенную операцию.
Как интеграция защищается от повторного создания заказа?
Операция получает устойчивый идемпотентный ключ. При повторном запросе система находит прежний результат, обновляет журнал и сохраняет единственный бизнес-объект.
Сотрудник увидит причину ошибки без доступа к серверу?
Да. В журнале будет бизнес-операция, этап, число попыток и понятное пояснение: отсутствует поле, неизвестен справочник, истёк доступ или временно недоступен сервис.
Начальные данные тоже можно перенести?
Согласуем стартовую выборку, очистим её от дублей и загрузим перед включением текущих событий. Контрольная сверка отделяет историческую загрузку от новых операций.
Что произойдёт при недоступности внешнего API?
Запрос сохранится в очереди и повторится по безопасному расписанию. После восстановления обработка продолжится, а ответственному придёт уведомление только по операциям, которым действительно требуется вмешательство.
Можно позже добавить третью систему?
Да. Карта данных, единые идентификаторы и журнал создают основу для следующего подключения. Отдельно определим, какие сведения третья система читает и за какие статусы отвечает.
Что выбрать: новую интеграцию, восстановление или защиту от сбоев?
Эта услуга подходит для создания обмена между двумя системами. Повторы, журнал и защита от дублей уже включены. Если существующий обмен перестал работать после обновления или ошибки, начнём с услуги восстановления. Если он работает, но плохо переносит задержки внешнего сервиса, подойдёт отдельная доработка защиты от сбоев. На первом разговоре определим нужный вариант по вашей ситуации.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
В цену уже включены небольшие связанные уточнения, которые появляются после старта: например, дополнительное поле или изменение уведомления. Этот запас относится к новым уточнениям и не ограничивает время на основную работу: согласованный результат выполняем полностью за фиксированную сумму. Порядок расчёта резерва закрепляем в договоре; подробности есть в дополнительных вопросах об условиях работы ниже.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Документация API в OpenAPI и Swagger
Описать контракт и методы API
- 02Интеграция двух систем по API и webhook
Связать две системы и проверить обмен
- 03Защита интеграции при сбоях внешнего API
Защитить интеграцию от внешних сбоев