Integracja sklepu internetowego z Comarch ERP XL

Integracja sklepu internetowego z Comarch ERP XL pozwala automatycznie synchronizować zamówienia, stany magazynowe i ceny bez ręcznego przepisywania danych.

Na czym polega ta usługa

Konfiguracja obejmuje połączenie sklepu z Comarch ERP XL, ustawienie automatycznej synchronizacji zamówień i stanów oraz przetestowanie poprawności działania integracji.

Dla kogo ma sens

Usługa jest przydatna dla firm korzystających z Comarch ERP XL, które prowadzą lub uruchamiają sprzedaż internetową.

Ile to trwa

Konfiguracja integracji mieści się z reguły w standardowym czasie do 3 dni.

Warunki

Diagnoza wstępna i wycena są bezpłatne, a usługa objęta jest gwarancją do 12 miesięcy.

Architektura techniczna połączenia sklepu z systemem Comarch ERP XL

Połączenie platformy e-commerce ze strukturami Comarch ERP XL wymaga wdrożenia bezpiecznego mostu wymiany danych pomiędzy serwerem bazodanowym a silnikiem sklepu internetowego. Comarch ERP XL bazuje na relacyjnej bazie danych Microsoft SQL Server (oprogramowanie zarządzające strukturami danych, tabelami i procedurami transakcyjnymi). Bezpośredni zapis do tabel bazodanowych ERP z pominięciem mechanizmów walidacji jest niedozwolony, ponieważ może doprowadzić do uszkodzenia integralności bazy i naruszenia logiki biznesowej systemu. Integracja jest realizowana przy użyciu dedykowanych interfejsów programistycznych oraz szyn wymiany danych.

Kluczowym elementem komunikacyjnym po stronie systemu ERP jest Comarch ERP XL WebAPI (oficjalny zestaw interfejsów programistycznych udostępniany przez producenta, służący do bezpiecznego odczytu i zapisu danych z zachowaniem wszystkich reguł walidacji). WebAPI weryfikuje uprawnienia dostępu oraz poprawność logiczną przesyłanych dokumentów handlowych, a następnie wykonuje transakcje w bazie danych w sposób całkowicie kontrolowany. Komunikacja pomiędzy platformą sklepową a WebAPI odbywa się za pośrednictwem szyfrowanego protokołu HTTPS przy użyciu formatu JSON (lekki format wymiany danych tekstowych) lub XML (rozszerzalny język znaczników służący do strukturyzacji przesyłanych informacji).

Na serwerze bazodanowym lub dedykowanej maszynie wirtualnej konfigurowana jest usługa synchronizująca (aplikacja działająca w tle jako usługa systemowa Windows), która zarządza harmonogramem zadań, kolejkowaniem operacji oraz buforowaniem danych. Dzięki temu chwilowa niedostępność łączności internetowej lub spowolnienie działania serwera sklepu nie powoduje utraty zamówień ani zablokowania pracy użytkowników stacjonarnych w systemie Comarch ERP XL.

Zakres synchronizacji danych w procesach handlowo-magazynowych

Prawidłowo wdrożona integracja automatyzuje kluczowe obszary wymiany informacji pomiędzy sklepem a systemem Comarch ERP XL, eliminując konieczność manualnego przepisywania danych przez pracowników:

