Przejdź do treści

ERP i e-commerce

Integracja ERP ze sklepem — API, middleware, retry i bezpieczeństwo

Dobra integracja nie jest pojedynczym wywołaniem API. Musi określić źródło prawdy, kierunek danych, reakcję na błąd, ponowienia, monitoring i granicę między publicznym sklepem a siecią wewnętrzną firmy.

Następny krok

Najpierw kwalifikujemy sytuację i wskazujemy, czy potrzebna jest konsultacja, diagnoza techniczna czy bezpośrednia wycena.

Opisz projekt →

01

Najpierw źródło prawdy

Dla produktów, cen, stanów, klientów i zamówień trzeba wskazać system nadrzędny. Jeżeli dwa systemy mogą niezależnie zmieniać tę samą wartość, integracja potrzebuje reguły konfliktu. Bez niej synchronizacja będzie okresowo nadpisywać poprawne dane starszą wersją.

02

Mapa komunikatów i identyfikatorów

Opisujemy, jakie zdarzenie uruchamia wymianę, które pola są wymagane i jak mapowane są identyfikatory po obu stronach. Warto rozdzielić utworzenie, aktualizację i anulowanie. Ten sam komunikat wysłany ponownie nie powinien tworzyć duplikatu.

03

Middleware jako warstwa odpowiedzialności

Serwer pośredniczący może izolować publiczny sklep od sieci wewnętrznej, transformować dane, buforować kolejkę i kontrolować uwierzytelnienie. Nie jest obowiązkowy w każdym projekcie, ale staje się wartościowy, gdy ERP nie powinien być wystawiony bezpośrednio albo oba systemy mają różne tempo i format komunikacji.

04

Retry, kolejka i idempotencja

Błąd sieci nie może automatycznie oznaczać utraty zamówienia. Integracja zapisuje komunikat, rozpoznaje błędy przejściowe i wykonuje kontrolowane ponowienie. Operacja powinna być idempotentna: ponowne przetworzenie tego samego zdarzenia nie tworzy drugiego dokumentu ani nie podwaja stanu.

05

Logi i obserwowalność

Potrzebny jest wspólny identyfikator przepływu, status, czas próby i czytelna przyczyna odrzucenia. Log techniczny nie może przechowywać niepotrzebnych danych osobowych ani sekretów. Zespół operacyjny powinien widzieć, które komunikaty czekają, wymagają reakcji albo zostały poprawnie obsłużone.

06

Bezpieczeństwo sieci wewnętrznej

Ograniczamy kierunki połączeń, uprawnienia kont technicznych i zakres dostępnych endpointów. Stosujemy szyfrowanie, rotację sekretów i weryfikację nadawcy. Warstwa pośrednia pozwala firmie udostępnić konkretny kontrakt danych bez otwierania całej infrastruktury ERP dla publicznej aplikacji.

07

Testy przed uruchomieniem

Sprawdzamy poprawny przepływ oraz sytuacje trudne: duplikat, brak pola, błąd ERP, przerwę sieci, opóźnioną odpowiedź, anulowanie i ponowienie. Po uruchomieniu porównujemy wartości kontrolne między systemami i ustalamy procedurę ręcznego wyjaśnienia rozbieżności.

Następny krok

Opisz systemy, kierunki danych, przybliżoną skalę i procesy, które mają zostać zsynchronizowane. Nie przesyłaj kluczy API ani danych produkcyjnych.

Opisz integrację →

Weryfikacja merytoryczna

Ostatnia aktualizacja: 28 lipca 2026 r.

Odpowiedzialny: zespół integracji i architektury Gotoweb.

Planujesz integrację sklepu z ERP?

Opisz systemy, kierunki danych, przybliżoną skalę i procesy, które mają zostać zsynchronizowane. Nie przesyłaj kluczy API ani danych produkcyjnych.