Przejdź do treści

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
Zmiana cennika w ERP: ile zapisów trafia do Magento przykład · liczby demonstracyjne
  • 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
Liczby przykładowe, nie dane klienta. Ceny dla grup klientów (tier price) kosztują więcej niż cena bazowa, więc idą paczkami poza szczytem.

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

P-1 · cena bazowa z cennika ERP: 100,00 zł nettodane demonstracyjne
Model cenPartner 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ł nettoERP przysyła 90,00 zł netto
Magento liczy rabat od bazy
baza plus rabat
100,00 zł netto − 20% = 80,00 zł netto100,00 zł netto − 10% = 90,00 zł netto
Cena bazowa z cennika ERP: 100,00 zł netto. Dane demonstracyjne: role, ceny i rabaty są wymyślone, nie pochodzą od klienta.
ERP liczy cenę końcowącena końcowa z ERP
  • sklep tylko wyświetla,
  • łatwa zgodność z fakturą,
  • trudniejsze promocje.
Magento liczy rabat od bazybaza plus rabat
  • 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

Niski koszt
  • 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ą
Średni koszt
  • 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.
Wysoki koszt
  • 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
Koszt typowych operacji integracyjnych w Magento
OperacjaMechanizmKoszt przy dużym kataloguJak to prowadzimy
Aktualizacja stanusource itemsniskina bieżąco, tylko różnice
Aktualizacja ceny bazowejatrybut priceniskina 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średnipaczki, poza szczytem
Masowa zmiana atrybutówEAV, wiele tabelwysokikolejka, okno nocne, etapami
Zmiana struktury kategoriireindeks kataloguwysokistaging, potem wdrożenie planowane
Eksport zamówieniaorder APIniskina zdarzenie, z idempotencją
kierunki wymiany
DaneKierunekTryb
kartotekaERP → Magentobatch
stanyERP → Magentocyklicznie
cenniki B2BERP → Magentobatch
kontrahenciERP → Magentoprzy zmianie
zamówieniaMagento → ERPna zdarzenie
dokumentyERP → Magentona 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.

Magento i ERP — pytania

Nie ma tu Twojego pytania? Napisz

Bo większość atrybutów produktu nie jest kolumną w tabeli, tylko rekordem w osobnym zbiorze. Zapis kilkudziesięciu atrybutów dla dziesiątek tysięcy produktów po jednym rekordzie jest kosztowny. Dlatego przy dużych katalogach używamy operacji masowych i aktualizujemy tylko to, co faktycznie się zmieniło.
Najczęściej jako ceny dla grup klientów albo ceny specjalne dla kontrahenta. Ważne jest ustalenie, czy ERP wysyła cenę końcową, czy bazę plus rabat, bo to zmienia sposób liczenia w koszyku i to, co zobaczy partner po zalogowaniu.
Dużą aktualizację dzielimy na paczki, przetwarzamy przez kolejki i uruchamiamy poza szczytem. Indeksatory ustawiamy na harmonogram, a nie na zapis, żeby jeden import nie wywoływał pełnej reindeksacji katalogu w środku dnia.
Zamówienie eksportujemy po zmianie statusu na uzgodniony, z pełnym kompletem: pozycje, SKU, ceny, rabaty, VAT, adresy i forma płatności. Każdy eksport dostaje klucz idempotencji, a numer dokumentu z ERP wraca do Magento, żeby dało się połączyć dokument ze sprzedażą.
Z tego, że ERP zna stan magazynowy, a Magento operuje na salable quantity pomniejszonej o rezerwacje z niezrealizowanych zamówień. Jeżeli ERP już odjął zamówienie, a Magento nadal trzyma rezerwację, sklep pokazuje mniej, niż jest, dopóki wysyłka nie zwolni rezerwacji.

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.

przesyłasz

Liczba SKU

wielkość katalogu

przesyłasz

Liczba grup klientów

grupy cenowe B2B

przesyłasz

Nazwa ERP

system, z którym łączymy Magento