How to Integrate Fakturownia with Kiero OMS and Automate Invoicing

Automating financial workflows is key to saving time and eliminating manual errors in your daily e-commerce operations. We are excited to announce that we have fully integrated Fakturownia.pl (InvoiceOcean) with Kiero OMS.

With this new integration, Kiero OMS automatically generates sales invoices directly from your orders across channels (like Allegro, WooCommerce, Etsy) and sends them to customers or pushes them to the respective marketplaces.

Below is a detailed guide on how to set up the integration and leverage its advanced features.

---

Key Benefits of Fakturownia Integration

• Multi-Entity Management: Map different legal entities configured in Kiero OMS to specific departments in Fakturownia under a single account. This allows you to manage multiple companies or brands seamlessly.
• Automated B2B & B2C Invoicing: Automatically generate VAT invoices for businesses (based on NIP/tax numbers) and customer invoices (Faktura imienna) for individual buyers.
• Background Queue Processing: Document generation is handled asynchronously via a background queue task (fakturownia_invoice_create). This ensures the OMS UI remains fast and responsive during high-volume sales periods.
• Credit Notes & Corrections: Fully supports generating credit notes (corrections), tracking email delivery, and uploading documents directly to marketplaces (like Allegro).
• Direct Email Delivery: Kiero OMS triggers Fakturownia to deliver the generated PDF invoice directly to the customer's email address instantly.

---

Step-by-Step Setup Guide

Getting started is quick and easy:

Step 1: Copy Your API Token from Fakturownia

1. Log in to your Fakturownia.pl account.
2. Go to Settings -> Account Settings -> Integration.
3. Copy your unique API Authorization Code (API Token).

Step 2: Connect Fakturownia in Kiero OMS

1. Log in to Kiero OMS and go to Settings -> Integrations -> Fakturownia.
2. Paste the API Token into the field.
3. Enter your account domain name (e.g., your-account.fakturownia.pl).
4. Click Save or Connect.

Step 3: Map Departments (Multi-Entity)

1. Click Sync Departments to fetch your active Fakturownia departments.
2. Map your legal entities in OMS to the corresponding Fakturownia departments (e.g., set up separate departments for national B2B, B2C, and corrections).
3. Click Test Connection to verify that everything is configured correctly.

---

What Else Changed in Kiero OMS? (Recent Updates)

Over the last 3 days, we have also released several performance and stability updates:

1. Integrations (Integrations)

• WooCommerce: Added a custom User-Agent header to WooCommerce API requests. This prevents issues with WordPress hosting WAF systems (like Imunify360) blocking automated OMS sync.
• Furgonetka: Upgraded the integration to the secure OAuth2 protocol with automatic background token refreshes. We also improved handling of broker balance issues and added an Auto-Retry mechanism when request validation fails.
• Allegro (AI Act): Added support for EU AI Act guidelines on labeling AI-generated images. You can now toggle the "AI co-created" flag on product images, which will sync directly with Allegro.
• Allegro (Labels): Fixed a query bug that caused errors when fetching shipping labels when a single seller account was linked to multiple carrier configurations.

2. Automation (Updates)

• Added new triggers: "invoice_generated" and "correction_generated". You can now trigger custom emails, SMS alerts, or Slack/Telegram messages automatically when a document is created.
• Integrated returns triggers: "return_created" and "return_status_changed" to help automate customer refund notifications.

3. Security (Security)

• Enabled Row Level Security (RLS) on sensitive system log tables to enforce database-level access restrictions.

4. Improvements & Telegram Bot (Updates)

• Added a "Reject/Cancel" button and a cancel_fix command to the Telegram bot for quick mobile-based action on system alerts.
• Optimized shipping address verification for couriers by separating building and apartment numbers in recipient address schemas.