Як інтегрувати Fakturownia з Kiero OMS та автоматизувати виставлення рахунків

Автоматизація бухгалтерських процесів — це ключ до економії часу та уникнення помилок у щоденній роботі кожного продавця. З радістю повідомляємо, що ми повністю інтегрували платформу Fakturownia.pl (InvoiceOcean) з системою Kiero OMS.

Завдяки цій інтеграції Kiero OMS автоматично створює платіжні документи безпосередньо на основі замовлень із ваших каналів продажів (наприклад, Allegro, WooCommerce, Etsy), а потім надсилає їх покупцям або на відповідні торгові майданчики.

Нижче ви знайдете детальний посібник, як крок за кроком підключити інтеграцію та налаштувати її для вашого бізнесу.

---

Переваги інтеграції Kiero OMS з Fakturownia

• Підтримка Multi-Entity (Кілька компаній): Ви можете пов'язати різні юридичні особи, налаштовані в Kiero OMS, з окремими відділами (Departments) в одному акаунті Fakturownia. Це дозволяє зручно виписувати рахунки для різних брендів або фірм з єдиного кабінету.
• Автоматичне виставлення рахунків (B2B та B2C): Система автоматично генерує стандартні рахунки-фактури (Faktura VAT) для компаній (на основі коду NIP/ЄДРПОУ) та іменні рахунки (Faktura imienna) для приватних осіб.
• Обробка в черзі (Queue Processing): Процес генерації документів відбувається асинхронно через спеціальну фонову задачу (fakturownia_invoice_create). Це гарантує швидку роботу OMS без затримок навіть під час пікових навантажень.
• Платежі та Коригування (Corrections): Система повністю підтримує створення коригувальних рахунків (тип correction), відстежує історію надсилання клієнту електронною поштою та автоматично передає документи на зовнішні маркетплейси (наприклад, Allegro).
• Пряме надсилання e-mail: Kiero OMS автоматично дає вказівку сервісу Fakturownia надіслати готовий документ PDF на електронну пошту клієнта відразу після його створення.

---

Інструкція крок за кроком: Підключення та налаштування

Налаштування інтеграції триває всього кілька хвилин:

Крок 1: Отримайте API Token у Fakturownia

1. Увійдіть у свій кабінет на Fakturownia.pl.
2. Перейдіть до Ustawienia (Налаштування) -> Ustawienia konta (Налаштування облікового запису) -> Integracja (Інтеграція).
3. Скопіюйте ваш унікальний Kod autoryzacyjny API (API Token).

Крок 2: Активуйте інтеграцію в Kiero OMS

1. Увійдіть до панелі Kiero OMS та перейдіть до розділу Налаштування -> Інтеграції -> Fakturownia.
2. Вставте скопійований API Token.
3. Вкажіть адресу домену вашого облікового запису (наприклад, your-name.fakturownia.pl).
4. Натисніть кнопку Зберегти або Підключити.

Крок 3: Налаштуйте зв'язок відділів (Multi-Entity)

1. Натисніть Синхронізувати відділи, щоб Kiero OMS завантажив список ваших компаній/відділів з Fakturownia.
2. У налаштуваннях документів пов'яжіть відповідні профілі фірм в OMS з конкретними відділами у Fakturownia (наприклад, призначте окремі відділи для внутрішніх продажів B2B, B2C та коригувань).
3. Натисніть кнопку «Тестувати з'єднання», щоб переконатися, що все налаштовано правильно.

---

Что ще змінилося в Kiero OMS? (Огляд новинок)

Протягом останніх 3 днів ми впровадили низку покращень для підвищення стабільності та безпеки системи:

1. Інтеграції (Integrations)

• WooCommerce: Додано заголовок User-Agent до запитів до WooCommerce API. Це дозволяє обходити блокування WAF та систем безпеки серверів WordPress (наприклад, Imunify360).
• Furgonetka: Перенесено всю інтеграцію на безпечний протокол авторизації OAuth2 з фоновим автооновленням токенів. Покращено обробку балансових помилок та впроваджено механізм автоматичних повторних спроб (Auto-Retry) при помилках валідації.
• Allegro (AI Act): Додано підтримку вимог ЄС щодо маркування контенту, створеного штучним інтелектом. При редагуванні пропозицій Allegro тепер можна вказати статус «AI co-created» для зображень, і система надішле цю декларацію під час синхронізації.
• Allegro (Етикетки): Виправлено помилку запиту при отриманні транспортних етикеток, коли до одного облікового запису було прив'язано кілька конфігурацій перевізників.

2. Автоматизація (Updates)

• Додано нові тригери автоматизації: «invoice_generated» (створено рахунок) та «correction_generated» (створено коригування). Тепер можна автоматично надсилати e-mail, SMS або повідомлення в Slack/Telegram після виписки документа.
• Додано тригери для процесу повернень: «return_created» та «return_status_changed» для миттєвого реагування на запити клієнтів.

3. Безпека (Security)

• Впроваджено політику Row Level Security (RLS) для чутливих таблиць системних логів, що посилює захист даних від несанкціонованого доступу на рівня бази даних.

4. Покращення та Telegram-бот (Updates)

• У Telegram-бот додано кнопку швидкої дії «Відхилити/Скасувати» та команду cancel_fix для оперативного управління інцидентами з мобільного телефону.
• Покращено валідацію адрес для кур'єрських служб (розділення номерів будинків та квартир у даних отримувача).