Przejdź do treści

Automatyzacja i development

Integracja systemów przez API: jak połączyć sklep, ERP i CRM

Publikacja: Aktualizacja:
Czytaj poradnik
Jasna ilustracja automatyzacji procesów

Najważniejsze na początek

Połączenie sklepu, ERP, CRM lub systemu dystrybutora ma sens wtedy, gdy wiadomo, który system odpowiada za konkretne dane i co zrobić, gdy wymiana się nie powiedzie. Samo zestawienie API nie ustala własności pól, kolejności zmian ani procedury odzyskania danych.

Zaplanuj integrację API sklepu, ERP, CRM i dystrybutora. Zobacz mapę danych, metody wymiany, obsługę błędów i checklistę odbioru.

W tym poradniku

Krótka odpowiedź: Integrację systemów przez API zacznij od mapy danych: dla każdego pola wskaż źródło prawdy, odbiorcę, kierunek, częstotliwość i regułę błędu. Następnie wybierz API, webhook, plik lub gotowy konektor zgodnie z wymaganym przepływem i możliwościami systemów. Odbiór powinien sprawdzić poprawny przebieg, duplikat, brak danych, przerwę oraz ponowienie.

Czym jest integracja systemów przez API i co trzeba ustalić na początku?

Integracja systemów przez API wymienia dane lub zleca operacje między aplikacjami zgodnie z możliwościami ich interfejsów. API to udokumentowany sposób, w jaki jedna aplikacja może odczytać albo zmienić dane drugiej. Zanim połączysz sklep z ERP lub CRM, wskaż źródło prawdy dla każdego pola, czyli system, którego wartość ma być uznana za nadrzędną.

Ustal wersje systemów, plan abonamentowy, właściciela pola, kierunek przepływu, częstotliwość i reakcję na błąd. Zapisz także, kto odbiera alerty i jak uzgadnia dane po przerwie. Konkretne operacje i dostępne pola zależą od dokumentacji oraz konfiguracji danego systemu.

Mapa integracji powinna zawierać co najmniej te kolumny:

Tabela: przykładowa mapa odpowiedzialności za pola w integracji

PoleSystem źródłowyOdbiorcaKierunekReguła konfliktu
Cena produktuDo ustalenia dla wdrożeniaSystem sprzedażyŹródło do odbiorcyOdrzuć zmianę spoza źródła
Stan dostępnySystem wskazany przez firmęSklepŹródło do odbiorcyOznacz brak odpowiedzi jako nieaktualny
Status zamówieniaSystem prowadzący obsługęSystem powiązanyZależny od statusuMapuj tylko uzgodnione statusy
Dane kontaktoweFormularz lub CRMCRM lub system powiązanyZależny od operacjiNie nadpisuj pól bez reguły

Wartości w tabeli są wzorem do uzupełnienia dla konkretnej firmy, a nie specyfikacją konkretnego ERP lub sklepu. Przy stanach magazynowych określ też, po jakim czasie nieaktualna wartość ma ograniczyć sprzedaż.

Jeśli firma potrzebuje wdrożenia gotowego przepływu sprzedażowego, integracja z BaseLinkerem może obejmować konfigurację procesu zależnie od używanych systemów. Przed wyceną trzeba uzgodnić zakres danych, warunki dostępu i scenariusze błędów.

Potrzebujesz pomocy we wdrożeniu? Zobacz Integracja z BaseLinkerem - poznaj zakres prac i sposób wyceny.

Wdrożenie w Twojej firmie

Jeśli chcesz przełożyć to na swoją firmę, kwadrans rozmowy wystarczy, żeby powiedzieć, od czego zacząć.

Wolisz zlecić to nam? Integracja z BaseLinkerem - wycena w 24h →

Bezpłatna wycena →

Kiedy wybrać API, webhook, plik CSV albo gotowy konektor?

API wybierz do odczytu lub zmiany danych, webhook do powiadomienia o zdarzeniu, CSV do kontrolowanej wymiany partii, a gotowy konektor wtedy, gdy obsługuje wymagane operacje w odpowiednich wersjach systemów. Webhook nie zastępuje API: może poinformować, że zmieniło się zamówienie, a integracja następnie pobiera jego aktualny stan przez API.

Tabela porównuje metody według sposobu działania i obsługi wyjątków.

Tabela: wybór metody wymiany danych

