IntegracjaE-commerceComarch Optima

Integracja sklepu z Comarch Optima — przewodnik krok po kroku

Robert Mońka ·

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.

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ływKierunekCzęstotliwość
Produkty i cennikiOptima → SklepKonfigurowalny interwał (domyślnie co 30s)
Stany magazynoweOptima → SklepKonfigurowalny interwał (domyślnie co 30s)
ZamówieniaSklep → OptimaKonfigurowalny interwał (domyślnie co 30s)
KontrahenciDwukierunkowyKonfigurowalny interwał (domyślnie co 30s)

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
{
  "data": [
    {
      "kod": "LAPTOP-PRO-15",
      "nazwa": "Laptop Pro 15 cali",
      "jm": "szt",
      "cenaNetto": 4500.00,
      "stawkaVAT": 23,
      "stanMagazynowy": 12,
      "ean": "5901234567890",
      "opis": "Laptop z procesorem...",
      "kategoria": "Elektronika"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 100,
    "totalCount": 847
  }
}

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 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, Twój system wysyła je do Optimy przez 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
{
  "kontrahentKod": "KLIENT-WEB-0042",
  "adresWysylki": {
    "ulica": "Przykładowa 1",
    "miasto": "Warszawa",
    "kodPocztowy": "00-001"
  },
  "modelPlatnosci": "przelew",
  "pozycje": [
    {
      "towarKod": "LAPTOP-PRO-15",
      "ilosc": 1,
      "cenaNetto": 4500.00,
      "rabat": 0
    },
    {
      "towarKod": "TORBA-LAPTOP-15",
      "ilosc": 1,
      "cenaNetto": 89.00,
      "rabat": 10
    }
  ],
  "uwagi": "Zamówienie #1847 ze sklepu"
}

VerSync 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 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 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 — Optima API połączy go z Comarch ERP Optima.

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

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

Ile trwa integracja

MetodaCzasKoszt
Ręczne przepisywanie∞ (ciągły koszt ludzi)Etat magazyniera/operatora
COM objects2–6 miesięcy developmentuProgramista .NET + utrzymanie
Bezpośredni SQL1–4 tygodnie (ryzykowne)Programista + zero wsparcia Comarch
Optima API + VerSync1–3 dniLicencja + abonament

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 automatyzują pełen cykl e-commerce: produkty, stany magazynowe, zamówienia, kontrahenci.

Nie musisz budować integracji od zera. Nie musisz znać COM objects. Wystarczy standardowe REST API 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.

RM

Robert Mońka

Założyciel WebArm. 28 lat w IT, właściciel firmy produkcyjno-handlowej. Buduje narzędzia integracyjne do Comarch ERP Optima i używa ich we własnych firmach.

LinkedIn →

Masz pytania o integrację z Comarch Optima?

Sprawdź FAQ Skontaktuj się