Jak zintegrować Wapro Mag ze Sky-Shop? Synchronizacja zamówień, produktów, cen i stanów magazynowych

Opublikowano — Dodaj komentarz

Integracja Wapro Mag ze Sky-Shop polega na połączeniu systemu sprzedażowo-magazynowego z platformą sklepu internetowego, aby dane o zamówieniach, produktach, cenach i dostępności towarów mogły być wymieniane automatycznie, bez ręcznego przepisywania informacji. Jedną z możliwych dróg technicznych jest wykorzystanie WebAPI Sky-Shop i odpowiednio przygotowanej warstwy integracyjnej komunikującej się z Wapro Mag. Samo uzyskanie klucza API nie wystarcza jednak do poprawnej synchronizacji: trzeba jeszcze ustalić kierunki wymiany danych, dopasowanie kartotek i zasady obsługi błędów.

W firmie, która sprzedaje równocześnie przez sklep internetowy i obsługuje magazyn w Wapro Mag, nawet niewielka rozbieżność może powodować realne straty. Pracownik widzi w programie pięć sztuk produktu, sklep pokazuje dziewięć, a po przyjęciu kolejnego zamówienia okazuje się, że towar jest już zarezerwowany. Integracja powinna ograniczać takie sytuacje, a nie tylko kopiować liczby pomiędzy systemami.

W tym poradniku wyjaśniamy, jak połączyć Wapro Mag ze Sky-Shop, jakie funkcje udostępnia platforma sklepu, skąd pobrać klucz WebAPI, jak zaplanować import zamówień i synchronizację magazynu oraz jakie testy przeprowadzić przed uruchomieniem. Rozróżniamy funkcje udokumentowane przez Sky-Shop od przykładowych reguł, które należy zaprojektować w konkretnym wdrożeniu. Artykuł nie jest instrukcją obsługi jednego gotowego modułu — pokazuje sposób przygotowania poprawnej integracji dwóch systemów.

W artykule przeczytasz o:

Czy Wapro Mag można zintegrować ze Sky-Shop?

Tak, połączenie Wapro Mag ze Sky-Shop jest możliwe, jeśli środowisko Wapro, pakiet sklepu i wybrany sposób wymiany danych pozwalają zrealizować wymagane operacje. Sky-Shop udostępnia WebAPI do komunikacji z aplikacjami zewnętrznymi, a integracja po stronie ERP może być obsługiwana przez odpowiedni konektor i platformę pośredniczącą. Nie oznacza to, że każda funkcja dostępna w panelu sklepu musi mieć identyczny odpowiednik w API albo że każde wdrożenie synchronizuje wszystkie dane w obie strony.

W najczęstszym modelu Wapro Mag odpowiada za kartotekę i gospodarkę magazynową, natomiast Sky-Shop obsługuje prezentację produktów, koszyk i składanie zamówień. Integracja pobiera zamówienia ze sklepu, przygotowuje dane zgodne z regułami ERP, a następnie przekazuje do sklepu uzgodnioną dostępność towarów oraz ceny. Można również przewidzieć inne przepływy, ale ich zakres należy potwierdzić w dokumentacji używanych systemów i w analizie procesu klienta.

Czasem właściciel sklepu chce tylko pobierać nowe zamówienia do Wapro. W innej firmie konieczna jest jednoczesna aktualizacja kilku cenników i oddzielnych magazynów. Nie należy zakładać, że te dwa przypadki wymagają takiej samej konfiguracji, kosztu czy częstotliwości synchronizacji. Skuteczność połączenia zależy przede wszystkim od ustalenia, jakie dane mają być nadrzędne i jaki wynik biznesowy ma dawać każda operacja.

Jakie problemy rozwiązuje integracja Wapro Mag ze Sky-Shop?

Pierwszym problemem jest ręczne przepisywanie zamówień. Pracownik loguje się do sklepu, otwiera zamówienie, kopiuje dane klienta, wyszukuje indeksy w Wapro i tworzy dokument. Kiedy zamówień jest kilka dziennie, bywa to do opanowania. Przy kilkudziesięciu dziennie rośnie koszt czasu, liczba pomyłek i ryzyko pominięcia pozycji. Integracja może zamienić tę sekwencję na kontrolowany proces automatycznego pobierania danych, z obsługą wyjątków.

Drugim problemem jest niespójność stanów. Przykładowo sprzedajesz towar również telefonicznie, a wydanie z magazynu rejestrujesz wyłącznie w Wapro. Jeśli sklep nie otrzyma aktualnej informacji, nadal pozwoli na zakup ilości, której nie da się zrealizować. Nie zawsze wystarczy przekazać fizyczny stan magazynowy — trzeba uwzględnić rezerwacje, bufor bezpieczeństwa i inne kanały sprzedaży.

Trzecim problemem są ceny i promocje. Firma zmienia cennik hurtowy lub detaliczny w ERP, lecz w Sky-Shop pozostają poprzednie wartości. Z kolei promocja ustawiona w sklepie może zostać przypadkowo nadpisana przez automatyczną aktualizację. Dlatego integracja powinna jasno wskazywać, kto jest właścicielem ceny bazowej, kto zarządza rabatami i czy określone produkty są wyłączone z synchronizacji.

Czwarty problem dotyczy kontroli procesu. Samo istnienie połączenia nie mówi, czy wszystkie zamówienia faktycznie dotarły do ERP. Potrzebny jest dziennik przetwarzania, możliwość ponowienia operacji, identyfikacja duplikatów i powiadomienie w razie błędu. Dobre połączenie systemów powinno ułatwiać ustalenie, co się wydarzyło, a nie tylko wykonywać działania w tle.

Co to jest WebAPI Sky-Shop i jak działa?

WebAPI Sky-Shop to udostępniany przez platformę interfejs pozwalający aplikacjom zewnętrznym komunikować się ze sklepem. Według materiałów producenta funkcjonalność API zależy od pakietu sklepu. Dokumentację można otworzyć z panelu administracyjnego, a producent wskazuje również adres sklepu z końcówką /api jako miejsce dostępu do dokumentacji interfejsu. Przed wdrożeniem warto upewnić się, że wybrany abonament obejmuje operacje potrzebne w danym projekcie.

Sky-Shop dokumentuje używanie metod GET i POST oraz podaje limit jednego wywołania API na sekundę. Jest to ważna, praktyczna różnica względem innych platform e-commerce. Jeśli integrator próbuje w krótkim czasie wysłać tysiące osobnych żądań, może przekroczyć dozwoloną częstotliwość. Mechanizm synchronizacji powinien więc planować kolejkę żądań i dostosowywać tempo do aktualnie obowiązujących reguł. Przed produkcyjnym wdrożeniem sprawdza się dokumentację przypisaną do konkretnego sklepu, ponieważ interfejs i limity mogą się zmieniać.

Dostęp do WebAPI nie oznacza bezpośredniego dostępu do bazy danych serwera Sky-Shop. Aplikacja zewnętrzna wykonuje operacje dozwolone przez udostępniony interfejs, korzystając z adresu sklepu i klucza. Z tego powodu projekt integracji musi uwzględniać sposób pobierania rekordów, dostępne filtry, obsługiwane modyfikacje i ograniczenia odpowiedzi. Nie należy odtwarzać nieudokumentowanych endpointów ani zakładać, że nazwy pól są identyczne w różnych wersjach API.

