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

Łukasz Palej

Technical Implementation Expert

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ń.

Skorzystaj z darmowego audytu konta Allegro

Szybkie i proste poprawki

Analiza ofert i sklepu

Kluczowe wskazówki na przyszłość

Skorzystaj z darmowego audytu konta Allegro

Szybkie i proste poprawki

Analiza ofert i sklepu

Kluczowe wskazówki na przyszłość

Jak skonfigurować integrację Comarch Optima w Base

Konfiguracja wariantu API nie jest w pełni samoobsługowa. Według pomocy Base konieczny jest kontakt z supportem Base i spotkanie ze specjalistą, który przeprowadzi początkową konfigurację połączenia. Dopiero potem przechodzisz do ustawień integracji w panelu.

  1. Przygotuj środowisko Optimy i WebAPI zgodnie z wymaganiami powyżej.

  2. Skontaktuj się z supportem Base i umów konfigurację połączenia.

  3. W Base dodaj integrację: Integracje → Dodaj integrację → Księgowość/ERP → Comarch ERP Optima by Base.

  4. W zakładce Połączenie ustaw zasady przekazywania dokumentów oraz dopasowywania produktów i kontrahentów.

  5. Zmapuj serie numeracji, typy płatności i sposoby dostawy na odpowiedniki w Optimie.

  6. Włącz i ustaw częstotliwość synchronizacji cen oraz stanów, a następnie powiąż magazyny.

  7. Przetestuj przekazanie kilku faktur, paragonów i korekty przed włączeniem automatyki.

Zakładki integracji i za co odpowiadają

Zakładka

Co ustawiasz

Połączenie

Główne zasady przekazywania dokumentów, dopasowanie produktów i kontrahentów

Eksportuj dokumenty

Masowy eksport faktur i paragonów, maksymalnie do roku wstecz

Seria numeracji

Wykluczenie serii z przekazywania i nadpisanie ustawień dla wybranych serii

Typy płatności

Mapowanie płatności z zamówień na formy płatności w Optimie

Sposoby dostawy

Usługa w Optimie widoczna na dokumencie jako dostawa

Zamówienia

Tworzenie dokumentów RO w Optimie na podstawie zamówień z Base

Ceny i Stany

Włączenie synchronizacji z Optimy do Base i jej częstotliwość

Magazyny

Powiązanie magazynów Optimy z magazynami w Base

Przy eksporcie obowiązuje ta sama zasada co w innych integracjach ERP: „Eksportuj” pomija dokumenty już przekazane, a „Wyeksportuj wszystkie faktury ponownie” wysyła wszystko jeszcze raz. Z drugiej opcji korzystaj tylko wtedy, gdy wcześniejsze faktury z danego miesiąca zostały usunięte z Optimy – inaczej powstaną duplikaty.

Eksport XML z rejestru sprzedaży do Optimy

Jeśli nie potrzebujesz synchronizacji stanów, prostszym rozwiązaniem jest plik XML. Generujesz go w Base w dziale Zamówienia → Faktury → Rejestr sprzedaży, a księgowa importuje go w module księgowym Optimy. Plik obejmuje dokumenty sprzedaży, kontrahentów, pozycje, płatności i korekty. Pomoc Base opisuje kilka typowych problemów przy imporcie:

  • Suma płatności nie zgadza się z kwotą dokumentu – sprawdź tryb sumowania w Optimie i wybierz odpowiednią opcję „Wyliczanie kwoty netto” przy generowaniu rejestru.

  • Brak polskich znaków – ustaw opcję „Konwertuj litery do łacińskiego alfabetu” na „Tak”.

  • Nie ustalono rodzaju korekty – upewnij się, że importujesz plik w poprawnym module; to rejestr sprzedaży.

  • Nie znaleziono formy płatności – metody płatności z rejestru muszą istnieć w Optimie i mieć powiązania.

  • Niezgodność identyfikatora bazy – kod bazy docelowej w Base musi odpowiadać nazwie bazy w Optimie (domyślnie wpisywane jest „k1”).

Optima jako źródło danych – jak to połączyć z resztą procesu

Model, w którym ERP jest źródłem prawdy o produktach, cenach i stanach, a Base obsługuje kanały sprzedaży, jest zgodny z ogólnym schematem integracji ERP opisanym w pomocy Base. Sprawdza się w firmach z większym asortymentem i kilkoma magazynami. Ma jednak konsekwencje: zmiany cen i stanów wprowadzasz w Optimie, a Base tylko je pobiera. Szerzej opisujemy to w tekście o tym, kiedy integracja Base z ERP jest potrzebna.

