ㅤSitniks — це сучасна українська CRM-система для малого й середнього бізнесу. Вона допомагає автоматизувати процеси управління замовленнями, складом, доставкою, продажами та фінансами. За допомогою Sitniks компанії можуть швидко обробляти замовлення, контролювати запаси та організовувати роботу команд.
ㅤ
ㅤІнтеграція Sitniks із Finmap дозволяє автоматично передавати дані про фінансові транзакції (платежі, витрати) в систему обліку фінансів без ручного введення. Це зменшує ризики помилок, економить час команди і забезпечує актуальність фінансової звітності в реальному часі.
ㅤ
ㅤ
⚙️ Як працює інтеграція?
ㅤ
1. Отримання даних із Sitniks
- Система використовує Sitniks API-ключ для доступу до ваших транзакцій.
- Дані отримуються порціями по 50 транзакцій, щоб не перевантажити систему.
ㅤ
2. Фільтрація та обробка
- Фільтруємо лише нові транзакції (з дати старту або після останньої синхронізації).
- Перевіряємо, чи транзакція вже не була передана раніше.
- Визначаємо тип:
- Дохід → «дохід» у Finmap.
- Витрата → «витрата» у Finmap.
- Прив’язуємо транзакцію до відповідного рахунку у Finmap.
ㅤ
ㅤ
3. Передача у Finmap
- Дані передаються через Finmap API-ключ.
- Якщо транзакція не проходить — система повторює спробу кожні 15 хвилин.
ㅤ
ㅤ
4. Періодичність
- Раз на годину: основна синхронізація.
- Кожні 15 хвилин: повторна перевірка невдалих транзакцій.
ㅤ
5. Логи та надійність
- Усі дії логуються для відстеження.
- У разі помилок — команда отримує повідомлення для оперативного реагування.
Які дані передаються з Sitniks у Finmap
| Дані з Sitniks | Як виглядає у Finmap | Що означає / приклади |
| 🆔 ID транзакції | Унікальний ідентифікатор операції | Напр. “tx_12345”. Використовується для перевірки унікальності та уникнення дублювання. |
| 📅 Дата та час транзакції | date | Напр. “2025-01-15 10:30:00”. Використовується для синхронізації (беруться тільки нові транзакції після певної дати). |
| 💰 Сума транзакції | amount | Позитивна → дохід (Income), від’ємна → витрата (Expense). Напр. +1500 UAH (оплата клієнта), -100 UAH (комісія чи доставка). |
| 📊 Тип транзакції | type | Визначається автоматично за знаком суми: • Дохід: платежі від клієнтів, продажі через Instagram, Rozetka, Prom.ua. • Витрата: комісії маркетплейсів, доставка (Нова Пошта), повернення. |
| 📝 Опис транзакції | comment (основа) | Напр. “Оплата за замовлення #123 від клієнта Іваненко”. Є базою для коментаря у Finmap. |
| 👤 Контрагент | Додається у comment | Напр. ім’я клієнта (Іваненко), email, Instagram-нік або ID клієнта. |
| 🌐 Джерело транзакції | Додається у comment | Напр. “Instagram”, “Rozetka”, “Нова Пошта”. Використовується для додаткової категоризації. |
| ➕ Додаткові деталі | Комбінуються у comment | Напр. номер замовлення, спосіб оплати, доставка. Формують інформативний текст. |
📍 Де це видно у Finmap
Рахунок → обраний рахунок користувача (наприклад, “Каса”)
ㅤ
Розділ: Операції (Operations)
Відображення у веб-інтерфейсі:
Сума → amount (дохід або витрата)
Дата → date
🧾 Що потрібно для запуску?
Зберіть і передайте ці дані:
ㅤ
| Дані | Де знайти | Коментар |
|---|---|---|
| Sitniks API-ключ | Sitniks → Налаштування → Інтеграції → Open API | Доступ до транзакцій |
| Finmap API-ключ | Finmap → Налаштування компанії → API | Доступ до запису в Finmap |
| ID або назва рахунку | Finmap → Рахунки | Вкажіть ID або назву |
| Дата початку | На ваш розсуд | З якої дати починати імпорт |
| Ім’я користувача | Будь-яке унікальне ім’я | Наприклад, sitniks_user_1 |
ㅤ
ㅤ
🚀 Що відбувається після запуску?
ㅤ
Перший запуск:
- Імпортуємо всі транзакції з дати початку.
- Фіксуємо, що вже було передано.
ㅤ
Подальша робота:
- Щогодини перевіряємо нові транзакції.
- Повторно пробуємо невдалі транзакції кожні 15 хвилин.
ㅤ
Надійність:
- Перевірка ключів перед стартом.
- Один рахунок Finmap → одна інтеграція.
- Логи всіх дій.
- Готовність до масштабування та додавання інших сервісів.
ㅤ
🔄 Оновлення логіки інтеграції з Sitniks
У рамках оновлення інтеграції з Sitniks, у Finmap до коментарів транзакцій тепер також передається статус замовлення. Це дозволяє користувачам зручно відслідковувати етапи обробки замовлень безпосередньо у Finmap.
ㅤ
🔮 У майбутньому:
- Гнучке налаштування частоти (наприклад, раз на добу).
- Slack-сповіщення про зміни у Sitniks.
- Обробка транзакцій через черги для великих обсягів.
ㅤ