Stany magazynowe i wielomagazynowość: Integrator pobiera stany ilościowe ze zdefiniowanych magazynów logicznych w Comarch ERP XL i przesyła je do sklepu internetowego. Uwzględniane są stany dyspozycyjne (ilość towaru fizycznie dostępnego w magazynie pomniejszona o aktywne rezerwacje pod dotychczasowe zamówienia). Konfiguracja umożliwia sumowanie stanów z wielu lokalizacji magazynowych lub przypisywanie wybranych magazynów do konkretnych kanałów sprzedaży.
Cenniki, rabaty i waluty: System ERP stanowi główne źródło informacji o polityce cenowej firmy. Integrator przesyła ceny podstawowe, ceny promocyjne oraz indywidualne cenniki przypisane do określonych grup kontrahentów (przydatne w modelach B2B – handel pomiędzy przedsiębiorstwami). Obsługiwane są także transakcje wielowalutowe oraz automatyczne mapowanie stawek podatku VAT zgodnie z przypisanymi grupami towarowymi.
Kartoteki towarowe i atrybuty produktów: Synchronizacja może obejmować nazwy artykułów, kody EAN (unikalne kody kreskowe towaru), kody katalogowe, jednostki miary, wagi, a także zaawansowane cechy i atrybuty (np. rozmiar, kolor, materiał) oraz powiązane załączniki i zdjęcia produktowe.
Import zamówień i tworzenie rezerwacji: Nowe zamówienie złożone przez klienta w sklepie jest automatycznie przesyłane do Comarch ERP XL, gdzie tworzony jest dokument zamówienia sprzedaży (ZS) lub rezerwacji odbiorcy (ZSO). System automatycznie weryfikuje dostępność towaru, blokuje stany magazynowe i przypisuje zdefiniowane formy płatności oraz metody dostawy.
Kartoteki kontrahentów: Podczas importu zamówienia system weryfikuje dane zamawiającego na podstawie numeru NIP (Numer Identyfikacji Podatkowej) lub adresu e-mail. Jeśli kontrahent istnieje w bazie, zamówienie jest dopisywane do jego historii; jeśli jest to nowy klient, zakładana jest nowa karta kontrahenta z zachowaniem wymaganych pól ewidencyjnych.
Statusy zamówień i dokumenty handlowe: Po zrealizowaniu zamówienia w systemie ERP (np. wystawieniu faktury sprzedaży FS lub dokumentu wydania zewnętrznego WZ – dokument magazynowy potwierdzający wydanie towaru z magazynu), integrator przesyła informację o zmianie statusu do sklepu internetowego. Przesyłany może być także numer listu przewozowego oraz wygenerowany plik PDF z dokumentem sprzedaży.

Obsługiwane platformy e-commerce i systemy marketplace

Konfiguracja integracji obejmuje popularne silniki sklepów internetowych oraz integratory wielokanałowe. Połączenie może zostać zestawione bezpośrednio z platformą sklepową lub poprzez zewnętrzną szynę integracyjną:

WooCommerce (WordPress): Oprogramowanie e-commerce oparte na systemie WordPress, łączone za pomocą dedykowanych modułów komunikujących się przez REST API (interfejs programistyczny oparty na standardowych metodach protokołu HTTP).
PrestaShop: Samodzielny silnik sklepowy, integrowany za pomocą modułów webservice, zapewniający pełną synchronizację wariantów, cech produktów oraz wielomagazynowości.
Magento / Adobe Commerce: Zaawansowana platforma dla dużych sklepów i portali B2B, wykorzystująca asynchroniczne kolejki zapytań w celu zachowania wysokiej wydajności przy dziesiątkach tysięcy indeksów towarowych.
Shopify i Shoper: Platformy działające w modelu SaaS (oprogramowanie jako usługa w chmurze), integrowane poprzez bezpieczne klucze API i mechanizmy webhook (automatyczne powiadomienia o zdarzeniach w sklepie wysyłane w czasie rzeczywistym).
BaseLinker: Narzędzie integrujące Comarch ERP XL z setkami platform marketplace (m.in. Allegro, Amazon, eBay, Erli) oraz firmami kurierskimi. Integracja z BaseLinkerem pozwala centralnie zarządzać sprzedażą ze wszystkich kanałów bezpośrednio w systemie ERP.

Warianty integracji i modele transferu danych

W zależności od skali sprzedaży, liczby asortymentu oraz infrastruktury serwerowej dobierany jest optymalny model wymiany danych pomiędzy systemami:

W wariancie synchronizacji cyklicznej aplikacja integracyjna uruchamia zadania w określonych interwałach czasowych, korzystając z Harmonogramu zadań Windows (systemowe narzędzie do cyklicznego wywoływania procesów). Stany magazynowe mogą być odświeżane co kilka minut, natomiast import zamówień może odbywać się niemal w trybie ciągłym. Pełna synchronizacja kartotek towarowych, obejmująca opisy i zdjęcia, jest zazwyczaj planowana na godziny nocne, aby nie obciążać łącza internetowego ani serwera bazodanowego w godzinach szczytu handlowego.

