SKLEPINTERNETOWY.BIZPoradniki i wiedza e-commerce
Poradnik›BŁĘDY›Magento – aktualizacja produktów przez Bulk API samoczynnie…
BŁĘDY

Magento – aktualizacja produktów przez Bulk API samoczynnie włącza wyłączone oferty

18 listopada 202613 min czytanianetpoint

W Magento Open Source 2.4.9 zgłoszono poważny błąd asynchronicznej aktualizacji produktów, który może doprowadzić do samoczynnego włączenia wcześniej wyłączonych ofert. Problem występuje podczas aktualizowania wybranych atrybutów produktu przez Bulk REST API, nawet jeżeli przesyłane dane w ogóle nie zawierają informacji o zmianie jego statusu.

W udokumentowanym przypadku integracja wysyła wyłącznie nową wagę produktu. Magento powinno zapisać zmodyfikowaną wagę i zachować dotychczasowy status produktu. Tymczasem podczas przetwarzania danych asynchronicznych system może dopisać wartość status = 1, oznaczającą produkt aktywny.

W efekcie produkt, który wcześniej posiadał status Disabled, zostaje zapisany jako Enabled bez świadomego polecenia administratora lub systemu integracyjnego.

Zgłoszenie zostało utworzone 17 listopada 2026 roku w oficjalnym repozytorium Magento pod numerem #41874. Autor wskazał konkretną zmianę kodu odpowiedzialną za regresję i potwierdził nieprawidłowe zachowanie mechanizmu kodowania i dekodowania danych.

Problem jest szczególnie istotny dla sklepów korzystających z systemów ERP, PIM, integracji magazynowych oraz innych rozwiązań masowo aktualizujących katalog produktów przez API.

Na czym polega błąd samoczynnej aktywacji produktów w Magento?

Magento pozwala administratorowi określić, czy produkt jest aktywny, czy wyłączony.

Status Enabled oznacza produkt włączony, natomiast Disabled oznacza produkt wyłączony.

W REST API Magento wartości te są reprezentowane liczbowo:

Enabled = 1
Disabled = 2

Status jest jednym z podstawowych parametrów wykorzystywanych podczas zarządzania katalogiem.

Sklep może posiadać produkty wyłączone z różnych powodów. Mogą to być towary wycofane ze sprzedaży, oferty przygotowywane do uruchomienia, produkty sezonowe lub pozycje czasowo niedostępne.

Jeżeli zewnętrzna integracja aktualizuje wagę, opis albo inny atrybut produktu, nie powinna przy okazji zmieniać jego statusu.

W Magento 2.4.9 opisano jednak scenariusz, w którym asynchroniczny mechanizm Bulk API traktuje brak pola statusu w żądaniu tak, jakby integracja zażądała aktywowania produktu.

Jak odtworzono błąd Magento 2.4.9 Bulk API?

Autor zgłoszenia przygotował scenariusz obejmujący prosty produkt z wyłączoną możliwością sprzedaży.

Przykładowy produkt posiada następujące dane:

SKU: async-status-repro
status: 2
weight: 1

Wartość status: 2 oznacza produkt wyłączony.

Następnie do asynchronicznego interfejsu aktualizacji katalogu wysyłane jest żądanie zawierające nową wagę produktu.

Endpoint wykorzystany w scenariuszu:

PUT /rest/all/async/bulk/V1/products/bySku

Przykładowe dane JSON:

[
  {
    "product": {
      "sku": "async-status-repro",
      "weight": 2.5
    }
  }
]

W żądaniu nie występuje pole status.

System powinien więc zmienić wyłącznie wagę z 1 na 2,5 i pozostawić produkt wyłączony.

Oczekiwany rezultat aktualizacji

sku: async-status-repro
weight: 2.5
status: 2

Produkt powinien nadal posiadać status Disabled.

Nieprawidłowy rezultat przetwarzania asynchronicznego

sku: async-status-repro
weight: 2.5
status: 1

W problematycznej ścieżce serializacji Magento dopisuje status aktywny, mimo że nie został on przesłany przez integrację.

W wyniku tego mechanizm zapisywania produktu może potraktować aktywację jako zwykłą, prawidłową zmianę atrybutu.

