Integracja Comarch Optima ERP by Base pozwala przekazywać sprzedaż z Base.com do lokalnie zainstalowanego programu Comarch ERP Optima oraz pobierać z Optimy produkty, ceny i stany magazynowe. Dzięki temu Base.com może zbierać zamówienia z marketplace’ów i sklepów, a Comarch Optima pozostaje źródłem danych o asortymencie, cenach i dostępności produktów.
Jak działa integracja Comarch Optima by Base
Dwa niezależne warianty: API i XML
Wariant API służy do stałej wymiany danych między Base.com i lokalną instalacją Comarch ERP Optima. Wariant XML jest niezależnym eksportem pliku z rejestru sprzedaży, który można zaimportować ręcznie do modułu księgowego Optimy.
| Obszar | Comarch Optima by Base – API | XML z rejestru sprzedaży |
|---|---|---|
| Miejsce konfiguracji | Integracje → Comarch Optima by Base | Zamówienia → Faktury → Rejestr sprzedaży → Faktury |
| Sposób połączenia | WebAPI Comarch Optima działające przy lokalnej instalacji programu | Plik do ręcznego importu w Optimie |
| Przekazywanie dokumentów | Automatyczne po utworzeniu dokumentu albo zbiorcze z zakładki eksportu | Eksport na żądanie |
| Dokumenty sprzedażowe | FS, PA, proforma, RO, korekty i WZ | Dokumenty sprzedaży, kontrahenci, pozycje, płatności i korekty |
| Produkty, ceny i stany | Import z Optimy do Base.com | Brak synchronizacji |
| Magazyny | Pobieranie i mapowanie magazynów Optimy | Brak synchronizacji magazynów |
| OSS, JPK i waluty | Ustawienia integracji i serii numeracji | Parametry eksportu XML |
| KSeF | Integrator API nie obsługuje KSeF | Możliwość dodania numeru KSeF z Base.com do pliku XML |
Schemat zakładający, że ERP jest źródłem danych dla produktów, cen i stanów, a Base.com obsługuje kanały sprzedaży, jest zgodny ze schematem integracji systemu ERP z Base.com.
Konfiguracja i codzienna praca z integracją API
Wymagania startowe
Przed dodaniem integracji przygotuj środowisko Comarch Optima i dostęp do API:
- Comarch ERP Optima musi być zainstalowana lokalnie na komputerze lub serwerze.
- Komputer z Optimą i API musi być włączony i nie może przechodzić w tryb uśpienia.
- WebAPI Comarch Optima musi być włączone i mieć aktywną licencję.
- WebAPI musi mieć dokładnie tę samą wersję co program Comarch ERP Optima. Przykładowo: wersja Optimy 2026.3.1.5710 wymaga WebAPI 2026.3.1.5710.
- API musi być dostępne z internetu. Potrzebny jest publiczny adres, najlepiej stały, otwarty port oraz konfiguracja zapory sieciowej. W praktyce zalecane jest HTTPS.
- Operator w Optimie musi mieć uprawnienia do dokumentów sprzedaży, kontrahentów, towarów oraz – jeśli są przekazywane płatności – kasy i banku.
- W Optimie muszą istnieć aktywne formy płatności oraz produkty typu U – Usługa, jeśli chcesz mapować sposoby dostawy.
- Na tym samym koncie Base.com nie uruchamiaj równolegle drugiego integratora Comarch Optima.
Jak skonfigurować połączenie
Aby można było skonfigurować połączenie z Comarch Optima ERP by Base konieczny jest kontakt z Supportem Base oraz spotkanie ze specjalistą, który zajmie się początkową konfiguracją połączenia.
W zakładce Integracje → +Dodaj integrację w sekcji Księgowość/ERP wyszukaj systemową integrację Comarch ERP Optima by Base.
Zakładki w integracji:
Połączenie:
W tej zakładce możesz zdefiniować główne ustawienia integracji, jak przekazywanie dokumentów, czy sposób dopasowywania produktów i kontrahentów. Są to ustawienia, które będą obowiązywały dla wszystkich dokumentów, o ile nie nadpiszesz ich dla serii numeracji.
Eksportuj dokumenty:
W tym miejscu możesz masowo wyeksportować dokumenty z Base w celu utworzenia ich w Comarch Optima. Masowy eksport faktur i paragonów jest możliwy maksymalnie do roku wstecz. Opcja "Eksportuj" (nr. 1 na zrzucie), która sprawdza wszystkie faktury i jeśli jakaś jest już przekazana, to nie przesyła jej ponownie, aby nie zdublować faktury w Comarch Optima. Opcja "Wyeksportuj wszystkie faktury ponownie" (nr. 2 na zrzucie) powoduje eksport wszystkich faktur niezależnie, czy zostały wcześniej przesłane, czy też nie. Przy tej opcji należy się upewnić, że faktury wcześniej dla danego miesiąca zostały usunięte z Comarch Optima.
Seria numeracji:
W tym miejscu możesz wybrać, które serie numeracji mają nie być przekazywane do Comarch Optima, a także, wybierając koło zębate, nadpisać dla nich ustawienia, które zostały zadeklarowane w zakładce Połączenie.
Typy płatności:
W tej zakładce po lewej stronie widoczne są wszystkie płatności, które występują w Twoich zamówieniach w Base, a po prawej, w rozwijanej liście metody płatności zdefiniowane po stronie Comarch Optima.
Sposoby dostawy:
W tej zakładce możesz wskazać, która usługa po stronie Comarch Optima ma być wyświetlana na dokumentach jako dostawa. Dla różnych typów sposobów dostawy możesz dodać odpowiednie mapowanie.
Zamówienia:
Tutaj możesz zdefiniować, w jaki sposób mają być pobierane zamówienia do Base z Comarch Optima, a także, w jaki sposób mają być tworzone RO w Comarch Optima na podstawie zamówień z Base.
Ceny:
W tej zakładce możesz włączyć synchronizację cen z Comarch Optima do Base, a także zdecydować o jej częstotliwości.
Stany:
W tej zakładce możesz włączyć synchronizację stanów z Comarch Optima do Base, a także zdecydować o jej częstotliwości.
Magazyny:
To bardzo istotna zakładka, zwlaszcza jeśli posiadasz kilka magazynów w Comarch Optima i chcesz je zsynchronizować z Base. W tym miejscu możesz je powiązać, aby odpowiednio synchronizować stany.