MetodaTyp przepływuPotwierdzenie odbioruObsługa błędówWarunek wyboru
APIOdczyt lub zapis na żądanieOdpowiedź interfejsuKody odpowiedzi i logiPotrzebne operacje są dostępne
WebhookPowiadomienie o zdarzeniuOdpowiedź endpointuDuplikaty i ponowieniaDostawca emituje potrzebne zdarzenie
CSVImport lub eksport partiiRaport importu lub uzgodnienieRekordy odrzucone i błędneDopuszczalny jest cykl wsadowy
Gotowy konektorPrzepływ z gotowego modułuStatus wykonania narzędziaLimity i funkcje konektoraModuł obejmuje potrzebne pola i akcje

Wybierz metodę, która zapewnia wymaganą częstotliwość i widoczny wynik błędu, bo sama łatwość konfiguracji nie gwarantuje poprawnego procesu.

Jak działa integracja sklepu internetowego z ERP przez API?

Integracja sklepu z ERP zwykle przekazuje zamówienie do systemu obsługi dokumentów, a następnie zwraca do sklepu uzgodnione statusy i informacje o wysyłce. ERP oznacza system planowania zasobów przedsiębiorstwa, który może prowadzić między innymi dokumenty sprzedażowe lub magazynowe. Dokładne pola i operacje zależą od dokumentacji obu systemów.

Tabela pokazuje typowy model przepływu do uzgodnienia.

Tabela: przykładowy przepływ zamówienia między sklepem a ERP

EtapDane lub operacjaWarunek poprawnego wynikuPrzypadek brzegowy
Sklep do integracjiID zamówienia, SKU, ilość i dane odbiorcyWymagane pola są kompletneBrak mapowania SKU
Integracja do ERPDokument z pozycjami i ID źródłowymERP zwraca własny identyfikatorPowtórzone żądanie
ERP do sklepuUzgodniony status dokumentuStatus dotyczy tego samego zamówieniaStatus spoza mapy
System wysyłkowy do sklepuNumer przesyłki i wysłane pozycjeCzęściowa wysyłka jest rozpoznanaJedna pozycja pozostaje niewysłana

ID źródłowe zapisuj po obu stronach, aby ponowienie mogło odnaleźć dokument zamiast utworzyć drugi. Częściowa wysyłka wymaga własnej reguły statusu; sama obecność numeru przesyłki nie musi oznaczać realizacji całego zamówienia.

Zalecamy odebrać przepływ na zamówieniu testowym z brakującym SKU i powtórzonym żądaniem, bo te próby ujawniają błędy, których nie pokaże pojedyncze poprawne zamówienie.

Jak połączyć sklep z dystrybutorem przez API?

Integracja sklepu z dystrybutorem przez API może pobierać produkty, ceny i dostępność, jeśli dostawca udostępnia te zasoby w dokumentacji i planie używanym przez firmę. Przed konfiguracją sprawdź warunki dostępu, limity zapytań, zasady identyfikacji produktów i to, czy odpowiedź zawiera dane magazynowe, czy tylko wartość zbiorczą.

Tabela porządkuje dane, które należy uzgodnić z dystrybutorem.

Tabela: mapa danych sklepu i dystrybutora

Jakie dane są wymieniane?Kierunek wymianyReguła mapowaniaReakcja na brak lub zmianę danych
Katalog produktówDystrybutor do sklepuID dostawcy i SKU sklepuKolejka do ręcznego dopasowania
CenaDystrybutor do sklepuWaluta i jednostka sprzedażyOdrzuć wartość bez waluty
DostępnośćDystrybutor do sklepuMagazyn i dostępna ilośćOznacz nieaktualność i uruchom uzgodnioną regułę sprzedaży
Opis i atrybutyDystrybutor do sklepuPola katalogu sklepuNie nadpisuj treści bez reguły

Uzgodnij, czy dystrybutor może zmieniać opisy, kategorie i zdjęcia, czy sklep zachowuje własną treść. Osobno sprawdź, czy API wysyła pełny katalog, czy tylko przyrost zmian. Tych zachowań nie można zakładać bez dokumentacji dostawcy.

Jak ustalić synchronizację stanów magazynowych i cen?

Synchronizację stanów i cen ustal wokół jednego wskazanego źródła dla każdej wartości oraz reguły aktualności danych. Dostępny stan może uwzględniać rezerwacje, bufor lub kilka magazynów, więc sklep nie powinien samodzielnie interpretować pustej odpowiedzi jako zera.

Zapisz częstotliwość pobierania, sposób oznaczania czasu aktualizacji, mapowanie SKU i zachowanie przy braku odpowiedzi. Jeśli źródło nie odpowiada, sklep może przechować ostatni znany stan wyłącznie jako nieaktualny. Ustal limit jego ważności; po jego przekroczeniu ogranicz lub wstrzymaj sprzedaż danego produktu do czasu potwierdzenia dostępności. Cena wymaga analogicznej reguły dla waluty, podatku, promocji i zaokrągleń, jeśli te informacje występują w systemach.

