Jak zintegrować Fakturownia z Kiero OMS i zautomatyzować fakturowanie

Automatyzacja procesów księgowych to klucz do oszczędności czasu i eliminacji błędów w codziennej pracy każdego sprzedawcy. Z przyjemnością informujemy, że w pełni zintegrowaliśmy platformę Fakturownia.pl (InvoiceOcean) z systemem Kiero OMS.

Dzięki nowej integracji Kiero OMS automatycznie generuje dokumenty sprzedażowe bezpośrednio na podstawie zamówień z Twoich kanałów sprzedaży (np. Allegro, WooCommerce, Etsy), a następnie przesyła je bezpośrednio do klientów lub na powiązane platformy.

Poniżej znajdziesz szczegółowy poradnik, jak krok po kroku uruchomić integrację oraz jak w pełni wykorzystać jej zaawansowane możliwości.

---

Korzyści z integracji Kiero OMS z Fakturownią

• Obsługa Multi-Entity (Wielu firm): Możesz powiązać różne podmioty prawne skonfigurowane w Kiero OMS z osobnymi działami (Departments) w ramach jednego konta Fakturowni. Pozwala to na wygodne fakturowanie wielu marek lub firm z jednego miejsca.
• Automatyczne wystawianie faktur (B2B i B2C): System automatycznie generuje standardowe faktury VAT dla firm (na podstawie numeru NIP) oraz faktury imienne (Faktura imienna) dla klientów indywidualnych.
• Fakturowanie w tle (Queue Processing): Proces tworzenia dokumentów odbywa się asynchronicznie przez dedykowane zadanie w kolejce (fakturownia_invoice_create). Dzięki temu OMS działa szybko i bez opóźnień, nawet podczas nagłych pików sprzedażowych.
• Płatności i Korekty (Corrections): System w pełni wspiera generowanie faktur korygujących (typ correction), śledzi historię wysyłki do klienta oraz automatycznie przekazuje dokumenty na rynki zewnętrzne (np. Allegro).
• Bezpośrednia wysyłka e-mail: Kiero OMS automatycznie zleca Fakturowni wysłanie gotowego dokumentu PDF na adres e-mail klienta natychmiast po jego wygenerowaniu.

---

Instrukcja krok po kroku: Podłączenie i konfiguracja

Konfiguracja integracji zajmuje tylko kilka chwil:

Krok 1: Pobierz API Token z Fakturowni

1. Zaloguj się na swoje konto w Fakturownia.pl.
2. Przejdź do Ustawienia -> Ustawienia konta -> Integracja.
3. Skopiuj swój unikalny Kod autoryzacyjny API (API Token).

Krok 2: Aktywuj integrację w Kiero OMS

1. Zaloguj się do panelu Kiero OMS i przejdź do zakładki Ustawienia -> Integracje -> Fakturownia.
2. Wklej skopiowany API Token.
3. Podaj adres domeny swojego konta (np. twoja-nazwa.fakturownia.pl).
4. Kliknij przycisk Zapisz lub Połącz.

Krok 3: Skonfiguruj mapowanie działów (Multi-Entity)

1. Kliknij Synchronizuj działy, aby Kiero OMS pobrał listę Twoich firm/działów z Fakturowni.
2. W ustawieniach dokumentów powiąż odpowiednie profile firm w OMS z konkretnymi działami w Fakturowni (np. przypisz osobne działy dla sprzedaży krajowej B2B, B2C oraz korekt).
3. Kliknij przycisk „Testuj połączenie”, aby upewnić się, że konfiguracja działa bez zarzutu.

---

Co jeszcze zmieniło się w Kiero OMS? (Przegląd nowości)

W ciągu ostatnich 3 dni wdrożyliśmy szereg ulepszeń zwiększających stabilność i bezpieczeństwo systemu:

1. Integracje (Integracje)

• WooCommerce: Dodaliśmy dedykowany nagłówek User-Agent do zapytań API WooCommerce. Pozwala to na bezproblemowe omijanie blokad bezpieczeństwa WAF oraz systemów chroniących serwery WordPress (np. Imunify360).
• Furgonetka: Przenieśliśmy całą integrację na nowoczesny i bezpieczny protokół autoryzacji OAuth2 z automatycznym odświeżaniem tokenów w tle. Usprawniliśmy także obsługę specyficznych błędów API (np. brak środków na koncie prepaid) oraz wprowadziliśmy automatyczny mechanizm ponownych prób (Auto-Retry) w przypadku błędów walidacji danych.
• Allegro (AI Act): Dodaliśmy pełne wsparcie dla unijnych wymogów dotyczących oznaczania treści wygenerowanych przez sztuczną inteligencję. W edycji ofert Allegro możesz teraz zaznaczyć status „AI co-created” dla obrazów, a system prześle tę deklarację podczas synchronizacji.
• Allegro (Etykiety): Naprawiliśmy błąd zapytania, który powodował problemy przy pobieraniu etykiet Allegro, w sytuacji gdy do jednego konta przypisanych było kilka konfiguracji przewoźników.

2. Automatyzacja (Updates)

• Wprowadziliśmy nowe wyzwalacze w module automatyzacji: „invoice_generated” (wygenerowano fakturę) oraz „correction_generated” (wygenerowano korektę). Możesz teraz automatycznie wysyłać powiadomienia e-mail, SMS lub wiadomości na Slacku/Telegramie po wystawieniu dokumentu finansowego.
• Dodaliśmy triggery automatyzacji powiązane z procesem zwrotów: „return_created” oraz „return_status_changed”, co pozwala na błyskawiczne reagowanie na zgłoszenia klientów.

3. Bezpieczeństwo (Bezpieczeństwo)

• Wdrożyliśmy politykę Row Level Security (RLS) dla wrażliwych tabel z logami systemowymi, zwiększając poziom ochrony danych przed nieautoryzowanym dostępem na poziomie bazy danych.

4. Ulepszenia i Telegram Bot (Poprawki)

• Dodaliśmy do bota Telegrama nowy przycisk szybkiego reagowania „Odrzuć/Anuluj” oraz komendę cancel_fix, pozwalające na sprawne zarządzanie incydentami bezpośrednio ze smartfona.
• Udoskonaliliśmy walidację adresów wysyłkowych dla kurierów (rozdzielenie numerów budynków i lokali w danych adresowych odbiorcy).