Gdzie znaleźć klucz WebAPI w panelu Sky-Shop?

Producent opisuje konkretną ścieżkę: Integracje → Web API sklepu. W tym miejscu znajduje się pole z kluczem dostępu i przycisk prowadzący do dokumentacji API. Można korzystać z wygenerowanego klucza lub skonfigurować własną wartość, zgodnie z instrukcją Sky-Shop. Po zmianach trzeba je zapisać. Nie ma potrzeby udostępniania integratorowi głównego hasła administratora sklepu tylko po to, żeby uzyskać dostęp do API.

Sky-Shop pozwala wskazać kilka kluczy rozdzielonych przecinkami. To przydatne, gdy sklep jest połączony z kilkoma zewnętrznymi usługami: można nadać osobny klucz integracji ERP, a następnie usunąć tylko ten klucz, gdy połączenie zostanie wyłączone. Trzeba przy tym pamiętać, że sam fakt posiadania osobnych kluczy nie przesądza o szczegółowych uprawnieniach do pojedynczych zasobów; dostępne mechanizmy ograniczeń należy sprawdzić w dokumentacji producenta.

Klucz API jest sekretem. Nie powinien trafiać do treści artykułu, publicznego repozytorium, zrzutu ekranu wysłanego bez zabezpieczeń ani do otwartego pliku JavaScript w przeglądarce klienta. Integracja powinna przechowywać go po stronie serwera lub w bezpiecznym magazynie sekretów, ograniczać dostęp administratorów i umożliwiać wymianę klucza w razie podejrzenia ujawnienia.

Przed podłączeniem produkcji warto przygotować listę kontrolną: poprawny adres własnego sklepu, dostępność WebAPI w pakiecie, klucz przeznaczony dla integratora, dokumentacja wymaganych metod, możliwość odczytania testowych danych i procedura wyłączenia połączenia. Takie przygotowanie zajmuje mniej czasu niż późniejsze szukanie przyczyny błędu wśród kilkunastu systemów.

Jak wygląda architektura połączenia Sky-Shop z Wapro Mag?

Typowa architektura ma trzy logiczne części: sklep Sky-Shop, warstwę integracyjną oraz środowisko Wapro Mag z bazą SQL Server. Sklep udostępnia operacje przez WebAPI. Warstwa integracyjna odpowiada za pobranie danych, mapowanie, harmonogram, kontrolę błędów i przekazywanie danych. Wapro Mag pozostaje programem, w którym firma obsługuje sprzedaż i magazyn zgodnie ze swoją konfiguracją.

W przypadku platformy ROVENS po stronie firmy działa konektor komunikujący się ze środowiskiem Wapro, a platforma integracyjna umożliwia wymianę informacji z zewnętrznymi aplikacjami. To rozdziela obsługę lokalnego systemu ERP od komunikacji z usługą internetową. ROVENS posiada dedykowaną platformę integracyjną Wapro Mag — sposób wykorzystania jej do konkretnego sklepu ustala się zgodnie z wymaganiami przedsiębiorstwa.

Przepływ informacji nie musi być symetryczny. Zamówienie może iść ze Sky-Shop do ERP, stan i cena z ERP do sklepu, a numer przesyłki wracać do sklepu po nadaniu paczki. Każdy kierunek wymaga osobnych reguł, uprawnień, identyfikatorów i obsługi błędów. Określenie „integracja dwukierunkowa” bez wskazania, które dane są dwukierunkowe, bywa mylące — statusy, ceny i dokumenty mogą mieć różnych właścicieli.

Ważna jest także kolejność operacji. Jeśli dokument sprzedaży w Wapro powstaje dopiero po zatwierdzeniu płatności, integrator nie powinien importować każdego rozpoczętego koszyka. Jeśli magazyn w firmie rezerwuje produkt już po złożeniu zamówienia, sklep może potrzebować innej liczby dostępnych sztuk niż fizyczna ilość na półce. Architektura techniczna musi realizować te zasady, a nie zastępować je przypadkową synchronizacją wszystkich pól.

Jakie dane warto synchronizować między Wapro Mag a Sky-Shop?

Nie każde przedsiębiorstwo musi przenosić wszystkie dostępne informacje. Dla większości sklepów priorytetem są zamówienia, dostępność towaru i ceny. Kartoteki produktów oraz kontrahentów mogą być synchronizowane w szerszym lub ograniczonym zakresie, zależnie od tego, gdzie są tworzone i kto nimi zarządza. Można też rozważyć statusy realizacji, dane wysyłkowe i numer przesyłki, jeśli konkretna metoda API oraz proces firmy to obsługują.

Rodzaj danychTypowy kierunekCo trzeba uzgodnić
ZamówieniaSky-Shop → Wapro MagKiedy pobierać, jak eliminować duplikaty, które statusy importować
Stany magazynoweWapro Mag → Sky-ShopMagazyny źródłowe, rezerwacje, bufor, częstotliwość
CenyWapro Mag → Sky-ShopCennik, VAT, brutto/netto, promocje i zaokrąglenia
ProduktyWedług modelu firmyIdentyfikatory, warianty, opisy, zdjęcia, kategorie
KontrahenciZwykle wraz z zamówieniemOsoba/firma, NIP, adres, zgodność pól
Status realizacjiZależnie od procesuMapowanie statusów i moment wysłania zmiany
Dane przewozoweZależnie od projektuKurier, numer przesyłki, identyfikator paczki

Tabela pokazuje typowy projektowany przepływ danych, a nie obietnicę, że każdy element jest udostępniany identycznie we wszystkich pakietach i wersjach Sky-Shop. Ostateczne możliwości należy zweryfikować w dokumentacji API używanego sklepu i w zakresie wybranego rozwiązania integracyjnego.

Największą korzyścią dobrze dobranego zakresu jest przewidywalność. Jeśli zdjęcia i treści marketingowe są opracowywane w panelu Sky-Shop, nie ma sensu nadpisywać ich podczas każdej aktualizacji ceny. Jeśli Wapro pozostaje źródłem dostępności magazynowej, pracownik nie powinien ręcznie ustawiać tam innego stanu tylko po to, żeby ukryć produkt. Integracja działa sprawniej, gdy wiadomo, które pola można modyfikować z której strony.

Jak przenieść zamówienia ze Sky-Shop do Wapro Mag?

Import zamówień wygląda na prostą operację: odczytaj nowe zamówienie, a następnie zapisz je w ERP. W rzeczywistości zawiera kilka decyzji biznesowych. Najpierw trzeba wybrać moment importu. Czy zamówienie ma trafić do Wapro natychmiast po złożeniu? Dopiero po opłaceniu? A może po ręcznym zatwierdzeniu przez obsługę sklepu? Wybór wpływa na dostępność towaru, dokumenty magazynowe i liczbę zamówień wymagających anulowania.

Po pobraniu zamówienia integracja musi zidentyfikować produkty. Kod towaru w Sky-Shop może różnić się od numeru artykułu w Wapro Mag. Dlatego warto utrzymywać tabelę powiązań pomiędzy trwałym identyfikatorem produktu w sklepie a kartoteką w ERP. Nie powinno się opierać dopasowania jedynie na nazwie, ponieważ nazwy mogą zawierać dopiski marketingowe, różne rozmiary lub być zmieniane bez wiedzy działu magazynowego.

