Як автоматично повертати гроші з Allegro Finance в Kiero OMS

Обробка рекламацій та повернень — один із найбільш трудомістких процесів в інтернет-торгівлі. До цього часу після розгляду рекламації продавцю доводилося вручну авторизуватися в кабінеті Allegro, знаходити потрібне замовлення та вручну оформляти повернення коштів в Allegro Finance.

Раді повідомити, що ми впровадили повну інтеграцію повернень Allegro Finance безпосередньо з модулем рекламацій у Kiero OMS. Відтепер ви можете повернути кошти покупцеві в один клік прямо з картки рекламації в OMS, з автоматичним відстеженням статусу транзакції в базі даних.

У цій інструкції ви дізнаєтеся, як працює нова функція, які переваги вона надає та як користуватися нею в щоденній роботі.

---

Ключові переваги для вашого бізнесу

• Економія часу: Скорочення часу обробки повернення з кількох хвилин до кількох секунд.
• Усунення людських помилок: Kiero OMS автоматично підтягує суму замовлення та пов'язані платежі. Ризик помилитися в номері замовлення, сумі чи реквізитах отримувача знижується до нуля.
• Асинхронна робота (Background Sync): Ініціювання повернення та оновлення його статусу відбуваються у фоновому режимі. Інтерфейс завантажується миттєво, а статус оновлюється автоматично.
• Повна історія в OMS: Кожне повернення фіксується в базі даних Kiero OMS із детальною історією операцій, що полегшує подальший бухгалтерський облік.

---

Покрокова інструкція: Як виконати повернення Allegro Finance в Kiero OMS

Нова функція повністю інтегрована з модулем обробки рекламацій.

Крок 1: Перейдіть до деталей рекламації

У бічній панелі Kiero OMS виберіть розділ Рекламації (Complaints) та відкрийте запит, за яким було прийнято рішення про повернення коштів.

Крок 2: Надішліть запит на повернення коштів з Allegro Finance

У вікні деталей рекламації натисніть кнопку «Повернути кошти через Allegro Finance» (Refund via Allegro Finance).
Система автоматично перевірить пов'язане замовлення Allegro та доступні методи оплати.

Крок 3: Вкажіть суму та підтвердьте

У діалоговому вікні ви можете вибрати:

• Повне повернення: Вся сума замовлення разом із витратами на доставку.
• Часткове повернення: Будь-яка вказана сума (наприклад, у разі зниження ціни товару через виявлений дефект).

Після введення суми натисніть «Підтвердити повернення».

Крок 4: Відстеження статусу у фоновому режимі

Система надішле запит до API Allegro. Завдяки фоновій синхронізації цей процес не блокує інтерфейс користувача. Ви можете продовжувати роботу, поки Kiero OMS у фоновому режимі отримує остаточний статус транзакції з Allegro Finance та автоматично оновлює статус рекламації та пов'язаного замовлення.

---

Що ще змінилося в Kiero OMS? (Огляд оновлень за останні 3 дні)

Окрім автоматичних повернень Allegro Finance, ми впровадили низку важливих покращень у всій системі:

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

• Скринька повідомлень Allegro: Ми перенесли синхронізацію повідомлень Allegro на асинхронну дію, яка виконується на стороні клієнта. Також додали індикатор завантаження (loading state) в інтерфейсі користувача, автоматичне визначення облікового запису відправника та приховування непотрібних полів тем для транзакційних гілок.
• WooCommerce: Для розв'язання проблем із блокуванням запитів системами безпеки серверів WordPress (наприклад, Imunify360 / WAF), ми впровадили авторизацію типу Query String Auth та додали спеціальний заголовок User-Agent до запитів API.
• Scanye: Реалізовано повну ідемпотентність для коригувань інвойсів Scanye з механізмом автоматичного очищення записів у базі даних у разі відсутності фізичних файлів.

2. Інструменти та автоматизація (Updates)

• Kiero Print Agent (Автоматичний гібридний друк): Впроваджено інтелектуальне маршрутизування друку (hybrid printing) з автоматичним перемиканням. Система виконує миттєвий локальний друк, а у разі втрати зв'язку автоматично перемикається на хмарний друк (cloud fallback). Облікові дані агента тепер безпечно зберігаються у localStorage, а статус з'єднання агента уніфікований і відображається на всій панелі керування.

3. Інтерфейс користувача та UX (Updates)

• Перегляд зображень (Image Zoom): На сторінках пропозицій та замовлень додано сучасний компонент масштабування зображень товарів при наведенні курсора миші.
• Пошук та фільтри: Додано фільтр за ID продукту (Product ID) на сторінці пропозицій, а також оптимізовано пошук товарів за допомогою триграмних індексів (trgm) для номерів NIP та EAN.
• Адаптивність: Ми переробили діалогові вікна в повноекранні бічні панелі (Sheet layouts) в адміністративній панелі, а також прибрали жорсткі обмеження висоти у вікні деталей рекламації, що значно покращило зручність роботи на мобільних пристроях.

4. Безпека (Bezpieczeństwo)

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