Integracja sklepu internetowego z Comarch ERP Optima pozwala wyeliminować ręczne przepisywanie danych — zamówienia, stany magazynowe, cenniki i kontrahenci synchronizują się automatycznie. Problem w tym, że Comarch ERP Optima jako oprogramowanie ERP nie posiada natywnego REST API do połączenia z zewnętrznymi platformami e-commerce. Ten przewodnik pokazuje jak przeprowadzić automatyzację procesów między sklepem a Optimą z pomocą Optima API i VerSync od WebArm, krok po kroku.

Najważniejsze informacje

Połączenie sklepu z Optimą obejmuje produkty, cenniki, stany magazynowe, zamówienia i kontrahentów. Pominięcie jednego z tych przepływów szybko tworzy rozbieżności.
Optima API od WebArm wystawia dane Optimy przez REST API, bez zmuszania sklepu do pracy na COM objects lub bezpośrednim SQL.
VerSync automatyzuje harmonogramy synchronizacji, mapowanie pól, retry, dead-letter queue i monitoring.
Typowy start to 1-3 dni dla podstawowego przepływu, jeśli sklep ma REST API lub dostęp do bazy danych.

Przepływ danych między sklepem internetowym a systemem ERP

Dlaczego integracja jest konieczna

Sklep internetowy i Comarch ERP Optima to dwa odrębne systemy. Bez integracji sklepu z Optimą Twój zespół musi ręcznie:

Przepisywać zamówienia ze sklepu do Optimy — ten proces powtarza się cyklicznie i pochłania czas pracowników
Aktualizować stany magazynowe po każdej sprzedaży, co utrudnia sprawną obsługę magazynu
Synchronizować cenniki i opisy produktów między systemami
Przenosić dane nowych klientów do bazy kontrahentów

Przy kilku zamówieniach dziennie to jeszcze do opanowania. Przy kilkudziesięciu — to pełnoetatowa praca jednej osoby. Przy kilkuset — fizyczna niemożliwość.

Automatyzacja procesów w Comarch ERP Optima eliminuje potrzebę ręcznego wprowadzania danych i przyspiesza realizację zamówień. Synchronizacja danych między sklepem internetowym a systemem ERP odbywa się automatycznie — pracownicy mogą skupić się na rozwoju biznesu zamiast na monotonnym przepisywaniu danych.

Co trzeba zsynchronizować

Typowa integracja sklepu z Comarch ERP Optima obejmuje 4 przepływy danych, które mogą być realizowane w czasie rzeczywistym między platformą e-commerce a systemem ERP:

Przepływ	Kierunek	Częstotliwość
Produkty i cenniki	Optima → Sklep	Konfigurowalny interwał (domyślnie co 30s)
Stany magazynowe	Optima → Sklep	Konfigurowalny interwał (domyślnie co 30s)
Zamówienia	Sklep → Optima	Konfigurowalny interwał (domyślnie co 30s)
Kontrahenci	Dwukierunkowy	Konfigurowalny interwał (domyślnie co 30s)

Zakres warto ustalić przed wyceną. Inaczej integracja sklepu z Optimą kończy się “prawie działającym” połączeniem: produkty są aktualne, ale zamówienia wchodzą ręcznie; zamówienia wchodzą automatycznie, ale stany magazynowe dalej są przestarzałe; albo kontrahenci duplikują się przy każdej zmianie adresu.

Comarch e-Sklep czy zewnętrzna platforma e-commerce

Comarch e-Sklep jest naturalnym wyborem dla części firm pracujących w ekosystemie Comarch, ale nie jest warunkiem automatyzacji. Ten sam model integracyjny można zastosować dla WooCommerce, PrestaShop, Shopify, Shoper, BaseLinker, Allegro, panelu B2B albo sklepu pisanego na zamówienie. Różni się tylko adapter docelowy, mapowanie pól i sposób autoryzacji.

