Blog WebArm: integracja sklepu z Comarch Optima

Dobra integracja nie zaczyna się od wyboru technologii, tylko od mapy procesu. Trzeba ustalić, skąd pochodzą towary, cenniki, stany magazynowe, kontrahenci, płatności, faktury i statusy. W praktyce dopiero taka mapa pokazuje, czy wystarczy prosta wymiana plików, czy potrzebna jest stała integracja sklepu z Comarch Optima.

Jeżeli sklep już działa, najczęściej pierwszy problem dotyczy zamówień. Wtedy trzeba sprawdzić formę płatności, koszt przesyłki, stawkę VAT, kontrahenta, rezerwacje i komunikat błędu dla operatora. Bez tego import zamówień do Optimy może działać tylko dla prostych przypadków.

Jeżeli firma sprzedaje z kilku magazynów albo ma rezerwacje, priorytetem staje się automatyczna synchronizacja stanów magazynowych. Tu liczy się nie tylko aktualny stan, ale też harmonogram, kolejka, retry, rollback i jasna informacja, które źródło danych ma pierwszeństwo.

Jeżeli decyzję podejmuje dział IT albo właściciel chce znać ryzyka, trzeba rozdzielić odczyt danych od zapisu dokumentów. Porównanie REST API vs COM objects jest ważne zwłaszcza przy fakturach, paragonach i WZ, gdzie zapis powinien przejść przez walidację programu Comarch ERP Optima.

Niezgodne towary i cenniki. Sklep internetowy może mieć własne nazwy produktów, warianty, kody EAN, rabaty i stany dostępności. System ERP przechowuje towary, cenniki i magazyny według reguł księgowo-magazynowych. W integracji trzeba więc ustalić reguły mapowania, źródło prawdy dla ceny i sposób obsługi produktów, których sklep nie powinien sprzedawać mimo obecności w kartotece.

Niepełne zamówienia. Zamówienie ze sklepu to nie tylko koszyk. W praktyce trzeba sprawdzić kontrahenta, adresy wysyłki, formę płatności, koszt przesyłki, stawkę VAT, dokumenty handlowe, rezerwacje i statusy. Dlatego import zamówień powinien mieć walidację danych wejściowych, czytelny komunikat błędu i jasną decyzję, czy zamówienie tworzy rezerwację, fakturę, paragon czy dokument magazynowy.

Zapis poza walidacją programu. Bezpośredni SQL bywa kuszący przy odczytach, ale zapis faktur, paragonów albo dokumentów magazynowych poza mechanizmami programu ERP może ominąć numerację, rozrachunki i reguły VAT. Porównanie REST API vs COM objects wyjaśnia, dlaczego zapis powinien przejść przez kontrolę programu.

Brak monitoringu i retry. Integracja sklepu z Optima działa stabilnie dopiero wtedy, gdy użytkownik widzi komunikat, status, log i możliwość ponowienia. Właśnie tu przydaje się VerSync: harmonogram, kolejka, dead-letter, rollback oraz aktualizacja stanów magazynowych w czasie rzeczywistym.

Optima API to warstwa REST API od WebArm instalowana przy Comarch ERP Optima. Umożliwia integrację e-commerce, WMS, CRM, BI albo aplikacji webowej przez HTTP/JSON, bez zmuszania sklepu do bezpośredniej pracy z COM objects.

VerSync to silnik synchronizacji danych. Ma sens tam, gdzie trzeba obsłużyć nie pojedyncze wywołanie, lecz stały proces: aktualizacja stanów magazynowych, przekazywanie zamówień, mapowanie kontrahentów, synchronizacja produktów i raportowanie błędów.

Comarch e-Sklep jest ważnym scenariuszem, ale nie jedynym. Te same problemy występują przy WooCommerce, PrestaShop, Shopify, marketplace, panelu B2B i każdym e-commerce, który musi wymieniać dane z systemu ERP. Czasem wystarcza gotowy moduł albo integrator marketplace, a czasem potrzebna jest indywidualna synchronizacja z bazą i API.

Gotowe integracje są dobrym punktem startu, gdy sklep działa standardowo: jedna waluta, proste stany magazynowe, typowe płatności i przewidywalny import zamówień. Gdy firma ma własny proces sprzedaży, integracja powinna uwzględnić dopasowania poszczególnych synchronizacji, a nie tylko samo połączenie sklepu z ERP.

COM objects są lokalnym interfejsem programu Comarch ERP Optima. Dają dostęp do walidacji biznesowej, ale wymagają Windows, sesji programu i wiedzy o strukturach Optimy. Dlatego wiele firm szuka prostszego kontraktu REST.

Synchronizacja danych oznacza kontrolowane porównanie dwóch systemów. Nie chodzi tylko o kopiowanie danych, lecz o decyzję, które pole jest źródłem prawdy, kiedy wolno nadpisać wartość i jak pokazać użytkownikowi błąd.

