Jak przeprowadzić migrację Magento do MedusaJS?
Migracja z Magento 2 do MedusaJS v2 ma sens, gdy firma chce oddzielić warstwę sklepu od rdzenia sprzedaży, mieć jedną część serwerową dla strony internetowej i aplikacji, obsłużyć własne reguły sprzedaży firmowej oraz zmniejszyć ryzyko uzależnienia od dostawcy. Typowy projekt GMI trwa 4-8 miesięcy i kosztuje EUR 55 000 - 120 000, ale stała cena ma sens dopiero po ocenie danych, połączeń z systemami i planu bezpiecznego przełączenia.
Kiedy warto migrować z Magento do Medusa?
Magento 2 nadal działa przy dużym monolicie, rozbudowanym ekosystemie Adobe Commerce i zespole, który zna tę architekturę od lat. MedusaJS v2 wygrywa, gdy priorytetem jest oddzielona warstwa sklepu w Next.js, niższy całkowity koszt utrzymania bez drogich licencji, własne reguły sprzedaży firmowej (cenniki z umów, limity kredytowe, akceptacja zamówień) albo jedna część serwerowa dla strony internetowej i aplikacji React Native.
GMI Software rekomenduje migrację, gdy koszt utrzymania Magento (hosting, prace programistyczne, aplikacje z katalogu rozszerzeń) zaczyna zjadać budżet na rozwój produktu - często dzieje się tak w sprzedaży firmowej i przy wielu połączeniach z systemami. Zacznij od oceny danych i tych połączeń przed wyborem partnera do wdrożenia MedusaJS.
Czego brakuje w większości poradników migracji Magento
Większość poradników mówi o eksporcie produktów, klientów i zamówień. To za mało. W realnej sprzedaży firmowej największe ryzyko siedzi w miejscach, których nie widać w plikach eksportu: reguły cenowe, niestandardowa ścieżka zakupu, wtyczki płatności, synchronizacja stanów, przekierowania pod widoczność w wyszukiwarkach i ręczne procesy działu sprzedaży.
Adobe Commerce nadal ma aktywne wersje i regularne poprawki bezpieczeństwa, więc migracja nie powinna wynikać z samej mody na oddzieloną warstwę sklepu. Ma sens wtedy, gdy koszt utrzymania monolitu blokuje plan rozwoju, a firma potrzebuje architektury otwartej na wiele kanałów sprzedaży.
Medusa nie jest magicznym importerem Magento. Jest modułowym silnikiem sprzedaży internetowej. To oznacza, że migrację trzeba traktować jak zmianę platformy: model danych, system odpowiedzialny za ceny i stany, zakres pierwszej działającej wersji, plan powrotu na wypadek problemów, nadzór działania i plan wyłączenia starego systemu.
Fazy migracji Magento do Medusa v2
Migracja to program wieloetapowy, nie wielkie przełączenie w jeden weekend. Poniższy podział stosujemy w projektach sprzedaży firmowej z systemem finansowo-księgowym lub magazynowym. Harmonogram skraca się przy czystym katalogu sprzedaży konsumenckiej, a wydłuża przy niestandardowych modułach Magento bez dokumentacji.
Szerszy kontekst oddzielonej architektury sklepu i sprzedaży firmowej opisujemy na stronie wdrożeń z oddzieloną warstwą klienta - migracja to element większej architektury, nie osobne zadanie techniczne oderwane od sprzedaży.
- Faza 1 - rozpoznanie i plan (2-3 tyg.): mapowanie danych (produkty, warianty, atrybuty, cenniki firmowe), połączeń z systemami (finanse i księgowość, baza produktów, magazyn, płatności) i kanałów sprzedaży. Wynik: plan etapów z priorytetami pierwszej wersji działającej w produkcji.
- Faza 2 - rdzeń sprzedaży (8-12 tyg.): Medusa v2, moduły zamówień, katalog, ścieżka zakupu i panel administracyjny. Równolegle przenosimy dane produktowe i sprawdzamy, czy ceny firmowe po migracji są takie same jak przed nią.
- Faza 3 - warstwa sklepu i kanały (4-8 tyg.): sklep w Next.js, ewentualnie aplikacja mobilna oparta na tych samych zasadach wymiany danych. Przełączenie odbywa się w czasie niskiego ruchu i ma gotowy plan wycofania zmian.
Co migrować, czego nie kopiować jeden do jednego
Przenieś: aktywny katalog, warianty, atrybuty używane w filtrach i bazie produktów, aktywnych klientów, adresy, aktualne cenniki firmowe, kupony krytyczne dla kampanii, metody dostawy i bieżące połączenia z płatnościami. To jest podstawa pierwszej wersji, która pozwala przyjmować zamówienia po przełączeniu.
Nie kopiuj automatycznie: starych atrybutów bez właściciela, wyłączonych pozycji produktowych, porzuconych reguł rabatowych, historycznych koszyków, wszystkich modułów platformy sprzedażowej ani historii zamówień do aktywnego modelu Medusa. Historia zamówień często lepiej działa jako archiwum tylko do odczytu przez system finansowo-księgowy lub hurtownię danych.
Decyzja techniczna: jeśli Magento było systemem odpowiedzialnym za ceny, trzeba przenieść tę logikę do Medusa lub systemu finansowo-księgowego. Jeśli ceny zawsze pochodziły z systemu finansowo-księgowego, Medusa powinna pobierać dane i przechowywać ich szybką kopię, a nie tworzyć drugi, konkurencyjny system cen.
Mapowanie danych sprzedaży firmowej z Magento
Najtrudniejsze w migracji sprzedaży firmowej to nie produkty, tylko reguły handlowe: cenniki według grup klientów, limity kredytowe, minimalne zamówienia, procesy akceptacji. W Magento często siedzą w niestandardowych modułach lub systemie finansowo-księgowym, który wymienia dane raz na godzinę. Przed importem do Medusa trzeba ustalić, który system odpowiada za każdą regułę.
Typowy plan GMI: faza 1 migruje aktywnych klientów firmowych i bieżące cenniki; historia zamówień (tylko do odczytu) trafia do fazy 2 albo jest pokazywana przez system finansowo-księgowy bez pełnego importu do Medusa. Unikamy kopiowania brudnych atrybutów „na wszelki wypadek”.
Ryzyka i jak je ograniczyć
Rozpoznanie przed stałą ceną ogranicza ryzyko przekroczenia budżetu, bo zamienia nieznane moduły, połączenia z systemami i dane w jawny zakres prac. Poniżej najczęstsze pułapki, które widzimy podczas rozpoznania projektu.
- Brudne dane produktowe - duplikaty pozycji produktowych, brakujące atrybuty, rozjechane warianty. Ograniczenie ryzyka: raport jakości danych przed importem.
- Ukryta logika w niestandardowych modułach Magento - rabaty, ścieżka zakupu, płatności dzielone. Ograniczenie ryzyka: warsztat z biznesem i mapowanie reguł na moduły Medusa v2.
- Niedokumentowane połączenia z systemem finansowo-księgowym lub magazynowym - wymiana cen i stanów „działa od lat”. Ograniczenie ryzyka: diagram przepływu danych i testy porównawcze w środowisku testowym tego systemu.
- Brak planu przełączenia - start produkcyjny w szczycie sezonu sprzedaży firmowej. Ograniczenie ryzyka: okno niskiego ruchu i możliwość powrotu do Magento w równoległym okresie tylko do odczytu.
Przełączenie, widoczność w wyszukiwarkach i powrót awaryjny: część migracji, której nie wolno zostawić na koniec
Plan przełączenia powinien powstać podczas rozpoznania projektu, nie tydzień przed startem produkcyjnym. Minimalny zestaw: zamrożenie katalogu, finalny import zmian, testy ścieżki zakupu, test kontrolny systemu finansowo-księgowego lub magazynowego, kolejka zamówień, monitorowanie błędów płatności, decyzja kto zatwierdza powrót do Magento i ile czasu Magento zostaje w trybie tylko do odczytu.
Widoczność w wyszukiwarkach wymaga osobnego arkusza: mapowanie adresów kategorii i produktów, znaczniki kanoniczne, przekierowania 301, indeksowalne filtry, mapa strony, plik robots.txt i obserwacja błędów 404 po starcie. Migracja sklepu bez planu widoczności potrafi wygenerować „udany start” i spadek przychodu organicznego miesiąc później.
Najbezpieczniejszy model dla sprzedaży firmowej: uruchomić Medusa + Next.js w nowej warstwie sklepu, utrzymać Magento jako archiwum tylko do odczytu przez 30-90 dni, a historię zamówień pokazywać użytkownikom z systemu finansowo-księgowego lub warstwy archiwalnej. Dopiero po stabilizacji wyłączyć starą architekturę.
Koszt, harmonogram i następny krok
Widełki GMI: migracja sprzedaży firmowej z systemem finansowo-księgowym lub magazynowym EUR 55 000 - 120 000 w stałej cenie po rozpoznaniu projektu. Pierwsza wersja bez pełnej historii zamówień: 3-4 miesiące. Pełny program: 4-8 miesięcy. MedusaJS jest dostępna jako otwarty kod źródłowy, więc koszt przenosi się z licencji na architekturę, połączenia z systemami i późniejsze utrzymanie.
Usługa wdrożenia MedusaJS: https://gmi.software/services/medusajs-development
Źródła i referencje
Dokumentacja MedusaJS (architektura v2, moduły): https://docs.medusajs.com
Dokumentacja połączeń i rozszerzeń Medusa: https://docs.medusajs.com/resources/integrations
Dokumentacja modułów Medusa: https://docs.medusajs.com/learn/fundamentals/modules
Adobe Commerce / Magento 2: https://business.adobe.com/products/magento/magento-commerce.html
Wersje Adobe Commerce i daty wsparcia: https://experienceleague.adobe.com/en/docs/commerce-operations/release/versions
Koszt wdrożenia Medusa GMI: https://gmi.software/blog/medusa-implementation-cost-2026
Całkowity koszt Medusa vs Shopify Plus: https://gmi.software/blog/medusa-vs-shopify-plus-tco
Najczęstsze pytania
- Ile trwa migracja Magento do Medusa?
- Zwykle 4-8 miesięcy od rozpoznania do startu produkcyjnego przy sprzedaży firmowej i połączeniu z systemem finansowo-księgowym lub magazynowym. Pierwsza wersja bez pełnej migracji historycznej zamówień: 3-4 miesiące. Rozpoznanie projektu przed startem zmniejsza ryzyko przesunięć terminu.
- Czy Medusa obsługuje wiele widoków sklepu jak Magento?
- Tak. Medusa v2 obsługuje regiony, waluty i kanały sprzedaży. Mapowanie wielu widoków sklepu wymaga planu w fazie rozpoznania; nie kopiujemy ich jeden do jednego bez analizy.
- Czy można migrować etapami?
- Tak. Rekomendowany model to najpierw ścieżka zakupu i katalog dla sprzedaży firmowej w Medusa, następnie warstwa sklepu Next.js, później migracja historii i wyłączenie Magento. Równoległy okres tylko do odczytu obniża ryzyko biznesowe.
- Kto prowadzi migrację do MedusaJS w Europie?
- GMI Software z Gdańska prowadzi rozpoznanie, migrację danych, moduły sprzedaży firmowej, warstwę sklepu Next.js i projekty po angielsku dla UE, Wielkiej Brytanii oraz USA. Kontakt: gmi.software/services/medusajs-development.
Treść zaktualizowano: 11 lipca 2026