Test synchronizacji powinien obejmować zmianę wartości, brak mapowania produktu, niedostępność źródła i uzgodnienie danych po przywróceniu połączenia. Porównaj identyfikatory produktów i czas aktualizacji, a nie tylko sumę pozycji katalogu.

Jak działa integracja formularza lub strony z CRM?

Integracja formularza z CRM przekazuje zgłoszenie do właściwego kontaktu, sprawy lub zadania, zależnie od reguł firmy. CRM to system zarządzania relacjami z klientami. Zapisz ID zgłoszenia z formularza, źródło kontaktu i wynik operacji, aby ponowienie nie tworzyło przypadkowo nowego rekordu.

Tabela rozdziela dane, właściciela i wynik procesu.

Tabela: przepływ formularza do CRM

Jakie dane są przekazywane?Właściciel polaOczekiwany wynikPrzypadek wyjątku do testu
ID zgłoszeniaFormularzPowiązanie z operacją CRMPonowne przesłanie tego samego ID
Dane kontaktoweUzgodniony system źródłowyNowy kontakt albo aktualizacjaKontakt już istnieje
Temat zapytaniaFormularz lub CRMSprawa przypisana do zespołuBrak kategorii
Preferencje komunikacjiAdministrator danychZapis zgodny z ustalonym procesemBrak wymaganej wartości

Zgłoszenie może utworzyć osobną sprawę powiązaną z istniejącym kontaktem. Zdecyduj, które pola CRM wolno aktualizować automatycznie, by nowy formularz nie usuwał ręcznych ustaleń zespołu.

Jak obsłużyć błędy, duplikaty i ponowienia w integracji API?

Integracja API musi rozróżniać błąd chwilowy od błędu danych, bo ponawianie niepoprawnego rekordu zwykle nie rozwiązuje przyczyny. Idempotencja oznacza, że powtórzenie tej samej operacji nie tworzy kolejnego skutku, na przykład drugiego dokumentu. Powiąż zdarzenie z identyfikatorem źródłowym i zapisz wynik obsługi.

Błąd chwilowy, taki jak przerwa połączenia, może kwalifikować się do ponowienia zgodnie z regułami API. Brak wymaganego pola lub nieznane SKU wymaga korekty danych albo ręcznej decyzji. Log zapisuj z ID operacji, czasem, typem błędu i statusem, bez sekretów i niepotrzebnych danych klientów.

Dokumentacja Stripe webhooków wskazuje, że dostawca może ponownie dostarczyć to samo zdarzenie, a kolejność zdarzeń nie jest gwarantowana; informacje sprawdzono w listopadzie 2026. To opis zachowania Stripe, a nie limit każdego API. Reguły ponowień i limity odczytaj w dokumentacji konkretnego dostawcy.

Zalecamy utrwalić zdarzenie lub umieścić je w kolejce przed potwierdzeniem odbioru, jeśli architektura wymaga późniejszego przetwarzania. W przeciwnym razie odpowiedź potwierdzająca może zostać wysłana przed bezpiecznym zapisaniem pracy.

Jak wybrać Make, Zapier, n8n czy własną integrację?

Jeśli przepływ jest prosty, a gotowy konektor obsługuje wymagane akcje i pola, rozważ platformę integracyjną. Jeśli proces wymaga szczegółowej kontroli nad logiką, testami, przechowywaniem i utrzymaniem, rozważ własny kod. W obu przypadkach najpierw sprawdź możliwości konkretnej wersji systemu i wymagane operacje.

Make dokumentuje kolejkowanie danych przychodzących przez webhook, ustawienie kolejności przetwarzania i obsługę błędów; limity i zachowanie zależą od konfiguracji oraz planu. Zapier opisuje ponawianie i odtwarzanie błędnych przebiegów. Dokumentacja n8n opisuje przegląd i ponawianie wykonań workflow. Informacje sprawdzono w listopadzie 2026; przed wdrożeniem potwierdź bieżące warunki, wersję i zakres dostępnych funkcji.

Tabela porównuje decyzje, które trzeba podjąć przy wyborze rozwiązania.

Tabela: kryteria wyboru platformy integracyjnej

KryteriumMakeZapiern8nWłasna integracja
OperacjeSprawdź akcje i pola modułówSprawdź akcje i pola aplikacjiSprawdź węzły i APIImplementuj uzgodnione operacje
HostingSprawdź model usługi i planSprawdź model usługi i planUstal wariant chmurowy lub własnyUstal środowisko utrzymania
BłędySprawdź kolejkę i obsługę scenariuszaSprawdź autoreplay i odtwarzanieSprawdź ponawianie wykonaniaZaprojektuj log i ponawianie
UtrzymanieWskaż właściciela scenariuszaWskaż właściciela ZapówWskaż właściciela workflowWskaż właściciela kodu i wdrożeń

