TL;DR — w skrócie

Comarch ERP Optima ma wbudowany moduł KSeF (od 2025) — ale wielu klientów wybiera zewnętrznego integratora dla niższych kosztów lub dodatkowych funkcji.
Integracja Fakturium ↔ Optima przez Comarch Web API (REST + uwierzytelnianie operatora).
Po stronie Optima: aktywuj Web API, utwórz operatora „FAKTURIUM" z uprawnieniami sprzedaży i kontrahentów.
Po stronie Fakturium: wpisz URL Web API + login + hasło → sync produktów i kontrahentów.
Restart usługi Comarch Web API z poziomu menedżera usług Windows wymagany po aktywacji.

Comarch ERP Optima (ComArch S.A., Kraków) to popularny system ERP polskich średnich firm — szczególnie tych z księgowością prowadzoną wewnętrznie. Comarch wprowadził własny moduł KSeF do Optimy w 2025 roku, ale wielu klientów wybiera zewnętrznego integratora (np. Fakturium) z różnych powodów: niższy całkowity koszt licencji, łatwiejsza konfiguracja, lepsze integracje z e-commerce (BaseLinker, Allegro, WooCommerce), dostęp do panelu z przeglądarki bez VPN do Optimy.

Ten przewodnik pokazuje jak skonfigurować integrację Comarch ERP Optima → Fakturium → KSeF przez Web API Comarcha. Setup wymaga uprawnień administratora Optima i restartu usługi systemowej.

Po co integrator zewnętrzny skoro Optima ma KSeF natywnie?

Trzy główne powody dla których firmy wybierają Fakturium zamiast wbudowanego KSeF Optima:

KOSZT — Fakturium 99-199 zł / mies vs roczna licencja Optima KSeF (sprawdź aktualne ceny u Comarcha)
INTEGRACJE E-COMMERCE — Fakturium ma natywne BaseLinker, Allegro, WooCommerce, Shopify; Optima KSeF głównie obsługuje sprzedaż wystawianą w samej Optimie
DOSTĘPNOŚĆ — Fakturium webowy z dowolnego miejsca; Optima desktop, czasem wymaga VPN-a do firmy

Uwaga

Wybór między natywnym KSeF Optima a zewnętrznym integratorem zależy od wielkości firmy i workflow. Duże firmy z rozbudowaną Optimą zwykle zostają przy natywnym KSeF Comarcha. Mniejsze firmy z mocnym e-commerce wybierają zewnętrznego integratora typu Fakturium.

Konfiguracja integracji — krok po kroku

Krok 1: Zaloguj się do Optima jako administrator

