How to Automate Refunds via Allegro Finance in Kiero OMS

Managing complaints and refunds is one of the most time-consuming processes in e-commerce. Until now, after resolving a complaint, a merchant had to manually log into the Allegro dashboard, locate the specific order, and manually request a refund in Allegro Finance.

We are excited to announce that we have implemented full integration of Allegro Finance refunds directly into the complaints module in Kiero OMS. From now on, you can issue refunds to the buyer with a single click, right from the complaint details card in the OMS, with automatic status tracking in the database.

In this guide, you will learn how this new feature works, the benefits it brings, and how to use it in your daily operations.

---

Key Benefits for Your Business

• Time Savings: Reduce refund processing time from several minutes to just a few seconds.
• Elimination of Human Errors: Kiero OMS automatically retrieves the order amount and associated payment details. The risk of mixing up order numbers, amounts, or recipient details is reduced to zero.
• Asynchronous Execution (Background Sync): The refund request and status retrieval are processed in the background. The page loads instantly, and the refund status updates automatically.
• Complete History in OMS: Every refund is logged in the Kiero OMS database with a detailed history of operations, simplifying accounting and reconciliation.

---

Step-by-Step Guide: How to Issue an Allegro Finance Refund in Kiero OMS

The new feature is fully integrated into the complaints management module.

Step 1: Open Complaint Details

In the sidebar menu of Kiero OMS, navigate to Complaints and open the ticket that has been approved for a refund.

Step 2: Request Allegro Finance Refund

In the complaint details view, click the "Refund via Allegro Finance" button.
The system will automatically verify the associated Allegro order and check available payment methods.

Step 3: Specify the Amount and Confirm

In the dialog window, you can choose:

• Full Refund: The entire order amount including delivery costs.
• Partial Refund: Any custom declared amount (e.g., in case of a discount due to a minor product defect).

After entering the amount, click "Confirm Refund".

Step 4: Background Status Tracking

The system will dispatch the request to the Allegro API. Thanks to asynchronous background synchronization, this process does not freeze the user interface. You can continue working while Kiero OMS retrieves the final status from Allegro Finance in the background and updates the complaint and related order status.

---

What Else Changed in Kiero OMS? (Last 3 Days Overview)

In addition to automatic Allegro Finance refunds, we have implemented several important updates across the system:

1. Integrations (Integrations)

• Allegro Message Center: Shifted Allegro message synchronization to a background client-side action with a visual loading state indicator in the UI. Also added auto-selection of sending accounts and hid redundant subject fields for marketplace transaction threads.
• WooCommerce: To bypass connection blocks caused by WordPress server security systems (like Imunify360 / WAF), we introduced Query String Auth and added a custom User-Agent header to API requests.
• Scanye: Added full idempotency for Scanye invoice corrections with an automatic cleanup mechanism for database records when physical files are missing.

2. Tools & Automations (Updates)

• Kiero Print Agent (Automatic Hybrid Printing): Implemented smart hybrid routing with automatic failover. The system prints instantly on the local printer, and if the connection is lost, it automatically routes the job to the cloud (cloud fallback). Credentials for the agent are now securely persisted in localStorage, and the agent's connection status is unified and visible across the entire panel.

3. User Interface & UX (Updates)

• Image Zoom Component: Added a modern hover-to-zoom component for product images on offer and order pages.
• Search & Filters: Introduced a Product ID filter on the offers page and optimized product searches using trigram indexes (trgm) for NIP and EAN codes.
• Responsiveness: Redesigned modal dialogs into full-screen side sheets (Sheet layouts) in the administration panel, and eliminated fixed-height limitations in the complaint details view, greatly improving the mobile experience.

4. Security (Security)

• Row Level Security (RLS): Enabled row-level security on sensitive system log tables, preventing unauthorized access directly at the database layer.