Następny krok to dane kupującego. Zamówienie osoby fizycznej ma inny zestaw informacji niż zakup na firmę. W procesie trzeba ustalić zasady tworzenia i aktualizowania kontrahenta, przypisywania NIP-u, korzystania z adresu dostawy oraz obsługi gości bez konta. Integracja powinna ograniczać tworzenie zbędnych duplikatów kartotek, ale nie może też automatycznie łączyć odrębnych klientów na podstawie pojedynczego podobnego pola.

Ważne są koszty wysyłki i płatności. Kwota dostawy może wymagać przypisania do usługi, pozycji dokumentu albo osobnego pola — zgodnie z konfiguracją systemu i zasadami księgowymi firmy. Zamówienie z pobraniem nie jest tym samym co zamówienie opłacone online. Integrator powinien przenieść odpowiednie informacje, ale nie może samodzielnie nadawać dokumentom niewłaściwych statusów finansowych.

Ostatecznie proces zapisuje identyfikator zamówienia w sklepie i powiązany identyfikator dokumentu lub operacji w ERP. Dzięki temu można sprawdzić, czy import się udał, uniknąć duplikatu po ponownej próbie oraz prześledzić historię konkretnego zgłoszenia klienta. Poprawny import to nie samo przesłanie treści zamówienia, lecz potwierdzenie uzyskania oczekiwanego wyniku w Wapro Mag.

Co zrobić, żeby jedno zamówienie nie trafiło do Wapro dwa razy?

Duplikaty pojawiają się zwykle przy błędach komunikacji. Integracja wysyła zamówienie do ERP, ERP je zapisuje, ale odpowiedź nie dociera z powrotem. Po chwili mechanizm ponawia wysyłkę, bo uważa pierwszą próbę za nieudaną. Jeśli proces nie sprawdza wcześniejszego wyniku, powstaje drugi dokument. Problem może wystąpić nawet wtedy, gdy oba systemy działają poprawnie, a zawodzi jedynie połączenie w najgorszym możliwym momencie.

Podstawową ochroną jest utrwalanie identyfikatora źródłowego zamówienia oraz stanu przetwarzania. Przed utworzeniem nowego dokumentu należy sprawdzić, czy dane zamówienie nie zostało już wcześniej obsłużone. Dobrze jest przechowywać również numer dokumentu w Wapro, datę ostatniej próby, wynik i komunikat błędu. Jeśli zamówienie wymaga ręcznego dokończenia, administrator powinien móc zobaczyć te informacje bez przeszukiwania całej bazy danych.

W technice integracyjnej taki problem łączy się z idempotentnością, czyli projektowaniem operacji tak, aby bezpieczne ponowienie tej samej czynności nie powodowało dodatkowego, niezamierzonego skutku. Nie zawsze można to zagwarantować jednym parametrem API. Czasem konieczny jest rejestr własnych operacji, dodatkowa walidacja lub mechanizm uzgadniania danych pomiędzy systemami.

Nie wolno zakładać, że każde połączenie zwróci odpowiedź w oczekiwanym czasie. Zdarzają się przerwy internetu, aktualizacje usług, blokady danych i okresowe błędy API. Integrator powinien odróżniać sytuację „na pewno nie wykonano” od sytuacji „nie wiadomo, czy wykonano”. Przy tej drugiej bezwarunkowe ponowienie zapisu jest szczególnie ryzykowne. Bezpieczna obsługa może wymagać wcześniejszego odczytu aktualnego stanu zamówienia lub weryfikacji dokumentu w ERP.

Jak synchronizować stany magazynowe Wapro Mag ze Sky-Shop?

W synchronizacji magazynu najważniejsze jest określenie, co oznacza „dostępna ilość”. Firma może mieć 20 sztuk produktu na stanie fizycznym, ale 12 sztuk jest już zarezerwowanych pod zamówienia hurtowe. Jeśli sklep pokazuje 20, może przyjąć sprzedaż, której magazyn nie zrealizuje. Jeżeli pokaże 8, wynik będzie bliższy realnej dostępności, ale trzeba jeszcze rozważyć, czy część zapasu powinna pozostać poza sprzedażą internetową.

Przykładowa reguła może wyglądać następująco: ilość oferowana w sklepie = stan przyjęty do sprzedaży – rezerwacje – uzgodniony bufor bezpieczeństwa, z dolnym ograniczeniem do zera. To przykład reguły biznesowej, a nie automatyczny wzór obowiązujący w każdym Wapro. W praktyce dostępne są różne typy stanów, kilka magazynów, ruchy między magazynowe i inne operacje, które trzeba rozważyć podczas konfiguracji.

Szczególnie istotny jest przypadek towaru sprzedawanego równolegle w sklepie, punkcie stacjonarnym i zamówieniach telefonicznych. Integracja aktualizująca stan raz na dobę może nie wystarczyć. Z drugiej strony przy ograniczeniu API do jednego wywołania na sekundę nie zawsze opłaca się wysyłać aktualizację każdego produktu natychmiast po dowolnym ruchu magazynowym. Warto grupować zmiany, korzystać z obsługiwanych przez interfejs mechanizmów efektywnego pobierania i priorytetyzować produkty, których dostępność rzeczywiście się zmieniła.

Dobrym rozwiązaniem organizacyjnym jest regularna kontrola zgodności. Na przykład raz dziennie można porównać wybrany zestaw indeksów w obu systemach, oznaczyć nietypowe różnice i wskazać źródło problemu. Samo cykliczne wysyłanie nowych stanów może ukrywać błędy — produkt z niewłaściwym mapowaniem będzie otrzymywał aktualizację, ale nadal nie do tego rekordu, do którego powinien.

Warto też z góry ustalić zachowanie dla zera sztuk. Czy produkt ma pozostać widoczny jako niedostępny, czy zostać ukryty? Czy dopuszczalne są zamówienia przedsprzedażowe? To decyzje handlowe i zależą od konfiguracji sklepu oraz jego możliwości API. Integracja powinna odzwierciedlać przyjętą politykę sprzedaży, a nie wymuszać jeden wariant na wszystkie produkty.

Kilka magazynów w Wapro Mag – który stan pokazać klientowi?

Wapro Mag może obsługiwać firmę mającą więcej niż jeden magazyn, podczas gdy sklep internetowy prezentuje prostą informację o dostępności produktu. Trzeba wtedy zdecydować, czy stan dla Sky-Shop ma pochodzić z magazynu centralnego, z sumy kilku wybranych lokalizacji, czy z magazynu przeznaczonego wyłącznie do realizacji sprzedaży internetowej.

Sumowanie magazynów bywa atrakcyjne, ale nie zawsze prawidłowe. Jeśli produkt znajduje się w oddalonym oddziale, klient może oczekiwać szybkiej wysyłki z centrali, a przeniesienie towaru zajmie dwa dni. Wtedy sama suma sztuk w całej firmie nie oddaje faktycznej możliwości realizacji zamówienia. Warto więc ustalić osobne reguły udostępniania zapasu i przewidywanego czasu realizacji.

Przy rozbudowanej strukturze można podzielić towary na grupy: dostępne od ręki, wymagające przesunięcia oraz sprowadzane na zamówienie. Możliwe jest również ograniczenie synchronizacji tylko do indeksów przypisanych do konkretnego sklepu. Takie reguły powinny być wyraźnie zapisane w dokumentacji wdrożenia, aby po zmianie magazyniera czy administratora firma nadal rozumiała, skąd biorą się ilości widoczne dla klientów.