W programie Comarch ERP Optima źródłem danych pozostaje kartoteka towarów, cenniki, kontrahenci, dokumenty handlowe i stany magazynowe. Po stronie sklepu trzeba ustalić, które pola są nadrzędne: nazwa, opis, EAN, cena, stawka VAT, stan dostępny, rezerwacje, status zamówienia oraz dokumenty powiązane. Aktualizacja stanów magazynowych powinna działać osobno od importu zamówień, bo oba procesy mają inne tempo i inne ryzyko błędu.

Dobre wdrożenie nie polega na tym, że sklep raz dziennie pobiera plik eksportu. Integracja e-commerce powinna cyklicznie czytać zmiany z systemu Comarch ERP Optima, zapisywać status każdej synchronizacji i jasno pokazywać, czy problem leży po stronie Optimy, sklepu, mapowania czy konkretnego dokumentu handlowego.

Jak wybrać firmę do integracji z Comarch Optima

Firma do integracji z Comarch Optima powinna znać nie tylko API sklepu, ale też zachowanie Optimy przy dokumentach, kontrahentach, cennikach, stanach i płatnościach. WebArm łączy dwa elementy: Optima API, czyli warstwę REST/JSON do Comarch ERP Optima, oraz VerSync, czyli silnik synchronizacji z retry, monitoringiem i rollbackiem.

Przy wyborze partnera warto pytać o konkretne scenariusze: co stanie się z zamówieniem bez NIP, jak powstaje kontrahent, kiedy tworzy się faktura, jak obsłużyć płatność częściową, jak cofnąć błędną zmianę ceny i gdzie operator zobaczy błąd synchronizacji. Odpowiedź “mamy integrację” nie wystarcza, jeśli system nie pokazuje statusu operacji i nie rozróżnia problemu sklepu od problemu Optimy.

Kryterium wyboru	Co sprawdzić przed wdrożeniem
Doświadczenie w Optimie	Czy firma rozumie COM objects, dokumenty handlowe, rozrachunki i definicje dokumentów.
Zakres integracji	Czy obejmuje produkty, stany, cenniki, zamówienia, kontrahentów, płatności i dokumenty powiązane.
Obsługa błędów	Czy są retry, dead-letter queue, logi i czytelny status każdej operacji.
Utrzymanie po aktualizacji	Czy partner bierze odpowiedzialność za kompatybilność z nowymi wersjami Comarch ERP Optima.
Dane i bezpieczeństwo	Czy zapis przechodzi przez walidację Optimy, a nie bezpośredni SQL bez reguł biznesowych.

Krok 1: Pobranie produktów z Optimy

Optima API — REST API do Comarch ERP Optima stworzone przez WebArm — udostępnia endpoint do pobierania listy towarów z pełnymi danymi:

GET /api/towary?aktywny=true&stronaRozmiar=100
X-Api-Key: twoj-klucz
X-Optima-Firma: FIRMA-DB

Odpowiedź zawiera kod, nazwę, jednostkę miary, cenę, stawkę VAT, stan magazynowy, EAN, opis i kategorię. Dla sklepu to komplet danych potrzebny do aktualizacji karty produktu bez ręcznego eksportu z Optimy.

Twój sklep internetowy pobiera te dane i mapuje na własną strukturę produktów. EAN, kod, nazwa, cena, stawka VAT — wszystko przychodzi w jednym żądaniu. Optima API udostępnia dane z Comarch ERP Optima w standardowym formacie JSON, dzięki czemu integracja sklepu z Optimą działa z dowolną platformą e-commerce. Jak to wygląda w praktyce pokazuje case study synchronizacji produktów i cen między Comarch Optimą a panelem B2B.

Krok 2: Synchronizacja stanów magazynowych

Stany magazynowe zmieniają się najczęściej — sprzedaż w sklepie stacjonarnym, sprzedaż w e-commerce, przyjęcia towaru, zwroty. VerSync od WebArm monitoruje zmiany w Comarch ERP Optima i automatycznie aktualizuje sklep internetowy, obsługując stany dostępności, rezerwacje oraz przesunięcia magazynowe w wielu magazynach:

