
Integracja Wapro Mag z Magento 2 polega na połączeniu firmowego systemu sprzedażowo-magazynowego ze sklepem internetowym Magento Open Source lub Adobe Commerce, tak aby wymieniać zamówienia, kartoteki produktów, ceny i informacje o dostępności. W praktyce integracja wykorzystuje odpowiednio uprawniony interfejs sklepu, warstwę synchronizacji i kontrolowane operacje w środowisku Wapro Mag. Najważniejsze jest ustalenie źródła poszczególnych danych, reguł magazynowych oraz obsługi sytuacji, w których połączenie chwilowo nie działa.
W Magento nie wystarczy wysłać liczby sztuk z ERP do dowolnego pola. Sklep może pracować na wielu źródłach magazynowych, rezerwować produkty w trakcie sprzedaży i wyliczać oddzielnie ilość możliwą do zaoferowania klientowi. Zamówienie może zawierać produkt konfigurowalny, kilka typów rabatów, koszty przesyłki i wiele adresów. Dlatego dobrze zaprojektowane połączenie Wapro Mag z Magento uwzględnia zarówno technologię API, jak i reguły sprzedaży konkretnej firmy.
W tym poradniku wyjaśniamy, jak połączyć Wapro Mag z Magento 2, od wyboru sposobu komunikacji po testy przed uruchomieniem. Omawiamy REST API, magazyny MSI, produkty i warianty, przesyłanie zamówień, cenniki B2B, bezpieczeństwo oraz diagnostykę. Przykłady procesów są scenariuszami poglądowymi, a nie opisem konkretnego wdrożenia u klienta. Zakres każdego połączenia zależy od wersji sklepu, modułów i sposobu pracy Wapro Mag.
Czy Wapro Mag można zintegrować z Magento 2?
Tak, Wapro Mag i Magento 2 można połączyć za pomocą warstwy integracyjnej korzystającej z udokumentowanych interfejsów sklepu oraz kontrolowanego dostępu do środowiska ERP. Magento Open Source i odpowiednie warianty Adobe Commerce udostępniają API pozwalające zarządzać między innymi produktami i zamówieniami. To umożliwia zaprojektowanie procesu, w którym dokument sprzedaży nie jest przepisywany ręcznie z panelu sklepu, a dane magazynowe są okresowo uzgadniane z ERP.
W uproszczonym modelu klient zamawia towar w Magento, po czym integracja odczytuje jego pozycje, identyfikator, status i dane dostawy. Następnie dopasowuje produkty do kartotek Wapro Mag i wykonuje uzgodnioną operację po stronie ERP. W drugą stronę mogą wracać ceny, stany lub informacje o realizacji. Nie musi to jednak oznaczać pełnej synchronizacji każdego pola w obie strony.
Przed wyborem integratora warto wypisać, jakie działania mają być automatyczne. Inne potrzeby ma sklep z jednym magazynem i kilkuset produktami, a inne sprzedawca z kilkoma oddziałami, zestawami, grupami klientów i osobnymi witrynami. Zdecydowanie łatwiej przygotować stabilne rozwiązanie dla konkretnych procesów niż zacząć od ogólnej obietnicy „dwukierunkowego połączenia”.
Czym Magento różni się od innych platform e-commerce?
Magento jest platformą e-commerce o rozbudowanym modelu produktów, wariantów, atrybutów i procesów sprzedażowych. Występuje między innymi jako Magento Open Source i Adobe Commerce. Oba rozwiązania dzielą znaczną część technologii, ale konkretne funkcje, sposób wdrożenia i dostępne interfejsy zależą od edycji, wersji i modelu hostingu. W przypadku usługi Adobe Commerce as a Cloud Service część zasad API i uwierzytelniania jest odmienna od klasycznego wdrożenia Magento Open Source.
Dla integracji ERP ważne są nie tylko same zamówienia. Magento może prowadzić wiele sklepów internetowych w jednej instalacji, odrębne widoki językowe, osobne ceny wynikające z konfiguracji witryn oraz wielomagazynową dostępność. Wiele procesów pracuje w tle: aktualizacja indeksów, kolejki komunikatów, reguły cenowe i zadania cron. Jeśli sklep nie odświeża informacji po zapisaniu danych przez API, przyczyna może leżeć poza integratorem.
Nie zakładajmy przy tym, że każda funkcja opisana dla Adobe Commerce istnieje w Magento Open Source. Szczególnie w obszarach B2B, rozbudowanych usług chmurowych i zdarzeń integracyjnych trzeba weryfikować konkretne wydanie. Różnicę wersji należy zapisać już w dokumentacji projektu, ponieważ od niej zależy zarówno konfiguracja, jak i przyszła aktualizacja połączenia.
Po co łączyć Wapro Mag z Magento?
Najprostszy powód to oszczędność czasu przy obsłudze zamówień. Bez integracji pracownik otwiera panel Magento, sprawdza płatność, przepisuje dane kontrahenta, wyszukuje towar w ERP i ręcznie przygotowuje dokument. Kiedy zamówień przybywa, koszt tych czynności rośnie, a pomyłki mogą dotyczyć numeru indeksu, ilości lub adresu dostawy. Automatyczny import pozwala ograniczyć powtarzalne przepisywanie informacji.
Druga korzyść to spójniejsza dostępność produktów. Towar sprzedawany przez handlowca lub w sklepie stacjonarnym wpływa na stan magazynowy Wapro Mag, ale internetowy sklep nie musi wiedzieć o tej zmianie, dopóki nie otrzyma aktualizacji. Integracja pozwala przekazać do Magento odpowiednią ilość do sprzedaży z uwzględnieniem wcześniej przyjętych reguł, na przykład bufora i rezerwacji.
Trzecia korzyść wynika z centralnego zarządzania ofertą. W firmie Wapro może odpowiadać za część kartotek, cen i dokumentów, natomiast Magento za prezentację produktów, promocje i zachowanie koszyka. Dobry projekt eliminuje sytuacje, w których te same informacje są korygowane niezależnie w dwóch programach. Nie oznacza to jednak całkowitego wyeliminowania pracy człowieka: wyjątki, reklamacje i konflikty danych nadal wymagają jasno określonej procedury.
Jakie metody połączenia Magento z Wapro Mag są możliwe?
Najbardziej typową metodą jest integracja po API Magento z wykorzystaniem programu pośredniczącego. Taka warstwa może działać cyklicznie, odbierać zdarzenia z odpowiedniego rozszerzenia lub łączyć obie metody. Odpowiada za uwierzytelnianie, mapowanie towarów, rejestrowanie wykonanych operacji i ponawianie zadań po błędach. Dzięki temu sklep i ERP nie muszą znać nawzajem swojej wewnętrznej struktury.
Możliwe są również rozwiązania oparte na rozszerzeniach Magento, które eksportują dane w uzgodnionym formacie, oraz integracje plikowe używane na przykład do jednorazowego importu katalogu. Trzeba jednak rozróżniać cykliczny import pliku od bieżącej synchronizacji. Jeżeli firma potrzebuje aktualizacji zamówień przez cały dzień, ręczny eksport CSV raz na dobę raczej nie będzie równoważny z automatycznym mechanizmem wymiany danych.
ROVENS posiada dedykowaną platformę integracyjną Wapro Mag, która służy do automatyzacji wymiany danych z zewnętrznymi aplikacjami. Jeśli firma chce połączyć Wapro Mag z Magento, zakres przepływów ustala się na podstawie procesu zamówień, magazynów, cen i wymaganej aktualności danych. Istotne jest to, że platforma integracyjna jest osobną warstwą rozwiązania, a nie wbudowaną funkcją producenta Magento lub Wapro ERP.
Jak wygląda architektura integracji Wapro Mag i Magento?
W praktycznej architekturze występują trzy główne części: sklep Magento, warstwa integracyjna i środowisko Wapro Mag z bazą Microsoft SQL Server. Magento udostępnia dane za pomocą odpowiednio chronionego interfejsu. Warstwa integracyjna pobiera lub zapisuje wybrane rekordy i prowadzi ich historię. Po stronie Wapro wykonywane są uzgodnione operacje zgodne z logiką danego systemu i uprawnieniami środowiska.
Dobrze, aby komunikacja nie wymagała wystawienia portu SQL Server bezpośrednio do publicznego Internetu. Zamiast tego można wykorzystać kontrolowany konektor działający w sieci firmy, bezpieczne połączenie i uprawnienia ograniczone do niezbędnego zakresu. Ważne jest także oddzielenie dostępu technicznego od uprawnień użytkowników sklepu i księgowości. Hasło konta administratora domeny lub SQL nie powinno być przekazywane integratorowi jako uniwersalny sekret.
Warstwa pośrednicząca powinna przechowywać identyfikatory operacji, ostatni skuteczny punkt synchronizacji i szczegóły błędów. Gdy Magento odpowiada z opóźnieniem albo firmowy serwer jest niedostępny, zadania mogą pozostać w kolejce do ponowienia. Połączenie jest naprawdę użyteczne dopiero wtedy, gdy po awarii można ustalić, co zostało przetworzone, a co nadal czeka — bez zgadywania i ręcznego porównywania całego dnia sprzedaży.
REST API Magento – czym jest i jak pomaga w integracji?
REST API Magento umożliwia uprawnionym aplikacjom wykonywanie udokumentowanych operacji przez HTTP. W klasycznym Magento Open Source i Adobe Commerce PaaS występują między innymi trasy związane z produktami, zamówieniami i magazynem. Przykładowo katalog produktów można odczytywać z użyciem GET /rest/V1/products oraz parametrów wyszukiwania searchCriteria. Prawidłowy adres i zakres uprawnień zależą od konfiguracji sklepu oraz kontekstu witryny.
Ważne, aby nie traktować przykładowego adresu endpointu jako kompletnej instrukcji wdrożeniowej. W Adobe Commerce as a Cloud Service format bazowego URL i sposób uwierzytelniania różnią się od wariantu PaaS. Niektóre możliwości wymagają też odpowiednich modułów, uprawnień lub wersji instalacji. Dlatego przed integracją sprawdzamy dokumentację właściwego wydania, a nie kopiujemy przypadkowych przykładów z innego środowiska.
REST API jest szczególnie przydatne, gdy integrator musi wykonywać operacje dotyczące zaplecza: odczytywać zamówienia, identyfikować produkty po SKU lub zmieniać wybrane atrybuty. W praktyce nie każda operacja nadaje się do masowego wykonywania w tym samym momencie. Dla dużych katalogów trzeba uwzględnić stronicowanie, ograniczenia wydajnościowe, kolejkę zadań oraz proces indeksowania informacji w Magento.
REST czy GraphQL – co wybrać do połączenia ERP ze sklepem?
Magento obsługuje również GraphQL, czyli interfejs pozwalający klientowi określić strukturę potrzebnej odpowiedzi. W niektórych scenariuszach frontend sklepu korzysta z niego bardzo intensywnie. Nie należy jednak zakładać, że GraphQL udostępnia ten sam zakres operacji zaplecza administracyjnego co REST API. Integracja ERP zwykle potrzebuje możliwości z obszaru zamówień, kartotek, cen i stanów, a ich obsługa musi być zweryfikowana dla konkretnej wersji Magento.
Przy doborze interfejsu nie chodzi o popularność technologii. Dla każdego procesu przygotowuje się listę: odczyt nowego zamówienia, pobranie produktu, zapis stanu określonego źródła magazynowego, aktualizacja ceny, dopasowanie klienta. Następnie sprawdza się, który oficjalny interfejs realizuje daną operację przy odpowiednim modelu autoryzacji i akceptowalnej liczbie zapytań.
Jeżeli sklep ma własne rozszerzenia, mogą one dodawać dedykowane operacje API. Taka możliwość daje elastyczność, ale zwiększa odpowiedzialność za aktualizacje i testy regresji. Najbezpieczniej projektować integrację w oparciu o publicznie udokumentowane interfejsy, a rozwiązania niestandardowe wdrażać dopiero tam, gdzie wymagają ich rzeczywiste procesy firmy.
Jak przygotować dostęp do API Magento?
Najpierw trzeba ustalić edycję Magento, wersję, sposób hostingu i model uprawnień. W klasycznych wdrożeniach Magento Open Source i Adobe Commerce PaaS istnieje mechanizm integracji wykorzystujący OAuth 1.0a oraz tokeny dostępu. Dokumentacja Adobe rozróżnia tokeny administratorów, klientów i integracji. Ich cykl życia i przeznaczenie nie są identyczne. Dla Adobe Commerce as a Cloud Service sposób autoryzacji opiera się na usługach Adobe IMS i nie należy bez zmian stosować instrukcji przygotowanych dla klasycznego Magento.
Integracja powinna otrzymać wyłącznie uprawnienia do zasobów, które rzeczywiście obsługuje. Jeżeli ma odczytywać zamówienia i aktualizować stany, nie potrzebuje automatycznie pełnej administracji wszystkimi ustawieniami sklepu. Oddzielny dostęp techniczny ułatwia wyłączenie integracji, rotację sekretów i ustalenie, która aplikacja wykonała operację.
Przed połączeniem warto ustalić, gdzie będą przechowywane tokeny, kto będzie je odnawiał i jakie informacje wolno zapisywać w logach. Sekrety nie powinny trafiać do kodu strony publicznej, repozytorium dostępnego dla wszystkich pracowników ani niezaszyfrowanych raportów błędów. Komunikację wykonuje się przez HTTPS, a testy najlepiej prowadzić na środowisku staging, które nie generuje prawdziwych dokumentów sprzedaży.
Jakie dane należy zsynchronizować w pierwszej kolejności?
Najczęściej projekt rozpoczyna się od czterech grup danych: zamówień, produktów, cen i dostępności magazynowej. Później można rozważyć klientów, statusy realizacji, przesyłki, dokumenty, zwroty i informacje charakterystyczne dla danego modelu sprzedaży. Ważne, żeby nie uruchamiać wszystkiego naraz. Im więcej rodzajów danych zmieniają oba systemy, tym więcej trzeba przygotować zasad rozstrzygania konfliktów.
Przydatna jest macierz kierunków synchronizacji. Zamówienia zwykle trafiają ze sklepu do ERP, ale to nie znaczy, że wszystkie statusy muszą wracać w przeciwną stronę. Ceny bazowe mogą pochodzić z Wapro, natomiast kampanie promocyjne pozostać w Magento. Stany dostępne do sprzedaży mogą wynikać z Wapro i rezerwacji w różnych kanałach, ale Magento może równolegle prowadzić własne rezerwacje w mechanizmie MSI.
Dla każdej grupy danych zapisujemy: identyfikator rekordu, kierunek aktualizacji, system nadrzędny, częstotliwość, regułę ponowienia i osobę odpowiedzialną za wyjątki. Taki dokument często oszczędza więcej pracy niż samo napisanie kodu do pierwszego pobierania zamówień. Pozwala także ocenić, czy nowe wymaganie klienta jest zmianą istniejącego procesu, czy zupełnie nową funkcjonalnością.
| Dane | Typowy kierunek | Najważniejsza zasada |
|---|---|---|
| Zamówienia | Magento → Wapro Mag | Identyfikator zamówienia i ochrona przed duplikatem |
| Kartoteki produktów | Zależnie od firmy | Spójne SKU/EAN i warianty |
| Ceny bazowe | Najczęściej Wapro → Magento | Zachowanie zakresu witryn i promocji |
| Dostępność | ERP / reguły magazynowe → Magento | MSI, rezerwacje i bufor |
| Status realizacji | Zależnie od procesu | Mapowanie stanów i bezpieczne ponowienie |
| Klienci B2B | Zależnie od procesu | Identyfikatory, cenniki, ochrona danych |
Jak dopasować produkty Magento do kartotek Wapro Mag?
Podstawą jest stabilny identyfikator. W wielu projektach najważniejszą rolę pełni SKU, czyli kod produktu wykorzystywany w Magento. W Wapro Mag produkt posiada własną kartotekę i identyfikatory, a firma może dodatkowo używać symbolu, kodu kreskowego EAN lub własnego numeru katalogowego. Nie należy zakładać, że wszystkie te wartości są zawsze takie same albo unikalne w każdym wariancie towaru.
Przed synchronizacją przygotowujemy tabelę dopasowań. Zawiera ona identyfikator kartoteki Wapro, SKU Magento, ewentualny EAN, typ produktu i zakres, w którym powiązanie obowiązuje. Trzeba też określić zasady obsługi nowych produktów, zmian symboli i towarów nieaktywnych. Jeżeli jedna kartoteka z ERP odpowiada kilku ofertom sklepu, zwykłe mapowanie jeden do jednego może być niewystarczające.
Warto wprowadzić kontrolę brakujących powiązań. Jeśli zamówienie zawiera produkt nieznany integratorowi, nie powinno zostać po cichu zapisane pod przypadkowym kodem. Lepszy jest status wymagający wyjaśnienia, raport błędu i możliwość uzupełnienia mapowania. To istotne szczególnie po imporcie dużego katalogu, zmianie dostawcy towaru lub reorganizacji symboli magazynowych.
Produkty proste, konfigurowalne i zestawy w Magento – dlaczego są ważne?
W Magento produkt widoczny klientowi nie zawsze odpowiada jednej fizycznej pozycji magazynowej. Sklep może oferować produkty proste, produkty konfigurowalne z wariantami, produkty grupowane oraz zestawy typu bundle. Wariant rozmiaru lub koloru może mieć własne SKU, własny stan i odrębną pozycję w zamówieniu. Integrator powinien rozpoznać, który rekord faktycznie wpływa na magazyn, a który pełni przede wszystkim rolę prezentacyjną.
Przykładowo klient kupuje koszulkę w rozmiarze L. Na stronie może widzieć jeden produkt konfigurowalny „Koszulka”, ale konkretny wariant ma osobny kod magazynowy. Jeżeli integracja odczyta wyłącznie produkt nadrzędny, nie ustali poprawnie pozycji dokumentu. Podobny problem występuje przy zestawach, gdy sklep pozwala klientowi wybierać skład pakietu, a ERP ewidencjonuje części lub komplet jako odrębny towar.
Dlatego testy nie mogą ograniczać się do pojedynczego produktu prostego. Potrzebne są zamówienia z wariantami, rabatami, zestawami, produktami niedostępnymi i pozycjami wycofanymi z oferty. Dobrze także sprawdzić, co stanie się po zmianie SKU lub atrybutu wariantu. Dane raz dopasowane do błędnego kodu potrafią powodować problemy przez wiele kolejnych synchronizacji.
Jak synchronizować magazyn w Magento, gdy firma ma jeden magazyn?
Przy jednym magazynie schemat wydaje się prosty: Wapro Mag pokazuje ilość towaru, a integrator przesyła ją do Magento. W praktyce najpierw trzeba zdefiniować, co znaczy „ilość dostępna”. Czy sprzedawca chce udostępniać wszystkie sztuki fizycznie zapisane w magazynie, czy odjąć towar już zarezerwowany, przeznaczony na wydania lub sprzedawany równolegle w innych kanałach? Każda z tych definicji może dać inną liczbę.
Druga kwestia to moment aktualizacji. Magento może przyjąć zamówienie kilka sekund po ostatnim odczycie stanu Wapro, a w tym samym czasie handlowiec może sprzedać ostatnią sztukę bezpośrednio w ERP. Samo ustawienie synchronizacji co minutę zmniejsza ryzyko rozbieżności, lecz go nie eliminuje. Z tego powodu w wielu sklepach stosuje się bufor magazynowy, zasady rezerwacji lub blokadę sprzedaży wybranych produktów, gdy ilość jest bardzo mała.
Warto też przetestować proces odwrotny: co się dzieje przy anulowaniu zamówienia, zwrocie lub korekcie dokumentu. Jeżeli integrator odejmie ilość dwukrotnie albo zignoruje anulowanie, stan wyświetlany klientom będzie stopniowo odbiegał od rzeczywistości. Prawidłowy monitoring powinien wskazywać takie rozbieżności, a nie tylko informować, że ostatnie żądanie API zakończyło się kodem HTTP 200.
Magento MSI – czym są Sources, Stocks i Salable Quantity?
Multi Source Inventory (MSI) to mechanizm magazynowy Magento, który pozwala zarządzać dostępnością produktów w jednej lub wielu lokalizacjach. Source oznacza źródło zapasu, na przykład magazyn w Warszawie. Stock jest logicznym zbiorem źródeł przypisanym do odpowiedniego kanału sprzedaży. Salable Quantity określa ilość, którą system uznaje za dostępną do sprzedaży, uwzględniając zasady rezerwacji i konfigurację zapasów. Pojęcia te nie są zamienne.
Właśnie tu łatwo popełnić kosztowny błąd: przesłać do Magento stan fizyczny z Wapro Mag tak, jakby automatycznie był równy ilości możliwej do sprzedaży. Tymczasem Magento może już mieć rezerwacje wynikające z zamówień, a część towaru może być przypisana do innych źródeł. Dwa sklepy korzystające z jednej infrastruktury nie muszą też oferować klientom tej samej puli produktów.
Przy projektowaniu integracji należy ustalić, czy Magento działa w trybie pojedynczego źródła, czy korzysta z MSI z wieloma źródłami. W modelu wielomagazynowym potrzebna jest tabela powiązań magazynów Wapro z odpowiednimi źródłami Magento. Przepisanie sumy ze wszystkich magazynów do jednego domyślnego źródła może prowadzić do błędnej dostępności. Dodatkowo trzeba określić, gdzie wykonywany jest wybór miejsca realizacji zamówienia i kto odpowiada za przesunięcia magazynowe.
Dlaczego Salable Quantity może różnić się od ilości w Wapro Mag?
Przykładowo magazyn ma fizycznie 20 sztuk produktu. W Magento znajdują się dwa przyjęte zamówienia, dla których zapisano łącznie rezerwację 4 sztuk. W uproszczonym scenariuszu ilość możliwa do sprzedaży może wynosić 16, mimo że ilość fizyczna nadal wynosi 20. To nie jest automatycznie błąd synchronizacji: różnica wynika z tego, że oba systemy opisują inny etap procesu.
Sytuacja komplikuje się, gdy Wapro Mag sam prowadzi rezerwacje, firma sprzedaje przez kilka kanałów, a Magento ma własną logikę dostępności. Integrator musi wiedzieć, gdzie rezerwacja powstaje i kiedy jest zwalniana. Jeżeli ta sama sprzedaż obniża dostępność niezależnie w obu systemach, łatwo o podwójne odliczenie. Jeżeli nie robi tego nigdzie, sklep może oferować towar, który w praktyce nie jest już dostępny.
Dla każdego produktu należy zdefiniować liczbowy model: ilość fizyczna, rezerwacje, bufor bezpieczeństwa, stan do publikacji i ewentualne dopuszczenie zamówień ponad stan. Powinien on być opisany prostym przykładem liczbowym i przetestowany dla anulowania, wydania oraz zwrotu. Jeśli magazyn i sklep wyliczają różne miary, porównywanie ich jako dwóch identycznych liczb da fałszywe alarmy.
Jak połączyć kilka magazynów Wapro Mag z Magento?
Firma mająca centralę, punkt odbioru i magazyn zewnętrzny często chce zarządzać dostępnością inaczej niż pojedynczy sklep. Część towaru może być dostępna tylko dla zamówień realizowanych z magazynu głównego, a część może pochodzić z lokalizacji, która nie obsługuje wysyłek kurierskich. Samo zsumowanie stanów z Wapro Mag nie odpowiada wtedy na pytanie, co naprawdę można sprzedać klientowi internetowemu.
Pierwszym krokiem jest mapa magazynów i źródeł. Dla każdej lokalizacji trzeba określić, jakie towary zawiera, czy obsługuje sprzedaż online, czy realizuje wysyłki, jakie są czasy dostawy oraz jak traktowane są przesunięcia. Następnie ustala się odwzorowanie tej struktury na model Sources i Stocks Magento. Nie wszystkie procesy ERP muszą mieć bezpośredni odpowiednik w konfiguracji MSI.
Ważny jest również proces kompletacji i wydania. Zamówienie może być widoczne w Magento jako możliwe do realizacji z kilku źródeł, ale finalny dokument i rezerwacja w Wapro mogą wymagać wskazania jednego konkretnego magazynu. Trzeba określić, czy wybór lokalizacji następuje w sklepie, integratorze, Wapro czy dopiero u magazyniera. Bez tego nawet poprawnie działające API będzie przesyłało dane, z którymi pracownicy nie potrafią jednoznacznie postępować.
Jak przesyłać zamówienia Magento do Wapro Mag?
Proces importu rozpoczyna się od ustalenia, które zamówienia kwalifikują się do przekazania. Jedna firma importuje nowe zamówienia natychmiast po złożeniu, inna dopiero po potwierdzeniu płatności, a jeszcze inna po pozytywnej weryfikacji dostępności. Status pending lub processing ma znaczenie w kontekście konfiguracji sklepu i metody płatności; nie należy automatycznie przyjmować, że jeden status oznacza dla każdej firmy gotowość do utworzenia dokumentu w ERP.
Integracja powinna pobrać identyfikator zamówienia, dane klienta, adresy, walutę, metodę dostawy, płatność, pozycje i rabaty. Następnie musi dopasować SKU do kartotek Wapro, a reguły dokumentowania sprzedaży uzgodnić z firmą. W różnych środowiskach rezultat może oznaczać utworzenie zamówienia, rezerwacji lub dokumentu wykorzystywanego w dalszym procesie. Nie należy bez analizy automatycznie generować faktury dla każdego zamówienia internetowego.
Po wykonaniu operacji integrator zapisuje powiązanie identyfikatora zamówienia sklepowego z dokumentem Wapro oraz wynik przetwarzania. Jeśli dokument nie może powstać z powodu nieznanego towaru, brakującego kontrahenta lub błędnego VAT, powinien pojawić się komunikat pozwalający pracownikowi rozwiązać problem. Nieudane operacje muszą być widoczne w raporcie, a nie znikać tylko dlatego, że pozostałe zamówienia zostały przyjęte.
Jak uniknąć podwójnego importu zamówień z Magento?
Podwójny dokument może powstać nawet przy poprawnie działającym sklepie. Integrator wysyła żądanie do środowiska Wapro, dokument jest tworzony, ale przed odebraniem odpowiedzi połączenie zostaje przerwane. Program ponawia operację i, jeśli nie rozpoznaje poprzedniego wyniku, tworzy drugi dokument. Inny scenariusz to równoczesny import harmonogramowy i ponowne przetwarzanie zadania z kolejki.
Dlatego nie wystarczy sprawdzać, czy aktualne wywołanie API zwróciło błąd. Potrzebny jest trwały rejestr identyfikatorów zamówień, statusu ich obsługi i numeru dokumentu w Wapro. Przed zapisem należy zweryfikować, czy rekord został już pomyślnie przetworzony. Jeżeli wynik poprzedniej próby jest niepewny, integrator powinien najpierw go uzgodnić, a dopiero potem podjąć decyzję o ponowieniu operacji.
Dobrą praktyką jest też blokada równoległego przetwarzania tego samego identyfikatora, rozdzielenie błędów tymczasowych od trwałych i wyznaczenie limitu prób. Problem z połączeniem może uzasadniać ponowienie po czasie, ale nieznane SKU wymaga zwykle naprawy danych. Rozwiązanie, które bez końca próbuje importować błędny produkt, może nadmiernie obciążać system i ukrywać rzeczywisty problem.
Ceny w Magento i Wapro Mag – które powinny być nadrzędne?
Cena produktu może wynikać z cennika bazowego Wapro Mag, warunków indywidualnych klienta, promocji w Magento albo kombinacji tych elementów. Zanim uruchomimy synchronizację, trzeba ustalić, które wartości mogą być nadpisywane. Jeśli integrator ustawia cenę bazową po każdej zmianie w ERP, nie musi to oznaczać, że wolno mu usuwać rabat koszykowy lub promocję zaplanowaną wyłącznie w sklepie.
Magento operuje różnymi zakresami konfiguracji, w tym sklepami i widokami, a zachowanie cen zależy od edycji i ustawień. Firma działająca na kilku rynkach może mieć odrębne waluty lub polityki cenowe. Wapro Mag może natomiast korzystać z wielu cenników i rabatów. Połączenie nie polega więc wyłącznie na przesłaniu wartości liczbowej, lecz na zdefiniowaniu relacji między grupami klientów, cennikami i kontekstem danej witryny.
Trzeba też określić sposób zaokrąglania, przeliczania VAT oraz kolejność stosowania rabatów. Różnica kilku groszy może być dla klienta nieistotna, ale dla dokumentu księgowego wymaga wyjaśnienia. Testy powinny obejmować cenę regularną, promocję, produkt z wariantami, zamówienie w innej walucie i przypadek zmiany ceny między dodaniem produktu do koszyka a finalizacją zamówienia.
Czy Magento obsługuje sprzedaż B2B i cenniki firmowe?
Sprzedaż B2B może obejmować inne reguły niż klasyczne zamówienie konsumenta. Klient hurtowy może mieć własne rabaty, progi cenowe, ograniczenia kredytowe, terminy płatności albo wymaganą akceptację zamówienia. Część zaawansowanych funkcji B2B wiąże się z określonymi wydaniami Adobe Commerce lub dodatkowymi modułami, więc nie należy przypisywać ich automatycznie każdemu sklepowi Magento Open Source.
W integracji z Wapro Mag podstawowe pytanie brzmi: gdzie znajdują się wiarygodne dane handlowe klienta? Firma może prowadzić kontrahentów, limity i indywidualne cenniki w ERP, ale sklep musi wiedzieć, jaką ofertę pokazać zalogowanemu odbiorcy. W takim przypadku potrzebne jest mapowanie identyfikatorów kontrahentów i zasad przypisywania uprawnień, a nie tylko mechanizm wysyłający cennik do całego katalogu.
Warto rozdzielić dane potrzebne do wyświetlania oferty od danych wymaganych przy wystawianiu dokumentu. Nie wszystkie informacje o rozliczeniach klienta muszą być przesyłane do sklepu. Zasada minimalizacji danych, przejrzystość uprawnień i możliwość wyłączenia dostępu po zakończeniu współpracy są równie istotne jak poprawne obliczenie ceny. Dobrze przygotowane rozwiązanie nie ujawnia danych kontrahenta innym użytkownikom przez źle skonfigurowane API.
Płatności, dostawy i statusy zamówień – jak je mapować?
Sklep może oferować płatność kartą, szybkim przelewem, przelewem tradycyjnym i pobraniem. Z perspektywy Wapro Mag te metody nie zawsze przekładają się wprost na sposób rozliczenia dokumentu. Integrator powinien odróżniać metodę płatności zadeklarowaną przez klienta od potwierdzonego wyniku transakcji. Samo złożenie zamówienia w Magento nie musi oznaczać, że pieniądze wpłynęły.
Podobnie jest z dostawą. Wybór kuriera lub punktu odbioru w Magento należy przełożyć na odpowiedni sposób realizacji w firmie. Czasem trzeba też przekazać dodatkowe dane, na przykład identyfikator punktu odbioru, numer telefonu odbiorcy lub uwagę do zamówienia. Puste pole w takim miejscu może uniemożliwić przygotowanie etykiety, mimo że import dokumentu do ERP wydawał się poprawny.
Mapowanie statusów powinno być zapisane jako tabela, nie jako domysł wykonawcy. „Wysłano” po stronie sklepu nie zawsze znaczy to samo co „wystawiono dokument WZ” w ERP. Warto ograniczyć synchronizację do stanów, dla których firma ma jasną procedurę oraz możliwość cofnięcia błędnej informacji. Przy zmianach statusów trzeba też pamiętać o duplikatach zdarzeń i powtarzających się aktualizacjach.
Jak obsługiwać zwroty i anulowanie zamówienia?
Zwrot towaru nie jest po prostu zamówieniem z ujemną ilością. Może wystąpić zwrot całkowity, częściowy, reklamacja, wymiana produktu lub anulowanie jeszcze przed wydaniem. Każdy z tych procesów ma inne skutki dla stanu magazynowego, rozliczeń i dokumentów w ERP. Dlatego integracja, która poprawnie importuje sprzedaż, nie staje się automatycznie pełnym systemem obsługi zwrotów.
W Magento zwrot może wiązać się z operacjami rozliczeniowymi i zmianą statusu. Po stronie Wapro trzeba określić, czy towar ma wrócić na stan, do którego magazynu, w jakim stanie jakościowym i na podstawie jakiego dokumentu. Samo zdarzenie zwrotu środków klientowi nie powinno bezwarunkowo zwiększać dostępności produktu w sklepie, ponieważ zwrócony przedmiot może wymagać weryfikacji lub nie nadawać się do ponownej sprzedaży.
Najlepiej rozdzielić etap informacji o zwrocie, potwierdzenie fizycznego przyjęcia produktu oraz korektę dokumentów handlowych. Integrator może pomagać w przekazywaniu statusu lub danych, ale zakres automatyzacji powinien odpowiadać procedurze firmy. Przed uruchomieniem warto przetestować przypadek zwrotu jednej pozycji z wielopozycyjnego zamówienia i anulowanie po częściowej realizacji.
Cron, indeksowanie i kolejki Magento – dlaczego wpływają na integrację?
Magento wykonuje wiele zadań w tle. Mechanizm cron uruchamia między innymi czynności związane z odświeżaniem indeksów, regułami cen i innymi operacjami sklepu. Indexery przygotowują dane, które mają być szybko wykorzystywane przez frontend oraz wyszukiwarkę. Z tego powodu aktualizacja produktu przez API nie zawsze oznacza, że klient w tej samej chwili zobaczy zmianę na stronie. Mogą mieć znaczenie kolejki, harmonogram indeksacji i cache.
Jeżeli w Magento aktualizujemy tysiące cen, trzeba uwzględnić możliwości serwera, sposób indeksowania i częstotliwość przesyłania partii danych. Przesyłanie całego katalogu co minutę może być niepotrzebnie kosztowne. Często lepszy jest mechanizm przekazujący tylko zmienione rekordy, z okresowym pełnym uzgodnieniem. Musi on jednak radzić sobie z pominiętymi zmianami i przypadkiem odtworzenia stanu po przerwie.
Przy problemach z aktualizacją nie wystarczy zobaczyć, że integrator „wysłał ceny”. Warto sprawdzić, czy zapis został przyjęty przez właściwy interfejs, czy indeksy zostały przeliczone, czy zadania cron działają i czy sklep nie pokazuje starej wersji z pamięci podręcznej. Dokumentacja Adobe potwierdza, że błędna konfiguracja cron i indexerów może zaburzać działanie procesów sklepu.
Czy Magento ma API masowych i asynchronicznych operacji?
W klasycznych wdrożeniach Adobe Commerce i Magento dostępne są mechanizmy asynchronicznych oraz zbiorczych operacji API. W odpowiednich konfiguracjach żądania mogą trafiać do kolejki, a odpowiedzialny proces przetwarza je później. Odpowiedź przyjęcia operacji nie jest więc równoznaczna z zakończeniem aktualizacji wszystkich produktów. Integrator musi umieć odczytać końcowy wynik i zgłosić rekordy, których przetwarzanie się nie powiodło.
To szczególnie ważne przy dużych zmianach cen lub stanów, kiedy synchroniczne wysyłanie pojedynczych żądań mogłoby nadmiernie obciążać sklep. Przed wyborem rozwiązania należy jednak sprawdzić, jakie mechanizmy są dostępne w konkretnej instalacji i czy poprawnie działają konsumenci kolejek. W niektórych konfiguracjach wymagane są dodatkowe usługi infrastrukturalne, a zakres dostępnych endpointów różni się pomiędzy modelami Adobe Commerce.
Nie warto uruchamiać operacji masowych tylko dlatego, że brzmią nowocześnie. Jeśli firma aktualizuje kilkadziesiąt rekordów dziennie, prostszy mechanizm może być łatwiejszy do monitorowania. Jeśli jednak liczba produktów liczona jest w dziesiątkach tysięcy, planowanie partii, limitów i uzgadniania wyników staje się istotną częścią architektury.
Czy można używać webhooków do synchronizacji Magento z Wapro?
Wiele integracji sklepów działa na zasadzie powiadomień o zdarzeniach: gdy pojawia się zamówienie, sklep wysyła komunikat do systemu zewnętrznego. Nie należy jednak bez sprawdzenia zakładać, że każde standardowe wdrożenie Magento Open Source ma gotowe, uniwersalne webhooki dla wszystkich potrzebnych operacji. Dokumentacja podstawowego frameworka Web API Magento nie opisuje natywnych webhooków jako ogólnej funkcji; osobne możliwości zdarzeń mogą być dostępne w rozwiązaniach Adobe Commerce lub dodatkowych rozszerzeniach.
W praktyce możliwe są co najmniej dwa podejścia. Pierwsze to odpytywanie API o nowe i zmienione rekordy z użyciem odpowiedniego kursora lub daty aktualizacji. Drugie to komunikacja zdarzeniowa, o ile dany sklep posiada udokumentowany mechanizm jej realizacji. Można również połączyć oba sposoby: zdarzenie przyspiesza reakcję, a okresowe uzgadnianie wykrywa zmiany pominięte podczas awarii połączenia.
Niezależnie od sposobu powiadomienia niezbędne jest sprawdzenie idempotentności. To samo zdarzenie może zostać obsłużone ponownie, a wiadomości mogą dotrzeć z opóźnieniem lub w innej kolejności. Logika integracyjna powinna więc odczytywać aktualny stan zamówienia, a nie bezkrytycznie wykonywać wszystkie otrzymane akcje. Dzięki temu awaria Internetu nie zmienia się automatycznie w duplikat dokumentu lub nieprawidłową rezerwację towaru.
Jak często aktualizować produkty, ceny i stany?
Nie istnieje jeden interwał odpowiedni dla wszystkich sklepów. Zamówienia mogą wymagać częstszego odczytu niż pełna lista produktów. Ceny zmieniają się zazwyczaj inaczej niż stan zapasu na szybko rotującym towarze. Jeśli firma ma kilka kanałów sprzedaży, aktualność dostępności może być kluczowa, ale bardzo częste przepisywanie całego katalogu może przeciążać środowisko Magento.
Warto rozdzielić zadania według wagi i kosztu. Nowe zamówienia powinny trafiać do systemu z kontrolowanym opóźnieniem, które odpowiada potrzebom obsługi klienta. Aktualizacje stanów mogą dotyczyć tylko produktów zmienionych od poprzedniej synchronizacji. Duże przebudowy katalogu można wykonywać poza okresem największego ruchu. Niezależnie od harmonogramu potrzebne jest okresowe uzgadnianie pełniejszych danych, aby odnaleźć rekordy pominięte przy wcześniejszej awarii.
Dobrą miarą działania nie jest sama liczba wykonanych zapytań, lecz maksymalny wiek informacji pokazywanej klientowi. Jeżeli deklarujemy aktualność stanów, trzeba umieć sprawdzić datę ostatniej udanej synchronizacji dla konkretnego produktu. Dwa zielone wskaźniki dostępności serwerów nie powiedzą nam, że od trzech godzin żadne zamówienie nie dotarło do ERP.
Najczęstsze problemy przy integracji Wapro Mag z Magento
Dużą grupę problemów stanowią błędy mapowania: produkt o innym SKU, wariant niepowiązany z kartoteką, inny identyfikator magazynu albo brakująca grupa podatkowa. Druga grupa dotyczy stanu zamówienia: dokument był już zapisany, ale system próbuje go utworzyć ponownie, albo pojawiają się zmiany statusu, których nie przewidziano podczas projektu. Trzecia obejmuje przeciążenie i utrudnioną komunikację API.
W Magento dochodzą kwestie charakterystyczne dla platformy: rezerwacje MSI, zakres konfiguracji store view, indeksacja i pamięć podręczna. Może się zdarzyć, że API przyjęło nową cenę, a klient nadal widzi poprzednią. Wtedy badamy nie tylko log integratora, ale również stan indeksów, cron i cache. Podobnie rozbieżność między quantity a salable quantity nie zawsze wynika z awarii, bo te wartości opisują różne rzeczy.
W diagnozie pomaga prosta procedura: zidentyfikować problematyczny produkt lub zamówienie, ustalić system źródłowy, sprawdzić mapowanie, historię synchronizacji i odpowiedź API, a następnie zweryfikować wynik po stronie sklepu i ERP. Zmianę na produkcji wykonujemy dopiero po potwierdzeniu przyczyny. Ręczne przestawianie liczby w panelu może chwilowo ukryć objaw, nie usuwając błędnej reguły integracji.
| Objaw | Co sprawdzić najpierw | Możliwy dalszy krok |
|---|---|---|
| Towar ma inną dostępność w sklepie | MSI, rezerwacje, źródło i bufor | Uzgodnić model stanu do sprzedaży |
| Zamówienie nie pojawia się w Wapro | Status kwalifikacji, SKU, logi | Naprawić dane i bezpiecznie ponowić |
| Powstają dwa dokumenty | Rejestr ID i równoległe przetwarzanie | Wprowadzić kontrolę idempotencji |
| Cena zapisana, lecz niewidoczna | Zakres sklepu, indeksy, cache | Skontrolować harmonogram indeksacji |
| API zwraca odmowę dostępu | Model auth, uprawnienia, token | Skorygować zakres dostępu |
| Masowe aktualizacje trwają długo | Kolejki, indexery, wielkość partii | Przejść na zmiany przyrostowe |
Jak zabezpieczyć Magento, Wapro i dane klientów?
Integracja ERP ze sklepem internetowym przetwarza informacje, które mają wartość biznesową i mogą zawierać dane osobowe. Trzeba więc zadbać o połączenie szyfrowane, kontrolę uprawnień, ochronę tokenów oraz rejestrowanie operacji administracyjnych. Nie należy przechowywać haseł i kluczy w publicznym kodzie sklepu ani w logach, do których dostęp ma cała organizacja. Szczególnie niebezpieczne jest udostępnianie bazy SQL Server do Internetu bez potrzeby i odpowiedniej kontroli.
Dostęp do API Magento powinien należeć do osobnego konta lub integracji z właściwym zakresem uprawnień. Po stronie Wapro potrzebny jest analogiczny podział odpowiedzialności: konektor wykonuje operacje wymagane przez proces, a nie posiada przypadkowo pełnego dostępu administracyjnego do całej infrastruktury. Warto przewidzieć możliwość szybkiego zablokowania połączenia, jeśli token zostanie ujawniony lub pojawi się nieautoryzowana operacja.
Ochrona obejmuje również bezpieczeństwo samych danych. Backup musi pozwalać na odtworzenie sklepu i systemu ERP w spójnym stanie, a zmiany w integracji powinny być testowane przed produkcją. W przypadku błędu synchronizacji trzeba móc ustalić, jakie rekordy zostały zmodyfikowane. Samo zaszyfrowanie tunelu nie zastąpi mechanizmów walidacji, kontroli dokumentów i odpowiedniego monitorowania operacji.
Jak przetestować integrację przed uruchomieniem na produkcji?
Testy powinny odtwarzać typowe i nietypowe sytuacje biznesowe. Nie wystarczy pobrać przykładowego produktu i jednego zamówienia bez rabatu. Przygotujmy scenariusze obejmujące warianty, klienta firmowego, kilka magazynów, płatność niepotwierdzoną, częściowy zwrot, zmianę ceny, produkt wycofany i brak dopasowania SKU. W każdym przypadku ustalamy oczekiwany wynik po obu stronach oraz sposób rozpoznania błędu.
Druga grupa testów dotyczy odporności. Warto przerwać dostęp do API na określony czas, zasymulować brak odpowiedzi serwera firmowego i sprawdzić, czy zamówienie nie znika z kolejki. Następnie powtarzamy to samo zadanie, aby ocenić, czy nie powstaje duplikat. Dla masowych aktualizacji testujemy obciążenie, działanie kolejek i opóźnienie od zapisu przez API do widoczności zmian w sklepie.
Przed wdrożeniem produkcyjnym potrzebny jest plan wyłączenia nowej synchronizacji, sposób cofnięcia zmian i ustalenie okresu obserwacji. Dobrą praktyką jest uruchomienie najpierw tylko odczytu i raportów, następnie ograniczonej liczby zapisów, a dopiero na końcu pełnej automatyzacji. Pozwala to wykrywać konflikty i nieprzewidziane zachowania, zanim zaczną wpływać na całą sprzedaż.
Ile kosztuje integracja Wapro Mag z Magento?
Koszt zależy od zakresu danych, liczby sklepów, wielkości katalogu, struktury magazynów i poziomu skomplikowania procesów. Połączenie importujące tylko zamówienia będzie innym przedsięwzięciem niż rozwiązanie aktualizujące kilkadziesiąt tysięcy SKU, synchronizujące wiele cen oraz obsługujące MSI, zwroty i sprzedaż B2B. Znaczenie mają także niestandardowe rozszerzenia Magento i konfiguracja Wapro Mag.
Wycena nie powinna obejmować wyłącznie napisania mechanizmu pobrania danych. W realnym wdrożeniu potrzebne są też mapowanie, testy, ochrona przed duplikatami, rejestrowanie błędów, bezpieczeństwo, konfiguracja środowiska i plan późniejszych aktualizacji. Jeśli sklep już działa, należy przewidzieć sprawdzenie zgodności z jego bieżącymi modułami oraz potencjalne okno serwisowe przy zmianach technicznych.
Warto rozdzielić koszt uruchomienia od kosztu bieżącej opieki i infrastruktury. Długoterminowo znaczenie ma nie tylko najniższa cena początkowa, lecz także sposób aktualizacji po zmianach Magento, możliwość odtworzenia synchronizacji i czas potrzebny na wyjaśnienie problemów. ROVENS może pomóc w doborze zakresu połączenia i przygotowaniu wyceny na podstawie opisanych procesów sprzedaży i magazynu.
Jak przygotować firmę do integracji Magento z Wapro Mag?
Zanim zaczniemy konfigurację techniczną, warto spisać listę sklepów, magazynów i systemów wykorzystywanych przez pracowników. Następnie wskazujemy właścicieli danych: kto odpowiada za katalog produktów, kto zatwierdza cenniki, kto rozwiązuje problemy z zamówieniami i kto zajmuje się serwerem Wapro. Taki podział ogranicza sytuacje, w których po wdrożeniu każdy zakłada, że błędem zajmuje się ktoś inny.
Przygotowujemy także przykładowe dane testowe. Powinny znaleźć się wśród nich produkty zwykłe i wariantowe, kilka rodzajów płatności, rabaty, adresy krajowe i zagraniczne, kontrahenci oraz przypadki braków magazynowych. Jeśli firma posiada wiele magazynów, potrzebna jest lista ich odpowiedników w Magento. Dla każdego pola ustalamy, czy jest obowiązkowe i skąd pochodzi.
Po stronie infrastruktury sprawdzamy wersję Magento, konfigurację API, środowisko testowe, stan cron i indexerów oraz możliwość bezpiecznej komunikacji z Wapro Mag. Dopiero po takim przeglądzie można rozsądnie ustalić kolejność uruchamiania procesów i oszacować ryzyko przestoju. Zbieranie tych informacji nie oznacza konieczności przebudowy całej infrastruktury; chodzi o zaprojektowanie integracji zgodnej z tym, jak firma naprawdę działa.
Przykład: firma sprzedająca w Magento z dwóch magazynów
Wyobraźmy sobie firmę, która posiada magazyn centralny i mniejszy punkt lokalny. Wapro Mag zapisuje stany w dwóch magazynach, a Magento oferuje towary klientom sklepu. Firma chce automatycznie importować opłacone zamówienia i pokazywać dostępność tylko tych sztuk, które można wysłać w przyjętym terminie. Jest to scenariusz poglądowy, nie opis rzeczywistej realizacji ROVENS.
Najpierw firma określa, które magazyny Wapro mają być uwzględniane w ofercie internetowej. Następnie mapuje je na odpowiednią strukturę MSI Magento albo przyjmuje prostszy model agregacji, jeśli tak wynika z procesu realizacji. Zapisuje również zasady bufora, rezerwacji i wyboru źródła wysyłki. W kolejnej fazie integrator pobiera zamówienia o właściwym statusie, dopasowuje SKU i tworzy uzgodniony dokument w ERP, pamiętając identyfikator zamówienia sklepowego.
Po uruchomieniu firma mierzy liczbę skutecznie przekazanych zamówień, czas opóźnienia oraz rozbieżności stanów. Jeżeli jeden z magazynów staje się niedostępny, reguły powinny określić, czy jego zapas wycofujemy z oferty. Taki scenariusz pokazuje, że największą wartością nie jest samo wywołanie API, lecz poprawne przełożenie procesów sprzedaży na działanie dwóch systemów.
Lista kontrolna przed uruchomieniem integracji Wapro Mag – Magento
Przydatna checklista pozwala porównać gotowość techniczną z wymaganiami biznesowymi. Każdą pozycję należy potwierdzić w środowisku konkretnej firmy, a nie tylko zaznaczyć na podstawie zapewnienia, że „systemy mają API”. Jeśli test zakończy się niepowodzeniem, potrzebna jest osoba odpowiedzialna za naprawę i ponowne sprawdzenie.
- Potwierdzono wersję Magento Open Source lub Adobe Commerce oraz model hostingu.
- Sprawdzono dokumentację odpowiedniej wersji API i uprawnienia techniczne.
- Ustalono źródło prawdy dla produktów, cen, zamówień i magazynów.
- Przygotowano mapowanie SKU, wariantów, identyfikatorów towarów i magazynów.
- Zdefiniowano rezerwacje, bufor i sposób wyliczania dostępności MSI.
- Ustalono, które statusy zamówień uruchamiają import do Wapro Mag.
- Zdefiniowano dokumenty tworzone po stronie ERP i zasady rozliczeń.
- Sprawdzono, czy integracja nie tworzy duplikatów przy ponowieniu zadania.
- Przetestowano awarię API, SQL Server i łącza internetowego.
- Zweryfikowano stan indeksów, działania cron oraz kolejek Magento.
- Ustalono zasady ochrony tokenów, logów i dostępu do bazy danych.
- Przygotowano monitoring, plan wyłączenia i sposób uzgadniania danych.
Czy ROVENS pomaga zintegrować Wapro Mag z Magento?
ROVENS posiada dedykowaną platformę integracyjną Wapro Mag, przeznaczoną do automatyzacji wymiany danych między systemem ERP a zewnętrznymi aplikacjami. Jeżeli chcesz połączyć Wapro Mag z Magento, możesz przedstawić nam sposób działania sklepu, liczbę magazynów oraz zakres danych, które mają być synchronizowane. Na tej podstawie można dobrać odpowiedni model komunikacji i ustalić wymagania wdrożenia.
Przy takiej integracji ważna jest wiedza o obu stronach procesu: konfiguracji Magento i zasadach prowadzenia magazynu oraz dokumentów w Wapro Mag. Sam dostęp do REST API nie rozstrzyga, jak obsługiwać MSI, produkty konfigurowalne, promocje czy anulowania zamówień. Właśnie te elementy należy uzgodnić przed automatyzacją sprzedaży.
Jeśli interesuje Cię taki zakres prac, poznaj ofertę integracji Wapro Mag ROVENS. Możesz również przeczytać poradniki Co to jest REST API? i Co to jest automatyzacja?, które wyjaśniają podstawy wymiany danych między systemami. Do przedstawienia potrzeb wystarczy krótki opis sklepu, magazynu i czynności, które dziś trzeba wykonywać ręcznie.
Najczęściej zadawane pytania o integrację Wapro Mag z Magento (FAQ)
Czy Magento 2 można połączyć z Wapro Mag bez ręcznego importu CSV?
Tak. Integracja może wykorzystać API i odpowiednio zaprojektowaną warstwę synchronizacji, dzięki czemu dane są przekazywane automatycznie. Zakres automatyzacji trzeba jednak uzgodnić — import zamówień, aktualizacja cen i obsługa wielu magazynów to osobne procesy.
Czy integracja Wapro Mag z Magento działa dwukierunkowo?
Może obejmować przepływy w obu kierunkach, na przykład zamówienia z Magento do Wapro oraz stany magazynowe z Wapro do Magento. Nie oznacza to konieczności synchronizacji każdego pola w obie strony. Dla każdego rodzaju danych należy wskazać system nadrzędny.
Jakie API wykorzystuje Magento 2?
Magento Open Source i odpowiednie wersje Adobe Commerce udostępniają między innymi REST API i GraphQL. Do operacji zaplecza ERP często wykorzystuje się REST, ale dostępność konkretnych funkcji zależy od wersji, edycji i modelu hostingu.
Czy Magento i Adobe Commerce to dokładnie to samo?
Nie. Magento Open Source i Adobe Commerce mają wspólne podstawy technologiczne, lecz różnią się funkcjami, licencjonowaniem i zależnie od wdrożenia także zasadami korzystania z API. Przed integracją należy ustalić, z którym środowiskiem pracujemy.
Czy można synchronizować kilka magazynów Wapro Mag z Magento?
Tak, ale wymaga to zaplanowania mapowania magazynów i źródeł MSI. Trzeba określić, które lokalizacje są dostępne dla sprzedaży internetowej i jak obsługiwane są rezerwacje oraz wybór magazynu realizującego zamówienie.
Dlaczego stan fizyczny różni się od Salable Quantity?
Magento może uwzględniać rezerwacje i inne reguły dostępności. W rezultacie ilość fizyczna produktu i liczba możliwa do sprzedaży mogą być różne. Nie powinno się ich uzgadniać przez bezwarunkowe nadpisywanie jednej wartości drugą.
Czy Wapro Mag może być źródłem cen dla Magento?
Tak, jeśli taki model przyjmie firma. Należy jednak osobno ustalić, jak zachowują się promocje, cenniki B2B, grupy klientów, waluty i zakresy witryn. Nadpisywanie wszystkich cen bez rozróżnienia może powodować błędną ofertę.
Czy zamówienia z Magento mogą trafiać automatycznie do Wapro?
Tak. Integrator może pobierać zamówienia spełniające uzgodnione warunki i tworzyć odpowiednie dokumenty lub rekordy po stronie Wapro Mag. Ważne jest mapowanie produktów, statusów płatności oraz zabezpieczenie przed utworzeniem tego samego dokumentu dwa razy.
Czy można importować produkty konfigurowalne i warianty?
Tak, jeśli integracja uwzględnia ich strukturę. Wariant kupowany przez klienta może mieć własny SKU, dlatego nie należy bez sprawdzenia mapować wszystkich pozycji do produktu nadrzędnego. Trzeba przetestować także zestawy i produkty grupowane.
Czy po zmianie stanu w Wapro sklep od razu go pokaże?
Nie zawsze. Zależy to od częstotliwości synchronizacji, przetwarzania API, indeksacji i pamięci podręcznej Magento. Właściwy proces powinien umożliwiać sprawdzenie czasu ostatniej udanej aktualizacji.
Czy integracja automatycznie obsłuży zwroty i reklamacje?
Nie musi. Zwroty, anulowania i reklamacje wymagają odrębnych reguł dokumentowych i magazynowych. Można je objąć integracją, ale powinny być osobno opisane i przetestowane.
Czy w Magento trzeba udostępnić hasło administratora do integracji?
Nie powinno się przekazywać uniwersalnego hasła administratora jako jedynego sposobu dostępu. Należy zastosować właściwy mechanizm autoryzacji API oraz ograniczyć uprawnienia zgodnie z potrzebami aplikacji i wersją Magento.
Czy baza SQL Server Wapro musi być publicznie dostępna?
Nie. Bezpieczna architektura może korzystać z konektora w środowisku firmy i kontrolowanej komunikacji. Publiczne wystawianie portu SQL Server tylko z powodu integracji sklepu nie jest właściwym domyślnym rozwiązaniem.
Co zrobić, gdy Magento nie aktualizuje cen mimo odpowiedzi API?
Trzeba sprawdzić wynik operacji, zakres sklepu lub widoku, działanie indexerów, cron i cache. Kod potwierdzający przyjęcie żądania nie zawsze dowodzi, że klient widzi już nową wartość na stronie sklepu.
Czy integracja Magento z Wapro może działać przy przerwie Internetu?
W czasie przerwy komunikacja może być wstrzymana, ale dobrze zaprojektowana integracja zachowuje historię oczekujących zadań i potrafi bezpiecznie wznowić pracę. Ważne, aby po przywróceniu łączności nie tworzyć duplikatów zamówień.
Czy da się zintegrować Magento z kilkoma cennikami Wapro Mag?
Można zaplanować takie rozwiązanie, lecz wymaga ono mapowania grup klientów, zakresów cen i reguł promocji. Dostępność niektórych funkcji B2B zależy od edycji Magento i zainstalowanych modułów.
Czy aktualizacja Magento może wpłynąć na działanie integracji?
Tak. Aktualizacje platformy, zmiany API, wersji modułów i sposobu autoryzacji mogą wymagać testów. Dlatego warto utrzymywać środowisko testowe i planować aktualizacje sklepu razem z opieką nad integracją.
Ile trwa wdrożenie integracji Wapro Mag z Magento?
Czas zależy od zakresu danych, liczby magazynów, ilości produktów, dodatkowych rozszerzeń i jakości danych wejściowych. Prosty przepływ zamówień jest innym zadaniem niż rozbudowana synchronizacja MSI, cenników i procesów B2B. Harmonogram ustala się po analizie.
Czy Magento można połączyć także z innymi aplikacjami firmy?
Tak. W zależności od dostępnych interfejsów i potrzeb można projektować wymianę danych z systemami logistycznymi, magazynowymi lub firmowymi aplikacjami. Warto jednak unikać tworzenia kilku niezależnych mechanizmów, które bez uzgodnienia aktualizują te same pola produktu.
Jak zapytać ROVENS o integrację Magento z Wapro Mag?
Wystarczy opisać wersję Magento, liczbę sklepów i magazynów, przybliżoną liczbę produktów oraz proces, który ma działać automatycznie. ROVENS posiada dedykowaną platformę integracyjną Wapro Mag. Informacje o zakresie usług znajdują się na stronie Integracja Wapro Mag.
Podsumowanie: jak bezpiecznie połączyć Magento z Wapro Mag?
Integracja Wapro Mag z Magento 2 jest możliwa przez odpowiednio dobrany mechanizm komunikacji z API sklepu i środowiskiem ERP. O powodzeniu wdrożenia decyduje jednak nie liczba endpointów, lecz poprawne dopasowanie SKU, zamówień, cen, magazynów i reguł dostępności. W Magento szczególnego znaczenia nabierają MSI, Salable Quantity, rezerwacje, indeksowanie i praca z wieloma sklepami.
Najlepiej rozpocząć od mapy procesów, następnie uruchomić ograniczony zakres synchronizacji, przetestować błędy i dopiero potem zwiększać automatyzację. W ten sposób rozwiązanie ma szansę wspierać sprzedaż firmy, zamiast przenosić problemy z jednego systemu do drugiego.