Drugi ważny element to KSeF. Integrator API Optimy nie obsługuje KSeF, więc musisz zdecydować, który system wysyła e-faktury – Base czy Optima. Pomoc Base zaleca jeden kanał wysyłki, żeby uniknąć duplikatów. Więcej przeczytasz w artykule o integracji BaseLinker KSeF. Jeśli wahasz się między Optimą a innym programem, porównaj też integrację z Subiektem GT i nexo oraz programy do faktur online.

Przykładowy przepływ danych między Base a Optimą

Żeby lepiej zrozumieć podział ról, warto prześledzić jedno zamówienie od początku do końca. Przykład dla wariantu API, w którym Optima jest źródłem stanów:

  1. Optima aktualizuje stan produktu po przyjęciu dostawy, a Base pobiera go zgodnie z ustawioną częstotliwością synchronizacji.

  2. Base przekazuje nowy stan do ofert na Allegro, w sklepie i na innych marketplace’ach.

  3. Klient kupuje produkt, a zamówienie trafia do Base.

  4. Akcja automatyczna wystawia w Base fakturę lub paragon, a integracja przekazuje dokument do Optimy jako FS lub PA.

  5. Optima zmniejsza stan, a przy następnej synchronizacji Base pobiera aktualną ilość.

  6. Przy zwrocie w Base powstaje korekta, która trafia do Optimy.

Ten schemat pokazuje, dlaczego częstotliwość synchronizacji ma znaczenie. Przy produktach rotujących szybko, z małymi stanami, zbyt rzadkie pobieranie zwiększa ryzyko sprzedaży towaru, którego już nie ma. Mechanizmy ochrony przed takimi sytuacjami opisujemy w tekście o synchronizacji stanów w BaseLinkerze.

Lista kontrolna przed wdrożeniem

  • Czy wiesz, który system jest źródłem cen i stanów – Optima czy Base?

  • Czy komputer z Optimą i WebAPI działa całą dobę i ma stały adres publiczny?

  • Czy produkty w Optimie i w Base mają spójne kody (EAN, SKU), po których integracja je dopasuje?

  • Czy formy płatności i usługi dostawy w Optimie odpowiadają tym, które pojawiają się w zamówieniach?

  • Czy ustaliłeś z księgowym kanał wysyłki faktur do KSeF i sposób numeracji dokumentów?

Najczęściej zadawane pytania

Czy BaseLinker ma integrację z Comarch Optima?

Tak. Base oferuje integrację Comarch ERP Optima by Base działającą przez WebAPI oraz niezależny eksport XML z rejestru sprzedaży. API przekazuje dokumenty i pobiera produkty, ceny oraz stany, a XML służy do ręcznego importu sprzedaży w module księgowym.

Czy stany z Optimy aktualizują oferty w Base?

Tak, w wariancie API. W zakładkach Ceny i Stany włączasz synchronizację z Optimy do Base i ustawiasz jej częstotliwość, a w zakładce Magazyny wiążesz magazyny. Eksport XML nie synchronizuje stanów.

Dlaczego integracja pokazuje „0 dodane / 0 zaktualizowane”?

Według pomocy Base częstą przyczyną jest niezgodność wersji WebAPI z wersją Optimy po aktualizacji programu. Sprawdź też, czy komputer z Optimą jest włączony, a API dostępne z internetu.

Czy mogę sam skonfigurować integrację API z Optimą?

Środowisko po stronie Optimy przygotowujesz samodzielnie lub z serwisantem Comarch. Początkową konfigurację połączenia według pomocy Base przeprowadza specjalista Base po kontakcie z supportem. Ustawienia zakładek możesz potem zmieniać w panelu.

Czy Optima przez integrację wyśle faktury do KSeF?

Integrator API nie obsługuje KSeF. Do pliku XML możesz dodać numer KSeF nadany w Base. Ustal z księgowym, który system ma być jedynym kanałem wysyłki e-faktur.

Podsumowanie

Integracja BaseLinker Optima ma dwie twarze: pełne połączenie przez WebAPI, które przekazuje dokumenty i pobiera produkty, ceny oraz stany, oraz prosty eksport XML dla księgowości. API daje więcej, ale wymaga stałego, aktualnego środowiska i konfiguracji ze wsparciem Base. XML wystarczy, gdy Optima służy tylko do księgowania sprzedaży.

Jeśli chcesz połączyć Base z Comarch Optima i dobrać wariant do swoich procesów, jako certyfikowany partner wdrożeń Base pomożemy Ci to zaplanować i przeprowadzić – sprawdź nasze wdrożenie Base.

Jak skonfigurować integrację Comarch Optima w Base

