ТЕХНІЧНЕ ЗАВДАННЯ (ТЗ)
Інтеграція облікової системи з платформою InBoost
1. Мета інтеграції
Автоматизувати обмін даними між обліковою системою компанії та платформою InBoost для:
- ведення клієнтської бази
- роботи бонусної програми
- передачі подій покупок
- уникнення дублювання даних
- контролю коректності синхронізації
2. Синхронізація клієнтів
2.1 Логіка роботи
1. Система повинна періодично виконувати пошук клієнтів у InBoost.
2. Якщо клієнт існує у InBoost, але відсутній в обліковій системі — необхідно створити клієнта в обліковій системі.
3. Якщо клієнт існує в обох системах:
- передати історію покупок за останні 3 місяці (без дублювання);
- передати актуальний баланс бонусів.
2.2 Ідентифікація клієнтів
Ідентифікація клієнтів виконується за номером телефону.
3. Бонусна програма
3.1 Оновлення бонусів
При зміні балансу бонусів в обліковій системі необхідно:
- відправляти нову кількість бонусів у InBoost
- використовувати API InBoost
Передача повинна виконуватися при кожній зміні бонусного балансу.
4. Нарахування бонусів
При нарахуванні бонусів система повинна:
- відправляти код нарахування бонусів на Webhook InBoost.
Вимоги:
- реалізувати захист від дублювання
- код нарахування передається лише один раз.
5. Списання бонусів
При списанні бонусів система повинна:
- відправляти код списання бонусів на Webhook InBoost.
Вимоги:
- реалізувати захист від дублювання
- код списання передається лише один раз.
6. Події після покупки
Після здійснення покупки необхідно:
1. відправити подію покупки на Webhook InBoost;
2. виконати окремий API-запит із деталями покупки.
Вимоги:
- подія передається лише один раз
- дублювання подій не допускається.
7. Інформування про згорання бонусів
Система повинна:
1. сформувати список клієнтів, у яких бонуси скоро згорять;
2. сформувати один webhook-запит;
3. передати перелік номерів телефонів клієнтів.
8. Дані клієнта (мапінг полів)
При створенні або оновленні клієнта необхідно зберігати:
- номер телефону
- ім’я
- прізвище
- дата народження
- джерело залучення
- спеціальність
9. Технічні вимоги
Інтеграція повинна використовувати:
- REST API InBoost
- Webhook події.
10. Логування
Необхідно реалізувати:
- логування всіх API-запитів
- логування помилок
- логування випадків дублювання подій.
11. Захист від дублювання
Для наступних подій має використовуватись унікальний ID події:
- покупки
- нарахування бонусів
- списання бонусів
Це необхідно для уникнення повторної обробки подій.
12. Періодичність синхронізації
Рекомендована частота роботи системи:
- синхронізація клієнтів — кожні 10–30 хвилин
- передача бонусів — у реальному часі
- передача подій покупок — у реальному часі.
13. Очікуваний результат
Після реалізації інтеграції повинно бути забезпечено:
- автоматичну синхронізацію клієнтів
- коректну роботу бонусної програми
- передачу подій покупок у систему
- відсутність дублювання даних
- стабільну інтеграцію між системами.
