ㅤUspasy — це сучасна онлайн-платформа, що поєднує в собі CRM, комунікації, спільну роботу, автоматизацію процесів та аналітику в одному місці. Вона допомагає організувати робочі процеси компанії, сприяє ефективній взаємодії в команді, управлінню продажами та завданнями.
ㅤ
ㅤ
🔧 Кому буде корисна інтеграція
- Власникам бізнесу — бачать фінансову картину в реальному часі завдяки автоматичному перенесенню даних із CRM.
- Бухгалтерам і фінансовим менеджерам — економія часу на ручному внесенні операцій та зменшення ризику помилок.
- Адміністраторам — зручна синхронізація для формування звітності та контролю фінансових процесів.
ㅤ
🔗 Переваги інтеграції з Uspasy
- Автоматичне завантаження транзакцій із Uspacy у Finmap.
- Передача даних кожну годину.
- Повторна перевірка незавершених транзакцій кожні 15 хвилин.
ㅤ
🔧 Які дані передаються з Uspacy у Finmap
| Дані з Uspacy (UspacyTransaction) | Як виглядає у Finmap | Примітки |
| id | Використовується у comment | Наприклад: “Transaction from Uspacy {id}” |
| title | comment | Додається до опису операції |
| owner | — | Використовується лише при зворотній синхронізації |
| created_at | date | Конвертується у формат дати |
| amount.value | amount | Дохід (якщо >0) / Витрата (якщо <0) |
| amount.currency | currency | Якщо не вказано → за замовчуванням UAH |
| external_id | externalId | Формат: finmap_uspacy_${uuid} |
| — | type | income або expense (автоматично) |
| — | accountToId / accountFromId | Залежить від типу операції |
| created_by, changed_by, converted, updated_at, link, integration, kanban_status, kanban_reason_id, kanban_stage_id, paid_at, closed_by, closed_at, first_closed_by, first_closed_at | — | Не відображаються напряму, використовуються для внутрішньої логіки / моніторингу |
ㅤ
📌 Підсумок:
- З Uspacy забирається повний набір полів транзакції, але у Finmap реально використовуються лише: назва, сума, валюта, дата, externalId, тип (дохід/витрата), рахунок.
- Решта полів зберігаються для технічних потреб (синхронізація, моніторинг, логіка).
ㅤ
⚙️Що потрібно для підключення інтеграції?
- Uspacy API-ключ — це як пароль, який дозволяє нам брати транзакції з вашого Uspacy. Ви можете знайти його у налаштуваннях Uspacy або звернутися до підтримки Uspacy.
- Finmap API-ключ — це ключ, який дозволяє нам додавати транзакції у ваш Finmap. Знайти його можна Налаштуваннях компанії → розділі API.
ㅤ
ㅤ
ㅤ
- ID рахунку в Finmap. Для того щоб знайти id рахунку потрібно відкрити Інструменти розробника (зробити це можна за допомогою комбінації клавіш Ctrl+Shift+I).
Далі необхідно перейти до вкладки Network, оновити сторінку та ввести у пошуковому рядку accounts, після чого натиснути на accounts?context=log та відкрити вкладку Preview.
У списку id рахунків потрібно обрати те id, яке знаходиться біля номеру вашого рахунку у лівій бічній панелі рахунків -1. Тобто якщо ваш рахунок 8 у списку, потрібно обирати id рахунку під номером 7.
ㅤ
ㅤ
- Дата початку інтеграції — це дата, починаючи з якої платежі будуть надходити до Finmap.
- Ім’я користувача — унікальна назва для інтеграції (наприклад, uspacy_user_1).
ㅤ
⚙️Як підключити інтеграцію?
- Напишіть у нашу службу підтримки і надайте усі дані, що необхідні для підключення інтеграції (API-ключі, id рахунку, дату початку інтеграції та ім’я користувача).
- Ми перевіримо чи все працює належним чином і запустимо процес інтеграції.
- Ви побачите транзакції у Finmap протягом години після запуску (або швидше, якщо є нові дані).
ㅤ
⚙️Як інтеграція працює після запуску?
- Перший запуск: система завантажує всі транзакції, починаючи з вашої дати старту, і переносить їх у Finmap.
- Далі: щогодини перевіряються нові транзакції, а у випадку помилок повторна спроба робиться кожні 15 хв.
- Фільтрація: у Finmap передаються тільки нові, ще не відправлені операції.
ㅤ
⚙️Надійність і контроль
- Перевірка ключів: перед запуском інтеграція тестує чи працюють ваші ключі для Uspacy і Finmap
- Унікальність: один рахунок Finmap може бути прив’язаний лише до однієї інтеграції.
- Логування: усі дії записується у спеціальні файли (логи) для того щоб при потребі виявити помилки та виправити їх.
ㅤ
✅ Готово! Інтеграція Uspasy із Finmap налаштована!