Niezależnie od wybranego modelu należy przetestować przyjęcie towaru, sprzedaż, zwrot, rezerwację i przesunięcie między magazynami. Właśnie te operacje pokazują, czy algorytm obliczania dostępności jest zgodny z praktyką firmy. Bez testów można otrzymać poprawną technicznie aktualizację API, która z punktu widzenia obsługi sklepu daje nieprawidłową liczbę.

Jak połączyć produkty Wapro Mag z kartoteką Sky-Shop?

Najczęstszy problem produktowy polega na braku wspólnego identyfikatora. Produkt może mieć w Wapro symbol wewnętrzny, a w sklepie osobny identyfikator platformy, kod dostawcy i EAN. Jeden z tych identyfikatorów powinien służyć do pierwszego rozpoznania rekordu, ale ostatecznie najlepiej przechowywać trwałe powiązanie pomiędzy identyfikatorem z obu systemów.

EAN nie zawsze jest dobrym jedynym kluczem. W niektórych kartotekach nie występuje, bywa wprowadzony błędnie albo jest współdzielony między jednostkami handlowymi. Podobnie SKU może zostać zmieniony po reorganizacji nazewnictwa towarów. Integracja powinna mieć procedurę obsługi niejednoznacznych dopasowań i nie może automatycznie scalać produktów wyłącznie dlatego, że ich nazwy są podobne.

Warto odróżnić utworzenie produktu od aktualizacji istniejącego produktu. Sklep internetowy może przechowywać rozbudowany opis marketingowy, zdjęcia, warianty, metadane SEO i relacje kategorii. Jeżeli ERP jest źródłem jedynie symbolu, ceny i dostępności, synchronizacja nie powinna nadpisywać pozostałych pól. To jeden z najważniejszych wymogów bezpieczeństwa danych handlowych w integracji e-commerce.

Dla firm z dużą liczbą produktów przydatny jest raport pozycji bez mapowania. Pokazuje on towary obecne w Wapro, których nie znaleziono w sklepie, i odwrotnie. Administrator może wtedy zdecydować, czy brak powiązania oznacza błąd, produkt wyłączony ze sprzedaży lub jeszcze nieopublikowaną nowość. Wyraźne rozróżnienie tych sytuacji ogranicza zbędne alarmy i przypadkowe tworzenie duplikatów ofert.

Jak obsługiwać warianty produktów, rozmiary i zestawy?

Odzież, części zamienne czy wyposażenie często występują w kilku wariantach. Jeden produkt widoczny dla kupującego może mieć osobne rozmiary i kolory, a każdy z nich własną dostępność. W ERP wariant może być oddzielną kartoteką, cechą artykułu albo elementem przyjętej struktury magazynowej. Integracja musi znać tę różnicę i poprawnie łączyć identyfikatory na poziomie wariantu, a nie wyłącznie nazwy głównego produktu.

Przykładowo klient wybiera koszulkę w rozmiarze L. Jeśli integrator rozpoznaje tylko produkt „Koszulka”, może zaktualizować niewłaściwy stan, przypisać błędny indeks albo utworzyć nieprawidłową pozycję zamówienia. Dlatego testy powinny obejmować każdy model wariantowania używany w sklepie, zwłaszcza przypadki z osobnymi kodami, cenami lub kodami kreskowymi.

Osobną kategorią są zestawy produktów. Sklep może sprzedawać komplet składający się z trzech artykułów, natomiast magazyn prowadzi ich stany oddzielnie. Jeśli integrator ma obsługiwać zestawy, trzeba zdefiniować sposób rozbijania kompletu na składniki lub wskazania właściwej kartoteki zestawu. Bez tego zamówienie może być pozornie poprawne, lecz nie obniży stanów odpowiednich elementów.

Warto również przetestować zwrot pojedynczego składnika zestawu, wymianę wariantu i sytuację, gdy jedna pozycja zostaje wycofana z oferty. Takie wyjątki często ujawniają ograniczenia gotowych rozwiązań. Własna platforma integracyjna daje możliwość zaprojektowania odpowiednich reguł, ale ich sens zależy od rzeczywistych możliwości systemów i modelu biznesowego sklepu.

Jak synchronizować ceny Wapro Mag i Sky-Shop bez nadpisywania promocji?

Synchronizacja cen wymaga ustalenia źródła prawdy. Jeśli podstawowy cennik jest utrzymywany w Wapro Mag, integracja może przekazywać jego wartości do sklepu. Jeśli jednak część promocji powstaje wyłącznie w Sky-Shop, nie wolno bezwarunkowo nadpisywać cen promocyjnych za każdym razem, gdy aktualizuje się stan magazynowy. Cena podstawowa i mechanizm promocji to dwa różne obszary odpowiedzialności.

Następny problem dotyczy wartości netto i brutto. ERP może operować na cenach netto dla określonych grup odbiorców, a sklep wyświetla ceny konsumenckie z podatkiem. Uzgodnienie powinno wskazywać, która wartość jest przesyłana, gdzie następuje przeliczenie VAT, jak zaokrąglać grosze i co zrobić w przypadku różnych stawek. Nie warto opierać całej integracji na przypadkowym pomnożeniu netto przez 1,23, ponieważ różne towary i transakcje mogą podlegać innym zasadom.

Dodatkowym wyzwaniem są cenniki indywidualne. Firma może mieć osobne ceny hurtowe i detaliczne, rabaty dla kontrahentów lub warunki zależne od wielkości zamówienia. Jeśli sklep korzysta z takich mechanizmów, integracja powinna przesyłać właściwą cenę do właściwego kontekstu. Nie należy zakładać, że zwykłe pole ceny katalogowej w API automatycznie obsłuży wszystkie scenariusze B2B.

Bezpieczna konfiguracja pozwala wyłączyć wybrane produkty z aktualizacji cen, określić akceptowalny zakres zmiany i zapisywać historię modyfikacji. Dzięki temu przypadkowy import cennika z błędnym przecinkiem dziesiętnym nie musi od razu spowodować publikacji nieprawidłowych ofert. Przy dużych zmianach cen przydatny bywa test na małej grupie towarów przed synchronizacją całej kartoteki.

Integracja Sky-Shop z hurtownią a integracja z Wapro Mag – jaka jest różnica?

To szczególnie ważny temat, bo Sky-Shop ma własne funkcje integracji z hurtowniami. Według dokumentacji producenta mechanizm ten pozwala pobierać informacje produktowe z plików dostawcy, zwykle XML lub CSV, a następnie aktualizować wybrane dane, w tym ceny i stany. Jest to jednak inny proces niż synchronizacja sklepu z firmowym ERP. Hurtownia publikuje ofertę dostawcy, natomiast Wapro Mag może reprezentować rzeczywiste zasoby i dokumenty przedsiębiorstwa.

Wyobraźmy sobie sklep, który pobiera katalog hurtowni do Sky-Shop, ale zamówienia klientów rozlicza w Wapro. Pojawia się pytanie, kto aktualizuje stany: plik hurtowni czy ERP? Jeśli oba mechanizmy mają prawo nadpisywać tę samą wartość, sklep może w różnych godzinach pokazywać inne ilości. Podobny konflikt dotyczy cen, nazw i dostępności produktów wycofanych przez dostawcę.

