Jak zintegrować Wapro Mag z IdoSell? Zamówienia, magazyny, ceny i API sklepu

Integracja Wapro Mag z IdoSell polega na połączeniu systemu sprzedażowo-magazynowego Wapro Mag ze sklepem internetowym działającym na platformie IdoSell, tak aby zamówienia, produkty, stany magazynowe, ceny i wybrane informacje o klientach mogły być wymieniane automatycznie. Połączenie można realizować za pomocą dostępnych rozwiązań integracyjnych albo warstwy komunikacyjnej wykorzystującej interfejs IdoSell Admin API. Najważniejsze jest nie samo przesłanie danych, lecz określenie, który system jest ich źródłem i jak rozwiązywane są błędy.

W praktyce sklep internetowy i program ERP pracują w innych rytmach. IdoSell obsługuje ruch klientów, promocje, płatności i zamówienia. Wapro Mag prowadzi firmowe kartoteki, gospodarkę magazynową i dokumenty handlowe. Bez dobrze ustalonego przepływu danych jeden produkt może mieć dwie różne ceny, ta sama sprzedaż może pojawić się dwa razy, a sklep może pokazać towar, którego nie da się już wydać.

W poradniku wyjaśniamy jak połączyć Wapro Mag z IdoSell, co udostępnia API platformy, jakie możliwości daje oferowany przez producenta IdoSell Bridge i kiedy warto zaplanować indywidualną integrację. Omawiamy pobieranie zamówień, synchronizację magazynów, wariantów i cenników, obsługę webhooków, bezpieczeństwo, testy oraz typowe problemy wdrożeniowe. Przykładowe scenariusze są modelami procesów, a nie deklaracją, że każda konfiguracja IdoSell i Wapro obsługuje je identycznie.

Czy Wapro Mag można połączyć z IdoSell?

Tak. IdoSell i Wapro Mag można zintegrować, a producent platformy sklepowej dokumentuje nawet gotowe rozwiązanie IdoSell Bridge przeznaczone do komunikacji z Wapro Mag. Istnieje też droga polegająca na wykorzystaniu Admin API i odpowiedniej warstwy integracyjnej. To ważne rozróżnienie: nie każdy sklep musi korzystać z tego samego modelu technicznego, a sposób połączenia dobiera się do procesów i zakresu danych.

W najprostszym scenariuszu klient składa zamówienie w IdoSell, po czym informacja trafia do Wapro Mag. Tam pracownik obsługuje dokument i realizację. Z kolei aktualny stan dostępny do sprzedaży jest obliczany po stronie firmy i przesyłany do IdoSell. Takie połączenie ogranicza powtarzanie czynności, ale wymaga dopasowania produktów, kontrahentów, metod płatności i sposobów dostawy.

Bardziej rozbudowana firma może obsługiwać kilka magazynów, sklepy w różnych językach, odbiorców hurtowych i indywidualne cenniki. Wtedy samo określenie „synchronizacja dwukierunkowa” niczego nie wyjaśnia. Dla jednego pola źródłem może być Wapro, dla innego IdoSell, a część informacji może nie podlegać synchronizacji. Dobrze zaprojektowany proces zapisuje te reguły przed pierwszym uruchomieniem.

Po co firmie integracja sklepu IdoSell z Wapro Mag?

Najbardziej widoczna korzyść to ograniczenie ręcznego wprowadzania zamówień. Bez integracji pracownik otwiera panel sklepu, odczytuje dane klienta, wyszukuje towar w ERP i tworzy kolejne pozycje zamówienia. Następnie sprawdza płatność, magazyn i rodzaj dostawy. Każda czynność jest okazją do pomyłki, zwłaszcza gdy rośnie liczba zamówień albo jedna osoba obsługuje kilka kanałów sprzedaży.

Drugą korzyścią jest spójniejsza informacja o dostępności. Towar wydany klientowi stacjonarnemu znika z firmowego magazynu, ale bez wymiany danych sklep może nadal oferować go online. Gdy integracja przekazuje do sklepu rzeczywistą ilość przeznaczoną do sprzedaży, ryzyko takich sytuacji maleje. Warunkiem jest jednak uwzględnienie rezerwacji, innych kanałów, dostaw oczekujących i ewentualnego bufora bezpieczeństwa.

Trzecia korzyść dotyczy kontroli procesu. Właściciel sklepu chce wiedzieć nie tylko, czy „integracja jest włączona”, ale też czy wszystkie zamówienia trafiły do ERP, które rekordy się nie powiodły i czy ceny są aktualne. Z tego względu równie ważne jak transfer danych są rejestr zdarzeń, raport błędów, możliwość ponowienia operacji i jasny podział odpowiedzialności.

Jakie metody integracji Wapro Mag z IdoSell są dostępne?

Można wyróżnić trzy praktyczne podejścia: IdoSell Bridge, indywidualną integrację opartą na API oraz wymianę danych przez pliki lub inne uzgodnione mechanizmy. Nie należy jednak traktować ich jako metod równoważnych. Każda ma inny zakres konfiguracji, możliwości rozbudowy i wymagania organizacyjne.

IdoSell Bridge to rozwiązanie udostępniane przez IdoSell, instalowane w środowisku Windows z dostępem do Wapro Mag. Producent opisuje synchronizację zamówień, zwrotów, towarów, cen, stanów i danych klientów. Dokumentacja przedstawia również ustawienia kierunku synchronizacji oraz zasady działania przy wielu magazynach. Przy wyborze tego wariantu należy dokładnie sprawdzić zakres funkcji i sposób współpracy z własną konfiguracją ERP.

Integracja przez API wykorzystuje funkcje udostępnione przez IdoSell i warstwę pośredniczącą komunikującą się z Wapro Mag. Sprawdza się wtedy, gdy trzeba uwzględnić indywidualny proces firmy, dodatkowe systemy, własne reguły synchronizacji lub szczególne wymagania raportowania. ROVENS posiada dedykowaną platformę integracyjną Wapro Mag, którą można wykorzystać jako element takiej architektury po uzgodnieniu potrzeb.

Wymiana plikowa może pomóc przy jednorazowym imporcie katalogu, lecz nie powinna być automatycznie uznawana za odpowiednik stałej synchronizacji zamówień i magazynów. Plik dostarczony raz dziennie nie daje tej samej aktualności danych co regularnie wykonywane operacje integracyjne.

Czym jest IdoSell Admin API i do czego służy?

IdoSell Admin API jest interfejsem przeznaczonym do komunikacji z funkcjami zaplecza sklepu. Pozwala aplikacjom, które uzyskały właściwy dostęp, wykonywać wybrane operacje związane między innymi z zamówieniami, produktami, płatnościami, stanami i klientami. W dokumentacji producent zaznacza jednocześnie, że nie każda funkcja panelu administracyjnego ma swój odpowiednik w API.