Otwórz Comarch ERP Optima i zaloguj się jako Operator z prawami administracyjnymi (zwykle „ADM" lub konto utworzone przy instalacji). Bez uprawnień admina nie aktywujesz Web API.

Krok 2: Aktywuj Comarch ERP Web API

Idź do: Konfiguracja → Stanowisko → Wymiana danych → „Comarch ERP Web API". Włącz checkbox „Aktywne". Wybierz port (domyślnie 8080) i adres serwera (zwykle localhost dla lokalnej instalacji lub IP serwera dla central).

Krok 3: Utwórz operatora „FAKTURIUM"

Wróć do menu głównego Optima → Konfiguracja → Operatorzy → Dodaj. Konfiguracja:

Login: FAKTURIUM (dla rozróżnienia od ludzi)
Imię/Nazwisko: „Integration Fakturium" (lub dowolne)
Hasło: silne, min 16 znaków
Uprawnienia: sprzedaż (faktury — pełne), kontrahenci (odczyt + zapis), magazyn (tylko odczyt)
Bez uprawnień: kadry, księgi, kasa, raporty finansowe (niepotrzebne)

Krok 4: Restart usługi Comarch Web API

WAŻNE — bez restartu usługi systemowej, zmiany konfiguracyjne nie wejdą w życie. Otwórz Menedżer usług Windows (services.msc) → znajdź „Comarch ERP Web API" → kliknij prawym → „Uruchom ponownie". Status powinien zmienić się na „Uruchomiona".

Ostrzeżenie

Bez restartu usługi Web API klucz konfiguracji nie aktualizuje się — Fakturium dostanie błąd 401 Unauthorized lub 503 Service Unavailable mimo poprawnych credentials. To najczęstsza pułapka przy pierwszym setupie.

Krok 5: Połącz w Fakturium

W panelu Fakturium → Integracje → Comarch ERP Optima. Wpisz:

URL serwera Web API: pełen adres (np. https://serwer-firmy:8080/api lub localhost dla testów)
Użytkownik: FAKTURIUM
Hasło: hasło operatora

Kliknij „Połącz". Fakturium zweryfikuje credentials i pobierze: kontrahentów (Optima → Słowniki → Kontrahenci), kartoteki towarów (Magazyn → Cennik), strukturę cennikową. W zależności od wielkości bazy: 30 sekund - 5 minut.

Krok 6: Test wystawienia faktury z synchronizacją

W Fakturium wystaw fakturę testową używając kontrahenta z Optima (auto-fill danych po wybraniu w pickerze). Wyślij do KSeF. Po przyjęciu KSeF Fakturium:

Zapisuje fakturę w Optima jako „Faktura sprzedaży" przez Web API
Wpisuje numer KSeF w polu uwag faktury Optima
Pobiera UPO i przechowuje w obu systemach (Optima + Fakturium)
Generuje PDF dla nabywcy (z brandingiem Twojej firmy z Optima)

Cennik

Comarch ERP Optima (bazowa licencja): roczny lub kontraktowy — sprawdź aktualne ceny na comarch.pl/erp/optima
Comarch Web API (zwykle wliczone w bazową licencję) — potwierdź u handlowca Comarcha
Fakturium Free: 0 zł — 5 faktur miesięcznie
Fakturium Pro: 99 zł netto / mies — do 70 faktur, 5 użytkowników, KSeF produkcja (typowy plan dla małej firmy z Optimą)
Fakturium Business: 199 zł netto / mies — nielimitowane faktury i użytkownicy, priorytetowy support, API/webhooki

Uwaga

Ceny Comarch ERP Optima są dopasowane indywidualnie do firmy (liczba stanowisk, modułów, formy licencji). Skontaktuj się z handlowcem Comarcha lub partnerem wdrożeniowym po wycenę. Cennik Fakturium podany wyżej jest aktualny na maj 2026 r.

Częste problemy

Problem 1: 401 Unauthorized po dodaniu credentials

Najczęstsza przyczyna: nie zrestartowano usługi Comarch Web API po zmianach konfiguracji. Wróć do Kroku 4 i zrestartuj. Pozostałe przyczyny: literówka w haśle, operator wyłączony / wygasły, port zablokowany w firewall Windows / sieci.

Problem 2: Operator widzi za mało rekordów

Optima ma uprawnienia per-firma (jeśli masz wiele baz / firm w jednej instancji). Operator FAKTURIUM musi mieć dostęp do KAŻDEJ firmy z którą chcesz synchronizować. Konfiguracja → Operatorzy → FAKTURIUM → Uprawnienia firm.

Problem 3: Synchronizacja zatrzymuje się przy dużej bazie

Comarch Web API ma wewnętrzny limit transakcji (zwykle 1000 rekordów per call). Fakturium robi paginację automatycznie, ale bardzo duże bazy (100k+ kontrahentów) mogą wymagać kilkukrotnych retry. Jeśli problem trwa: zwiększ timeout w Optimie (Konfiguracja → Web API → Timeout) lub skontaktuj się z support Fakturium.

FAQ

Czy Fakturium zastępuje moduł KSeF Optima?

Tak — gdy korzystasz z Fakturium, możesz wyłączyć wbudowany moduł KSeF Optima (lub po prostu go nie używać). Optima zostaje jako system księgowy / ERP, Fakturium pełni rolę KSeF gateway. Ważne: nie używaj OBU jednocześnie — powstaną duplikaty faktur w KSeF.

Co z fakturami zaliczkowymi i końcowymi z Optima?

Optima generuje faktury zaliczkowe (FZ) i końcowe (FK) w bazowej funkcjonalności. Fakturium odbiera obie typy faktur z Optima przez Web API i wysyła do KSeF z odpowiednim TypDokumentu w schemacie FA(2). Schemat KSeF rozróżnia FZ i FK automatycznie.

Czy Optima Online (chmura) działa z Fakturium?

Optima Online ma osobny Web API dostępny przez chmurę Comarcha. Fakturium oficjalnie wspiera Optima desktop / lokalną. Wsparcie Optima Online jest na roadmapie 2026 — napisz na hi@fakturium.pl jeśli potrzebujesz tego wcześniej.

Czy Fakturium synchronizuje rozrachunki z Optima?

Aktualnie nie — Fakturium synchronizuje tylko faktury (sprzedażowe + korekty), kontrahentów i pozycje cennika. Płatności i rozrachunki zostają w Optima jako „source of truth". Synchronizacja rozrachunków jest na roadmapie Q4 2026.

“Wybór między natywnym KSeF Optima a Fakturium zależy od priorytetów. Optima KSeF — gdy masz pełen budżet Comarcha i chcesz wszystko w jednym systemie. Fakturium — gdy chcesz tańszej alternatywy, lepszych integracji z e-commerce i dostępu z przeglądarki.”
— Bartosz Sińczuk, prawnik · Fakturium

Praktyka

Wystaw fakturę KSeF jednym kliknięciem

Fakturium robi cały proces za Ciebie — od auto-fillu po NIP, przez wysyłkę do MF, po UPO i email do nabywcy. Plan Free do 5 faktur miesięcznie, bez karty kredytowej.

Załóż konto za darmo