Rozwiązaniem jest ustalenie właściciela pola. Katalog i zdjęcia mogą pochodzić z hurtowni, a dostępność własnego magazynu i zamówienia z Wapro. W innym modelu firma sprzedaje wyłącznie w dropshippingu i ilości pochodzą od dostawcy. W takim przypadku Wapro nadal może obsługiwać dokumenty, ale nie powinno bez uzasadnienia nadpisywać informacji o zewnętrznym zapasie.

Warto osobno opisać sytuację, w której produkt występuje w magazynie własnym i u dostawcy. Trzeba określić, czy klient widzi sumę dostępności, wyłącznie własny stan, czy dwa terminy realizacji. Tego nie rozstrzyga sama obecność API. Decyzja należy do procesu sprzedażowego i wymaga uzgodnienia w projekcie integracyjnym.

Jak zaplanować synchronizację przy limicie WebAPI Sky-Shop?

Producent Sky-Shop podaje limit jednego wywołania WebAPI na sekundę. To parametr, który trzeba uwzględnić już podczas projektowania integracji. Przykładowo tysiąc odrębnych żądań wykonywanych kolejno, z odstępem jednej sekundy, zajmie co najmniej około 17 minut — nawet bez uwzględnienia opóźnień sieciowych, przetwarzania odpowiedzi i dodatkowych odczytów. Jest to matematyczny przykład, a nie prognoza wydajności konkretnego wdrożenia.

W praktyce warto odróżnić pełny import początkowy od synchronizacji przyrostowej. Przy pierwszym uruchomieniu trzeba często powiązać dużą liczbę produktów. Po zakończeniu wdrożenia codzienne operacje powinny w miarę możliwości obejmować jedynie dane zmienione od poprzedniej synchronizacji albo pozycje wytypowane na podstawie uzgodnionego harmonogramu. Zakres dostępnych filtrów i metod pobierania wynika z dokumentacji API, dlatego nie można z góry zakładać istnienia dowolnego mechanizmu „pobierz wszystkie zmiany od godziny X”.

Dobra kolejka nie traktuje wszystkich operacji identycznie. Nowe zamówienie klienta zwykle ma większy priorytet niż odświeżenie opisu produktu, który nie był modyfikowany od miesiąca. Podobnie aktualizacja dostępności szybko sprzedającego się towaru może wymagać szybszego przetworzenia niż synchronizacja kategorii. Priorytety należy zaprojektować tak, aby pojedynczy duży import nie blokował na długo bieżącej sprzedaży.

Mechanizm powinien też posiadać kontrolę ponowień i opóźnień. Jeśli sklep zwróci błąd przejściowy, zadanie może zostać odłożone, zamiast powtarzać żądanie w pętli. Jeśli błąd wynika z nieprawidłowego klucza albo brakującego produktu, natychmiastowe ponawianie niczego nie naprawi. Dlatego potrzebne są różne kategorie błędów: autoryzacja, dane, konfiguracja, limit częstotliwości i niedostępność usługi.

Szczególnej uwagi wymagają równoległe procesy integracyjne. Jeśli dwa niezależne moduły korzystają z tego samego sklepu, każdy może przestrzegać własnego odstępu jednej sekundy, a łącznie przekroczą limit usługi. Rozwiązaniem może być centralne zarządzanie kolejką żądań do konkretnego sklepu. To znacznie bezpieczniejsze niż przypadkowe uruchomienie wielu harmonogramów bez koordynacji.

Czy integracja musi działać w czasie rzeczywistym?

Sformułowanie „synchronizacja w czasie rzeczywistym” często pojawia się w opisach integracji, ale bywa rozumiane zbyt dosłownie. W praktyce systemy mogą pracować asynchronicznie, z krótkim opóźnieniem wynikającym z harmonogramu, kolejkowania lub ograniczeń interfejsu. Automatyczne przekazywanie danych nie zawsze oznacza aktualizację w tej samej sekundzie, w której zmiana została zapisana w ERP.

Warto więc określić akceptowalne opóźnienie biznesowe dla każdego typu informacji. Nowe zamówienia można przetwarzać z wyższym priorytetem, dostępność aktualizować możliwie często w granicach API, a opisy produktów odświeżać znacznie rzadziej. Taka polityka wykorzystuje ograniczone zasoby komunikacji na operacje najbardziej wpływające na realizację sprzedaży.

Nie mniej ważna jest przejrzystość. Panel administracyjny lub raport integracyjny powinien pokazywać czas ostatniej udanej synchronizacji i liczbę oczekujących zadań. Dzięki temu pracownik nie musi zgadywać, czy towar jest dostępny od pięciu minut, czy od ostatniego dnia. Ustalenie realnego czasu aktualizacji danych jest bardziej użyteczne niż marketingowe zapewnienie o „natychmiastowości” bez określonej miary.

Jak mapować statusy zamówień, płatności i dostaw?

Sky-Shop i Wapro Mag nie muszą posługiwać się takimi samymi nazwami i etapami obsługi zamówienia. Status „nowe” w sklepie może oznaczać, że klient właśnie złożył zamówienie, ale nie ukończył płatności. W firmie z kolei zamówienie może przechodzić przez zatwierdzenie, rezerwację, kompletację, wystawienie dokumentu i wydanie. Integracja nie powinna utożsamiać różnych etapów tylko dlatego, że ich nazwy są podobne.

Najlepiej przygotować mapę statusów z opisem warunków przejścia. Na przykład importuj zamówienia z określonym stanem płatności, nie przekazuj anulowanych, a po utworzeniu dokumentu zapisz wynik importu. Jeśli proces przewiduje odsyłanie statusu realizacji do sklepu, należy wskazać, która czynność go wyzwala. Aktualizacja statusu „wysłane” powinna następować dopiero wtedy, gdy firma rzeczywiście zakończyła odpowiedni etap logistyczny.

Zdarzenie biznesoweZalecana decyzja projektowa
Zamówienie utworzone, nieopłaconeUstalić, czy import ma czekać na płatność
Płatność potwierdzonaZweryfikować, czy nie istnieje wcześniejszy import
Zamówienie anulowaneUstalić zasady anulowania lub wstrzymania w ERP
Zamówienie częściowo zrealizowaneOkreślić obsługę pozycji i dostępności
Paczka nadanaPrzesłać wybrane dane wysyłki, jeśli obsługuje to API
Zwrot lub reklamacjaObsłużyć zgodnie z osobnym procesem magazynowo-finansowym

Ta tabela jest przykładem zasad projektowych, a nie odwzorowaniem nazw i kodów statusów udostępnianych przez konkretną wersję Sky-Shop. Szczegółowe wartości trzeba pobrać z dokumentacji API i ustawień sklepu. Dużą zaletą spisania mapy przed wdrożeniem jest możliwość przeanalizowania nietypowych scenariuszy wspólnie z działem handlowym, magazynem i księgowością.

Jak bezpiecznie połączyć Wapro Mag, SQL Server i sklep w chmurze?

Wapro Mag pracuje w środowisku firmy lub na odpowiednio przygotowanym serwerze. Sklep Sky-Shop jest usługą internetową. Połączenie tych środowisk nie powinno polegać na publicznym udostępnieniu portu bazy SQL Server całemu internetowi. Baza danych ERP nie musi być bezpośrednio dostępna z zewnątrz tylko dlatego, że sklep potrzebuje danych magazynowych.

