Błędna reguła synchronizacji może pokazać klientowi nieaktualny stan, nadpisać cenę albo utworzyć zamówienie bez właściwego dokumentu. Dlatego przed połączeniem PrestaShop z Comarch ERP Optima rozpisujemy przepływy danych, wyjątki i odpowiedzialność za ich obsługę.
Krótka odpowiedź
Comarch ERP Optima można połączyć z PrestaShop przez gotowy moduł, zewnętrzny łącznik albo integrację dedykowaną. Niezawodność wymaga ustalenia źródła danych dla każdego obiektu, zgodnych identyfikatorów produktów i wariantów oraz bezpiecznej obsługi ponowień.
Zakres trzeba potwierdzić dla konkretnych wersji systemów, magazynów i dokumentów.
Usługi KC Mobile
Potrzebujesz pomocy w tym temacie?
Czytasz poradnik „Jak zaplanować niezawodną integrację Comarch ERP Optima z PrestaShop”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny.
Jakie dane powinny przepływać między PrestaShop a Optimą?
Dla każdego obiektu ustal kierunek synchronizacji, system źródłowy i zdarzenie uruchamiające aktualizację. System źródłowy to miejsce, w którym zespół edytuje wartość i które rozstrzyga rozbieżności.
Tabela pokazuje typowy podział przepływów, który przed wdrożeniem trzeba dopasować do procesu firmy.
| Obiekt | Kierunek danych | Źródło prawdy | Zdarzenie aktualizacji |
|---|---|---|---|
| Produkty | Optima do PrestaShop | ERP | Utworzenie lub zmiana kartoteki |
| Ceny | Optima do PrestaShop | ERP | Zmiana cennika |
| Stany | Optima do PrestaShop | Magazyn ERP | Przyjęcie, wydanie lub rezerwacja |
| Zamówienia | PrestaShop do Optimy | Sklep | Złożenie zamówienia |
| Klienci | PrestaShop do Optimy | Do uzgodnienia | Nowe zamówienie lub zmiana danych |
| Faktury | Optima do PrestaShop | ERP | Wystawienie dokumentu |
| Płatności | PrestaShop do Optimy lub status zwrotny | Operator lub ERP | Potwierdzenie, zwrot lub obciążenie zwrotne |
Tabela jest punktem wyjścia do specyfikacji, ponieważ konkretny kierunek zależy od procesu sklepu. Dokumentacja PrestaShop 8 Webservice opisuje zasoby produktów, zamówień i stanów, ale nie definiuje reguł biznesowych Comarch ERP Optima. Porównanie WooCommerce i Shopify może pomóc firmie ocenić wybór platformy. Oferta sklepów internetowych KC Mobile dotyczy realizacji sklepów na WooCommerce, dlatego przy projekcie PrestaShop trzeba osobno uzgodnić zakres platformy i integracji.
Czytasz poradnik „Jak zaplanować niezawodną integrację Comarch ERP Optima z PrestaShop”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny. Omów temat tego poradnika
Co sprawdzić w sklepie i ERP przed integracją?
Przed uruchomieniem połączenia sprawdź wersje systemów, identyfikatory produktów oraz reguły handlowe i magazynowe. Identyfikator techniczny produktu i SKU to różne wartości, a ich pomylenie może utworzyć duplikat lub skierować zamówienie do niewłaściwej kartoteki.
Lista kontrolna przed analizą integracji:
- Wersja PrestaShop, wersja Comarch ERP Optima, moduły i dostęp do środowiska testowego.
- SKU i kody EAN, unikalność identyfikatorów oraz zasady ich zmiany.
- Warianty produktów i sposób przypisania kombinacji do kartoteki ERP.
- Liczba magazynów, magazyn wysyłkowy, rezerwacje i stany minimalne.
- Cenniki, waluty, rabaty, stawki VAT i zasady zaokrągleń.
- Numeracja dokumentów, statusy zamówień, anulowania i zwroty.
- Zakres dostępu do API i sposób przechowywania kluczy.
W PrestaShop 9 dostęp do Webservice włącza się w panelu administracyjnym w "Advanced Parameters > Web service", a klucz API może otrzymać uprawnienia do wybranych zasobów i operacji. Dokumentacja zaleca nadawanie tylko wymaganych praw. Przy integracji ze sklepem na PrestaShop 8 trzeba sprawdzać instrukcję dla wersji 8, w tym strukturę zasobu `stock_availables`. Dokumentację sprawdziliśmy w październiku 2026.
Jak wybrać sposób połączenia systemów?
Gotowy moduł wybierz, gdy jego udokumentowany zakres pokrywa proces sklepu i nie pomija krytycznych wyjątków. Zewnętrzny łącznik może pasować do wielu kanałów, a integrację dedykowaną warto rozważyć, gdy reguły firmy wykraczają poza dostępne konfiguracje.
Tabela porównuje kryteria wyboru, a nie konkretne produkty ani ceny.
| Sposób połączenia | Zakres do sprawdzenia | Obsługa wyjątków | Utrzymanie |
|---|---|---|---|
| Gotowy moduł | Wersje systemów i obiekty | Funkcje modułu | Aktualizacje modułu i systemów |
| Zewnętrzny łącznik | Kanały i mapowania | Konfiguracja dostawcy | Umowa i monitoring dostawcy |
| Integracja dedykowana | Dopasowanie do procesu firmy | Reguły projektowane dla procesu | Podział odpowiedzialności stron |
Tabela pokazuje, jakie pytania zadać dostawcy przed wyborem rozwiązania. Poproś o demonstrację anulowania zamówienia, błędnego SKU, niedostępności API i ponownego przetworzenia zdarzenia. Poradnik konfiguracji PrestaShop 8.x opisuje ustawienia sklepu, które mogą wpływać na integrację.
Jak zaprojektować synchronizację produktów i stanów?
Synchronizacja powinna rozróżniać produkt, jego wariant i ilość dostępną w konkretnym sklepie. Dokumentacja PrestaShop 8 opisuje zasób `stock_availables` z polami `id_product`, `id_product_attribute`, `id_shop` i `quantity`; API pozwala odczytywać i aktualizować dostępne ilości.
Konflikt może powstać, gdy ERP wysyła stan 8 sztuk, klient składa zamówienie na 2 sztuki, a opóźniony proces zapisuje starszą wartość. Reguła musi określić, czy ERP przekazuje stan po rezerwacjach, czy sklep odejmuje zamówienie od zapasu oraz jak systemy uzgadniają kolejną aktualizację.
Tabela przedstawia przypadki, w których integracja potrzebuje osobnych reguł.
| Przypadek | Reguła do ustalenia | Kontrola po synchronizacji |
|---|---|---|
| Produkt prosty | SKU i magazyn źródłowy | Stan zgodny z magazynem |
| Wariant | Identyfikator kombinacji | Ilość przypisana do wariantu |
| Kilka magazynów | Magazyn sprzedażowy lub suma | Brak zapasu niedostępnego dla sklepu |
| Rezerwacja | Moment zmiany stanu dostępnego | Brak sprzedaży ponad ustalony zapas |
| Równoczesna zmiana | Priorytet źródła i kolejność zdarzeń | Konflikt zapisany w logu |
Tabela ułatwia zatwierdzenie reguł przed testami. W PrestaShop 8 trzeba również sprawdzić, czy rekord dotyczy właściwej kombinacji i sklepu oraz jak konfiguracja multistore wpływa na współdzielenie ilości.
Jak obsłużyć zamówienia, płatności i dokumenty?
Integracja powinna przekazywać zamówienie po uzgodnionym zdarzeniu, a statusy sklepu i ERP muszą mieć jawne mapowanie. Status "oczekuje na płatność" nie musi oznaczać gotowości do rezerwacji zapasu lub realizacji.
Ustal osobną kolejność działań dla płatności online, pobrania, anulowania, korekty i zwrotu. Sklep może przyjąć zamówienie, operator potwierdzić transakcję, a ERP utworzyć dokument. Firma określa, kiedy rezerwuje zapas, wystawia fakturę i rozdziela zwrot pieniędzy od przyjęcia towaru.
Tabela wskazuje punkty procesu, które powinny mieć przypisane działanie i wynik zwrotny.
| Zdarzenie | Działanie w Optimie | Wynik zwrotny |
|---|---|---|
| Nowe zamówienie | Utworzenie dokumentu lub kolejki | Numer dokumentu albo błąd |
| Potwierdzona płatność | Zmiana statusu i dalsza realizacja | Status przyjęcia |
| Anulowanie | Zwolnienie rezerwacji | Potwierdzenie anulowania |
| Wysłanie towaru | Aktualizacja realizacji i dokumentu | Numer przesyłki lub status |
| Zwrot | Korekta i przyjęcie towaru zgodnie z procesem | Status rozliczenia |
Tabela opisuje decyzje wdrożeniowe, a nie funkcje gwarantowane przez każdy moduł. Właściciel procesu księgowego powinien zatwierdzić zdarzenia tworzące dokumenty ERP oraz obsługę korekt.
Jak zapewnić niezawodność i wykrywać błędy?
Niezawodność zapewniają trwała kolejka, ograniczone ponowienia, idempotencja, logi i alerty. Idempotencja oznacza, że ponowne przetworzenie tego samego zdarzenia nie tworzy drugiego zamówienia ani dokumentu.
Diagnozę zacznij od identyfikatora zamówienia, czasu zdarzenia i odpowiedzi systemu docelowego. Następnie sprawdź połączenie API, uprawnienia, odpowiedź HTTP, walidację danych, mapowanie SKU i stan kolejki. Przed ponowieniem sprawdź, czy ERP nie wykonał już operacji.
Tabela rozdziela mechanizmy, które ograniczają utratę zdarzeń i ułatwiają diagnozę.
| Mechanizm | Co kontroluje | Oczekiwany skutek |
|---|---|---|
| Kolejka | Zdarzenia oczekujące na przetworzenie | Utrata połączenia nie gubi zamówienia |
| Ponowienie | Błędy przejściowe | Próba po przerwie z limitem i logiem |
| Idempotencja | Powtórzone zdarzenia | Jedno zamówienie dla jednego klucza |
| Log | Dane wejściowe, wynik i przyczynę błędu | Diagnoza konkretnego obiektu |
| Alert | Zdarzenia wymagające interwencji | Informacja trafia do właściciela procesu |
Tabela wiąże mechanizmy z konkretnym celem. Ponowienia powinny mieć limit, a po jego osiągnięciu system powinien przekazać sprawę do obsługi ręcznej.
Jak przetestować integrację przed uruchomieniem?
Testy powinny obejmować nowe i zmienione dane, zamówienie, zwrot, awarię połączenia oraz ponowienie tego samego zdarzenia. Kryteria akceptacji zapisz przed rozpoczęciem testów, aby zespół znał oczekiwany stan w obu systemach.
Tabela podaje minimalne scenariusze testowe i warunki odbioru.
| Scenariusz | Warunek akceptacji |
|---|---|
| Nowy produkt i wariant | Towar trafia do właściwej kartoteki i kombinacji |
| Zmiana ceny i stanu | Sklep pokazuje wartości zgodne ze źródłem |
| Nowe zamówienie | ERP tworzy jeden dokument z poprawnymi pozycjami |
| Anulowanie i zwrot | Statusy, rezerwacja i korekta są zgodne z procesem |
| Chwilowa niedostępność | Zdarzenie pozostaje w kolejce i jest ponawiane |
| Ponowne przetworzenie | Nie powstaje duplikat zamówienia |
Tabela określa minimalne kryteria, które trzeba rozszerzyć o płatność pobraniową, obce waluty lub wiele magazynów, jeśli sklep używa tych procesów. Protokół testu powinien zawierać identyfikator zdarzenia, wynik w obu systemach i decyzję o akceptacji.
Ile kosztuje integracja i co wpływa na zakres prac?
Zakres prac zależy od liczby sklepów i magazynów, jakości kartotek, dokumentów oraz wyjątków w statusach i płatnościach. Bez tych informacji nie można rzetelnie rozstrzygnąć, czy wystarczy gotowy moduł, czy potrzebne będą dodatkowe prace.
Do wyceny przygotuj wersje systemów, liczbę produktów i wariantów, listę magazynów, przykładowe zamówienia oraz mapę statusów. Opisz dokumenty, zwroty, kanały sprzedaży i oczekiwany monitoring. Oferta opieki nad sklepem internetowym dotyczy utrzymania sklepu, a nie zastępuje analizy zakresu integracji ERP.
Perspektywa KC Mobile: z naszych wdrożeń wynika, że część problemów po starcie pojawia się przy nieuzgodnionych wyjątkach danych i statusów. Zalecamy wyznaczyć osobę odpowiedzialną za alerty oraz opisać ręczną obsługę dokumentu, którego nie można bezpiecznie ponowić.
Jeśli planujesz nowy sklep, oferta wykonania sklepu internetowego KC Mobile opisuje realizacje oparte na WooCommerce. Przy istniejącym sklepie PrestaShop zakres integracji trzeba dopasować do platformy, wersji systemów i procesów firmy.
Czy te same założenia sprawdzą się przy Shopify?
Reguły właściciela danych i testowania pozostają przydatne przy Shopify, ale metody integracji i model danych trzeba sprawdzić osobno. PrestaShop Webservice API ma zasoby produktów, zamówień i stanów, natomiast integrację Shopify należy ocenić według API, uprawnień i wersji używanych przez wybrane rozwiązanie.
Porównaj warianty produktów, identyfikatory, magazyny, statusy zamówień i zdarzenia płatnicze. Porównanie WooCommerce i PrestaShop opisuje różnice platform, a poradnik o wyborze PrestaShop pomaga ocenić model sklepu. Założenia integracji Shopify trzeba potwierdzić dla konkretnego sklepu.

Więcej poradników w tym temacie
- PrestaShop API: jak skonfigurować dostęp i bezpiecznie zintegrować sklep
- CRM connector do PrestaShop: jak wybrać moduł i połączyć dane
- Magento API w praktyce: endpointy, integracje i bezpieczeństwo
- WooCommerce API: jak połączyć sklep z innymi systemami
- Konfiguracja wydruku paragonów: drukarka, system i testy
Wspomniane narzędzia
Najczęściej zadawane pytania
Czy Comarch ERP Optima można zintegrować z PrestaShop?
Jak synchronizować stany magazynowe między Optimą a PrestaShop?
Czy integracja obsłuży warianty produktów i kilka magazynów?
Jak przesyłać zamówienia do Optimy i informacje o fakturach do PrestaShop?
Co zrobić, gdy integracja działa z opóźnieniem albo nie przesyła zamówień?
Czy integracja Comarch Optima z Shopify działa na tych samych zasadach?
Potrzebujesz pomocy w tym temacie?
Czytasz poradnik „Jak zaplanować niezawodną integrację Comarch ERP Optima z PrestaShop”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny.