Autor odtworzył dopisywanie statusu podczas przetwarzania danych w kodzie Magento 2.4.9. Pełny scenariusz uruchomiony na czystej bieżącej instalacji rozwojowej nadal wymagał niezależnego potwierdzenia przez opiekunów projektu.

Przyczyna techniczna: regresja w Magento WebapiAsync

Źródłem problemu jest zmiana sposobu przygotowywania wiadomości przekazywanych do asynchronicznego przetwarzania.

W Magento operacje Bulk API nie muszą być wykonywane natychmiast podczas odbierania żądania.

System może przyjąć zestaw operacji, zapisać je w kolejce i przetworzyć później za pomocą odpowiedniego konsumenta wiadomości.

Takie rozwiązanie jest przydatne przy aktualizowaniu dużych katalogów, ponieważ nie wymaga od zewnętrznego systemu oczekiwania na zakończenie wszystkich operacji.

W zgłoszeniu wskazano regresję związaną ze zmianą kodu oznaczoną jako ACP2E-4394. Dotyczyła ona wcześniej obsługi asynchronicznych zwrotów faktur, ale zmodyfikowała mechanizm wykorzystywany również przez inne operacje API.

Zmiana w OperationRepository::create()

Problem powiązano z klasą:

Magento\WebapiAsync\Model\OperationRepository

Wcześniejszy sposób przygotowywania komunikatu korzystał z serializacji danych przesłanych przez klienta API:

$encodedMessage = $this->jsonSerializer->serialize(
    $requestData[$operationId]
);

Po zmianie mechanizm wykorzystuje:

$encodedMessage = $this->messageEncoder->encode(
    $topicName,
    $entityParams
);

Różnica jest istotna.

W pierwszym podejściu serializowane były dane bezpośrednio przesłane w żądaniu.

W drugim kodowanie odbywa się na podstawie parametrów przetworzonych przez mechanizm obsługi usług Magento.

Podczas tego procesu mogą zostać wywołane metody zwracające domyślne wartości atrybutów.

Dlaczego pominięte pole status staje się wartością Enabled?

Magento wykorzystuje metodę:

Magento\Catalog\Model\Product::getStatus()

Jeżeli surowe dane produktu nie zawierają statusu, metoda może zwrócić domyślną wartość:

Status::STATUS_ENABLED

Odpowiada ona liczbie 1.

Podczas kodowania wiadomości asynchronicznej brakujące pole zostaje więc zastąpione rzeczywistą wartością statusu.

Po ponownym odczytaniu komunikatu Magento nie widzi już informacji, że pole zostało pominięte. Widzi jawnie określoną wartość status = 1.

To prowadzi do kolejnego etapu problemu.

ProductRepository::save() nie rozpoznaje pominiętego statusu

Magento posiada mechanizm zachowywania istniejącego statusu produktu, jeżeli aktualizacja nie zawiera nowej wartości.

Istotny jest warunek:

!$product->hasData(Product::STATUS)

Jeżeli aktualizowany obiekt nie zawiera pola statusu, system może zachować wartość zapisaną wcześniej w bazie danych.

Jednak po błędnej serializacji obiekt zawiera już status Enabled.

Warunek zachowania wcześniejszej wartości nie zostaje więc spełniony.

Magento traktuje status aktywny jako wartość dostarczoną do aktualizacji i zapisuje ją w produkcie.

Nie jest to problem polegający na tym, że API błędnie odczytuje istniejący status z bazy. Problem powstaje podczas przygotowywania i przekazywania danych operacji asynchronicznej.

Dlaczego problem dotyczy integracji ERP i PIM?

W dużych sklepach internetowych dane produktowe często nie są zarządzane wyłącznie w panelu Magento.

Ceny, opisy, wagi, identyfikatory, atrybuty techniczne i inne informacje mogą pochodzić z zewnętrznych systemów.

Przykładowo:

  • ERP przekazuje dane związane z produktami i logistyką.
  • PIM aktualizuje opisy, parametry i warianty produktów.
  • System magazynowy synchronizuje dane wykorzystywane przy realizacji zamówień.
  • Dedykowany integrator wykonuje cykliczne aktualizacje katalogu przez REST API.

Takie systemy często przesyłają tylko atrybuty, które uległy zmianie.

Jeżeli waga produktu zmienia się z 1 kg na 2,5 kg, integracja może wysłać wyłącznie nową wagę, bez ponownego przesyłania całego obiektu produktu.