To istotna różnica względem prostego wyobrażenia, że integracja „widzi całą bazę sklepu”. IdoSell jest usługą SaaS. Zewnętrzna aplikacja nie powinna oczekiwać dostępu do jej wewnętrznej bazy danych; korzysta z udokumentowanych operacji pod adresem API danego sklepu. Adres ten oraz klucz dostępu zależą od konkretnego panelu.

W projekcie integracyjnym warto sporządzić listę wymaganych działań: odczyt nowych zamówień, odczyt danych o produktach, aktualizacja dostępności, zapis cen czy zmiana statusu. Następnie każdą operację weryfikuje się w odpowiedniej wersji dokumentacji IdoSell. Jeśli funkcja nie jest dostępna, trzeba zmienić proces lub wybrać inną udokumentowaną metodę. Nie należy opierać wdrożenia na odgadywanych adresach endpointów.

Gdzie znaleźć dostęp do API w panelu IdoSell?

Według dokumentacji IdoSell klucze dostępowe do Admin API są zarządzane w panelu sklepu w obszarze Ustawienia → Dostęp. Do ich utworzenia potrzebne są odpowiednie uprawnienia administracyjne. Dla każdej aplikacji warto przygotować osobny klucz, nadać tylko wymagane uprawnienia i, jeżeli pozwala na to scenariusz, ograniczyć hosty, z których dostęp będzie wykorzystywany.

IdoSell opisuje dwa sposoby autoryzacji: klucz przesyłany w nagłówku X-API-KEY oraz mechanizm OAuth 2.0 z tokenem Bearer. Wybór zależy od tego, jak zaprojektowano aplikację i które możliwości autoryzacji wykorzystuje. Hasło do panelu sklepu nie powinno pełnić roli uniwersalnego hasła przekazywanego wielu wykonawcom.

Przy uruchamianiu integracji warto sprawdzić również, czy klucz ma prawo odczytywać i zmieniać dokładnie te zasoby, których dotyczy proces. Brak odpowiedniego uprawnienia może wyglądać jak błąd integratora, mimo że właściwy problem tkwi w konfiguracji dostępu. W osobnym rejestrze powinny być wskazane osoba odpowiedzialna, termin rotacji sekretu i sposób wyłączenia połączenia.

Klucze API nigdy nie powinny znaleźć się w publicznej instrukcji, niezaszyfrowanych logach, źródle strony sklepu ani w korespondencji dostępnej dla przypadkowych osób.

Jaka jest różnica między IdoSell Bridge a integracją indywidualną?

IdoSell Bridge jest konkretną aplikacją oferowaną przez dostawcę sklepu. Producent określa jej funkcjonalność, wspierane scenariusze i sposób konfiguracji. Zaletą takiej ścieżki bywa możliwość szybkiego uruchomienia standardowego procesu, gdy środowisko firmy odpowiada założeniom gotowego rozwiązania. W dokumentacji podano między innymi obsługę zamówień i zwrotów, kierunków synchronizacji, kontrahentów oraz magazynów.

Indywidualna integracja nie musi próbować odtwarzać całej listy funkcji gotowego oprogramowania. Może skupiać się na mniejszej liczbie, ale bardziej specyficznych procesów: przekazywaniu zamówień spełniających określone warunki, obsłudze własnego systemu kompletacji, łączeniu kilku kanałów sprzedaży albo specjalnym algorytmie ustalania stanów. Jej sens ocenia się przez dopasowanie do wymagań biznesowych, a nie samą liczbę funkcji na liście.

Firma korzystająca z rozbudowanych kartotek, indywidualnych dodatków Wapro lub niestandardowego obiegu dokumentów powinna szczególnie dokładnie zbadać ograniczenia wybranego wariantu. Sam producent IdoSell zaznacza, że w przypadku modyfikowanych środowisk nie wszystkie niestandardowe elementy muszą być objęte integracją Bridge. Nie jest to wada każdej gotowej integracji, tylko ważny punkt do sprawdzenia przed podpisaniem umowy.

Ostateczny wybór warto oprzeć na tabeli wymagań: jakie dane są potrzebne, skąd mają pochodzić, jak szybko muszą się aktualizować i jakie konsekwencje ma błąd. Dzięki temu decyzja jest mierzalna, a nie oparta wyłącznie na nazwie narzędzia.

Jak wygląda techniczna architektura połączenia IdoSell z Wapro Mag?

Przykładową architekturę można przedstawić jako trzy warstwy: IdoSell, platforma integracyjna oraz Wapro Mag z Microsoft SQL Server. Po stronie sklepu odczytuje się zamówienia i udostępnia wybrane dane lub zdarzenia. Warstwa integracyjna interpretuje rekordy, dopasowuje identyfikatory, pilnuje kolejności przetwarzania i zapisuje wyniki. Po stronie ERP wykonywane są operacje zgodne z jego zasadami i konfiguracją.

Taki podział ogranicza konieczność bezpośredniego udostępniania serwera SQL do Internetu. Integracja powinna wykorzystywać kontrolowany konektor, odpowiednie uwierzytelnianie i możliwie ograniczone uprawnienia. Nie należy wystawiać publicznego portu SQL Server ani udostępniać konta administratora bazy tylko po to, żeby przekazać zamówienia ze sklepu.

ROVENS posiada dedykowaną platformę integracyjną Wapro Mag, obejmującą komunikację ze środowiskiem ERP i wymianę informacji z systemami zewnętrznymi. W praktycznym projekcie ustala się, które operacje będą wykonywane w środowisku lokalnym, które po stronie usługi integracyjnej oraz co zostanie zapisane w dziennikach. Dobrze, gdy każda operacja ma swój identyfikator, stan wykonania i procedurę ponowienia.

Istotne są również awarie połączenia. Sklep może przyjmować zamówienia, kiedy serwer firmowy jest chwilowo niedostępny. Wtedy integrator nie powinien gubić danych ani tworzyć dokumentów na ślepo. Zadania mogą czekać w kolejce, a po powrocie komunikacji być przetwarzane w kontrolowanej kolejności.

Jakie dane synchronizować między IdoSell a Wapro Mag?

Najczęstszy zakres obejmuje zamówienia, kartoteki towarowe, ceny, dostępność produktów, dane klientów i wybrane statusy realizacji. W zależności od modelu sprzedaży można rozważyć również zwroty, numery przesyłek, limity kredytowe lub pola informacyjne potrzebne obsłudze klienta. Nie oznacza to, że każdy system i każda metoda integracji obsługuje wszystkie te operacje; ich dostępność trzeba zweryfikować.

Dla każdej grupy danych zapisujemy trzy decyzje. Po pierwsze: system źródłowy. Po drugie: kierunek aktualizacji. Po trzecie: co ma się stać w razie konfliktu. Przykładowo ceny bazowe mogą pochodzić z Wapro, ale reguły promocji pozostawać w IdoSell. Zamówienia zwykle napływają ze sklepu do ERP, natomiast stan wydania może być przekazywany z ERP w drugą stronę.

