Intum дозволяє з’єднатися з Fakturownia.pl - завантажувати рахунки-фактури, імпортувати клієнтів і налаштовувати автоматичні сповіщення про нові рахунки.
Можна підключити кілька облікових записів Fakturownia одночасно.
Як встановити
Перейдіть у Обліковий запис > Інтеграції та додатки (/account/apps). Знайдіть “Інтеграція з Fakturownia.pl” і натисніть Встановити.
Після встановлення в тому самому місці з’явиться кнопка Запустити - натискаєте її і переходите до застосунку.
Альтернативно до того самого місця ви потрапите з Продажі > Налаштування - унизу є розділ Інтеграції та додатки з посиланням “Додати інтеграцію”.
Підключення облікового запису Fakturownia
Після відкриття застосунку натисніть Додати обліковий запис. Вам потрібні дві речі:
-
URL облікового запису - це адреса вашої Fakturownia, напр.
https://mojafirma.fakturownia.pl - Токен API - ви знайдете його в Fakturownia: Налаштування > Інтеграція > Код авторизації API
Після додавання натисніть “Перевірити”, щоб переконатися, що з’єднання працює.
Швидкий шлях: активація через Fakturownia
Якщо ви раніше активували Intum з рівня самої Fakturownia (напр. увімкнувши в Fakturownia Налаштування > Налаштування облікового запису - розділ Інше внизу сторінки), то Токен API найчастіше вже налаштований в Intum автоматично - вам не потрібно його нікуди копіювати.
Додатково після ввімкнення Модуля CRM (або інших модулів Intum) у Fakturownia, у верхньому меню Fakturownia з’явиться посилання на CRM та решту активних модулів Intum. Натискаєте посилання і переходите прямо до Intum у контексті цього облікового запису.
Що можна робити
Завантаження рахунків-фактур
Натисніть на обліковий запис Fakturownia, а потім Запустити біля “Імпорт рахунків”. Рахунки потраплять до модуля Продажі разом із позиціями та даними контрагентів. Біля кожного імпортованого рахунка є посилання на оригінал у Fakturownia.
Завантаження клієнтів
Запустити біля “Імпорт клієнтів” - клієнти з Fakturownia потраплять до CRM. Якщо клієнт уже існує, заповнюються лише порожні поля (нічого не буде перезаписано).
Обидва імпорти показують прогрес у реальному часі - скільки рахунків/клієнтів створено, оновлено, пропущено.
Автоматичні рахунки (webhook-и)
У деталях облікового запису натисніть Зареєструвати в розділі Webhooks. Із цього моменту нові та змінені рахунки в Fakturownia автоматично потраплятимуть до Intum.
Webhook-и працюють лише на продакшні (Fakturownia повинна мати доступ до вашої адреси).
Швидкий доступ до Fakturownia з рівня Intum
Біля кожного імпортованого рахунка в Продажі > Рахунки є посилання “Показати в Fakturownia” - переносить прямо до цього рахунка в панелі Fakturownia. Так само біля клієнта - якщо він був імпортований з Fakturownia, видно посилання на його профіль.
Автоматичне виставлення рахунків в Intum
Якщо ви хочете, щоб з рівня Intum можна було виставляти рахунки (що відкриваються у Fakturownia із заповненими даними клієнта) - див. Виставлення рахунків в Intum через Fakturownia.pl.
Де це знайти
- Встановлення і список інтеграцій: Обліковий запис > Інтеграції та додатки (
/account/apps) - Швидкий шлях у модулі продажів: Продажі > Налаштування > розділ “Інтеграції та додатки”
- Пряме посилання на застосунок після встановлення:
/a/fakturownia-integration - Активація на боці Fakturownia: Fakturownia > Налаштування > Налаштування облікового запису > розділ Інше (внизу сторінки) - там ви вмикаєте Модуль CRM та решту модулів Intum
Ручна інтеграція (для досвідчених)
Стандартне встановлення через Обліковий запис > Інтеграції та додатки налаштовує все автоматично - включно з webhook-ами. Цей розділ читайте лише якщо з якоїсь причини хочете налаштувати інтеграцію вручну, через модуль Конектори.
Конектор Fakturownia і URL webhook
Замість застосунку з магазину інтеграцій ви можете додати конектор типу Fakturownia в модулі Конектори. Кожен конектор має свій код (напр. fakturownia1) - ви знайдете його в налаштуваннях конектора.
URL webhook для синхронізації рахунків має формат:
https://twoja-domena.intum.com/connect/connector/KOD_KONEKTORA/receive_invoice_webhook
Якщо у вас кілька конекторів Fakturownia, кожен має окремий URL.
Webhook-и на боці Fakturownia
- Увійдіть до Fakturownia
- Перейдіть до Налаштування > API > Webhooks (або зайдіть на
/webhooks) - Додайте два webhook-и, що вказують на той самий URL конектора:
- тип події
invoice:create- для нових рахунків - тип події
invoice:update- для змін (напр. зміна статусу на “оплачено”)
- тип події
Кожен рахунок з Fakturownia потрапить до Intum разом із позиціями та даними сторін. Рахунок буде автоматично прив’язаний до клієнта CRM за ІПН.
Синхронізація історичних рахунків
Webhook-и обробляють лише нові та змінені рахунки. Рахунки, виставлені до ввімкнення webhook-ів, ви імпортуєте через групову синхронізацію в налаштуваннях конектора.