W wariancie zdarzeniowym (ang. event-driven) wykorzystywane są mechanizmy webhook oraz triggery bazodanowe (specjalne procedury w bazie MS SQL uruchamiane automatycznie w momencie modyfikacji rekordu). Zmiana stanu magazynowego lub zmiana ceny w Comarch ERP XL generuje natychmiastowy pakiet danych przesyłany do sklepu, co minimalizuje ryzyko sprzedaży towaru, który został już wyprzedany w innym kanale.

Typowe błędy i zagrożenia przy samodzielnych próbach integracji

Wdrażanie integracji bez odpowiedniego przygotowania środowiska i znajomości struktury Comarch ERP XL często prowadzi do problemów operacyjnych i przestojów w sprzedaży:

Blokowanie bazy danych MS SQL: Nieoptymalnie skonstruowane zapytania SQL, które odpytują bazę ERP o całą ofertę produktową bez filtrowania po dacie modyfikacji, mogą powodować zjawisko deadlock (wzajemne blokowanie się procesów bazodanowych). Skutkuje to zawieszaniem się sesji użytkowników pracujących stacjonarnie w programie Comarch ERP XL.
Powstawanie zdublowanych kartotek: Błędne mechanizmy rozpoznawania kontrahentów prowadzą do powstawania tysięcy zduplikowanych kart klientów o tych samych danych, co zaburza historię sprzedaży i utrudnia prowadzenie rozrachunków księgowych.
Sprzedaż poniżej stanów magazynowych (overselling): Nieuwzględnienie rezerwacji towarowych lub zbyt rzadkie odświeżanie stanów dyspozycyjnych sprawia, że klienci w sklepie kupują produkty, które fizycznie zostały już zarezerwowane pod zamówienia hurtowe w Comarch ERP XL.
Rozbieżności zaokrągleń podatkowych: Różnice w algorytmach wyliczania podatku VAT (wyliczanie od sumy pozycji netto versus od sumy cen brutto) pomiędzy silnikiem sklepu a Comarch ERP XL mogą powodować rozbieżności kwotowe rzędu kilku groszy na zamówieniu, co uniemożliwia automatyczne wystawienie faktury lub paragonu.
Brak obsługi błędów sieciowych: Niewłaściwie zaprojektowane skrypty przy zerwaniu połączenia internetowego mogą powtórnie zaimportować to samo zamówienie, tworząc podwójne rezerwacje i generując ryzyko wysłania do klienta dwóch identycznych paczek.

Kiedy standardowy moduł integracyjny wymaga rozszerzenia

W wielu przedsiębiorstwach procesy handlowe wykraczają poza standardowy schemat prostego sklepu internetowego. W takich przypadkach konieczne jest wdrożenie dedykowanych reguł biznesowych:

Specyficzne cenniki kontraktowe i wielopoziomowe rabaty w segmencie B2B wymagają pobierania indywidualnych warunków handlowych przypisanych do danego kontrahenta w Comarch ERP XL po jego zalogowaniu w sklepie. Standardowe moduły rzadko radzą sobie z dynamicznym kalkulowaniem cen na podstawie skomplikowanych macierzy rabatowych ERP.

Obsługa partii towarowych, cech dostaw oraz numerów seryjnych (np. w branży elektronicznej lub farmaceutycznej) wymaga, aby integracja przekazywała do sklepu informacje o dostępności konkretnych partii lub rezerwowała towary z zachowaniem metody FIFO (zasada pierwsze przyszło, pierwsze wyszło – wydawanie towaru z najstarszych dostaw).

Konieczność automatycznego generowania dokumentów powiązanych, takich jak zlecenia kompletacji, zlecenia produkcyjne czy dokumenty kaucyjne na opakowania zwrotne, wymaga wdrożenia zaawansowanych procedur bazodanowych integrujących moduł handlowo-magazynowy z modułem logistyki i produkcji Comarch ERP XL.

Często zadawane pytania o integrację sklepu z Comarch ERP XL

Czy wdrożenie integracji wymaga zatrzymania pracy w systemie ERP?

