Przy integracji należy określić ERP lub WooCommerce jako źródło każdego pola, używać stabilnych SKU i zewnętrznych ID, a synchronizację projektować w sposób idempotentny. Zamówienia warto wysyłać przez kolejkę, stany magazynowe regularnie uzgadniać, a błędy pokazywać obsłudze. Przed startem produkcyjnym trzeba przeprowadzić test równoległy na rzeczywistych scenariuszach.
Połączenie WooCommerce z ERP eliminuje ręczne przepisywanie katalogu i zamówień tylko wtedy, gdy ma precyzyjne reguły. Oba systemy często przechowują podobne pola, ale używają ich inaczej. ERP może prowadzić stany osobno dla każdego magazynu i ceny netto, podczas gdy sklep wyświetla dostępność sprzedażową, promocje i warianty. Bez mapowania znaczenia powstają rozbieżności, które przy większym wolumenie trudno wyśledzić.
Dlatego integrację projektuje się wspólnie z osobami odpowiedzialnymi za sklep internetowy, magazyn, finanse i IT. Najpierw ustala się źródło prawdy i cykl życia zamówienia, a dopiero potem techniczny sposób wymiany danych. Niejasnej reguły nie da się naprawić szybszym API. Kolejne rozdziały obejmują produkty, magazyn, zamówienia, odporność na awarie oraz wdrożenie bez zagrożenia dla bieżącej działalności.
Określ źródło prawdy dla katalogu
W tabeli mapowania uwzględnij nazwę, opis, SKU, EAN, wariant, cenę, kategorię podatkową, stan magazynowy, wagę, zdjęcia i status publikacji. Przy każdym polu oznacz kierunek i odpowiedzialnego właściciela. Opis marketingowy może powstawać w WooCommerce, a cena w ERP. Synchronizacja nie może wtedy nadpisywać całego produktu jednym obiektem. Stabilne SKU lub wewnętrzne ID pozwala odróżnić rekord także po zmianie nazwy.
Model wariantów musi mieć jednoznaczne odwzorowanie. Pozycja w ERP może reprezentować każdy wariant osobno, podczas gdy WooCommerce grupuje je pod produktem nadrzędnym. Należy zdefiniować tworzenie, dezaktywację i ponowną aktywację. Brakująca pozycja nie musi oznaczać usunięcia; może chodzić o niekompletną partię danych. Obrazy warto przenosić przyrostowo i kontrolować ich rozmiar, format oraz prawa do wykorzystania. Import musi umieć bezpiecznie kontynuować działanie po przerwaniu.
Zaprojektuj magazyn i dostępność z myślą o równoczesnych operacjach
Należy odróżnić stan fizyczny, rezerwację, dostępność sprzedażową i oczekiwaną dostawę. WooCommerce potrzebuje wartości, na podstawie której dopuści zakup, ale ERP może mieć wiele magazynów i opóźnione ruchy. Proszę określić, kiedy sztuka jest rezerwowana, kiedy zwalniana po nieudanej płatności i jak przetwarzane jest ręczne zamówienie złożone poza stroną. Bez takiego modelu synchronizacja może poprawnie przenosić błędną wartość biznesową.
Przy większej współbieżności nie można w pełni polegać na sporadycznym eksporcie. Zastosuj zdarzenia lub częstszy przepływ przyrostowy oraz okresowe pełne uzgadnianie. Zmiany nie mogą oscylować między systemami. Monitoruj wiek informacji o stanie magazynowym, a na wypadek niedostępności ERP ustal świadome zachowanie: ostatnia znana wartość, rezerwa bezpieczeństwa lub tymczasowe ograniczenie sprzedaży w zależności od ryzyka asortymentu.
- Magazyn fizyczny, zarezerwowany i sprzedażowy
- Zasady zwolnienia po anulowaniu płatności
- Zmiany przyrostowe i uzgadnianie kontrolne
- Zdefiniowane zachowanie przy niedostępnym ERP
Przesyłaj zamówienie tylko raz i w całości
Należy określić status wyzwalający: utworzenie, potwierdzona płatność lub ręczne zatwierdzenie. Zamówienie zawiera pozycje, ilości, ceny jednostkowe, rabaty, dostawę, podatki, waluty, adresy i identyfikatory płatności; suma musi być zgodna po obu stronach. ERP nie powinien ponownie obliczać ceny według aktualnego cennika, jeśli ma ewidencjonować historyczną transakcję. Każdy transfer otrzymuje stabilny klucz, który zapobiega powstawaniu duplikatów.
Po powodzeniu należy zapisać numer z ERP i czas, a po błędzie — status i zrozumiałą przyczynę. Błąd tymczasowy obsługuje kolejka, a trwałą nieprawidłowość danych — człowiek. Korekta adresu lub pozycji po eksporcie wymaga osobnego procesu, a nie cichego nadpisania. Statusy z ERP warto mapować tylko wtedy, gdy mają znaczenie dla klienta lub operacji. Fakturę, numer śledzenia przesyłki i storno należy przesyłać jako osobne zdarzenia z własną idempotencją.
Wprowadź obserwowalność i bezpieczeństwo
Dashboard powinien pokazywać ostatnią udaną synchronizację, liczbę oczekujących i błędnych rekordów, wiek najstarszej wiadomości oraz rozbieżności przy uzgadnianiu. Identyfikator korelacji łączy zamówienie z logiem po obu stronach. Alert wymaga konkretnego właściciela i wskazówki, co należy sprawdzić. Samo „HTTP 500” nie pomoże pracownikowi magazynu; panel administracyjny powinien w bezpieczny sposób przełożyć błąd na brakujące SKU, nieznaną metodę dostawy lub niedostępny system.
Konta API mają minimalne uprawnienia i oddzielne klucze dla stagingu i produkcji. Sekrety nie mogą trafiać do repozytorium, e-maili ani zrzutów ekranu. Należy przesyłać tylko niezbędne dane klientów i redagować logi. Przy publicznym webhooku trzeba weryfikować podpis, czas i ochronę przed powtórzeniem. Proszę uzgodnić między dostawcami obu systemów odpowiedzialność za dostępność, zmiany schematu, retencję danych i obsługę incydentów.
- Identyfikator korelacji we wszystkich systemach
- Widoczna kolejka i zrozumiałe błędy
- Minimalne uprawnienia i bezpieczne sekrety
- Właściciel incydentu i zmiany kontraktu
Wdrażaj na próbce i z równoległą kontrolą
Najpierw należy przetestować reprezentatywne produkty: prosty, z wariantami, przeceniony, wyprzedany, nietypowo ciężki oraz z brakującymi danymi. Następnie trzeba przejść przez zamówienia z różnymi płatnościami, dostawą, kuponem, zwrotem i anulowaniem. Należy zweryfikować zduplikowane zdarzenie, awarię i przywrócenie działania. Testowy ERP nie może wysyłać rzeczywistych dokumentów ani ruchów magazynowych bez wyraźnego rozdzielenia. Wyniki należy porównywać pole po polu, a nie tylko według liczby rekordów.
Podczas migracji najpierw uruchom ograniczoną grupę lub równoległą kontrolę względem istniejącego procesu. Zdefiniuj granicę akceptowalnych różnic oraz warunki powrotu. Po starcie produkcyjnym tymczasowo sprawdzaj każdy błąd i regularnie uzgadniaj sumy. Dopiero po stabilizacji wyłącz stary ręczny przepływ. Dokumentacja powinna obejmować mapowanie, wyzwalacze, kolejki, kontakty oraz procedurę bezpiecznego ponawiania.
Najczęstsze pytania
Jak często synchronizować magazyn z ERP?
Zależy to od tempa sprzedaży, ryzyka wyprzedania i możliwości API. Przepływ oparty na zdarzeniach może szybko przenieść zmianę, a regularne uzgadnianie wychwyci przerwy. Częstotliwość należy ustalić według akceptowalnego wieku informacji o stanie magazynowym, a nie uniwersalnego interwału.
Co jeśli produkt nie ma tego samego ID w obu systemach?
Proszę utworzyć mapowanie i zapisywać zewnętrzne stabilne ID przy produkcie lub wariancie. Nazwa nie jest wiarygodnym kluczem. W przypadku brakującego lub zduplikowanego identyfikatora proszę wstrzymać import danego rekordu i zażądać poprawki.
Czy integracja z ERP może działać bez monitoringu?
Technicznie może to przez jakiś czas działać, ale cichy błąd zostanie wykryty późno. Monitoring kolejki, ostatniego udanego przebiegu i rozbieżności danych jest częścią niezawodnej eksploatacji, zwłaszcza gdy integracja wpływa na zamówienia, stany magazynowe lub dokumenty.
Źródła i dalsza lektura
- Dokumentacja WooCommerce
- Dokumentacja dla deweloperów WooCommerce
- Wytyczne Google dotyczące SEO dla e-commerce
Adam Antoni vyvíja weby, aplikácie a softvér na mieru. Prepája firemné systémy, automatizuje procesy a vytvára AI agentov. Pôsobí v Spišskej Novej Vsi a spolupracuje s firmami na celom Slovensku.