To prawidłowe podejście w przypadku częściowych aktualizacji, o ile API zachowuje pozostałe wartości.

Problem opisany w Magento 2.4.9 narusza to założenie.

Integracja może prawidłowo wysłać jedną zmianę, a Magento może zapisać dodatkowy atrybut, którego integracja nie zamierzała modyfikować.

Jakie mogą być konsekwencje samoczynnego włączania produktów?

1. Ponowna aktywacja produktów wycofanych ze sprzedaży

Produkt, który został celowo wyłączony, może otrzymać status aktywny podczas zwykłej aktualizacji danych.

Może to dotyczyć towarów wycofanych, produktów nieprzeznaczonych już do sprzedaży lub pozycji, które powinny pozostać nieaktywne do czasu podjęcia decyzji przez administratora.

Nie oznacza to automatycznie, że każdy taki produkt natychmiast stanie się widoczny i możliwy do kupienia.

Na faktyczną dostępność oferty wpływają również inne ustawienia Magento, między innymi widoczność produktu, jego przypisanie do witryny, stan magazynowy oraz konfiguracja kanału sprzedaży.

Samoczynna zmiana statusu usuwa jednak jedną z ważnych blokad sprzedażowych.

2. Przedwczesne udostępnienie nowych ofert

Sklep może przygotowywać nowe produkty z wyprzedzeniem, pozostawiając je wyłączone do czasu rozpoczęcia sprzedaży.

Jeżeli zewnętrzny system zmodyfikuje wagę, opis lub inny atrybut, a Magento przy okazji aktywuje produkt, oferta może stać się dostępna wcześniej, niż zaplanowano.

Ryzyko zależy od pozostałych ustawień publikacji i dostępności produktu.

3. Rozbieżności między Magento a systemem PIM

System PIM może nadal przechowywać informację, że produkt jest wyłączony, podczas gdy Magento zapisze jego status jako aktywny.

W efekcie dwa systemy posiadają różne informacje o tym samym produkcie.

Jeżeli integracja nie porównuje statusów po zakończeniu aktualizacji, niezgodność może pozostać niezauważona.

4. Nieprawidłowe dane w zewnętrznych kanałach sprzedaży

Jeżeli produkt po zmianie statusu spełnia pozostałe warunki publikacji, może zostać uwzględniony w kolejnych synchronizacjach katalogu lub eksportach danych.

Wtedy niezamierzona aktywacja może wpłynąć również na systemy zewnętrzne.

Nie oznacza to, że samo ustawienie status = 1 automatycznie powoduje publikację produktu w Google Merchant Center lub na marketplace. Jest to potencjalna konsekwencja zależna od konfiguracji integracji.

Jak sprawdzić, czy Magento zmieniło status produktu przez Bulk API?

1. Zweryfikuj wersję Magento

Na serwerze z dostępem do konsoli można sprawdzić wersję aplikacji:

bin/magento --version

Zgłoszenie dotyczy Magento Open Source 2.4.9.

W opisanym środowisku wykorzystywano między innymi:

magento/module-catalog 104.0.9
magento/module-webapi-async 100.4.7

Numer wersji stanowi punkt odniesienia, ale sam w sobie nie dowodzi występowania problemu w konkretnej instalacji.

2. Sprawdź sposób aktualizowania produktów

Ustal, czy integracja korzysta z endpointu:

/rest/all/async/bulk/V1/products/bySku

Przeanalizuj historię przesyłanych żądań i sprawdź, czy zawierają one pole status.

Szczególną uwagę zwróć na operacje modyfikujące tylko pojedyncze atrybuty produktu.

3. Porównaj status przed aktualizacją i po niej

Na środowisku testowym przygotuj produkt ze statusem Disabled.

Następnie wykonaj asynchroniczną aktualizację innego atrybutu, bez przesyłania statusu.

Po zakończeniu operacji odczytaj produkt przez API:

GET /rest/all/V1/products/async-status-repro

Sprawdź, czy produkt nadal posiada:

"status": 2

Jeżeli pojawia się:

"status": 1

mimo braku takiej wartości w żądaniu aktualizacyjnym, zachowanie odpowiada opisanemu mechanizmowi błędu.

4. Sprawdź kolejkę operacji asynchronicznych