Pomaga tabela mapowania pól. Nie wystarczy dopasować „nazwa” do „nazwa”: ważna jest długość pola, format danych, wymagane wartości oraz obsługa pustych rekordów. Szczególnie dużo uwagi wymagają dokumenty handlowe, stawki VAT, numery identyfikacyjne towarów, adresy dostawy, waluty i pola związane z klientami biznesowymi.

Najbezpieczniejsza zasada brzmi: synchronizować tylko to, co zostało zdefiniowane i przetestowane. Automatyczne nadpisywanie wszystkich pól między systemami może szybciej zniszczyć poprawne dane niż ręczna pomyłka w pojedynczym zamówieniu.

Jak pobierać zamówienia z IdoSell do Wapro Mag?

Proces zwykle zaczyna się od odczytu zamówienia, które spełnia ustalone warunki, na przykład ma właściwy status lub jest opłacone. Integrator sprawdza identyfikator zamówienia w sklepie, pozycje, warianty, koszty dostawy, formę płatności i dane klienta. Następnie mapuje towary na kartoteki Wapro i przygotowuje dokument zgodny z przyjętym w firmie sposobem obsługi sprzedaży.

Nie każda firma chce importować zamówienie w chwili jego utworzenia. W modelu przedpłat jednym z warunków może być potwierdzenie płatności. W sprzedaży za pobraniem proces może być inny. Dla części produktów konieczna jest wcześniejsza kontrola dostępności albo rezerwacji w magazynie. Dlatego sam webhook informujący o zakupie nie powinien automatycznie zastępować decyzji biznesowej o utworzeniu dokumentu.

Przed zapisem w ERP integrator powinien ustalić, czy dany numer sklepowego zamówienia był już przetworzony. Po poprawnym utworzeniu dokumentu należy zapisać jego identyfikator i wynik operacji. W przypadku błędu warto zachować szczegół techniczny oraz przyjazne wyjaśnienie dla obsługi, na przykład: „brak powiązania produktu” zamiast samego kodu błędu.

Po uruchomieniu monitorujemy różnicę między liczbą zamówień kwalifikujących się do importu a liczbą skutecznie zapisanych w Wapro. To prosty, ale bardzo użyteczny sposób wykrywania cichych problemów, których nie pokaże sam status serwera.

Jak zapobiegać duplikowaniu zamówień z IdoSell?

Duplikat zamówienia powstaje często nie dlatego, że klient kupił dwa razy, lecz dlatego, że integracja ponowiła operację bez sprawdzenia poprzedniego wyniku. Przykład: konektor wysłał dokument do ERP, dokument został zapisany, ale odpowiedź nie dotarła z powodu przerwanego połączenia. Przy ponowieniu system może nie wiedzieć, że poprzednia próba zakończyła się sukcesem.

Dlatego podstawą jest idempotentna obsługa zamówień, czyli taki sposób zapisu, który pozwala bezpiecznie powtórzyć żądanie bez tworzenia kolejnego dokumentu dla tego samego zdarzenia. Integrator powinien przechowywać powiązanie między identyfikatorem zamówienia IdoSell a identyfikatorem dokumentu Wapro. Przed próbą zapisu sprawdza, czy istnieje już udokumentowany wynik.

Pomocny jest też stan pośredni, na przykład „w trakcie przetwarzania”, oraz ograniczenie równoległych operacji dla jednego zamówienia. Jeżeli jednocześnie przyjdzie powiadomienie webhook i uruchomi się okresowa synchronizacja, oba procesy nie mogą niezależnie stworzyć dwóch dokumentów. Reguły blokady i ponowienia powinny być przetestowane przy rzeczywistym opóźnieniu komunikacji.

Usuwanie duplikatów po fakcie nie jest dobrą podstawową metodą. Dokumenty handlowe mogą wpływać na rezerwacje, stany i dalsze procesy. Lepiej zapobiegać problemowi przez identyfikatory, historię przetwarzania i kontrolę spójności.

Jak synchronizować stany magazynowe między Wapro Mag a IdoSell?

Wbrew pozorom stan magazynu nie zawsze oznacza jedną liczbę. Firma może mieć ilość fizyczną, ilość zarezerwowaną, towar już przygotowany do wysyłki i zapas, którego nie chce oferować w sklepie. Dlatego przed integracją należy ustalić, co znaczy stan dostępny do sprzedaży i skąd jest wyliczany.

Załóżmy, że w Wapro widnieje 20 sztuk produktu. Sześć jest już przydzielonych do innych zamówień, a firma utrzymuje bufor dwóch sztuk na sprzedaż stacjonarną. Sklep może więc otrzymać wartość 12, o ile taki wzór odpowiada faktycznej logice magazynowej i nie liczy dwukrotnie tej samej rezerwacji. To tylko przykład reguły biznesowej — nie domyślne zachowanie każdego połączenia.

Synchronizacja powinna uwzględniać także opóźnienia. W chwili wzmożonej sprzedaży nawet poprawna aktualizacja co kilka minut może pozostawiać krótkie okno ryzyka. Dla produktów o małych stanach można zastosować dodatkową rezerwę lub częstsze aktualizacje określonych rekordów, jeżeli wydajność i interfejs sklepu na to pozwalają.

Warto mierzyć liczbę niezgodności i ich przyczyny. Jeśli problem dotyczy wyłącznie jednego magazynu albo określonej grupy towarów, nie zawsze trzeba przebudowywać całą integrację. Często wystarczy poprawić identyfikację kartotek lub regułę dostępności.

Wiele magazynów w Wapro Mag i IdoSell – jak wybrać stan do sklepu?

Obsługa wielu magazynów to jeden z obszarów, w których projekty potrafią się znacząco różnić. Firma może prowadzić magazyn centralny, punkt odbioru, magazyn zwrotów i osobny skład towarów uszkodzonych. Nie wszystkie lokalizacje powinny zwiększać dostępność oferty w sklepie internetowym. Samo zsumowanie stanów wszystkich magazynów może więc prowadzić do błędnych obietnic wobec klientów.

W jednym modelu sklep prezentuje wyłącznie magazyn centralny. W drugim sumuje zapasy wybranych punktów. W trzecim pokazuje dostępność zależnie od kraju, sposobu dostawy lub wybranego sklepu. To decyzje logistyczne, które trzeba przełożyć na konkretne mapowanie magazynów między IdoSell i Wapro Mag.

Producent IdoSell opisuje w dokumentacji Bridge również obsługę wielu magazynów i zasady identyfikacji kartotek po indeksie katalogowym. Warto się z nimi zapoznać przy ocenie gotowego rozwiązania, ale nie należy automatycznie zakładać identycznych reguł w każdym rozwiązaniu indywidualnym.

Dobrze zaprojektowany system powinien pokazać, które magazyny wchodzą do obliczenia stanu sklepowego i co dzieje się po zmianie konfiguracji. Przydaje się możliwość tymczasowego wyłączenia określonej lokalizacji bez ręcznego zerowania produktów.

