Integracja BaseLinker z Magento: stany i rezerwacje MSI
Marketplace sprzedaje towar, który w Magento jest już zarezerwowany, a stany z BaseLinkera nie zgadzają się z frontem? Mapujemy magazyny BaseLinkera na magazyny Magento (moduł MSI) i wysyłamy do kanałów stan pomniejszony o rezerwacje, więc kanały widzą tylko to, co naprawdę można sprzedać.
Realizacjaok. 115 tys. produktów i wariantów ze stanami z BaseLinkera na Magento 2.4.8, 936 testów przed wdrożeniemSportina B2B · Magento + BaseLinker- BaseLinker → Magento Stan: 10 szt. zapis do source item magazynu na produkcie simple; zapis do configurable jest ignorowany source qty 10
- rezerwacje w Magento −3 szt. trzy niezrealizowane zamówienia; Magento odejmuje je od dostępności, a nie od stanu w źródle zamówienia w toku
- Magento → kanały Salable quantity: 7 szt. tę liczbę integracja czyta i wysyła dalej; wysłanie 10 to sprzedaż towaru już zarezerwowanego do sprzedaży
- front sklepu 7 szt. po indeksacji wynik widać po przebiegu indeksatora (cataloginventory_stock, tryb schedule) uruchamianego przez cron po przebiegu crona
Simple, configurable i to, który z nich naprawdę ma stan
BaseLinker wysyła jedną liczbę. Magento przechowuje stan osobno dla każdego magazynu (source items), odejmuje rezerwacje z niezrealizowanych zamówień i pokazuje wynik dopiero po indeksacji. Do tego klient widzi produkt configurable (jedną kartę modelu), a stan, SKU i cena siedzą na produktach simple (konkretnych rozmiarach). Integracja musi zapisywać stan w jednym miejscu, a raportować sprzedaż w drugim — inaczej sprzedaż w podziale na modele nigdy się nie zgodzi.
Co idzie z Magento do BaseLinkera i kanałów
source qty 10rezerwacje −3trzy niezrealizowane zamówieniasalable quantity → 7tę liczbę integracja czyta i wysyła dalejsource qty → 10błędna synchronizacja: wysłanie 10 to sprzedaż towaru już zarezerwowanegoTen sam rozmiar M: od modelu do dostępności
| Poziom | Stan w źródle | Rezerwacje | Do sprzedaży |
|---|---|---|---|
| Produkt główny configurable – model, który widzi klient | zapis do configurable jest ignorowany | — | — |
| Wariant: rozmiar M simple – stan, SKU i cena; tu idzie zapis stanu | Stan: 10 szt. source item magazynu | −3 szt. | 7 szt. salable quantity |
Wariant i produkt nadrzędny
Test na jednym zamówieniu (ten sam rozmiar z dwóch magazynów) potwierdził zdjęcie po jednej sztuce z każdego magazynu, a lokalna kopia stanu w Magento schodzi dokładnie o zamówioną ilość.
Pozycja zamówienia i katalog
W platformie B2B, którą wdrożyliśmy, stan prowadzi BaseLinker. Zamówienie od razu zmniejsza stan w platformie i trafia do BaseLinkera powiązane z katalogiem i z magazynem wskazanym na pozycji, więc zdejmuje stan z właściwego magazynu. Stany z BaseLinkera, w tym sprzedaż z innych kanałów, platforma pobiera cyklicznie, według harmonogramu. Przyczyny i naprawę opisujemy w poradniku o zamówieniach z Magento w BaseLinkerze.
Poradnik o zamówieniach z Magento w BaseLinkerzeCoś się nie zgadza po zamówieniu: to awaria stanu czy awaria zapisu zamówienia?
- Zamówienie jest w BaseLinkerze, a stan się nie zmienia.Awaria stanuBez powiązania pozycji zamówienia z katalogiem stan nie rusza się wcale, więc nie da się sprawdzić ani magazynu, ani anulowania. Co sprawdzić: powiązanie pozycji z produktem w katalogu i magazyn wskazany na pozycji – kroki 02 i 03 niżej.
- Problem jest w samym zamówieniu: pozycje bez dopasowania albo drugie zamówienie.Awaria zapisu zamówieniaImport zamówienia (order + order items, mapowanie po SKU simple): pozycje bez dopasowania i błędne raporty. Duplikaty zamówień: ponowienie po timeoucie tworzy drugie zamówienie, bo brakuje klucza idempotencji i znacznika „już przekazane”.
Na czym operuje integracja w Magento
stan, dostępność, cena (scope), import zamówienia, publikacja na froncie – obiekt, mechanizm i objaw, gdy go zabraknie
| Operacja | Obiekt w Magento | Mechanizm | Co pójdzie źle bez tego (objaw) |
|---|---|---|---|
| Aktualizacja stanu | simple product | source item dla każdego magazynu | zapis do configurable jest ignorowany |
| Odczyt dostępności | configurable + simple | salable quantity | integracja czyta source qty zamiast salable quantity i wysyła ją dalej: kanał sprzedaje towar zarezerwowany w Magento, a zamówienia trafiają na brak towaru |
| Aktualizacja ceny | simple product | scope: global / website | zapis bez świadomości zakresu (scope) zmienia cenę w zakresie domyślnym (global), a witryna (website) z własną ceną dalej pokazuje starą |
| Import zamówienia | order + order items | mapowanie po SKU simple | pozycje bez dopasowania i błędne raporty |
| Publikacja na froncie | indeksy katalogu i stanu | cron + indexer w trybie schedule | „zapisało się, ale nie widać”: rekord w bazie poprawny, front pokazuje stare dane, bo tryb „by schedule” działa bez crona albo winny jest cache pełnostronicowy; tryb „on save” z kolei spowalnia import |
Bez mapy źródeł stany sumują się przypadkowo
Zanim cokolwiek podłączymy, spisujemy każdy magazyn BaseLinkera i jego odpowiednik w Magento — razem z decyzją, czy w ogóle bierze udział w sprzedaży online.
| BaseLinker | Magento source | Online |
|---|---|---|
| Magazyn A | default | tak |
| Magazyn B | warehouse_b | tak |
| Salon | retail_pos | nie |
| Serwis | service_hold | nie |
| W drodze | brak odwzorowania | nie |
- jeden magazyn BaseLinkera = jedno source w Magento,
- magazyny nieuczestniczące w sprzedaży online oznaczone jawnie,
- stock (zestaw źródeł przypisany do witryny) opisany razem z zasadą wyliczania dostępności,
- towar w drodze i zwroty mają własną regułę, nie wpadają do stanu handlowego,
- zmiana mapy zawsze przechodzi przez staging przed produkcją.
Kolejność wdrożenia, która nie wstrzymuje sprzedaży
W tej parze kolejność kroków jest ważniejsza niż sama konfiguracja. Przy każdym kroku: co przygotować na start (element, po co, kto daje). Dane dostępowe (token BaseLinkera, konto API Magento) przekazujemy osobnym kanałem, nie w formularzu kontaktowym.
- Mapa magazynów i indeksatorymapa magazynów BaseLinkera i źródeł Magento (sekcja wyżej) oraz tryb pracy indeksatorów,
Przygotuj: lista magazynów i źródeł MSI · mapa stanów · klient; tryb indeksatorów i lista cronów · kiedy zmiana jest widoczna na froncie · klient - Powiązanie pozycji z katalogiempowiązanie pozycji zamówienia z produktem w katalogu BaseLinkera, po EAN albo SKU wariantu,
Przygotuj: lista kanałów i źródeł zamówień · zakres synchronizacji i magazyn domyślny · klient - Magazyn na pozycjimagazyn wskazany na każdej pozycji, a nie domyślny dla źródła zamówienia,
- Test na jednym zamówieniutest na jednym zamówieniu: stany i rezerwacje odczytane przed i po złożeniu, w obu systemach,
Przygotuj: staging będący kopią produkcji · test bez ryzyka dla sprzedaży · klient; okno na zamówienie testowe · odczyt stanów przed i po · wspólnie - Ścieżka anulowaniaścieżka anulowania sprawdzona w panelu, zanim zostanie zautomatyzowana.
Pięć rzeczy, które skracają wdrożenie, to listy i dostępy przy krokach 01, 02 i 04. Tak wyglądał test z kroku 04 w przypadku z wdrożenia B2B – opis przy parze produkt główny / wariant wyżej.
Awarie przy masowym zapisie, statusach i ponowieniach
Blokady tokenu przy limicie API wspólnym z ERP i ponawianie eksportu zamówień opisuje poradnik o ERROR_BLOCKED_TOKEN. Duplikaty zamówień opisujemy przy awarii zapisu zamówienia wyżej.
Import kładzie sklep w ciągu dnia
Masowy zapis atrybutów w modelu EAV plus reindeks całego katalogu potrafią zająć bazę na kilkadziesiąt minut. Rozwiązaniem są paczki, kolejki i okno poza szczytem.
Status w pętli
Dwukierunkowa synchronizacja wszystkich statusów sprawia, że dwa systemy nadpisują się nawzajem. Ograniczamy ją do kilku stanów granicznych z jednym kierunkiem.
Podeślij listę magazynów i tryb pracy indeksatorów
To dwie informacje, które w Magento decydują o większości problemów ze stanami. Na ich podstawie powiemy, czy kanały mogą dziś sprzedać zarezerwowany towar i jak to zamknąć.
Lista magazynów
magazyny BaseLinkera i źródła MSI
Tryb indeksatorów
i lista cronów
Czy konfiguracja jest bezpieczna
na podstawie tych dwóch informacji