Konfiguracja wariantu API nie jest w pełni samoobsługowa. Według pomocy Base konieczny jest kontakt z supportem Base i spotkanie ze specjalistą, który przeprowadzi początkową konfigurację połączenia. Dopiero potem przechodzisz do ustawień integracji w panelu.

  1. Przygotuj środowisko Optimy i WebAPI zgodnie z wymaganiami powyżej.

  2. Skontaktuj się z supportem Base i umów konfigurację połączenia.

  3. W Base dodaj integrację: Integracje → Dodaj integrację → Księgowość/ERP → Comarch ERP Optima by Base.

  4. W zakładce Połączenie ustaw zasady przekazywania dokumentów oraz dopasowywania produktów i kontrahentów.

  5. Zmapuj serie numeracji, typy płatności i sposoby dostawy na odpowiedniki w Optimie.

  6. Włącz i ustaw częstotliwość synchronizacji cen oraz stanów, a następnie powiąż magazyny.

  7. Przetestuj przekazanie kilku faktur, paragonów i korekty przed włączeniem automatyki.

Zakładki integracji i za co odpowiadają

Zakładka

Co ustawiasz

Połączenie

Główne zasady przekazywania dokumentów, dopasowanie produktów i kontrahentów

Eksportuj dokumenty

Masowy eksport faktur i paragonów, maksymalnie do roku wstecz

Seria numeracji

Wykluczenie serii z przekazywania i nadpisanie ustawień dla wybranych serii

Typy płatności

Mapowanie płatności z zamówień na formy płatności w Optimie

Sposoby dostawy

Usługa w Optimie widoczna na dokumencie jako dostawa

Zamówienia

Tworzenie dokumentów RO w Optimie na podstawie zamówień z Base

Ceny i Stany

Włączenie synchronizacji z Optimy do Base i jej częstotliwość

Magazyny

Powiązanie magazynów Optimy z magazynami w Base

Przy eksporcie obowiązuje ta sama zasada co w innych integracjach ERP: „Eksportuj” pomija dokumenty już przekazane, a „Wyeksportuj wszystkie faktury ponownie” wysyła wszystko jeszcze raz. Z drugiej opcji korzystaj tylko wtedy, gdy wcześniejsze faktury z danego miesiąca zostały usunięte z Optimy – inaczej powstaną duplikaty.

Eksport XML z rejestru sprzedaży do Optimy

Jeśli nie potrzebujesz synchronizacji stanów, prostszym rozwiązaniem jest plik XML. Generujesz go w Base w dziale Zamówienia → Faktury → Rejestr sprzedaży, a księgowa importuje go w module księgowym Optimy. Plik obejmuje dokumenty sprzedaży, kontrahentów, pozycje, płatności i korekty. Pomoc Base opisuje kilka typowych problemów przy imporcie:

  • Suma płatności nie zgadza się z kwotą dokumentu – sprawdź tryb sumowania w Optimie i wybierz odpowiednią opcję „Wyliczanie kwoty netto” przy generowaniu rejestru.

  • Brak polskich znaków – ustaw opcję „Konwertuj litery do łacińskiego alfabetu” na „Tak”.

  • Nie ustalono rodzaju korekty – upewnij się, że importujesz plik w poprawnym module; to rejestr sprzedaży.

  • Nie znaleziono formy płatności – metody płatności z rejestru muszą istnieć w Optimie i mieć powiązania.

  • Niezgodność identyfikatora bazy – kod bazy docelowej w Base musi odpowiadać nazwie bazy w Optimie (domyślnie wpisywane jest „k1”).

Optima jako źródło danych – jak to połączyć z resztą procesu

Model, w którym ERP jest źródłem prawdy o produktach, cenach i stanach, a Base obsługuje kanały sprzedaży, jest zgodny z ogólnym schematem integracji ERP opisanym w pomocy Base. Sprawdza się w firmach z większym asortymentem i kilkoma magazynami. Ma jednak konsekwencje: zmiany cen i stanów wprowadzasz w Optimie, a Base tylko je pobiera. Szerzej opisujemy to w tekście o tym, kiedy integracja Base z ERP jest potrzebna.

Drugi ważny element to KSeF. Integrator API Optimy nie obsługuje KSeF, więc musisz zdecydować, który system wysyła e-faktury – Base czy Optima. Pomoc Base zaleca jeden kanał wysyłki, żeby uniknąć duplikatów. Więcej przeczytasz w artykule o integracji BaseLinker KSeF. Jeśli wahasz się między Optimą a innym programem, porównaj też integrację z Subiektem GT i nexo oraz programy do faktur online.

Przykładowy przepływ danych między Base a Optimą

Żeby lepiej zrozumieć podział ról, warto prześledzić jedno zamówienie od początku do końca. Przykład dla wariantu API, w którym Optima jest źródłem stanów:

  1. Optima aktualizuje stan produktu po przyjęciu dostawy, a Base pobiera go zgodnie z ustawioną częstotliwością synchronizacji.

  2. Base przekazuje nowy stan do ofert na Allegro, w sklepie i na innych marketplace’ach.

  3. Klient kupuje produkt, a zamówienie trafia do Base.

  4. Akcja automatyczna wystawia w Base fakturę lub paragon, a integracja przekazuje dokument do Optimy jako FS lub PA.

  5. Optima zmniejsza stan, a przy następnej synchronizacji Base pobiera aktualną ilość.

  6. Przy zwrocie w Base powstaje korekta, która trafia do Optimy.