Magento wykorzystuje konsumenta:

async.operations.all

W testowej instalacji można uruchomić odpowiedniego konsumenta zgodnie z konfiguracją środowiska:

bin/magento queue:consumers:start async.operations.all

W systemie produkcyjnym sposób uruchamiania konsumentów może być zarządzany przez procesy serwera, dlatego nie należy uruchamiać dodatkowych instancji bez sprawdzenia obecnej konfiguracji.

Przed oceną końcowego wyniku operacji trzeba potwierdzić, że wiadomość została rzeczywiście przetworzona.

5. Sprawdź szczegółowy status operacji Bulk API

Po przesłaniu żądania Magento zwraca identyfikator bulk_uuid.

Można go wykorzystać do sprawdzenia wyniku przetwarzania:

GET /rest/all/V1/bulk/{bulk_uuid}/detailed-status

Zakończenie operacji bez błędu technicznego nie gwarantuje, że wszystkie atrybuty produktu zachowały prawidłowe wartości.

Dlatego konieczne jest również porównanie rzeczywistego stanu produktu przed operacją i po niej.

Jak tymczasowo zabezpieczyć Magento przed samoczynną aktywacją produktów?

Autor zgłoszenia wskazał dwa sposoby ograniczenia problemu.

Obejście 1. Przesyłaj jawnie prawidłowy status produktu

Jeżeli integracja aktualizuje produkt przez asynchroniczne Bulk API, może dołączyć do żądania aktualny, oczekiwany status.

Przykładowe żądanie dla produktu, który ma pozostać wyłączony:

[
  {
    "product": {
      "sku": "async-status-repro",
      "weight": 2.5,
      "status": 2
    }
  }
]

W ten sposób mechanizm asynchroniczny otrzymuje jednoznaczną informację, że produkt ma pozostać wyłączony.

Obejście wymaga jednak posiadania wiarygodnych danych o aktualnym statusie.

Nie należy ustawiać status = 2 wszystkim produktom ani automatycznie przekazywać statusu aktywnego dla całego katalogu.

Integracja powinna posługiwać się rzeczywistą wartością przechowywaną w systemie źródłowym i uwzględniać możliwość równoczesnych zmian wykonywanych przez administratorów.

Obejście 2. Korzystaj z synchronicznej aktualizacji produktów

W zgłoszeniu wskazano również możliwość zastosowania standardowego endpointu aktualizacji produktu:

PUT /rest/all/V1/products/{sku}

W tej ścieżce pominięcie pola statusu powinno zachować jego dotychczasową wartość.

Zmiana sposobu komunikacji z asynchronicznego na synchroniczny może jednak wpłynąć na wydajność integracji, czas oczekiwania i obsługę większych pakietów danych.

W przypadku dużych katalogów należy sprawdzić limity API i zaplanować przetwarzanie tak, aby nie przeciążać sklepu.

Dlaczego problemu nie należy naprawiać bezpośrednio w bazie danych?

Jeżeli produkt został przypadkowo aktywowany, najpierw trzeba ustalić, jakie operacje do tego doprowadziły.

Magento może przechowywać atrybuty produktów w różnych strukturach danych, a zachowanie statusu może zależeć od konfiguracji i zakresu sklepu.

Ręczne wykonywanie zapytań UPDATE bez znajomości pełnego modelu danych grozi dodatkowymi niespójnościami.

Bezpieczniejsze jest ustalenie listy nieprawidłowo aktywowanych produktów, sprawdzenie ich oczekiwanego statusu w systemie źródłowym oraz przywrócenie wartości przez odpowiednie mechanizmy Magento.

Podobne znaczenie ma spójność danych zamówień i rozliczeń. W innym zgłoszeniu dotyczącym Magento 2.4.9 potwierdzono błąd zapisywania ujemnych wartości Credit Memo, który może zniekształcać dane zwrotów. Choć obie usterki mają odmienne przyczyny, pokazują znaczenie kontroli wartości zapisywanych przez mechanizmy platformy.

Czy Magento przygotowało oficjalną poprawkę?

Zgłoszenie #41874 zostało dodane do procesu weryfikacji problemów Magento i otrzymało status Ready for Confirmation.

Utworzono również wewnętrzne zadanie Adobe oznaczone numerem AC-19891.