Jak dopasować produkty z Wapro Mag do kartoteki IdoSell?

Podstawą synchronizacji jest jednoznaczna identyfikacja towaru. Wapro i IdoSell mogą posługiwać się własnymi identyfikatorami wewnętrznymi, a dodatkowo numerami SKU, indeksami katalogowymi lub EAN. Te wartości mają różne znaczenie. EAN nie zawsze jest unikatowy w firmowej bazie, nazwa produktu może się zmieniać, a dwa warianty tego samego towaru mogą mieć bardzo podobne opisy.

Dlatego integrator powinien posiadać trwałą tabelę powiązań, określającą, który produkt lub wariant sklepu odpowiada któremu rekordowi w ERP. Przy pierwszym połączeniu można wykorzystać indeksy katalogowe, ale wynik mapowania wymaga sprawdzenia i zapisania. Automatyczne tworzenie powiązań na podstawie samej nazwy jest ryzykowne.

Szczególną uwagę trzeba poświęcić produktom, które już istnieją w obu systemach. Nieprawidłowy import może utworzyć drugi rekord zamiast powiązać istniejący. Jeszcze poważniejszy błąd to przypisanie stanu jednego wariantu do innego, na przykład rozmiaru M do L. W firmach odzieżowych lub obuwniczych wpływa to bezpośrednio na liczbę nieudanych zamówień.

Dobrym rozwiązaniem jest raport „produkty bez powiązania”, uruchamiany przed synchronizacją produkcyjną. Operator widzi wtedy brakujące indeksy, niezgodności i niejednoznaczne kartoteki. Dopiero po ich uporządkowaniu włącza się automatyczne aktualizacje danych.

Jak obsługiwać warianty, zestawy i produkty wielojęzyczne?

Platformy sklepowe rozwijają strukturę produktów o kolory, rozmiary, konfiguracje, zestawy i wersje językowe. ERP może przechowywać je w inny sposób. Integracja musi więc rozdzielić pojęcie produktu widocznego dla klienta od konkretnej pozycji magazynowej. Czasami jeden produkt w IdoSell ma wiele wariantów, a każdy z nich odpowiada odrębnemu indeksowi w Wapro.

Przykładowo klient kupuje buty w rozmiarze 42, nie ogólną kartę produktu „Buty model X”. Jeżeli system prześle do ERP tylko identyfikator produktu nadrzędnego, bez właściwego wariantu, dokument magazynowy może dotyczyć niewłaściwego towaru. Mapowanie musi uwzględniać pełny identyfikator sprzedawanego wariantu.

Zestawy są jeszcze bardziej wymagające. Sklep może sprzedać komplet składający się z dwóch produktów, natomiast firma może obsługiwać go jako oddzielną kartotekę lub zestaw pozycji. Trzeba ustalić, czy integracja przekazuje zestaw jako jeden indeks, czy rozbija go na składniki. Obie metody mogą mieć sens, ale nie wolno mieszać ich bez kontroli stanów i cen.

Opisy w kilku językach często powinny pozostać w sklepie, podczas gdy Wapro zarządza danymi handlowymi i magazynowymi. Nadpisywanie całego katalogu z ERP może niepotrzebnie usuwać treści przygotowane do sprzedaży online.

Jak zsynchronizować ceny Wapro Mag z IdoSell bez nadpisywania promocji?

Ceny bywają bardziej złożone niż zwykła kolumna z kwotą. Firma może stosować cenę detaliczną, hurtową, indywidualne rabaty B2B, waluty, progi ilościowe i czasowe promocje w sklepie. Integracja musi wskazać, które wartości są źródłowe, a które wylicza sam sklep. Bez tej decyzji automatyczna aktualizacja potrafi zastąpić promocyjną cenę inną wartością.

Typowy model polega na przesyłaniu z ERP ceny bazowej, podczas gdy IdoSell obsługuje kampanie i prezentację rabatów. Możliwa jest też sytuacja odwrotna, jeśli proces firmy tego wymaga i wykorzystywana metoda techniczna wspiera taki kierunek. Nie powinno się jednak jednocześnie aktualizować tego samego pola w obu systemach bez reguły rozstrzygania konfliktów.

Warto ustalić sposób zaokrągleń, VAT, waluty, cen netto i brutto oraz moment wejścia nowej ceny w życie. Jeśli sklep sprzedaje za granicą, różnice mogą wynikać nie z błędu API, lecz z odmiennych reguł podatkowych albo sposobu przeliczania waluty. W takich przypadkach nie wystarczy porównać dwóch liczb na ekranie.

Przed uruchomieniem testujemy zwykły produkt, produkt w promocji, pozycję objętą rabatem indywidualnym i przypadek zmiany stawki VAT. Dzięki temu sprawdzamy rzeczywisty proces, nie tylko sukces pojedynczego żądania API.

Czym są webhooki IdoSell i jak pomagają przy synchronizacji?

Webhook IdoSell to mechanizm informowania zewnętrznej aplikacji o określonym zdarzeniu w sklepie, na przykład złożeniu zamówienia, jego anulowaniu albo zmianie statusu. Zamiast pytać API co kilkanaście sekund, aplikacja może odebrać powiadomienie i uruchomić odpowiedni proces. To przydatne rozwiązanie, ale nie oznacza, że każdy webhook zawiera wszystkie informacje potrzebne do zapisania zamówienia w ERP.

Dokumentacja IdoSell wskazuje, że webhooki są zbierane i wysyłane w pakietach co około 10 minut. Z tego powodu nie należy obiecywać klientowi, że integracja oparta wyłącznie na webhookach zawsze przeniesie każde zdarzenie w ułamku sekundy. Trzeba oddzielać moment zdarzenia od momentu dostarczenia powiadomienia i zakończenia pracy integratora.

IdoSell opisuje ponawianie nieudanych wysyłek. Jeżeli serwer odbierający nie potwierdzi przyjęcia danych w wymaganym czasie, system może spróbować ponownie. Odbiorca powinien więc zweryfikować autentyczność komunikatu, szybko potwierdzić jego otrzymanie i przetwarzać zadanie w kolejce. Nie należy wykonywać długiej operacji SQL w czasie oczekiwania na odpowiedź HTTP, jeśli powoduje to przekroczenie limitu czasu.

Dobrą praktyką jest połączenie webhooków z okresowym sprawdzaniem zgodności. Powiadomienia przyspieszają identyfikację zmian, a kontrolne odczyty API pomagają wykryć brakujące lub pominięte rekordy.

Webhook czy cykliczne odpytywanie API – co wybrać?

Oba mechanizmy mogą się uzupełniać. Webhook sprawdza się jako informacja, że w sklepie wydarzyło się coś wymagającego uwagi. Odczyt API pozwala pobrać aktualny stan danych i upewnić się, że zdarzenie odpowiada rzeczywiście istniejącemu zamówieniu. W wielu projektach najlepszy wynik daje połączenie tych metod zamiast bezwzględnego wyboru jednej.

