Przejdź do treści

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
Ile sztuk rozmiaru M może sprzedać kanał: od stanu w magazynie do frontu przykład · dane demonstracyjne
  • 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
Przykład dla jednego produktu simple i jednego źródła, nie konfiguracja klienta. Przy kilku źródłach dostępność liczy się dla stocku przypisanego do witryny — mapę magazynów opisujemy niżej.

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

rozmiar M · odczyt dostępnościprzykład
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ż zarezerwowanego

Ten sam rozmiar M: od modelu do dostępności

Magento · produkt główny i wariantprzykład
PoziomStan w źródleRezerwacjeDo 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
Przykład dla jednego produktu simple i jednego źródła, nie konfiguracja klienta. Na froncie wynik widać po indeksacji.
Przypadek z wdrożenia B2B

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ść.

Przypadek z wdrożenia B2B

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 BaseLinkerze

Coś się nie zgadza po zamówieniu: to awaria stanu czy awaria zapisu zamówienia?

  1. 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.
  2. 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
Na czym operuje integracja w Magento
OperacjaObiekt w MagentoMechanizmCo pójdzie źle bez tego (objaw)
Aktualizacja stanusimple productsource item dla każdego magazynuzapis do configurable jest ignorowany
Odczyt dostępnościconfigurable + simplesalable quantityintegracja 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 cenysimple productscope: global / websitezapis bez świadomości zakresu (scope) zmienia cenę w zakresie domyślnym (global), a witryna (website) z własną ceną dalej pokazuje starą
Import zamówieniaorder + order itemsmapowanie po SKU simplepozycje bez dopasowania i błędne raporty
Publikacja na froncieindeksy katalogu i stanucron + 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.

mapa magazynówprzykład
BaseLinkerMagento sourceOnline
Magazyn Adefaulttak
Magazyn Bwarehouse_btak
Salonretail_posnie
Serwisservice_holdnie
W drodzebrak odwzorowanianie
Przykładowy układ mapy magazynów, nie konfiguracja klienta.
  • 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.

  1. 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
  2. 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
  3. Magazyn na pozycjimagazyn wskazany na każdej pozycji, a nie domyślny dla źródła zamówienia,
  4. 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
  5. Ś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.

BaseLinker i Magento — pytania

Nie ma tu Twojego pytania? Napisz

Bo w Magento to simple trzyma stan i SKU, a configurable jest tylko produktem nadrzędnym prezentowanym klientowi. Integracja musi więc operować na simple przy stanach i cenach, ale mapować zamówienie na właściwy produkt nadrzędny, żeby raporty sprzedaży miały sens.
Przy Multi Source Inventory stan nie jest jedną liczbą. Są source items dla każdego magazynu i wyliczana salable quantity, pomniejszona o rezerwacje. Integracja powinna zapisywać do konkretnego source, a czytać salable quantity — inaczej sprzedasz towar, który jest już zarezerwowany.
Zwykle przez indeksatory i cache. Dopóki nie przebiegnie indeksacja stanu i cen albo nie zostanie unieważniony cache, front pokazuje stare dane. Przy częstych aktualizacjach z BaseLinkera warto ustawić indeksatory na tryb harmonogramu i pilnować kolejek cron.
Jeden do jednego, spisane wprost przed wdrożeniem. Każdy magazyn w BaseLinkerze powinien mieć swoje source w Magento i jasno określone, czy w ogóle uczestniczy w sprzedaży online. Bez tej mapy stany sumują się przypadkowo.
Można, ale nie warto robić tego dla wszystkich statusów. Bezpieczniej wybrać kilka stanów granicznych, na przykład wysłane i anulowane, i dla nich ustalić jeden kierunek. Pełna dwukierunkowość szybko prowadzi do nadpisywania statusu w kółko.

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ąć.

przesyłasz

Lista magazynów

magazyny BaseLinkera i źródła MSI

przesyłasz

Tryb indeksatorów

i lista cronów

odpowiadamy

Czy konfiguracja jest bezpieczna

na podstawie tych dwóch informacji