Bezpieczniejszy model wykorzystuje odpowiednio uprawniony komponent integracyjny, który komunikuje się z systemem ERP w kontrolowany sposób, a z usługami internetowymi przez szyfrowane połączenia. Należy ograniczyć konta usługowe do potrzebnych operacji, sprawdzić sposób przechowywania sekretów i zadbać o logi działań. Dotyczy to zarówno danych klientów, jak i możliwości tworzenia dokumentów handlowych.

ROVENS posiada dedykowaną platformę integracyjną Wapro Mag. W rozwiązaniu tym konektor pracuje po stronie środowiska z danymi Wapro, a platforma obsługuje komunikację z systemami zewnętrznymi. Właściwa konfiguracja połączenia z wybranym sklepem wymaga jednak uzgodnienia zakresu i zasad przetwarzania danych. Nie należy utożsamiać ogólnej architektury platformy z automatycznym udostępnieniem każdej funkcji każdej usługi e-commerce.

Ważnym elementem bezpieczeństwa jest także plan działania podczas awarii. Co się stanie, jeśli połączenie z internetem przestanie działać, a pracownicy nadal realizują sprzedaż w magazynie? Czy zadania zostaną zapisane w kolejce? Czy po przywróceniu komunikacji nastąpi kontrola zaległych zmian? Czy integrator nie wyśle ponownie dokumentów, które wcześniej zostały poprawnie zapisane? Odpowiedzi powinny znaleźć się w projekcie, zanim system rozpocznie codzienną pracę.

Najczęstsze błędy integracji Wapro Mag ze Sky-Shop

Najwięcej problemów wynika nie z samego API, ale z niezgodnych założeń. Sklep może odpowiadać poprawnie, a produkty nadal nie są aktualizowane, ponieważ integracja używa nieprawidłowego identyfikatora. Wapro może tworzyć dokumenty bez błędu technicznego, ale nadawać im nieodpowiedni typ. Dlatego przy diagnozowaniu należy oddzielać błąd połączenia, błąd danych i błąd reguły biznesowej.

ObjawMożliwa przyczynaCo sprawdzić najpierw
Brak połączenia z WebAPINiewłaściwy adres, klucz, pakiet lub niedostępność sklepuDomenę sklepu, panel Web API i prosty odczyt testowy
Synchronizacja wyraźnie zwalniaZbyt wiele wywołań lub nieoptymalny harmonogramKolejkę, odstępy między żądaniami i logi odpowiedzi
Zamówienia tworzą się dwukrotnieBrak ochrony przed ponowieniemMapowanie identyfikatorów i historię importu
Nieaktualne stanyZły magazyn, rezerwacje lub zbyt rzadkie odświeżanieŹródło ilości i czas ostatniej poprawnej synchronizacji
Cena zmienia się bez oczekiwaniaKonflikt cenników lub promocjiWłaściciela pola, reguły VAT i zakres aktualizacji
Zły wariant produktuNieprawidłowe powiązanie SKU albo identyfikatora wariantuTabelę mapowania na poziomie wariantu
Brak części zamówieńFiltr statusów lub błąd paginacjiWarunki importu i listę zamówień źródłowych
Brak danych kontrahentaNiekompletne dane lub złe mapowanie pólWalidację wejścia i komunikaty odrzuconych operacji

Przy błędach połączenia warto rozpocząć od najprostszego testu: czy klucz WebAPI jest aktywny, czy adres wskazuje na właściwy sklep i czy pakiet udostępnia wymagane funkcje. Dopiero potem badać logikę produktów i dokumentów. Jeśli połączenie działa, lecz zamówienie nie zostało zaimportowane, sam test dostępności API nie wyjaśnia problemu — trzeba prześledzić konkretny identyfikator zamówienia przez cały proces.

Nie zaleca się „naprawiania” błędów przez wyłączenie walidacji albo automatyczne ponawianie wszystkich operacji bez limitu. To może prowadzić do większej liczby duplikatów, nadpisania prawidłowych cen i trudności przy rozliczeniu sprzedaży. Lepiej mieć widoczną listę przypadków wymagających interwencji niż pozwolić systemowi wykonywać niepewne operacje w tle.

Jak przetestować integrację przed uruchomieniem produkcyjnym?

Testy powinny być zaplanowane przed pierwszą masową synchronizacją. Sama informacja „połączenie z API działa” nie wystarczy, bo najpoważniejsze problemy pojawiają się przy zmianie statusu, ponowieniu zamówienia lub nietypowym produkcie. Pierwszy etap to weryfikacja dostępu: pobranie testowych danych, sprawdzenie uprawnień i potwierdzenie poprawnego adresu WebAPI.

Drugi etap obejmuje produkty i stany. Warto wybrać kilka indeksów reprezentujących różne scenariusze: produkt zwykły, produkt z wariantami, produkt bez EAN, towar z rezerwacją, pozycję dostępną w dwóch magazynach oraz towar wyłączony z publikacji. Dla każdego przypadku trzeba zapisać oczekiwany stan w sklepie i porównać go z wynikiem działania integracji.

Trzeci etap to zamówienia i płatności. Test powinien obejmować zakup osoby prywatnej, zamówienie firmowe z NIP, różne metody dostawy, pozycje o różnych stawkach podatku, anulowanie i próbę ponownego importu tego samego zamówienia. Jeżeli integracja obsługuje statusy zwrotne, należy sprawdzić, czy nie powodują niepożądanej pętli aktualizacji.

Czwarty etap to odporność na awarie. Można zasymulować czasową niedostępność sklepu, brak odpowiedzi ze środowiska Wapro oraz błąd danych produktu. Poprawnie przygotowany mechanizm powinien zarejestrować niepowodzenie, nie tworzyć duplikatu przy ponowieniu i umożliwić administratorowi wskazanie przyczyny. Przed testami należy zadbać o kopie bezpieczeństwa i wyraźne odróżnienie danych testowych od produkcyjnych.

Ostatni etap to akceptacja biznesowa. Magazyn powinien potwierdzić ilości, handlowiec ceny, a osoba rozliczająca dokumenty sposób obsługi płatności i wysyłki. Integracja jest gotowa do regularnej pracy dopiero wtedy, gdy spełnia uzgodnione kryteria, a nie tylko wtedy, gdy programista otrzyma poprawną odpowiedź serwera.

Przykład: firma sprzedaje przez Sky-Shop i prowadzi magazyn w Wapro Mag

Rozważmy hipotetyczną firmę sprzedającą akcesoria biurowe. W katalogu sklepu ma 2500 produktów, a magazyn obsługuje przyjęcia, sprzedaż stacjonarną i zamówienia B2B. Każdego dnia wpływa około 45 zamówień internetowych. Pracownicy przepisują je do Wapro, a stany ręcznie poprawiają w panelu sklepu po zakończeniu dnia. Skutkiem są pomyłki przy numerach katalogowych i opóźnienia w aktualizacji dostępności.

Firma ustala, że nowe opłacone zamówienia mają trafiać do ERP, natomiast dostępność i bazowa cena produktów będą pochodziły z Wapro. Zdjęcia, opisy i kategorie nadal pozostają zarządzane w Sky-Shop. Integracja przechowuje powiązania identyfikatorów, zapisuje historię importu i oznacza zamówienia wymagające ręcznej decyzji. W przypadku błędu połączenia operacje nie znikają, lecz oczekują na bezpieczną ponowną próbę.