Autor wskazał, że docelowa poprawka powinna zachować różnicę między polem pominiętym w żądaniu a polem, dla którego jawnie przesłano określoną wartość.

W praktyce oznacza to, że brak status nie może zostać automatycznie zamieniony na status = 1.

Poprawka musi jednocześnie zachować prawidłową obsługę operacji, których dotyczyła wcześniejsza zmiana ACP2E-4394.

Do 18 listopada 2026 roku nie potwierdzono udostępnienia stabilnej aktualizacji rozwiązującej problem.

Nie można też twierdzić, że błąd został już niezależnie potwierdzony na wszystkich wydaniach Adobe Commerce. Publiczne zgłoszenie dotyczy Magento Open Source 2.4.9.

Dlaczego kontrola aktualizacji katalogu jest ważna w e-commerce?

Integracje katalogowe często wykonują bardzo dużą liczbę operacji bez bezpośredniego udziału administratora.

Jeżeli każda aktualizacja jednego atrybutu może niezamierzenie zmienić drugi, problem może zostać powielony w wielu produktach.

Szczególnie ważne jest zatem monitorowanie nie tylko tego, czy operacja zakończyła się powodzeniem, ale również tego, jakie wartości zostały zapisane.

Podobne ryzyko związane z integracjami występuje również w innych platformach. Przykładowo błąd eksportu produktów Shopware może spowodować bardzo wysokie zużycie pamięci i awarię MySQL. To odrębna usterka, lecz również pokazuje, że rutynowe operacje wymiany danych mogą wpływać na stabilność sprzedaży.

W Magento szczególnie istotne jest zachowanie statusów wyłączonych produktów, ponieważ mogą one stanowić świadomą decyzję handlową, logistyczną lub organizacyjną.

Najczęściej zadawane pytania

Czy Magento 2.4.9 może samoczynnie włączyć wyłączony produkt?

Takie zachowanie opisano podczas asynchronicznego kodowania aktualizacji produktu przez Bulk API. Pominięty status może zostać zastąpiony domyślną wartością Enabled.

Czy problem występuje przy zwykłej edycji produktu w panelu?

Zgłoszenie dotyczy ścieżki asynchronicznego Bulk REST API. Nie potwierdza analogicznego problemu przy każdej ręcznej edycji produktu.

Czy zmiana samej wagi może aktywować produkt?

Tak. W scenariuszu technicznym użyto aktualizacji wagi z 1 na 2,5, bez przesyłania pola statusu. Podczas przetwarzania asynchronicznego do danych może zostać dopisana wartość status = 1.

Czy aktywny status oznacza, że produkt od razu można kupić?

Nie zawsze. Dostępność sprzedażowa zależy również od innych ustawień, takich jak przypisanie do witryny, widoczność i stan magazynowy.

Jak ograniczyć ryzyko?

Można jawnie przesyłać prawidłowy status przy aktualizacjach asynchronicznych lub korzystać z synchronicznego endpointu aktualizacji produktów. Oba rozwiązania wymagają wcześniejszego przetestowania w danym środowisku.

Czy oficjalna poprawka jest już dostępna?

Według stanu na 18 listopada 2026 roku zgłoszenie pozostawało w procesie weryfikacji, a stabilna poprawka nie została potwierdzona.

Co powinni zrobić administratorzy Magento 2.4.9?

Najważniejsze jest sprawdzenie integracji korzystających z asynchronicznego Bulk API i ustalenie, czy przesyłają częściowe aktualizacje produktów bez pola statusu.

Warto także porównywać wartości produktów przed synchronizacją i po jej zakończeniu, szczególnie w przypadku ofert celowo wyłączonych ze sprzedaży.

Każdy sklep internetowy wykorzystujący Magento oraz rozbudowane integracje katalogowe powinien zapewniać zgodność statusów produktów między systemem źródłowym a platformą sprzedażową.

Sam komunikat o pomyślnym zakończeniu operacji API nie gwarantuje prawidłowego zapisania wszystkich atrybutów. W przypadku opisanej usterki szczególnie ważne jest wykrywanie zmian, których integracja nigdy nie zleciła.

Źródła

netpoint

Materiały o e-commerce, sprzedaży i technologii dla sklepów internetowych.

Czytaj dalej

Powiązane materiały