Nie ma konieczności przerywania bieżącej pracy firmy. Prace konfiguracyjne, tworzenie procedur oraz mapowanie danych są realizowane w tle lub na kopii roboczej bazy danych. Jedynie moment ostatecznego przełączenia produkcyjnego i testów weryfikacyjnych jest planowany w dogodnym oknie czasowym, aby nie zakłócać pracy działu handlowego i magazynu.

W jaki sposób chroniona jest baza Comarch ERP XL przed niepowołanym dostępem z zewnątrz?

Komunikacja nie wymaga bezpośredniego wystawiania portów bazy MS SQL na publiczny adres IP. Dostęp realizowany jest za pośrednictwem szyfrowanych połączeń VPN (wirtualna sieć prywatna tworząca bezpieczny tunel komunikacyjny), bezpiecznych bramek API z autoryzacją za pomocą tokenów lub dedykowanych usług pośredniczących zainstalowanych po stronie serwera lokalnego.

Co dzieje się z zamówieniami w przypadku awarii internetu w siedzibie firmy?

Zamówienia składane przez klientów w sklepie internetowym są bezpiecznie przechowywane w bazie danych platformy e-commerce lub w chmurze integratora. W momencie przywrócenia łączności internetowej usługa synchronizująca automatycznie pobiera zaległe zamówienia według kolejności ich złożenia i generuje odpowiednie dokumenty w Comarch ERP XL.

Jak rozwiązywana jest kwestia jednostek miar i przeliczników opakowań?

W konfiguracji integratora definiuje się tabele mapowania jednostek miar. Jeżeli w Comarch ERP XL towar prowadzony jest w sztukach, a w sklepie sprzedawany w opakowaniach zbiorczych (lub odwrotnie), system automatycznie przelicza ilości oraz ceny jednostkowe zgodnie ze zdefiniowanym przelicznikiem magazynowym.

Czy istnieje możliwość synchronizacji wielu sklepów internetowych z jedną bazą Comarch ERP XL?

Tak, architektura Comarch ERP XL umożliwia obsługę wielu niezależnych kanałów sprzedaży w ramach jednej bazy danych. Każdy sklep może mieć przypisany osobny magazyn logiczny, dedykowany cennik, osobną serię dokumentów handlowych oraz zindywidualizowane schematy numeracji zamówień.

Procedura wdrożenia integracji i opieka techniczna

Proces integracji rozpoczyna się od szczegółowej analizy struktury danych w Comarch ERP XL oraz konfiguracji platformy e-commerce. Weryfikowane są wersje silnika bazy danych, zainstalowane moduły Comarch oraz parametry serwera. Na tej podstawie przygotowywane jest precyzyjne mapowanie pól bazodanowych, obejmujące kartoteki towarowe, grupy kontrahentów, stawki podatkowe, metody płatności oraz sposoby dostawy.

Przed uruchomieniem produkcyjnym wykonywane są testy spójności na środowisku testowym. Weryfikowana jest poprawność zakładania rezerwacji, zachowanie systemu przy nietypowych znakach w danych adresowych oraz odporność na chwilowe przerwy w łączności. Po uruchomieniu synchronizacji na środowisku produkcyjnym zapewnione jest wsparcie techniczne do 30 dni, obejmujące bieżący monitoring poprawności transferu danych i ewentualne korekty parametrów konfiguracyjnych.

Bezpieczna i spójna automatyzacja sprzedaży internetowej

Prawidłowo skonfigurowane połączenie sklepu internetowego z systemem Comarch ERP XL stanowi fundament skalowalnego biznesu e-commerce. Automatyzacja wymiany danych eliminuje błędy ludzkie przy przepisywaniu zamówień, zabezpiecza przedsiębiorstwo przed sprzedażą brakującego towaru oraz pozwala na natychmiastowe aktualizowanie cen w odpowiedzi na zmiany rynkowe. Zastosowanie stabilnych mechanizmów transakcyjnych i oficjalnych interfejsów programistycznych gwarantuje pełne bezpieczeństwo danych i ciągłość operacyjną przedsiębiorstwa.

22 378 48 09