Platformę rozważ dla prostego przepływu z gotowym modułem, a kod dla logiki wymagającej większej kontroli; decyzję potwierdź testem reprezentatywnych wyjątków.

Jak odebrać i bezpiecznie monitorować integrację systemów?

Integrację systemów odbieraj na zestawie przypadków testowych i z przypisanym właścicielem monitoringu. Protokół powinien wskazywać dane wejściowe, oczekiwany wynik, uzyskany wynik, osobę akceptującą i sposób zgłoszenia błędu.

Tabela zawiera minimalny zestaw prób odbiorowych.

Tabela: przypadki testowe dla integracji systemów

PróbaOczekiwany wynikDowód do odbioruOsoba odpowiedzialna
Poprawny przebiegDane pojawiają się w systemie docelowymID źródłowe i wynik operacjiWłaściciel procesu
DuplikatBrak drugiego skutkuPowiązanie z pierwszym IDWłaściciel integracji
Brak wymaganego polaRekord zatrzymany lub oznaczonyKomunikat i status błęduWłaściciel danych
Przerwa połączeniaBłąd jest widoczny i możliwy do obsługiLog z czasem i przyczynąAdministrator systemu
Ponowienie po przerwieDane zostają uzgodnione bez duplikatuWynik ponownego przetworzeniaWłaściciel procesu

Monitoring powinien pokazywać błędy, ostatni udany przebieg i zaległe rekordy, jeśli narzędzie je udostępnia. Ogranicz uprawnienia tokenów, trzymaj sekrety po stronie serwera i usuń je z logów. Zapisz też procedurę cofnięcia dostępu i powrotu do poprzedniej obsługi.

Jeśli po analizie potrzebujesz wykonawcy do konfiguracji procesu sprzedażowego, wdrożenie integracji z BaseLinkerem można omówić na podstawie listy systemów, pól i testów odbiorowych. Przed startem trzeba potwierdzić dostępność wymaganych operacji w API i warunki posiadanych planów.

Najczęściej zadawane pytania

Czym jest integracja systemów przez API?

To uzgodniona wymiana danych lub operacji między aplikacjami przy użyciu ich udokumentowanych interfejsów. Zakres obejmuje mapowanie pól, identyfikatory, odpowiedzialność za dane i obsługę błędów. Sam klucz API nie definiuje reguł procesu.

Jak zintegrować sklep internetowy z systemem ERP przez API?

Najpierw ustal, które dane przechodzą do ERP i które statusy wracają do sklepu. Zapisz identyfikator zamówienia, mapowanie SKU, zachowanie dla częściowej wysyłki i regułę duplikatu. Szczegółowe pola potwierdź w dokumentacji obu systemów.

Jak działa integracja sklepu z dystrybutorem?

Integracja może pobierać katalog, ceny i dostępność, jeśli dostawca udostępnia takie dane w API i danym planie. Trzeba uzgodnić mapowanie SKU, walutę, magazyny oraz reguły brakujących wartości. Nie zakładaj, że API dystrybutora obsługuje pełną synchronizację.

Czy API może automatycznie uzupełniać produkty, ceny i stany?

Może, jeśli API udostępnia odpowiednie dane, a sklep i integracja potrafią je zapisać. Ustal źródło prawdy, częstotliwość, mapowanie produktów i zachowanie przy braku odpowiedzi. Przetestuj zmianę oraz nieznane SKU.

Co wybrać do integracji API: Make, Zapier, n8n czy własne rozwiązanie?

Dla prostego przepływu z gotowym konektorem rozważ platformę, a dla procesu wymagającego szczegółowej kontroli logiki i utrzymania rozważ kod. Porównaj obsługiwane operacje, hosting, uprawnienia i obsługę błędów. Wybór potwierdź testem reprezentatywnego przepływu z duplikatem i przerwą.

Źródła

Zdjęcie autora: Krzysztof Czapnik
O autorze

Krzysztof Czapnik

Founder & Technical Lead, KC Mobile

Projektuję i rozwijam strony WordPress, sklepy WooCommerce oraz aplikacje internetowe. Łączę projektowanie z programowaniem, integracjami i technicznym SEO. Projekty KC Mobile prowadzę osobiście.

Potrzebujesz pomocy z tym tematem? Napisz - odpowiem osobiście w 24h.

Zadzwoń Wycena