Менеджер бачить у CRM статус «готово» і передає замовлення у виконання. Юрист тим часом чекає на підпис клієнта. Обидві команди користуються системами, але по-різному розуміють одну позначку. Перед інтеграцією варто домовитися, яку подію підтверджує кожен статус і що він дозволяє робити далі.
Почніть зі значення події
Умовний приклад: пропозиція погоджена всередині компанії, проєкт договору надісланий клієнту, а обидві сторони ще не підписали документ. Це три різні факти. Внутрішнє погодження не має автоматично переводити замовлення в стан, для якого потрібне завершене підписання.
Для кожної події визначте джерело, час, пов’язаний документ і версію. Окремо погодьте умову переходу в CRM. Іноді потрібен набір подій: завершене підписання, перевірений обсяг та призначений виконавець. Один колір у картці не замінює цих умов.
Передавайте ідентифікатор, а не лише назву
Назва компанії може бути скорочена, а два файли — називатися однаково. Обмін має спиратися на узгоджені ідентифікатори клієнта, угоди й документа. Версію та напрям обміну також потрібно визначити явно: яка система створює запис, яка оновлює поле і хто розбирає конфлікт.
| Ситуація | Що перевірити | Наступна дія |
|---|---|---|
| Документ надіслано | Клієнт, версія, адресат | Очікувати визначену відповідь |
| Статус підписання отримано | Потрібні сторони й актуальна версія | Перевірити готовність передачі |
| Подія надійшла повторно | Ідентифікатор уже обробленої події | Не створювати повторне завдання |
| Виявлено іншу версію | Чи стосується подія чинного документа | Передати конфлікт відповідальному |
Виняток повинен мати власника
Запізніле повідомлення, недоступна система або невідомий клієнт не повинні непомітно губитися. Потрібна черга винятків із причиною, пов’язаним записом і відповідальним. Після виправлення обмін має відновлюватися без другого замовлення чи дубльованого повідомлення клієнту.
Під час пілоту перевірте не лише успішний маршрут. Повторіть подію, змініть версію перед її отриманням і тимчасово перервіть обмін. Команда має побачити, де зупинилася робота та як її відновити.
Приймайте інтеграцію за робочим результатом
Технічна відповідь сервера підтверджує лише певний етап обміну. Перевірте сам бізнес-запис: правильного клієнта, документ, допустимий статус і наступну задачу. У сценарії з Deals та чинною CRM доступні інтерфейси й конфігурацію потрібно підтвердити окремо — самого рішення про інтеграцію недостатньо.
- Узгодьте словник подій і переходів.
- Зафіксуйте ідентифікатори та джерела полів.
- Призначте відповідального за кожен тип помилки.
- Прийміть звичайний, повторний і перерваний сценарії.
Питання та відповіді
Чи достатньо передавати посилання на файл?
Посилання допомагає відкрити документ, але саме по собі не підтверджує його версію, клієнта чи стан підписання. Потрібний узгоджений контекст запису.
З якої інтеграції починати?
З одного типу документа й визначеного маршруту. Розширюйте обмін після перевірки основного сценарію та винятків.