Załóżmy, że IdoSell informuje o zmianie statusu zamówienia. Integrator może umieścić jego identyfikator w kolejce, następnie pobrać potrzebne dane przez Admin API i zdecydować, czy należy zaktualizować dokument w Wapro. Taki przebieg jest odporniejszy na sytuację, w której kilka zdarzeń dotyczących tego samego zamówienia dotrze z opóźnieniem.

Odpytywanie przydaje się przy synchronizacji początkowej i sprawdzaniu spójności. Trzeba jednak stosować paginację, filtry dat, odpowiednie odstępy i kontrolę wykorzystania API. Nie należy bez potrzeby pobierać całej historii zamówień podczas każdego cyklu. Jeżeli platforma zwróci błąd czasowy, system powinien zastosować kontrolowane ponowienie, a nie niekończącą się pętlę.

O wyborze decyduje nie tylko technologia, lecz także dopuszczalne opóźnienie. Dla raportu sprzedaży aktualizowanego raz dziennie wystarczy inny rytm pracy niż dla zamówienia, które magazyn ma zacząć kompletować wkrótce po opłaceniu.

Jak przekazywać statusy zamówień i informacje o wysyłce?

Statusy IdoSell i dokumenty Wapro Mag opisują często różne aspekty procesu. W sklepie status może informować klienta, czy zamówienie zostało przyjęte, opłacone, przygotowane lub wysłane. W ERP firma może korzystać z dokumentu zamówienia, rezerwacji albo dokumentu wydania. Integrator musi powiązać te etapy, lecz nie powinien utożsamiać ich automatycznie.

Przykładowo wystawienie dokumentu w Wapro nie zawsze oznacza, że paczka opuściła magazyn. Z kolei przyjęcie płatności w sklepie nie musi oznaczać, że zamówienie jest kompletne. Potrzebna jest tabela przejść: zdarzenie źródłowe, warunek, docelowy status, wyjątki i informacja, czy operacja może zostać cofnięta.

Jeżeli firma nadaje przesyłki przez własny moduł logistyczny, można rozważyć przekazywanie numeru listu przewozowego do sklepu, o ile wybrany sposób integracji udostępnia potrzebną operację. Nie należy jednak zakładać, że każde zdarzenie w systemie kurierskim oznacza faktyczne doręczenie lub nawet odbiór przesyłki. Te informacje mają osobne znaczenie biznesowe.

Mapowanie statusów trzeba przetestować także dla częściowej realizacji, anulowania, zwrotu i ponownego nadania. To sytuacje rzadsze niż zwykła wysyłka, ale często powodują najwięcej ręcznej pracy, gdy są pominięte w projekcie integracji.

Jak obsługiwać zwroty i korekty zamówień?

Zwrot produktu to nie tylko zmiana statusu w panelu sklepu. Może wiązać się z przyjęciem towaru, oceną jego stanu, zwrotem pieniędzy i dokumentem handlowym. Poszczególne systemy mogą mieć różny moment uznania zwrotu za zakończony. Jeśli integracja wykona operacje w niewłaściwej kolejności, stan magazynowy lub historia płatności mogą stać się niespójne.

Przy projektowaniu trzeba odróżnić zgłoszenie zwrotu, fizyczne otrzymanie towaru, decyzję o przyjęciu zwrotu i ewentualny dokument korygujący. Nie każdy z tych etapów musi być obsługiwany automatycznie. Czasami bezpieczniejszy jest proces częściowo ręczny, w którym pracownik zatwierdza przyjęcie towaru, a integrator przenosi jedynie uzgodnione informacje.

IdoSell dokumentuje w swoim rozwiązaniu Bridge obsługę przenoszenia zwrotów do Wapro Mag. Nie oznacza to jednak, że każde przedsiębiorstwo powinno bez analizy wdrażać identyczny obieg. Firma sprzedająca odzież może potrzebować innego procesu niż hurtownia elementów elektronicznych albo producent towarów na zamówienie.

Warto przetestować pełen cykl: sprzedaż, wysyłka, zwrot jednej pozycji, korekta, ponowne wprowadzenie towaru do właściwego magazynu. To pokazuje, czy spójność danych obejmuje także sytuacje po sprzedaży.

Jak obsługiwać klientów B2B, rabaty i limity kupieckie?

W sprzedaży hurtowej szczególnie ważne jest rozróżnienie klienta sklepu od kontrahenta w ERP. Jeden kontrahent może mieć kilku pracowników składających zamówienia, różne adresy dostawy i indywidualny cennik. Jeśli integrator zakłada nową kartotekę po każdym zakupie bez odpowiednich reguł, w Wapro szybko pojawią się duplikaty, które utrudnią rozliczenia.

Przy mapowaniu przydają się dane pozwalające identyfikować firmę: ustalony identyfikator zewnętrzny, NIP w odpowiednim kontekście i powiązanie z istniejącą kartoteką. Sam adres e-mail nie zawsze jest wystarczający. Równie ważne są zasady aktualizacji danych, zwłaszcza gdy klient zmienia adres fakturowania lub kilku użytkowników sklepu reprezentuje jedną firmę.

W dokumentacji integracji IdoSell Bridge z Wapro Mag opisano między innymi synchronizację indywidualnych rabatów, danych klientów oraz zadłużenia i limitu kredytu kupieckiego. Dla ostatnich dwóch wartości producent wskazuje kierunek z ERP do panelu sklepu. Te funkcje są przydatnym przykładem pokazującym, że integracja B2B wykracza poza same zamówienia.

Nie należy jednak przenosić limitów ani informacji finansowych automatycznie bez kontroli uprawnień i celu przetwarzania. Firma powinna określić, które osoby i systemy potrzebują tych danych, jak często muszą być aktualizowane oraz jak postąpić, gdy odczyt nie powiedzie się w chwili składania zamówienia.

Jak obsługiwać wiele sklepów, walut i sprzedaż zagraniczną?

Firma może prowadzić kilka witryn lub kanałów sprzedaży, przy czym każdy ma własne ceny, wersje językowe i zasady dostaw. Nawet jeśli produkty fizycznie pochodzą z tego samego magazynu, sklep w Polsce i sklep skierowany do klientów zagranicznych nie muszą korzystać z identycznej logiki cenowej. Integrator powinien odróżniać identyfikator sklepu, kanał zamówienia i walutę, zanim przekaże dokument do Wapro.

W przypadku sprzedaży zagranicznej ważne stają się podatki, kursy walut, koszty przesyłki i dane nabywcy. Nie powinno się obiecywać, że każde zamówienie z IdoSell może być bez żadnych reguł zapisane w dowolnej konfiguracji Wapro. Trzeba sprawdzić wymagane pola, obsługiwane typy dokumentów oraz sposób rozliczania konkretnych transakcji.