W rozmowach z klientami te same potrzeby pojawiają się pod różnymi nazwami: Comarch e-Sklep, własny e-sklep, panel B2B albo marketplace, na przykład Allegro. Dla integracji sklepu najważniejsze nie jest samo nazewnictwo, tylko to, jakie dane mają przechodzić między kanałem sprzedaży a programem Comarch ERP Optima.

Dla właściciela firmy najważniejsze są zwykle stany dostępności, ceny, zamówienia i status realizacji. Dla biura rachunkowego albo działu księgowego krytyczne będą kontrahenci, stawki VAT, dokumenty handlowe, płatności i numeracja. Dobry zakres integracji musi uwzględnić oba punkty widzenia, bo sprzedaż i księgowość korzystają z tych samych danych w innych momentach.

E-commerce to nie tylko strona sklepu. W praktyce obejmuje aktualizację stanów magazynowych, przekazywanie zamówień i faktur, koszt przesyłki, etykiety nadawcze, płatności oraz status, na podstawie którego klient widzi postęp realizacji. Część procesów może działać dopiero po zmianie statusu zamówienia. Jeżeli któryś z tych elementów zostaje poza integracją, pracownicy wracają do ręcznego przepisywania danych.

Przed rozmową techniczną warto przygotować kilka konkretnych przykładów: jedno poprawne zamówienie, jedno zamówienie z błędem, kartę towaru, pracę na kartotekach towarowych, formę płatności, używane magazyny i dokument, który ma powstać w Optimie. Taki zestaw szybciej pokazuje, czy potrzebne jest samo Optima API, harmonogram w VerSync, czy pełniejsza automatyzacja procesu.

Najbardziej ryzykowne są projekty, w których każdy dział inaczej rozumie słowo „integracja”. Dlatego zakres powinien być opisany operacyjnie: co ma się wydarzyć po złożeniu zamówienia, po zmianie ceny, po rezerwacji towaru, po anulowaniu płatności i po wystawieniu dokumentu. To jest użyteczniejsze niż lista ogólnych haseł i łatwiej na tej podstawie wycenić wdrożenie, bo potrzeby firmy i wymagania projektu muszą być ustalone na początku.

Pierwszy etap to analiza zakresu integracji. Trzeba ustalić, czy priorytetem są produkty, towary, cenniki, stany magazynowe, zamówienia, kontrahenci, płatności, faktury, etykiety nadawcze czy statusy. Bez tej listy łatwo zbudować połączenie, które działa tylko dla prostych przypadków.

Drugi etap to wybór metody technicznej. Prosty eksport pliku może wystarczyć do jednorazowej migracji, ale codzienna sprzedaż zwykle wymaga API. Jeśli zapis tworzy dokumenty w Comarch ERP Optima, trzeba pamiętać o walidacji programu, a nie tylko o tym, żeby rekord pojawił się w bazie.

Trzeci etap to mapowanie danych. Każdy dokument powinien mieć kontrahenta, towary, magazyn, płatność, stawkę VAT i status. Każdy sklep powinien wiedzieć, czy stany dostępności pochodzą z Optimy, panelu B2B, marketplace czy innego systemu.

Czwarty etap to uruchomienie harmonogramu. Dla stanów magazynowych ważna jest szybka aktualizacja, dla zamówień pełna walidacja i komunikat zwrotny, a dla cenników kontrola zmian. Właśnie tu przydaje się VerSync, bo oddziela logikę procesu od pojedynczych wywołań API.

Piąty etap to monitoring. Integracja sklepu z Optima nie powinna kończyć się na wdrożeniu. Operator musi widzieć, które zamówienia zostały zaimportowane, które faktury czekają na weryfikację, gdzie wystąpił błąd i czy można bezpiecznie ponowić zlecenie.

Kanał sprzedaży. Napisz, czy chodzi o Comarch e-Sklep, inny e-sklep, panel B2B, Allegro, marketplace czy kilka kanałów jednocześnie. Integracja ma inny zakres, gdy jeden sklep sprzedaje z jednego magazynu, a inny, gdy firma łączy kilka sklepów, punkt stacjonarny i program ERP.

Połączenie sklepu. Zbierz adres panelu, sposób logowania do API, wersję programu ERP, ścieżkę dostępu do ustawień i informację, kto może zatwierdzać zmiany. Przy pierwszej synchronizacji należy przejść przez konfigurację oddziału, uprawnienia operatora i klucz wymiany, jeżeli taki mechanizm występuje w danym wdrożeniu.

Konfiguracja Comarch e-Sklep. Jeżeli działa Comarch e-Sklep, zanotuj ustawienia z obszarów takich jak zakładka Ogólne, zakładka Dodatkowe i sekcja Dane. W konfiguracji Comarch e-Handel lub e-Sklep nie chodzi o przepisywanie instrukcji, tylko o wskazanie pól, które wpływają na wymianę danych.

