Integracja Magento z ERP przy dużym katalogu i cenach B2B
Przy dziesiątkach tysięcy SKU i cennikach B2B każda zmiana w ERP spowalnia sklep, a zamówienia trafiają do ERP podwójnie? Łączymy Magento z ERP tak, żeby kartoteka, stany i cenniki szły do sklepu jako same zmiany, w paczkach, a zamówienia wracały do ERP bez duplikatów.
Duży katalog B2Bok. 115 tys. produktów i wariantów, własne cenniki partnerów, wymiana danych przez BaseLinkerSportina B2B · Magento 2.4.8 + BaseLinker- Wyślij wszystko 20 000 SKU × 30 atrybutów każdy atrybut to osobny rekord (model EAV): ok. 600 000 zapisów i reindeks całego katalogu godziny
- Policz różnicę 800 SKU ze zmienioną ceną zapis tylko atrybutu price tych produktów; reszta katalogu nietknięta niski koszt
- Paczki w kolejce Zapis partiami, poza szczytem paczka z błędem wraca do kolejki i nie zatrzymuje przelotu w kolejce
- Reindeks Częściowy, tylko zmienione produkty indeksator w trybie schedule zamiast pełnego reindeksu po zapisie
Cena końcowa czy baza plus rabat — to trzeba ustalić raz
Od tej decyzji zależy, co partner zobaczy po zalogowaniu i czy koszyk policzy to samo, co faktura z ERP. Obie drogi są poprawne, ale nie można ich mieszać.
Ten sam produkt dla dwóch partnerów w obu modelach: P-1 · kurtka
| Model cen | Partner A dystrybutor · rabat kontraktowy −20% na kategorię główną | Partner B sklep partnerski · rabat grupy −10% na kategorię główną |
|---|---|---|
| ERP liczy cenę końcową cena końcowa z ERP | ERP przysyła 80,00 zł netto | ERP przysyła 90,00 zł netto |
| Magento liczy rabat od bazy baza plus rabat | 100,00 zł netto − 20% = 80,00 zł netto | 100,00 zł netto − 10% = 90,00 zł netto |
- sklep tylko wyświetla,
- łatwa zgodność z fakturą,
- trudniejsze promocje.
- sklep liczy,
- elastyczne promocje,
- wymaga identycznej kolejności reguł po obu stronach.
W obu modelach: grupy klientów i ślad zmian cennika
Grupy jeden do jednego
Grupy klientów w Magento muszą odpowiadać grupom cenowym w ERP — jeden do jednego.
Blokada zamiast ceny detalicznej
Kontrahent bez przypisanej grupy powinien dostać blokadę, a nie cenę detaliczną — tę regułę dokładamy, bo domyślnie Magento pokaże cenę grupy domyślnej. Ten sam objaw daje cennik, który nie dojechał z ERP.
Ślad w logu
Zmiana cennika w ERP ma ślad w logu: kiedy weszła i ilu partnerów objęła.
Od czego zależy koszt integracji
W Magento większość atrybutów produktu nie jest kolumną w tabeli, tylko osobnym rekordem, więc aktualizacja trzydziestu pól dla dużego katalogu to setki tysięcy operacji. Ta tabela decyduje o harmonogramie integracji: operacje z wysokim kosztem planujemy w oknie nocnym albo dzielimy na etapy. Zasada: zamiast „wyślij wszystko co noc” — policz różnicę, wyślij paczkami w kolejce i zaindeksuj to, co trzeba (częściowy reindeks, indeksator w trybie schedule).
Koszt typowych operacji przy dużym katalogu
- Aktualizacja stanu (source items): na bieżąco, tylko różnice
- Aktualizacja ceny bazowej (atrybut price): na bieżąco, tylko różnice
- Eksport zamówienia (order API): na zdarzenie, z idempotencją
- Ceny dla grup klientów (tier price): paczki, poza szczytem. W naszej platformie B2B ceny klientów działają inaczej: cena bazowa przychodzi z BaseLinkera, a rabat klienta liczy Magento.
- Masowa zmiana atrybutów (EAV, wiele tabel): kolejka, okno nocne, etapami
- Zmiana struktury kategorii (reindeks katalogu): staging, potem wdrożenie planowane
Co wymieniamy i w którą stronę
Pozostałe dane obok cenników: kierunek i tryb wymiany dla każdego typu.
Tabela wydajności: mechanizm i sposób prowadzenia każdej operacji
stan, cena bazowa, ceny dla grup klientów, masowa zmiana atrybutów, struktura kategorii, eksport zamówienia
| Operacja | Mechanizm | Koszt przy dużym katalogu | Jak to prowadzimy |
|---|---|---|---|
| Aktualizacja stanu | source items | niski | na bieżąco, tylko różnice |
| Aktualizacja ceny bazowej | atrybut price | niski | na bieżąco, tylko różnice |
| Ceny dla grup klientów (w naszej platformie B2B inaczej: cena bazowa z BaseLinkera, rabat klienta liczony w Magento) | tier price | średni | paczki, poza szczytem |
| Masowa zmiana atrybutów | EAV, wiele tabel | wysoki | kolejka, okno nocne, etapami |
| Zmiana struktury kategorii | reindeks katalogu | wysoki | staging, potem wdrożenie planowane |
| Eksport zamówienia | order API | niski | na zdarzenie, z idempotencją |
| Dane | Kierunek | Tryb |
|---|---|---|
| kartoteka | ERP → Magento | batch |
| stany | ERP → Magento | cyklicznie |
| cenniki B2B | ERP → Magento | batch |
| kontrahenci | ERP → Magento | przy zmianie |
| zamówienia | Magento → ERP | na zdarzenie |
| dokumenty | ERP → Magento | na zdarzenie |
Objawy, które w tym układzie wracają najczęściej, i jak je zamykamy
Nocny import nie kończy się do rana
Brak porównania różnic — proces wysyła cały katalog zamiast zmienionych rekordów. Rozwiązaniem jest porównanie różnic (diff) i kolejka, nie mocniejszy serwer.
Kolejka rośnie i nie schodzi
Proces obsługujący kolejkę (consumer) nie działa albo przetwarza wolniej, niż przybywa zadań. Monitoring kolejki, który ustawiamy, alarmuje, zanim opóźnienie zauważą klienci.
Zamówienie w ERP dwa razy
Ponowienie po timeoucie bez klucza idempotencji tworzy drugi dokument. Dlatego zapisujemy, że zamówienie zostało już przekazane, a gdy odpowiedź ERP nie dotarła, przed ponowieniem sprawdzamy po kluczu, czy dokument już powstał.
Nowe pole z ERP nie ma gdzie trafić
Brak atrybutu w Magento zatrzymuje cały import zamiast pominąć jedno pole. Nasza walidacja zgłasza wyjątek, a reszta importu przechodzi.
Podaj liczbę SKU, liczbę grup klientów i nazwę ERP
Trzy informacje wystarczą, żeby ocenić, czy wystarczy nocny import, czy potrzebna jest kolejka i warstwa pośrednia — i nie płacić za architekturę, której Twój katalog nie potrzebuje.
Liczba SKU
wielkość katalogu
Liczba grup klientów
grupy cenowe B2B
Nazwa ERP
system, z którym łączymy Magento