Szczególnej ostrożności wymagają promocje i rabaty obejmujące wybrane kraje. Ceny brutto w sklepie mogą różnić się od wartości obliczanych przez ERP ze względu na zasady podatkowe. W takich przypadkach integracja powinna zapisywać odpowiednie wartości źródłowe i wyjaśniać różnicę, zamiast po cichu zmieniać kwotę zamówienia.

Dobrym testem jest przeprowadzenie kilku zakupów próbnych: krajowych, zagranicznych, w różnych walutach oraz z różnymi stawkami podatkowymi. Testy należy przeprowadzić w środowisku zgodnym z realnym procesem księgowania i wystawiania dokumentów.

Jak zabezpieczyć połączenie IdoSell z Wapro i SQL Server?

Bezpieczeństwo integracji zaczyna się od ograniczenia uprawnień. Dostęp do API sklepu powinien mieć tylko uprawnienia niezbędne do wykonywanych operacji, a połączenie z serwerem Wapro należy skonfigurować zgodnie z zasadą najmniejszych uprawnień. Nie ma potrzeby otwierania dostępu do pełnej bazy danych ERP wszystkim usługom znajdującym się w Internecie.

Komunikacja sieciowa powinna odbywać się przez chronione kanały i mechanizmy uwierzytelniania. Sekrety API należy przechowywać poza publicznym kodem aplikacji i plikami dostępnymi przez przeglądarkę. Dzienniki powinny zawierać dane potrzebne do diagnostyki, ale nie pełne klucze, hasła czy niepotrzebne dane osobowe klientów. W logach można maskować wrażliwe wartości.

Warto przygotować osobne konta i klucze dla środowiska testowego oraz produkcyjnego. Dzięki temu programista może sprawdzać poprawność mapowania bez ryzyka przypadkowego zmodyfikowania rzeczywistych zamówień. Przed zmianą zakresu uprawnień trzeba ustalić, kto ją zatwierdza i jak zostanie udokumentowana.

Dodatkowym elementem ochrony jest monitorowanie anomalii: nietypowo duża liczba operacji, błędy uwierzytelniania, wielokrotne ponowienia lub masowe aktualizacje katalogu. Samo poprawne połączenie API nie dowodzi, że cały przepływ jest bezpieczny. Więcej o ochronie infrastruktury wyjaśniamy w materiale Bezpieczeństwo sieci dla firm.

Jakie błędy występują przy integracji Wapro Mag z IdoSell?

Jednym z częstszych problemów jest brak dostępu do operacji API. Powodem może być nieaktualny klucz, brak uprawnień do konkretnej bramki albo błędny adres panelu. Zamiast ponawiać żądanie bez końca, należy sprawdzić konfigurację autoryzacji i odczytać komunikat serwera. Inaczej łatwo zamienić pojedynczy problem w setki nieudanych operacji.

Druga grupa błędów dotyczy mapowania. Zamówienie zawiera wariant, którego nie powiązano z kartoteką Wapro, albo produkt ma różne indeksy po obu stronach. W takiej sytuacji integrator powinien zatrzymać konkretny rekord, zgłosić brak powiązania i pozwolić operatorowi na poprawienie danych. Automatyczne przypisanie „najbardziej podobnego” produktu może skończyć się wydaniem niewłaściwego towaru.

Trzecia grupa to problemy biznesowe: brak magazynu, nieznana forma płatności, błędna konfiguracja waluty, niezgodna kwota dostawy czy niemożliwość utworzenia dokumentu w ERP. Nie wynikają one bezpośrednio z awarii API. Wymagają znajomości konfiguracji handlowej firmy i sposobu jej pracy.

Czwarty rodzaj błędu występuje przy czasowej niedostępności któregoś systemu. Tu potrzebna jest kolejka, oznaczenie stanu i bezpieczne ponowienie. Operator powinien móc odróżnić „czeka na ponowienie” od „wymaga ręcznej korekty”, aby nie rozwiązywać każdego problemu przez restart całej integracji.

Jak rozpoznać, dlaczego zamówienie nie pojawiło się w Wapro?

Diagnostykę należy prowadzić po kolei: czy zamówienie istnieje w IdoSell, czy spełniło kryterium importu, czy integrator je odebrał, czy prawidłowo dopasowano towary i klienta, a na końcu czy operacja zapisu do Wapro zakończyła się sukcesem. Taki podział usuwa zgadywanie, czy problem tkwi w sklepie, sieci, SQL Server czy samym mapowaniu.

Jeżeli zamówienie nadal ma status, którego firma nie importuje, problem może wynikać z reguł procesu, a nie awarii. Jeśli integrator otrzymał identyfikator, ale nie potrafi odnaleźć produktu, potrzebna jest poprawa kartoteki. Jeżeli dokument w ERP już istnieje, lecz aplikacja nie zapisała potwierdzenia, trzeba ustalić wynik poprzedniej próby przed ponowieniem.

Przydatny jest dziennik zawierający identyfikator zamówienia IdoSell, czas ostatniego odczytu, etap przetwarzania, przyczynę zatrzymania i powiązany dokument Wapro. Log bez tych informacji, pokazujący tylko „błąd integracji”, często nie wystarczy do szybkiego przywrócenia działania.

Dobrze też sprawdzać, czy nie występuje opóźnienie webhooka albo przerwa w komunikacji z panelem. Wbudowane w IdoSell dzienniki zdarzeń mogą pomóc ustalić, czy webhook został wysłany i jaką odpowiedź otrzymał. To nie zastępuje dziennika integratora, ale ułatwia rozdzielenie odpowiedzialności.

Jak zaprojektować kolejki, ponowienia i kontrolę obciążenia API?

Kolejka synchronizacji porządkuje operacje, które nie muszą zostać wykonane w tej samej milisekundzie. Gdy sklep przekaże wiele zamówień, aplikacja może przygotować je do przetwarzania, a następnie wykonywać kolejne zadania zgodnie z dostępnymi zasobami. W przypadku niepowodzenia konkretna operacja nie powinna blokować całej kolejki bez wyraźnego powodu.

Ponawianie musi zależeć od rodzaju błędu. Tymczasowa niedostępność usługi może uzasadniać ponowną próbę po opóźnieniu. Błąd autoryzacji zwykle wymaga poprawienia uprawnień. Brak kartoteki produktu wymaga naprawy danych. Powtarzanie wszystkich trzech przypadków w taki sam sposób generuje ruch i utrudnia diagnostykę.

Przy aktualizacji dużej liczby produktów korzystne może być przesyłanie wyłącznie rekordów zmienionych od ostatniej synchronizacji, a nie pełnego katalogu. Pomagają też grupowanie operacji, paginacja, znaczniki czasu i limity równoległości, o ile konkretne bramki API oferują potrzebne mechanizmy. Parametry należy dobrać do aktualnej dokumentacji i obserwowanych odpowiedzi.

Warto kontrolować trzy wskaźniki: długość kolejki, wiek najstarszego zadania i liczbę zadań wymagających uwagi. Dzięki temu można zauważyć narastające opóźnienie, zanim klient zgłosi, że sklep pokazuje nieaktualne stany lub zamówienia nie trafiają do magazynu.

