Как описывать интеграции, если вы не технарь: вопросы, которые надо закрыть

У интеграций одна главная ловушка: всем кажется, что “там просто передать данные”. А потом выясняется, что данные разные, статусы не совпадают, ошибки неизбежны, и нужно решить, как бизнес будет работать в эти моменты.

Вот вопросы, которые должен закрыть заказчик. Не потому что вы должны стать инженером, а потому что это ваши бизнес‑правила.

1) Зачем интеграция и что должно улучшиться?

Один ответ: ускорить обработку, убрать ручной ввод, снизить ошибки, дать клиенту статус. Если цели нет — интеграция часто превращается в дорогую игрушку.

2) Какие сущности передаём?

По‑деловому: заявки, клиенты, заказы, оплаты, статусы, документы, остатки. И по каждой — какие поля важны (например, телефон, сумма, номер заказа).

3) Кто “главный” по каждому типу данных?

Где правда про оплату? Где правда про статус доставки? Где правда про контакт клиента? Это снимает вечные “а у нас в CRM иначе”.

4) Когда обновляем?

Сразу, раз в 5 минут, раз в час, раз в день. Частота — это деньги и риск. Вам нужно выбрать баланс: “достаточно быстро для процесса”.

5) Что считаем успехом и как это видно?

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

6) Что делаем при ошибках и задержках?

Ошибки будут. Важно иметь ответ:

• кто получает уведомление;
• что делает менеджер/оператор;
• как понять, что операция “зависла”;
• какие есть ручные обходные пути.

7) Как предотвращаем дубли?

Заказчик формулирует бизнес‑требование: “повтор не должен создавать новый заказ/платёж”. Подрядчик решает реализацию.

8) Как будем проверять на приемке?

Сценарии: создать заказ → оплатить → увидеть статус → убедиться, что цифры сходятся. Без сценариев интеграцию невозможно качественно принять.

Если вы зададите эти вопросы заранее, интеграции перестают быть “магией” и становятся управляемым проектом с понятным результатом.