100% pokrycia modułów Comarch Optima przez REST API

976 endpointów. 201 serwisów COM. 131 grup Swagger. 100% pokrycia obiektów COM Comarch. Optima API obsługuje teraz każdy moduł, każdy dokument i każdą operację dostępną przez interfejs COM Comarch ERP Optima — przez standardowe żądania HTTP/JSON.

Co oznacza “100% pokrycia”

Comarch ERP Optima udostępnia swoje funkcje przez obiekty COM — binarny interfejs Windows wymagający .NET, zainstalowanej Optimy i znajomości nieudokumentowanych struktur (dlaczego Comarch nie oferuje publicznego REST API). Optima API mapuje każdy z tych obiektów na endpoint REST:

Zakres	Liczba
Endpointy REST	976
Serwisy COM Comarch	201
Grupy Swagger	131

To nie jest “obsługujemy większość” — to pełne mapowanie 1:1 między interfejsem COM Comarch a REST API.

Moduły

Każdy moduł Comarch ERP Optima jest dostępny przez REST:

Handel z Magazynem — kontrahenci, towary, atrybuty, cenniki, dokumenty handlowe (faktury sprzedaży/zakupu, paragony, WZ, PZ, rezerwacje, zamówienia), stany magazynowe
Kasa/Bank — raporty kasowe, przelewy, rozliczenia, zapisy kasowo-bankowe
Księga Handlowa — dekretacja, plan kont, bilans, rozrachunki
Księga Podatkowa — KPiR, ewidencja VAT, rejestry VAT
Środki Trwałe — karty środków trwałych, amortyzacja, inwentaryzacja
Płace i Kadry — pracownicy, umowy, listy płac, składki ZUS
CRM — kontakty, zadania, notatki, historia komunikacji
Serwis — zlecenia serwisowe, części, czynności
Obieg Dokumentów — dokumenty, katalogi, atrybuty, procesy obiegu

Architektura dwuwarstwowa

Pełne pokrycie nie oznacza “wszystko przez COM”. Optima API stosuje dwie ścieżki:

Odczyty (GET, batch read) trafiają bezpośrednio do bazy SQL — maksymalna szybkość, zero obciążenia sesji COM. 25 endpointów batch (read i update) umożliwia operacje na wielu rekordach jednym żądaniem.

Zapisy (POST, PUT, DELETE) przechodzą przez COM objects z pełną walidacją biznesową Comarch: VAT, split payment, numeracja, reguły cenowe. Dedykowany wątek STA z kolejką eliminuje konflikty współbieżności.

# Odczyt — bezpośrednio z SQL, natychmiastowa odpowiedź
curl -X GET https://serwer/api/kontrahenci?pageSize=100 \
  -H "X-Api-Key: klucz" \
  -H "X-Optima-Firma: FIRMA-DB"

# Zapis — przez COM, pełna walidacja Comarch
curl -X POST https://serwer/api/dokumenty/faktury-sprzedazy \
  -H "X-Api-Key: klucz" \
  -H "X-Optima-Firma: FIRMA-DB" \
  -H "Content-Type: application/json" \
  -d '{"kontrahentKod": "FIRMA-001", "pozycje": [...]}'

Synchronizacja — 9 dedykowanych endpointów

Cursor-based sync endpoints pozwalają pobierać tylko zmiany od ostatniego zapytania:

/api/sync/towary
/api/sync/kontrahenci
/api/sync/kontakty
/api/sync/osoby
/api/sync/atrybuty-towarow
/api/sync/dokumenty
/api/sync/partie-dostaw
/api/sync/zapisy-kb
/api/sync/zdarzenia-kb

Parametr modifiedSince eliminuje konieczność pełnego odczytu — idealne dla integracji e-commerce i hurtowni danych.

Podział endpointów

Metoda HTTP	Liczba	Zastosowanie
GET	247	Odczyt pojedynczych zasobów i list
POST	384	Tworzenie nowych rekordów i batch read
PUT	177	Aktualizacja istniejących rekordów
DELETE	168	Usuwanie rekordów

Co to zmienia

Do tej pory integracja z Comarch Optimą wymagała wyboru: albo ograniczony zakres przez COM, albo ryzykowne bezpośrednie operacje na SQL (szczegółowe porównanie metod). Teraz jest trzecia opcja — kompletne REST API pokrywające każdy obiekt COM, z dokumentacją Swagger dostępną od pierwszej minuty po instalacji.

Niezależnie od modułu Optimy — handel, księgowość, kadry, CRM — Twój system komunikuje się z nim tym samym sposobem: HTTP request, JSON response.

Chcesz zobaczyć pełną dokumentację Swagger? Skontaktuj się z nami — uruchamiamy demo w ciągu jednego dnia roboczego.