Decyzja o migracji o przejściu z Subiekt GT na nexo PRO to dla wielu firm krok milowy. Nexo oferuje znacznie większą elastyczność, lepszą obsługę wariantów i nowoczesny interfejs. Jednak w głowie każdego właściciela e-commerce i managera IT pojawia się kluczowe pytanie: „Co z moimi integracjami?”.
Czy sklep internetowy, system B2B i połączenie z Allegro przestaną działać po zmianie systemu? Oto kompletny przewodnik po bezpiecznej migracji API.
1. Dlaczego migracja z GT na nexo PRO to wyzwanie dla programisty?
Mimo że oba systemy pochodzą od tego samego producenta (InsERT), ich architektura bazy danych jest diametralnie inna. Subiekt GT bazuje na strukturach projektowanych dwie dekady temu. Nexo PRO to zupełnie nowe podejście do obiektowości i relacji SQL.
Kluczowe różnice wpływające na API:
- Struktura tabel: Tabele takie jak
tw__Towar(GT) zamieniają się w bardziej złożone relacje w nexo. - Logika biznesowa: Nexo PRO wymaga bardziej rygorystycznego podejścia do logiki obiektowej Sfery.
- Identyfikatory (ID): Po migracji bazy danych, wewnętrzne identyfikatory obiektów mogą ulec zmianie, co jest krytyczne dla zewnętrznych integratorów.
- Oba to produkty firmy InsERT
2. Architektura Bridge API – Twoja polisa ubezpieczeniowa
Jeśli korzystasz z prostych, sztywno zakodowanych skryptów PHP/SQL łączących się z Subiektem GT, migracja prawdopodobnie je „wyłoży”. Jednak jeśli Twoja integracja opiera się na nowoczesnym Bridge API (REST), proces ten jest znacznie bezpieczniejszy.
Dlaczego Bridge API ułatwia migrację?
W modelu Bridge API Twój sklep internetowy nie komunikuje się bezpośrednio z bazą danych Subiekta, lecz z „warstwą pośrednią”. Podczas migracji:
- Sklep nadal wysyła te same JSON-y do API.
- Ty aktualizujesz jedynie „wtyczkę” wewnątrz Bridge API, która tłumaczy te dane na język nexo PRO.
- Frontend sklepu pozostaje nietknięty.
3. Co najczęściej „pęka” podczas migracji integracji?
Z doświadczenia wdrożeniowego wiemy, że najwięcej uwagi wymagają trzy obszary:
A. Pola własne
Subiekt GT ma ograniczoną liczbę pól własnych. W nexo PRO system ten jest niemal nieograniczony. Integracje muszą zostać przeprogramowane, aby poprawnie mapować dane z nowych tabel pól rozszerzonych.
B. Obsługa wariantów
W GT warianty (np. rozmiary ubrań) często są osobnymi produktami. Nexo PRO posiada natywne wsparcie dla asortymentu powiązanego. Migracja to moment, w którym musisz zdecydować, jak Twój sklep ma interpretować te zmiany, aby nie stracić historii sprzedaży.
C. Rezerwacje i statusy dokumentów
Nexo PRO wprowadza znacznie bardziej rozbudowany system statusów zamówień (ZK). Twoje API musi zostać dostosowane, aby poprawnie interpretować moment, w którym stan magazynowy powinien zostać zdjęty z Allegro czy sklepu.
4. Plan bezpiecznej migracji API w 5 krokach
- Audyt obecnych rozwiązań: Spisz wszystkie punkty styku Subiekta ze światem zewnętrznym.
- Stworzenie środowiska testowego: Wykonaj kopię bazy GT, zmigruj ją do nexo na osobnym serwerze i tam testuj integracje.
- Aktualizacja warstwy Bridge: Dostosuj zapytania SQL i wywołania Sfery do nowej struktury nexo PRO.
- Testy „End-to-End”: Prześlij testowe zamówienie ze sklepu i sprawdź, czy w nexo PRO utworzył się poprawny dokument z właściwymi stawkami VAT i formami płatności.
- Przełączenie produkcyjne (Weekend): Migrację najlepiej przeprowadzić w czasie najniższego ruchu, mając przygotowany plan szybkiego powrotu (rollback) do GT w razie awarii.
5. Czy warto zostać przy Subiekcie GT tylko z powodu integracji?
Krótka odpowiedź: Nie. Zostawanie przy GT z obawy przed migracją to budowanie długu technologicznego. Nexo PRO oferuje znacznie lepsze API (Sfera dla nexo jest potężniejsza) oraz natywne wsparcie dla wielu procesów, które w GT wymagają pisania skomplikowanych obejść.
Podsumowanie: Migracja to szansa na porządki
Przejście na Subiekt nexo PRO to idealny moment, aby wyrzucić stare, powolne integratory i zastąpić je nowoczesnym REST API. Dzięki temu Twoje systemy będą nie tylko gotowe na nexo, ale także na przyszłe wyzwania, jakie przyniesie e-commerce w nadchodzących latach.
Pamiętaj: Integracje przetrwają migrację, jeśli zostaną zaplanowane jako niezależne moduły komunikujące się przez JSON, a nie sztywne połączenia z bazą danych.
FAQ – Najczęściej zadawane pytania
Czy muszę kupić nową licencję Sfera dla nexo PRO?
Tak, nexo PRO wymaga własnej licencji na Sferę, jeśli Twoje integracje mają zapisywać dane (tworzyć dokumenty) zgodnie z logiką biznesową systemu.
Ile czasu zajmuje dostosowanie API do nexo PRO?
Dla standardowego sklepu internetowego, przy wykorzystaniu architektury Bridge API, dostosowanie i testy zajmują zazwyczaj od kilku dni do dwóch tygodni, w zależności od ilości pól własnych i skomplikowania logiki rabatowej.
Czy mogę używać Subiekta GT i nexo PRO jednocześnie podczas migracji?
Nie zaleca się pracy równoległej na dwóch systemach. Migracja powinna być procesem „cięcie-wklejenie”, gdzie w poniedziałek rano cały zespół zaczyna pracę już tylko na nexo PRO. O tym jak unikać więcej błędów: https://subiektbridge.pl/integracja-subiekt-z-allegro-w-2026-roku-jak-uniknac-bledow-w-stanach-magazynowych/