pipeline:
  name: stany-magazynowe
  source: optima
  target: woocommerce
  type: watch
  interval: 5m
  mapping:
    - from: stanMagazynowy
      to: stock_quantity
    - from: kod
      to: sku

VerSync sprawdza zmiany co 5 minut. Gdy stan się zmieni w Optimie — sklep jest aktualizowany automatycznie. Dzięki synchronizacji danych w czasie rzeczywistym integracja sklepu z Optimą umożliwia sprzedaż wielokanałową bez ryzyka rozbieżności stanów. Zero ręcznej pracy. Więcej o konfiguracji pipeline’ów synchronizacji stanów w artykule automatyczna synchronizacja stanów magazynowych.

Krok 3: Przekazywanie zamówień do Optimy

Gdy klient składa zamówienie w sklepie, system VerSync od WebArm wysyła je do Comarch ERP Optima przez REST API, wraz z adresem wysyłki i modelem płatności:

POST /api/dokumenty/zamowienia-klientow
X-Api-Key: twoj-klucz
X-Optima-Firma: FIRMA-DB
Content-Type: application/json

Minimalne dane zamówienia to kontrahent, adres wysyłki, model płatności, pozycje, ilości, ceny, rabaty i referencja zamówienia ze sklepu. Wdrożenie powinno też ustalić, kiedy tworzyć ZK, kiedy fakturę sprzedaży i jak obsługiwać statusy płatności.

VerSync (silnik synchronizacji WebArm) przekazuje zamówienie do Comarch ERP Optima, która tworzy dokument ZK (Zamówienie Klienta) z pełną walidacją — sprawdza stany, przelicza rabaty, generuje numer dokumentu. VerSync obsługuje też zmiany statusów zamówień i automatyczne generowanie dokumentów handlowych: faktur, paragonów czy dokumentów MM. Integracja sklepu z Optimą obejmuje również połączenie z firmami kurierskimi — generowanie etykiet nadawczych i numerów śledzenia paczek. Twój magazynier widzi zamówienie w Optimie tak samo, jak zamówienie złożone przez telefon. Pełen opis tego procesu — z obsługą scenariuszy brzegowych — znajdziesz w artykule jak przesyłać zamówienia ze sklepu do Optimy automatycznie.

Krok 4: Synchronizacja kontrahentów

Nowy klient w sklepie internetowym → nowy kontrahent w Comarch ERP Optima. Istniejący klient → automatyczna aktualizacja danych. Synchronizacja kontrahentów przez WebArm zapewnia spójność danych między platformą e-commerce a systemem ERP:

POST /api/kontrahenci
X-Api-Key: twoj-klucz
X-Optima-Firma: FIRMA-DB
Content-Type: application/json

{
  "kod": "KLIENT-WEB-0042",
  "nazwa1": "Jan Kowalski",
  "nip": "1234567890",
  "email": "[email protected]",
  "telefon": "+48600100200",
  "adres": {
    "ulica": "Kwiatowa 5",
    "miasto": "Warszawa",
    "kodPocztowy": "00-001"
  }
}

Jakie sklepy można zintegrować

Optima API od WebArm to standardowe REST API — integruje się z każdym systemem, który potrafi wysłać żądanie HTTP. Nie ma znaczenia czy Twoja platforma e-commerce to WooCommerce, PrestaShop, Shoper, Allegro, BaseLinker, sklep pisany na zamówienie czy wewnętrzna aplikacja firmowa. Jeśli Twój system komunikuje się przez HTTP — REST API od WebArm połączy go z Comarch ERP Optima.

VerSync od WebArm idzie o krok dalej — to gotowy silnik synchronizacji danych, który łączy się z dowolnym systemem e-commerce posiadającym REST API lub bazę danych. Konfiguracja nowego połączenia to plik YAML z definicją źródła, celu i mapowania pól, co pozwala na dopasowanie integracji sklepu z Optimą do specyfiki biznesu.

