Dlaczego Comarch nie oferuje publicznego REST API do Optimy (i co z tym zrobić)

Comarch ERP Optima — jeden z najpopularniejszych systemów ERP w Polsce — nie udostępnia publicznego REST API. Firmy, które chcą zintegrować Optimę z e-commerce, CRM, narzędziami AI lub innymi systemami, stają przed ścianą. Ten artykuł wyjaśnia dlaczego Comarch nie oferuje REST API, jakie alternatywy istnieją i jak Optima API od WebArm rozwiązuje ten problem.

Stan obecny: co oferuje Comarch

Comarch udostępnia kilka metod integracji z Optimą. Żadna z nich nie jest publicznym REST API w rozumieniu, do jakiego przyzwyczaił nas współczesny rynek SaaS.

COM objects

Obiekty COM (Component Object Model) to najstarszy i najbardziej rozpowszechniony interfejs integracyjny Optimy. Działają wyłącznie na Windows, wymagają zainstalowanej Optimy na maszynie, na której uruchamiasz kod, i nie mają oficjalnej dokumentacji.

Programiści uczą się API metodą prób i błędów, dekompilacji DLL-ek lub informacji przekazywanych ustnie na forach i w grupach partnerskich. Szczegółowe porównanie COM objects z innymi metodami integracji — z przykładami kodu — znajdziesz w artykule REST API vs COM objects.

Web API Comarch

Comarch oferuje Web API (webApi Optima), ale jest to web service oparty na protokole SOAP z komunikacją XML/RPC. Obsługuje moduły handlowe, księgowe, kadrowe i CRM, wymaga jednak dodatkowej licencji. Nie jest to REST API — brak formatu JSON, brak dokumentacji OpenAPI/Swagger, brak prostoty integracji, jaką daje standardowy interfejs HTTP/JSON.

Comarch XL SDK

Comarch XL (większy ERP dla średnich i dużych firm) ma rozbudowane SDK. Optima — skierowana do małych i średnich firm — takiego SDK nie posiada.

Dlaczego Comarch nie buduje publicznego REST API

Comarch nigdy oficjalnie nie wyjaśnił tej decyzji. Można jednak wskazać prawdopodobne przyczyny:

Model biznesowy — Comarch zarabia na licencjach i ekosystemie. Publiczne API umożliwiłoby integrację z konkurencyjnymi rozwiązaniami, zmniejszając uzależnienie od ekosystemu Comarch.

Architektura — Optima jest aplikacją desktopową z wieloletnią historią. Jej architektura opiera się na COM objects i bezpośrednim dostępie do bazy SQL Server. Budowa REST API wymagałaby fundamentalnych zmian architektonicznych lub budowy warstwy pośredniej.

Priorytetyzacja — Comarch rozwija Optima w wielu kierunkach jednocześnie (Optima w Chmurze, BI, iZam, e-Commerce). REST API dla developerów zewnętrznych może nie być najwyżej na liście priorytetów.

Wsparcie — publiczne API oznacza publiczną dokumentację, wersjonowanie, backward compatibility i wsparcie techniczne dla programistów trzecich. To znaczące zobowiązanie dla firmy, której głównym klientem jest księgowa i magazynier, nie programista.

Co robią firmy dzisiaj

Wariant 1: COM objects wrapper

Programista .NET pisze wrapper wokół COM objects, wystawiając własne REST API. To najczęstsze podejście wśród partnerów Comarch.

Problemy:

• Miesiące pracy na budowę i utrzymanie
• Każda aktualizacja Optimy może wymagać zmian we wrapperze
• Brak standaryzacji — każdy partner buduje własne rozwiązanie
• Sesyjność COM objects ogranicza wydajność

Wariant 2: Bezpośredni SQL

Czytanie i pisanie do bazy danych SQL Server, w której Optima przechowuje dane. Szybkie, ale ryzykowne — omija walidację biznesową, nie jest wspierane przez Comarch i może uszkodzić dane.

Wariant 3: Optima API od WebArm

Gotowe REST API do Comarch ERP Optima, zbudowane na COM objects z pełną walidacją biznesową. Standardowy interfejs HTTP + JSON z dokumentacją Swagger/OpenAPI.

GET /api/kontrahenci?szukaj=FIRMA
X-Api-Key: twoj-klucz
X-Optima-Firma: FIRMA-DB

{
  "data": [
    {
      "kod": "FIRMA-001",
      "nazwa1": "Przykładowa Firma Sp. z o.o.",
      "nip": "1234567890",
      "email": "[email protected]"
    }
  ]
}

Różnica: nie musisz pisać wrappera, nie musisz utrzymywać kodu, nie musisz testować kompatybilności po każdej aktualizacji Comarch. WebArm robi to za Ciebie. Jeśli prowadzisz sklep internetowy, sprawdź praktyczny przewodnik po integracji sklepu z Optimą.

Porównanie opcji

Kryterium	COM wrapper (DIY)	Bezpośredni SQL	Optima API (WebArm)
Czas budowy	2–6 miesięcy	1–4 tygodnie	0 (gotowe)
Utrzymanie	Ty	Ty	WebArm
Kompatybilność z aktualizacjami	Ręczna	Brak gwarancji	WebArm testuje
Walidacja biznesowa	Tak (COM)	Brak	Tak
Dokumentacja	Twoja	Brak	Swagger/OpenAPI
Platforma klienta	Tylko Windows	Dowolna	Dowolna

Dla partnerów Comarch

Jeśli jesteś partnerem Comarch i Twoi klienci pytają o integrację — nie musisz budować własnego API. Optima API od WebArm to gotowe rozwiązanie, które możesz zaoferować swoim klientom. Skupiasz się na wdrożeniu i konfiguracji, nie na pisaniu i utrzymaniu kodu integracyjnego.

Czy Comarch kiedyś wyda REST API?

Nie wiadomo. Comarch rozwija Optimę w Chmurze, co teoretycznie mogłoby ułatwić budowę API. Ale nawet gdyby REST API pojawiło się jutro — migracja z dotychczasowych integracji zajęłaby czas, a firmy potrzebują rozwiązania teraz, nie za rok.

Optima API od WebArm jest dostępne dzisiaj, z dokumentacją, wsparciem i aktualizacjami.

---

Masz pytania o integrację z Comarch Optima? Sprawdź odpowiedzi na najczęstsze pytania lub skontaktuj się z nami.