Jak przetestować integrację IdoSell z Wapro Mag przed uruchomieniem?

Testy powinny obejmować zarówno poprawne operacje, jak i sytuacje wyjątkowe. Zacznij od jednego zamówienia z jednym produktem, a następnie sprawdź zamówienie wielopozycyjne, różne metody dostawy i płatności, produkt z wariantami oraz zakup przez kontrahenta B2B. Każdy wynik porównaj w obu systemach, zamiast opierać się tylko na zielonym komunikacie „sukces”.

Kolejny etap to awarie kontrolowane: chwilowe przerwanie dostępu do API, wyłączenie konektora, błędny klucz, brak kartoteki i ponowne przetworzenie tego samego zamówienia. W ten sposób sprawdzisz, czy dane nie giną, kolejka wznawia pracę, a duplikaty nie powstają po odzyskaniu połączenia.

Testy stanów magazynowych warto przeprowadzić dla kilku magazynów, rezerwacji i bufora bezpieczeństwa. Przy cenach należy sprawdzić promocję, rabat B2B, różne stawki VAT oraz zmianę ceny podczas aktywnego zamówienia. Jeśli firma korzysta ze zwrotów, weryfikujemy także ich wpływ na stany oraz dokumenty.

Przed produkcją przygotuj kopię zapasową odpowiednich danych, procedurę przywrócenia poprzedniego sposobu pracy i osobę odpowiedzialną za zatwierdzenie rezultatów. Pierwsze uruchomienie najlepiej wykonać etapami: od odczytu danych, przez małą grupę aktualizacji, do pełnego zakresu. Automatyzacja nie powinna zaczynać się od nieodwracalnej zmiany tysięcy produktów.

Przykład integracji: sklep IdoSell i dwa magazyny w Wapro Mag

Wyobraźmy sobie firmę sprzedającą wyposażenie biurowe. Sklep działa w IdoSell, a Wapro Mag obsługuje magazyn centralny i magazyn przy punkcie odbioru. Dotychczas pracownicy przepisują zamówienia ręcznie, a stan na stronie jest aktualizowany raz dziennie. Prowadzi to do problemów, gdy jeden z magazynów wyda towar, który sklep nadal pokazuje jako dostępny.

Firma przyjmuje zasadę, że zamówienia z odpowiednim statusem w IdoSell trafiają do Wapro, a stan publikowany w sklepie jest wyliczany z wybranych magazynów po uwzględnieniu rezerwacji. Dla produktów szczególnie szybko rotujących utrzymuje dodatkowy bufor. Każde zamówienie ma jednoznaczne powiązanie z dokumentem ERP, aby nie mogło zostać dodane ponownie po przerwie w komunikacji.

W praktyce pojawiają się wyjątki. Jednego produktu brakuje w kartotece, a drugi występuje w dwóch wariantach. Zamiast tworzyć błędne dokumenty, integracja oznacza te zamówienia do sprawdzenia. Pozostałe operacje są przetwarzane normalnie. Raport dzienny wskazuje, ile zamówień przeniesiono i które wymagają interwencji.

To przykład hipotetyczny, pokazujący sposób projektowania przepływu danych. Konkretne możliwości i zakres automatyzacji zależą od konfiguracji IdoSell, Wapro Mag i wybranego rozwiązania integracyjnego.

Ile kosztuje integracja Wapro Mag z IdoSell?

Koszt zależy od zakresu, liczby sklepów i magazynów, liczby produktów, niestandardowych reguł oraz oczekiwanego sposobu utrzymania. Prosta wymiana zamówień wymaga innej liczby prac niż proces obejmujący wielomagazynowość, kilka cenników, rabaty B2B, zwroty i szczególne zasady obsługi dokumentów. Dlatego jedna publiczna kwota bez opisu wymagań może być myląca.

Warto rozdzielić opłatę za ewentualne narzędzie integracyjne, koszty konfiguracji, wdrożenia i późniejszego utrzymania. Dostępne na rynku rozwiązania mogą rozliczać się różnie; aktualne warunki należy sprawdzić u danego dostawcy. Ważniejszy od samej ceny początkowej jest całkowity koszt pracy: czy operatorzy nadal poprawiają zamówienia ręcznie i kto odpowiada za przywrócenie synchronizacji po awarii.

Opłacalność można policzyć prostym modelem. Jeżeli pracownik przepisuje 30 zamówień dziennie i poświęca średnio 4 minuty na każde, daje to 120 minut dziennie. Przy 20 dniach roboczych powstaje około 40 godzin pracy w miesiącu. To ilustracyjne wyliczenie, nie deklaracja oszczędności dla każdego sklepu. Trzeba odjąć czas kontroli wyjątków, uwzględnić koszt wdrożenia oraz rzeczywistą liczbę czynności zautomatyzowanych.

Przed złożeniem zapytania warto przygotować informację o liczbie zamówień, magazynach, strukturze produktów i zakresach danych. Dzięki temu łatwiej porównać oferty dotyczące tego samego rezultatu, a nie tylko podobnie brzmiącej nazwy usługi.

Kiedy potrzebna jest indywidualna integracja IdoSell z Wapro Mag?

Indywidualne połączenie warto rozważyć, gdy standardowy przepływ danych nie odpowiada na potrzeby firmy. Przykładowo przedsiębiorstwo może mieć własny proces rezerwacji, kilka różnych magazynów, specyficzne uprawnienia klientów B2B albo dodatkową aplikację magazynową. Wtedy konieczne może być opracowanie reguł, których nie da się wyrazić zwykłym wyborem opcji w konfiguratorze.

Kolejny powód to potrzeba centralizacji kilku systemów. Firma może jednocześnie korzystać z ERP, własnej platformy sprzedażowej, narzędzia logistycznego i analityki. Zamiast budować wiele niezależnych przepływów, można rozważyć warstwę integracyjną odpowiedzialną za porządek danych, monitorowanie błędów i spójność identyfikatorów. Nie zawsze jest to konieczne, ale przy rozbudowanej infrastrukturze bywa bardziej przejrzyste.

Nie należy jednak zamawiać indywidualnego rozwiązania tylko dlatego, że jest „bardziej zaawansowane”. Jeżeli zakres firmy dobrze odpowiada gotowemu narzędziu, dodatkowe komplikowanie architektury może nie przynieść korzyści. Najlepsza decyzja wynika z porównania wymagań funkcjonalnych, niezawodności, bezpieczeństwa i całkowitego kosztu utrzymania.

Decydujące są też możliwości wsparcia: kto diagnozuje błędy, kto aktualizuje integrację po zmianach API i jak szybko firma może odzyskać poprawną wymianę danych. Te zagadnienia warto uzgodnić przed uruchomieniem, nie dopiero po pierwszej awarii.

Jak ROVENS pomaga połączyć Wapro Mag z IdoSell?