Przed uruchomieniem firma zauważa, że 120 produktów ma w sklepie inne symbole niż w ERP, a kilkanaście indeksów w ogóle nie jest powiązanych. To nie jest problem, który rozwiąże szybsze API. Konieczne jest uporządkowanie kartotek i przypisanie właściwych identyfikatorów. Po przygotowaniu mapowania firma może przejść do testowej synchronizacji, a następnie uruchomić przetwarzanie większej grupy zamówień.

To przykład modelowy, a nie opis rzeczywistego klienta ROVENS ani obietnica konkretnego wyniku. Pokazuje jednak, dlaczego integracja e-commerce to projekt łączący technologię, dane i organizację pracy, a nie wyłącznie wpisanie klucza w formularzu.

Od czego zacząć wdrożenie integracji Wapro Mag ze Sky-Shop?

Najpierw należy ustalić cel. „Chcemy połączyć sklep z Wapro” to jeszcze za mało do przygotowania zakresu. Znacznie lepiej brzmi: „Chcemy importować opłacone zamówienia, aktualizować stany dwóch magazynów i przesyłać ceny detaliczne, ale nie nadpisywać opisów produktów”. Taki opis od razu wskazuje kluczowe przepływy i wyjątki.

Następnie warto zebrać informacje o środowisku: wersji Wapro Mag, sposobie dostępu do bazy SQL Server, wykorzystywanych magazynach, pakiecie Sky-Shop oraz dostępności WebAPI. Istotna jest liczba produktów, liczba zamówień dziennie i to, czy sklep korzysta z automatycznych aktualizacji danych z hurtowni. Te informacje wpływają na harmonogram, liczbę zapytań i priorytety synchronizacji.

Kolejnym krokiem jest określenie źródła prawdy. Kto nadaje indeksy towarowe? Gdzie tworzone są promocje? Który system rozpoznaje opłacenie zamówienia? Co ma się dziać z zamówieniami anulowanymi? Ustalenia należy zapisać, ponieważ bez nich dwa poprawnie działające programy mogą ciągle nadpisywać wzajemnie swoje dane.

Dopiero na tej podstawie projektuje się mapowanie, przygotowuje dostępy, wykonuje testy i uruchamia synchronizację. Wdrożenie etapowe jest często bezpieczniejsze niż uruchomienie wszystkich kierunków wymiany naraz. Przykładowo można zacząć od pobierania zamówień, później uruchomić stany magazynowe, a ceny dodać po potwierdzeniu reguł promocji. Ostateczna kolejność zależy jednak od potrzeb firmy.

Ile kosztuje integracja Sky-Shop z Wapro Mag?

Nie ma jednej wiarygodnej ceny, którą można podać bez znajomości zakresu. Połączenie obejmujące wyłącznie import zamówień różni się od projektu synchronizującego kilka magazynów, warianty, cenniki i statusy. Koszt zależy również od jakości kartotek, dostępności odpowiednich funkcji API, liczby wyjątków oraz konieczności utrzymania logiki biznesowej po aktualizacjach obu systemów.

Przy wycenie warto oddzielić opłatę za przygotowanie wdrożenia od kosztów związanych z utrzymaniem środowiska. Mogą występować także opłaty za abonamenty dostawców, infrastrukturę, wsparcie czy dodatkowe wymagania bezpieczeństwa. Nie należy sugerować, że każdy projekt oznacza taki sam model rozliczenia. Najpierw określa się wymagania, potem porównuje sposób ich realizacji i przedstawia zakres prac.

Ocena opłacalności powinna uwzględniać nie tylko oszczędzony czas. Ważne są także mniejsza liczba błędów przy przepisywaniu zamówień, szybsze wykrywanie rozbieżności i bardziej przewidywalna dostępność towaru. Jeżeli sklep sprzedaje niewiele produktów i przyjmuje dwa zamówienia tygodniowo, rozbudowana integracja może nie mieć uzasadnienia. Przy większej skali pracy korzyść biznesowa może wynikać nawet z odzyskania kilku godzin tygodniowo.

Jak ROVENS pomaga połączyć Wapro Mag ze Sky-Shop?

ROVENS posiada dedykowaną platformę integracyjną Wapro Mag, przeznaczoną do automatyzacji wymiany danych pomiędzy ERP a zewnętrznymi aplikacjami. Jeżeli chcesz zintegrować Wapro Mag ze Sky-Shop, możesz przedstawić nam sposób działania sklepu, magazynu i obsługi zamówień. Pomożemy ustalić właściwy model połączenia, kierunki synchronizacji i niezbędne reguły biznesowe.

Warto od razu wskazać, czy najważniejsze jest pobieranie zamówień, aktualizacja stanów magazynowych, synchronizacja cen, czy połączenie kilku procesów. Nie musisz przygotowywać dokumentacji technicznej samodzielnie. Wystarczy opisać obecny sposób pracy i problem, który chcesz wyeliminować. Na tej podstawie można doprecyzować zakres techniczny i warunki realizacji.

Więcej informacji znajdziesz na stronie Integracja Wapro Mag – platforma ROVENS. Jeśli interesuje Cię również sposób działania interfejsów, przeczytaj poradnik Co to jest REST API (RESTful API)? oraz artykuł Co to jest automatyzacja?. Materiały wyjaśniają technologię, a strona ofertowa pozwala zapytać o połączenie dopasowane do konkretnej firmy.

FAQ – najczęstsze pytania o integrację Wapro Mag ze Sky-Shop

Czy można połączyć Wapro Mag ze Sky-Shop bez ręcznego przepisywania zamówień?

Tak. Odpowiednio przygotowana integracja może pobierać zamówienia ze sklepu i przekazywać je do Wapro Mag według ustalonych reguł. Trzeba przy tym określić statusy kwalifikujące zamówienie do importu, mapowanie towarów oraz kontrolę duplikatów. Sam klucz API nie automatyzuje tego procesu bez warstwy integracyjnej.

Czy Sky-Shop ma API do integracji z systemem ERP?

Sky-Shop udostępnia WebAPI, a producent opisuje jego wykorzystanie do komunikacji z zewnętrznymi systemami. Dostępność funkcjonalności zależy od pakietu sklepu. Przed wdrożeniem trzeba potwierdzić, czy dokumentacja danej wersji interfejsu obejmuje wszystkie operacje potrzebne w konkretnym projekcie.

Gdzie znaleźć klucz API Sky-Shop?

W panelu sklepu przejdź do Integracje → Web API sklepu. W tym miejscu producent opisuje możliwość odczytania lub ustawienia klucza oraz przejścia do dokumentacji. Po zmianie klucza należy zapisać ustawienia. Klucza nie należy publikować ani przesyłać niezabezpieczonym kanałem komunikacji.

Jaki jest limit zapytań WebAPI Sky-Shop?

W publicznej instrukcji Sky-Shop producent wskazuje jedno wywołanie API na sekundę. Integracja powinna uwzględniać ograniczenie we wspólnej kolejce żądań i nie wysyłać nadmiernej liczby równoległych operacji. Aktualną wartość i zasady należy zawsze potwierdzić w dokumentacji przypisanej do danego sklepu.

Czy można synchronizować stany magazynowe Wapro Mag ze Sky-Shop?

Takie połączenie można zaprojektować, ale najpierw trzeba określić, który magazyn jest źródłem danych, czy odejmowane są rezerwacje oraz czy stosowany jest bufor bezpieczeństwa. Trzeba również potwierdzić dostępność wymaganych metod WebAPI. Sama liczba sztuk fizycznych w ERP nie zawsze oznacza ilość możliwą do sprzedania.