Ten schemat pokazuje, dlaczego częstotliwość synchronizacji ma znaczenie. Przy produktach rotujących szybko, z małymi stanami, zbyt rzadkie pobieranie zwiększa ryzyko sprzedaży towaru, którego już nie ma. Mechanizmy ochrony przed takimi sytuacjami opisujemy w tekście o synchronizacji stanów w BaseLinkerze.

Lista kontrolna przed wdrożeniem

  • Czy wiesz, który system jest źródłem cen i stanów – Optima czy Base?

  • Czy komputer z Optimą i WebAPI działa całą dobę i ma stały adres publiczny?

  • Czy produkty w Optimie i w Base mają spójne kody (EAN, SKU), po których integracja je dopasuje?

  • Czy formy płatności i usługi dostawy w Optimie odpowiadają tym, które pojawiają się w zamówieniach?

  • Czy ustaliłeś z księgowym kanał wysyłki faktur do KSeF i sposób numeracji dokumentów?

Najczęściej zadawane pytania

Czy BaseLinker ma integrację z Comarch Optima?

Tak. Base oferuje integrację Comarch ERP Optima by Base działającą przez WebAPI oraz niezależny eksport XML z rejestru sprzedaży. API przekazuje dokumenty i pobiera produkty, ceny oraz stany, a XML służy do ręcznego importu sprzedaży w module księgowym.

Czy stany z Optimy aktualizują oferty w Base?

Tak, w wariancie API. W zakładkach Ceny i Stany włączasz synchronizację z Optimy do Base i ustawiasz jej częstotliwość, a w zakładce Magazyny wiążesz magazyny. Eksport XML nie synchronizuje stanów.

Dlaczego integracja pokazuje „0 dodane / 0 zaktualizowane”?

Według pomocy Base częstą przyczyną jest niezgodność wersji WebAPI z wersją Optimy po aktualizacji programu. Sprawdź też, czy komputer z Optimą jest włączony, a API dostępne z internetu.

Czy mogę sam skonfigurować integrację API z Optimą?

Środowisko po stronie Optimy przygotowujesz samodzielnie lub z serwisantem Comarch. Początkową konfigurację połączenia według pomocy Base przeprowadza specjalista Base po kontakcie z supportem. Ustawienia zakładek możesz potem zmieniać w panelu.

Czy Optima przez integrację wyśle faktury do KSeF?

Integrator API nie obsługuje KSeF. Do pliku XML możesz dodać numer KSeF nadany w Base. Ustal z księgowym, który system ma być jedynym kanałem wysyłki e-faktur.

Podsumowanie

Integracja BaseLinker Optima ma dwie twarze: pełne połączenie przez WebAPI, które przekazuje dokumenty i pobiera produkty, ceny oraz stany, oraz prosty eksport XML dla księgowości. API daje więcej, ale wymaga stałego, aktualnego środowiska i konfiguracji ze wsparciem Base. XML wystarczy, gdy Optima służy tylko do księgowania sprzedaży.

Jeśli chcesz połączyć Base z Comarch Optima i dobrać wariant do swoich procesów, jako certyfikowany partner wdrożeń Base pomożemy Ci to zaplanować i przeprowadzić – sprawdź nasze wdrożenie Base.

Czy ten artykuł był pomocny? Oceń go
Bądź pierwszą osobą, która oceni

Łukasz Palej

Technical Implementation Expert

Wdraża integracje i rozwiązania IT dla e-commerce: sklepy, feedy produktowe, przepływ danych między systemami.

Wdraża integracje i rozwiązania IT dla e-commerce: sklepy, feedy produktowe, przepływ danych między systemami.

★★★★★
Współpracowałeś z Vinson?
Twoja opinia pomoże innym sprzedawcom wybrać sprawdzoną agencję. Zajmie Ci to minutę.
Oceń nas na Trustpilot →
Potrzebujesz pomocy z tym tematem?

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ń
Łukasz Palej – Technical Implementation Expert
Łukasz PalejTechnical Implementation Expert

Przeczytaj także

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

1 / 1

Masz pytania? Chętnie porozmawiamy!

Masz pytania? Chętnie porozmawiamy!

Masz pytania? Chętnie porozmawiamy!

Bartłomiej Stokłosa

CEO & Founder

"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie – przyjdzie i to zrobi."

Bartłomiej Stokłosa

CEO & Founder

"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie – przyjdzie i to zrobi."

ZADZWOŃ

574 944 685

ADRES

Kazimierza Wielkiego 7/7

32-700 Bochnia

Zamów darmowy audyt konta Allegro