ROVENS posiada dedykowaną platformę integracyjną Wapro Mag, przeznaczoną do wymiany danych między systemem ERP a zewnętrznymi aplikacjami. Jeśli chcesz zintegrować Wapro Mag z IdoSell, skontaktuj się z nami i opisz proces sprzedaży, magazynowania oraz obsługi zamówień. Pomożemy ustalić odpowiedni zakres połączenia i sposób realizacji synchronizacji.

Rozmowę warto zacząć od konkretnego problemu. Czy pracownicy przepisują zamówienia? Czy sklep pokazuje nieaktualne stany? Czy w firmie funkcjonują różne cenniki i kilka magazynów? Czy problem dotyczy duplikatów, danych kontrahentów albo aktualizacji cen? Te informacje pozwalają skupić się na tym, co naprawdę wpływa na działanie firmy.

W ramach planowania połączenia należy określić systemy źródłowe, mapowanie danych, warunki synchronizacji, środowisko testowe i sposób kontrolowania błędów. Klient nie musi sam projektować komunikacji API. Powinien natomiast wskazać, jakie działania jego zespół wykonuje dziś ręcznie i jaki efekt ma przynieść automatyzacja.

Sprawdź szczegóły usługi: Integracja Wapro Mag – ROVENS. Przydatne są również poradniki Co to jest REST API? oraz Co to jest automatyzacja?, które wyjaśniają podstawy wymiany danych między aplikacjami.

Tabela: jakie dane synchronizować w którym kierunku?

Poniższa tabela jest przykładem podziału odpowiedzialności, nie domyślnym ustawieniem IdoSell ani zapewnieniem, że każde wdrożenie ma identyczny zakres. Ma pomóc właścicielowi firmy opisać oczekiwania przed zleceniem prac. Konkretne kierunki i dostępność operacji zależą od wybranego wariantu połączenia.

Obszar danych	Przykładowy kierunek	Co trzeba ustalić
Nowe zamówienia	IdoSell → Wapro Mag	Kiedy importować i jak nie tworzyć duplikatów
Dostępność towaru	Wapro Mag → IdoSell	Magazyny, rezerwacje, bufor bezpieczeństwa
Ceny bazowe	Wapro Mag → IdoSell	Cennik, VAT, waluty, wykluczenie promocji
Status realizacji	Zależnie od procesu	Który system potwierdza pakowanie i wysyłkę
Klienci i kontrahenci	Według uzgodnionych reguł	NIP, identyfikatory, aktualizacja danych
Zwroty	Według obsługi zwrotów	Przyjęcie towaru, korekty i statusy
Numer przesyłki	System logistyczny / ERP → sklep	Moment nadania i sposób powiązania paczki

Tabela przypomina, dlaczego słowo „dwukierunkowa” nie jest wystarczającym opisem integracji. Dane w poszczególnych obszarach mogą płynąć w różnych kierunkach. Ważniejsze od hasła marketingowego jest to, czy informacje pozostają spójne i czy wiadomo, w którym systemie należy poprawić błąd.

Checklista przed uruchomieniem integracji IdoSell z Wapro Mag

Przed pracami warto zebrać dane techniczne i biznesowe. Dzięki temu wykonawca nie będzie musiał ustalać podstawowych zasad dopiero w chwili pierwszej awarii. Lista może również służyć do odbioru wdrożenia po testach.

1. Środowisko Wapro: wersja programu, lokalizacja serwera SQL, liczba podmiotów i ewentualne dodatki.
2. Sklep IdoSell: identyfikacja panelu, liczba witryn, dostęp do właściwego interfejsu API i metoda autoryzacji.
3. Towary: liczba kartotek, indeksy, SKU, warianty, zestawy, produkty nieaktywne.
4. Magazyny: lista lokalizacji, sposób liczenia stanu dostępnego, rezerwacje i bufor.
5. Zamówienia: kryterium importu, rodzaje płatności, sposoby dostawy, sposób mapowania klientów.
6. Ceny: kierunek synchronizacji, cenniki, waluty, rabaty, promocje i podatki.
7. Zwroty i statusy: zasady aktualizacji, odpowiedzialność za dokumenty i przesyłki.
8. Bezpieczeństwo: osobne klucze API, uprawnienia, sposób dostępu do Wapro i przechowywanie sekretów.
9. Testy: środowisko testowe, próbne zamówienia, przypadki błędów, plan wycofania zmian.
10. Utrzymanie: monitoring kolejki, raport błędów, osoba do kontaktu i czas reakcji.

Nie każda mała firma będzie potrzebować wszystkich elementów od pierwszego dnia. Nawet wtedy warto jawnie oznaczyć punkty, których integracja nie obejmuje, zamiast pozostawiać domysły o tym, co powinno działać automatycznie.

FAQ – najczęstsze pytania o integrację Wapro Mag z IdoSell

Podsumowanie – jak skutecznie zintegrować Wapro Mag z IdoSell?

Integracja Wapro Mag z IdoSell powinna zaczynać się od analizy danych i procesów, a nie od instalowania kolejnego programu. Warto ustalić, jak zamówienia trafiają do ERP, jakie magazyny wpływają na dostępność w sklepie, kto zarządza cenami oraz w jaki sposób kontrolowane są błędy. Dopiero wtedy wybiera się narzędzia i zakres prac.

IdoSell udostępnia Admin API, webhooki i rozwiązania integracyjne, w tym udokumentowany IdoSell Bridge. Po stronie Wapro konieczne jest dostosowanie komunikacji do rzeczywistej konfiguracji systemu. Niezależnie od metody najważniejsze są poprawne identyfikatory produktów i zamówień, brak duplikatów, bezpieczeństwo dostępów oraz widoczność wyników synchronizacji.

Jeżeli planujesz połączenie sklepu IdoSell z Wapro Mag, możesz skontaktować się z ROVENS. ROVENS posiada dedykowaną platformę integracyjną Wapro Mag i pomaga planować wymianę danych z systemami zewnętrznymi. Szczegółowe informacje znajdziesz na stronie integracja Wapro.

Te artykuły mogą okazać się pomocne

Jak zintegrować Wapro Mag z Magento 2? Zamówienia, magazyn, ceny i API

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

Jak zintegrować Wapro Mag z Shoper? Metody połączenia, zamówienia i synchronizacja magazynu

Czym są Wapro Czynności automatyczne? Jak działają, jak je uruchomić i rozwiązywać problemy?

Co to jest automatyzacja? Definicja, przykłady i zastosowanie w firmie

Co to jest REST API (RESTful API)? Jak działa i do czego służy?

Jak połączyć Wapro Mag z platformą marketplace inną niż Allegro?

Jak połączyć Wapro Mag z platformą B2B inną niż WAPRO Hybrid?

Jak połączyć Wapro Mag z zewnętrznym systemem WMS?

Jak zintegrować Wapro Mag z systemem kurierskim (InPost, DPD, DHL)?