Czy synchronizacja obejmuje kilka magazynów w Wapro?

Może obejmować kilka magazynów, jeżeli zostanie przygotowana odpowiednia reguła obliczania dostępności. Nie zawsze należy sumować wszystkie lokalizacje. Niektóre mogą wymagać przesunięcia towaru, a inne służą wyłącznie do obsługi określonych kanałów sprzedaży. Ostateczny model zależy od organizacji logistyki.

Czy integracja może aktualizować ceny produktów?

Może to być część projektu, jeśli potrzebne operacje są dostępne w interfejsie sklepu. Należy ustalić cennik źródłowy, zasady VAT i zaokrąglania oraz wyjątki dla promocji. Nie powinno się bezwarunkowo nadpisywać cen sklepowych, kiedy część z nich jest zarządzana ręcznie lub pochodzi z kampanii promocyjnej.

Czy połączenie Wapro Mag ze Sky-Shop tworzy produkty w sklepie?

To zależy od zakresu projektu i możliwości udokumentowanych metod API. Warto oddzielić tworzenie kartotek od aktualizacji istniejących indeksów. Firmy często wolą zarządzać opisami, zdjęciami i SEO po stronie sklepu, a z ERP przesyłać jedynie ceny i dostępność. Bez tego rozróżnienia można przypadkowo nadpisać treści sprzedażowe.

Czy po integracji można nadal korzystać z hurtowni Sky-Shop?

Tak, ale trzeba uzgodnić źródła danych. Integracja hurtowni może aktualizować katalog, ceny i dostępność na podstawie pliku dostawcy, natomiast połączenie ERP może przekazywać stan własnego magazynu. Gdy dwa mechanizmy mają prawo modyfikować to samo pole, konieczne jest określenie ich priorytetu.

Czy integracja Sky-Shop z Wapro Mag działa automatycznie?

Automatyzacja polega na wykonywaniu uzgodnionych operacji bez każdorazowej ręcznej ingerencji. Nie oznacza jednak braku nadzoru ani gwarancji zerowego opóźnienia. Potrzebne są harmonogramy, kolejki, walidacja danych i raportowanie błędów. Pracownik powinien mieć możliwość wyjaśnienia przypadków, których system nie potrafi bezpiecznie rozstrzygnąć.

Czy trzeba otwierać port SQL Server do internetu?

Nie jest to konieczny ani zalecany warunek integracji sklepu internetowego z ERP. Można zastosować bezpieczną architekturę z komponentem integracyjnym działającym przy środowisku Wapro i kontrolowaną komunikacją z usługami zewnętrznymi. Uprawnienia do bazy, klucze API i ruch sieciowy należy ograniczyć do faktycznych potrzeb.

Dlaczego połączenie działa, ale nie wszystkie zamówienia się importują?

Przyczyną może być filtr statusów, brak mapowania produktu, błędne dane kontrahenta, niepoprawna obsługa paginacji lub zatrzymana kolejka. Najlepiej sprawdzić konkretne zamówienie po jego identyfikatorze: czy zostało pobrane, zweryfikowane i zapisane w ERP oraz czy integrator otrzymał potwierdzenie wykonania.

Dlaczego produkty w Sky-Shop mają inne stany niż w Wapro?

Możliwe przyczyny to niewłaściwy magazyn źródłowy, nieuwzględnione rezerwacje, błędne powiązania produktów albo opóźnienie aktualizacji. Trzeba sprawdzić czas ostatniej poprawnej synchronizacji i regułę wyliczania dostępności. Nie każda różnica jest awarią: czasem systemy celowo prezentują inne rodzaje stanów.

Czy integracja obsługuje warianty i zestawy produktów?

Może zostać zaprojektowana z uwzględnieniem wariantów i zestawów, ale wymaga dokładnego ustalenia sposobu ich reprezentacji w obu systemach oraz sprawdzenia dostępnych funkcji API. Każdy wariant musi odpowiadać właściwemu indeksowi, a zestaw może wymagać dodatkowych reguł magazynowych. To jeden z ważniejszych obszarów testów przed wdrożeniem.

Czy można podłączyć Sky-Shop do Wapro Mag zainstalowanego na własnym serwerze?

Takie środowisko może być obsługiwane przez odpowiednio przygotowaną architekturę integracyjną. Warto sprawdzić wersję Wapro, dostępność SQL Server dla konektora, konta usługowe, zaporę sieciową i sposób zestawiania bezpiecznego połączenia. Nie trzeba zakładać, że sklep internetowy ma bezpośrednio łączyć się z bazą ERP.

Ile trwa wdrożenie integracji Wapro Mag i Sky-Shop?

Termin zależy od zakresu wymiany danych, liczby indeksów, jakości kartotek i liczby wyjątków. Projekt oparty na jednym prostym przepływie będzie mniej złożony niż synchronizacja wielu magazynów, cenników i statusów. Rzetelne oszacowanie wymaga najpierw sprawdzenia potrzeb i możliwości technicznych obu środowisk.

Czy po integracji można zmienić zasady synchronizacji?

Takie zmiany są możliwe w ramach funkcjonalności i architektury wybranego rozwiązania, ale należy je przetestować. Zmiana sposobu liczenia dostępności, źródła cen lub momentu importu zamówienia może oddziaływać na inne procesy. Dlatego warto utrzymywać spisane reguły i dziennik zmian konfiguracji zamiast wprowadzać modyfikacje bez kontroli.

Jak zamówić integrację Wapro Mag ze Sky-Shop w ROVENS?

Przejdź na stronę Integracja Wapro Mag w ROVENS lub skorzystaj z formularza kontaktowego. Napisz, jakie informacje mają być przekazywane między Wapro i Sky-Shop, ile zamówień obsługujesz oraz czy ważniejsze są stany, ceny, czy automatyczne tworzenie zamówień. ROVENS posiada dedykowaną platformę integracyjną Wapro Mag i pomoże dobrać sposób połączenia do procesu Twojej firmy.

Podsumowanie – jak skutecznie połączyć Wapro Mag ze Sky-Shop?

Integracja Wapro Mag ze Sky-Shop może ograniczyć ręczne przenoszenie zamówień, pomóc utrzymać spójne informacje o cenach i dostępności produktów oraz uporządkować codzienną sprzedaż. Podstawą techniczną może być WebAPI Sky-Shop połączone z odpowiednio przygotowaną platformą integracyjną obsługującą dane Wapro Mag.

Najważniejsze decyzje zapadają jednak przed uruchomieniem: które systemy odpowiadają za poszczególne dane, jak rozpoznawać produkty, jaki stan oferować klientom, kiedy importować zamówienia i kto reaguje na błędy. W przypadku Sky-Shop należy też uwzględnić dostępność API w używanym pakiecie i limit częstotliwości zapytań wskazany przez producenta.

Jeśli chcesz połączyć Wapro Mag ze Sky-Shop, sprawdź platformę integracyjną ROVENS i opisz, czego potrzebujesz. Najlepsze połączenie to takie, które odzwierciedla realną pracę Twojego magazynu i sklepu, a nie tylko wymienia dane między dwoma adresami API.

Średnia ocen użytkowników 0 na podstawie 0 głosów

Dodaj komentarz