Towary i opisy. Przygotuj produkty, towary, kod EAN, warianty, jednostki miary, opisy oraz grupę towarową używaną w sklepie. Jeżeli grupa towarów buduje drzewo towarów, integrator powinien wiedzieć, czy tę strukturę tworzy sklep, czy system ERP.

Ceny. Opisz, czy podstawą jest cena netto i brutto, domyślna waluta, rabaty, waluty obce, cenniki i prezentowane ceny w sklepie. Integracja musi też określić, kiedy cena w e-sklepie może różnić się od ceny w ERP.

Stany i magazyny. Wskaż liczbę magazynów, rezerwacje, przesunięcia magazynowe, stany magazynu głównego i zasady, według których sklep pokazuje stany. Synchronizacja stanów magazynowych powinna też opisywać, co dzieje się po każdej zmianie ilości albo rezerwacji.

Zamówienia. Ustal, które pola zamówień są wymagane: klienta, adresy wysyłki, koszt dostawy, forma płatności, uwagi klienta i status zamówień. Dobrze opisana integracja zamówień wskazuje też, czy pozycja usługowa jest odpowiednikiem kosztu przesyłki.

Kontrahenci. Określ, kiedy tworzyć kontrahentów, kiedy aktualizować dane i jak rozpoznać tego samego klienta w bazie. W integracji B2B ważne są też limity, indywidualne ceny, adresy wysyłki oraz numer NIP.

Dokumenty handlowe. Zdecyduj, czy system ma tworzyć rezerwację, faktury, paragony, WZ, pełny dokument handlowy czy tylko szkic do weryfikacji. Przy kilku magazynach warto ustalić, czy potrzebne jest tworzenie MM albo blokada zapisu do czasu akceptacji operatora.

Konfiguracja płatności. Sprawdź mapowanie metod płatności, pobrań, przelewów, kosztów przesyłki i stawka VAT dla pozycji dodatkowych. Ten sam koszt wysyłki może być inaczej pokazany w sklepie, a inaczej zapisany w systemie ERP.

Pola własne. Wypisz pola, których nie ma w standardowym eksporcie, ale są ważne dla firmy, księgowości albo magazynu. Często są to uwagi klienta, numer paczki, termin dostawy, identyfikator marketplace albo dane wymagane przez biuro rachunkowe.

Zmiany statusów. Określ, które zmiany statusów mają wracać do sklepu, a które powinny zostać tylko w programie ERP. Część automatyzacji działa na podstawie zmiany statusu, na przykład wysyłka numeru listu, aktualizacja płatności albo zamknięcie zamówień po wystawieniu dokumentu.

Zakres synchronizacji danych. Wybierz, czy synchronizacja obejmuje towary, stany magazynowe, import zamówień z kilku źródeł, kontrahentów, dokumentów handlowych, płatności czy przesyłanie statusów. Bez tej decyzji trudno porównać gotowe integracje z indywidualnym wdrożeniem.

Źródło prawdy. Wybierz, czy dane są ważniejsze po stronie sklepu, w bazie ERP, w programie magazynowym czy w zewnętrznym systemie sprzedażowym. To porządkuje stany magazynu, ceny, opisy oraz import zamówień, zanim integracja zacznie automatycznie nadpisywać dane.

Odpowiedzialność. Integrator powinien wiedzieć, kto poprawia dane, kto akceptuje koszt usługi, kto widzi możliwość ponowienia operacji i kto decyduje o wymaganiach danego projektu. To zmniejsza liczbę niejasności, gdy firma ma kilka działów i różne potrzeby firmy.

Model wdrożenia. Gotowy moduł sprawdzi się przy prostym procesie, ale z dowolnym systemem e-commerce da się pracować inaczej, jeśli ma API, eksport plików albo dostęp do bazy. Dlatego integracja powinna być opisana przez proces, a nie tylko przez nazwę platformy.

Rozmowa techniczna ma sens, gdy w firmie istnieją już konkretne ograniczenia: kilka magazynów, różne modele zapisu kontrahenta, indywidualne cenniki, stany dostępności zależne od rezerwacji, przesunięcia magazynowe albo kilka kanałów sprzedaży. Wtedy ogólna integracja sklepu z Optima przestaje być jednym zadaniem, a staje się procesem z zależnościami.

Warto też porozmawiać, gdy użytkownicy widzą błędy, ale nie wiedzą, czy źródłem jest sklep, Comarch e-Sklep, program Comarch ERP Optima, konfiguracja płatności, magazyn czy dokument. Problem może być też po stronie systemu Comarch ERP Optima. Dobrze zaprojektowana integracja pokazuje komunikat w takim miejscu, żeby operator mógł poprawić rekord bez eskalacji do programisty.

Jeżeli chcesz sprawdzić zakres projektu, przygotuj przykładowe zamówienie, kartę towaru z danymi ustawianymi na karcie towaru, formę płatności i scenariusz błędu. To wystarczy, żeby ocenić, czy potrzebne jest samo Optima API, harmonogram w VerSync, czy pełniejsza automatyzacja procesów przy Comarch Optima.