Platforma	Typ integracji	Typowy zakres
WooCommerce / PrestaShop / Shopify	REST API sklepu	produkty, stany, zamówienia, kontrahenci
Shoper / BaseLinker / marketplace	API pośrednika	zamówienia, statusy, przesyłki, rezerwacje
Panel B2B lub custom e-commerce	REST API albo baza danych	ceny hurtowe, cenniki, indywidualne warunki klienta
WMS / CRM / aplikacja wewnętrzna	REST API, webhook lub DB	dokumenty, kontrahenci, rozrachunki, statusy

Czas integracji — miesiące tradycyjną metodą vs dni przez REST API

Ile trwa integracja

Metoda	Czas	Koszt
Ręczne przepisywanie	∞ (ciągły koszt ludzi)	Etat magazyniera/operatora
COM objects (własny dev)	2–6 miesięcy developmentu	Programista .NET + utrzymanie
Bezpośredni SQL	1–4 tygodnie (ryzykowne)	Programista + zero wsparcia Comarch
Optima API + VerSync od WebArm	1–3 dni	Licencja + abonament

Krótki czas dotyczy podstawowego przepływu. Integracja z wieloma magazynami, cennikami, marketplace i indywidualnymi rabatami wymaga dodatkowego mapowania, testów i monitoringu. Dobra wiadomość: te elementy dopisuje się w konfiguracji pipeline, nie w osobnym wrapperze COM.

FAQ

Czy integracja sklepu z Comarch Optima wymaga Comarch e-Sklep? Nie. Integracja może działać z dowolnym sklepem lub platformą e-commerce, jeśli da się pobrać zamówienia i zapisać produkty, stany oraz statusy przez API albo bazę danych.

Czy można zsynchronizować wiele magazynów? Tak. Pipeline może pobierać stany z jednego magazynu, sumować kilka magazynów albo publikować osobne stany dla B2B i marketplace.

Czy da się zacząć tylko od zamówień? Tak. Najczęstszy minimalny zakres to import zamówień ze sklepu do Optimy, a dopiero później synchronizacja stanów, cenników i kontrahentów.

Dlaczego WebArm

WebArm produkuje dwa narzędzia, które razem rozwiązują problem integracji sklepu z Comarch ERP Optima end-to-end:

Optima API od WebArm — lokalny serwer REST instalowany obok Comarcha. Eksponuje wszystkie kluczowe encje (kontrahenci, towary, faktury, dokumenty handlowe i magazynowe, płatności) przez HTTP/JSON. Każda operacja przechodzi przez oficjalną warstwę biznesową Optimy — pełna walidacja, zachowanie gwarancji Comarcha.
VerSync od WebArm — silnik synchronizacji konfigurowany w YAML. Pipeline’y “watch” pollują źródła i wypychają zmiany do celu w czasie rzeczywistym (domyślnie co 30 sekund), z retry, dead-letter queue i monitoringiem.

WebArm specjalizuje się wyłącznie w integracjach Comarch ERP Optima — nie jest to firma wdrożeniowa “od wszystkiego”. Wdrożenia realizujemy bezpośrednio (analiza, instalacja, mapowanie, monitoring produkcyjny). Nasi klienci to producenci, dystrybutorzy i firmy handlowe sprzedający przez sklep + Allegro/marketplace + B2B równolegle.

Podsumowanie

Integracja sklepu internetowego z Comarch ERP Optima przez REST API eliminuje ręczną pracę, błędy ludzkie i opóźnienia w synchronizacji danych. Optima API od WebArm i VerSync od WebArm automatyzują pełen cykl e-commerce: produkty, stany magazynowe, zamówienia, kontrahenci.

Nie musisz budować integracji od zera. Nie musisz znać COM objects. Wystarczy gotowe REST API od WebArm i automatyzacja procesów działa od pierwszego dnia.

Chcesz zintegrować swój sklep z Optimą? Sprawdź odpowiedzi na najczęstsze pytania lub skontaktuj się z nami.