BaseLinker Comarch Optima – jak połączyć Base z systemem Comarch

Łukasz Palej
Technical Implementation Expert
BaseLinker Comarch Optima – jak połączyć Base z systemem Comarch

Połączenie BaseLinker Optima to temat dla firm, które prowadzą księgowość albo magazyn w Comarch ERP Optima, a sprzedaż internetową obsługują w Base. Dla biura rachunkowego Optima jest naturalnym środowiskiem pracy, dla zespołu e-commerce – Base z jego integracjami marketplace’ów. Pytanie brzmi: jak przekazywać sprzedaż do Optimy i czy stany z Optimy mogą wracać do ofert?
Base oferuje dwie drogi: integrację przez API (Comarch ERP Optima by Base) oraz eksport pliku XML z rejestru sprzedaży. W tym artykule porównujemy oba warianty, opisujemy wymagania techniczne, konfigurację i codzienną pracę, a także najczęstsze błędy przy imporcie. Opieramy się na aktualnej pomocy Base (stan na październik 2026 r.).
Dwa sposoby połączenia Base z Comarch Optima – API i XML
Pomoc Base wyraźnie podkreśla, że API i XML to dwa niezależne mechanizmy. Wariant API służy do stałej wymiany danych między Base (dawniej BaseLinker) a lokalną instalacją Optimy. Wariant XML to eksport pliku z rejestru sprzedaży, który ręcznie importujesz w module księgowym Optimy. Eksport XML nie korzysta z API, nie synchronizuje produktów ani stanów.
Obszar | Comarch Optima by Base (API) | XML z rejestru sprzedaży |
Gdzie konfigurujesz | Integracje → Comarch Optima by Base | Zamówienia → Faktury → Rejestr sprzedaży |
Sposób połączenia | WebAPI Comarch przy lokalnej instalacji Optimy | Plik do ręcznego importu w Optimie |
Przekazywanie dokumentów | Automatycznie po utworzeniu albo zbiorczo z zakładki eksportu | Eksport na żądanie |
Dokumenty | FS, PA, pro forma, RO, korekty i WZ | Dokumenty sprzedaży, kontrahenci, pozycje, płatności, korekty |
Produkty, ceny, stany | Import z Optimy do Base | Brak synchronizacji |
Magazyny | Pobieranie i mapowanie magazynów Optimy | Brak synchronizacji |
KSeF | Integrator API nie obsługuje KSeF | Możliwość dodania numeru KSeF z Base do pliku |
W praktyce wybór zależy od tego, czego oczekujesz. Jeśli Optima ma być źródłem danych o asortymencie, cenach i stanach, a Base ma obsługiwać kanały sprzedaży – potrzebujesz API. Jeśli księgowa chce tylko raz w miesiącu zaimportować sprzedaż do księgowości, XML jest prostszy i tańszy w utrzymaniu.
Wymagania integracji BaseLinker Optima przez API
Integracja API wymaga przygotowania środowiska po stronie Optimy. Według pomocy Base przed startem musisz spełnić kilka warunków:
Comarch ERP Optima zainstalowana lokalnie na komputerze lub serwerze, który jest stale włączony i nie przechodzi w tryb uśpienia.
Włączone WebAPI Comarch Optima z aktywną licencją – w dokładnie tej samej wersji co program (np. Optima 2026.3.1.5710 wymaga WebAPI 2026.3.1.5710).
API dostępne z internetu: publiczny, najlepiej stały adres, otwarty port i skonfigurowana zapora; w praktyce zalecany jest HTTPS.
Operator w Optimie z uprawnieniami do dokumentów sprzedaży, kontrahentów, towarów oraz – przy przekazywaniu płatności – kasy i banku.
Aktywne formy płatności w Optimie oraz produkty typu „Usługa”, jeśli chcesz mapować sposoby dostawy.
Brak drugiego integratora Comarch Optima uruchomionego równolegle na tym samym koncie Base.
Szczególnie ważna jest zgodność wersji. Pomoc Base wskazuje, że po każdej aktualizacji Optimy trzeba sprawdzić wersję WebAPI – niezgodność to częsta przyczyna braku magazynów, komunikatu „0 dodane / 0 zaktualizowane” i błędów przy tworzeniu dokumentów. To zadanie warto wpisać do stałej procedury IT, a aktualizacje Optimy planować poza godzinami największej sprzedaży, żeby ewentualna przerwa w synchronizacji nie trafiła na szczyt zamówień.


Łukasz Palej
Technical Implementation Expert
Wdrożenie Base
Łukasz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie – bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań

Przeczytaj także
Więcej porad z naszej bazy wiedzy – przesuń, aby zobaczyć kolejne artykuły.


