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
| Pole | System źródłowy | Odbiorca | Kierunek | Reguła konfliktu |
|---|---|---|---|---|
| Cena produktu | Do ustalenia dla wdrożenia | System sprzedaży | Źródło do odbiorcy | Odrzuć zmianę spoza źródła |
| Stan dostępny | System wskazany przez firmę | Sklep | Źródło do odbiorcy | Oznacz brak odpowiedzi jako nieaktualny |
| Status zamówienia | System prowadzący obsługę | System powiązany | Zależny od statusu | Mapuj tylko uzgodnione statusy |
| Dane kontaktowe | Formularz lub CRM | CRM lub system powiązany | Zależny od operacji | Nie 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
| Metoda | Typ przepływu | Potwierdzenie odbioru | Obsługa błędów | Warunek wyboru |
|---|---|---|---|---|
| API | Odczyt lub zapis na żądanie | Odpowiedź interfejsu | Kody odpowiedzi i logi | Potrzebne operacje są dostępne |
| Webhook | Powiadomienie o zdarzeniu | Odpowiedź endpointu | Duplikaty i ponowienia | Dostawca emituje potrzebne zdarzenie |
| CSV | Import lub eksport partii | Raport importu lub uzgodnienie | Rekordy odrzucone i błędne | Dopuszczalny jest cykl wsadowy |
| Gotowy konektor | Przepływ z gotowego modułu | Status wykonania narzędzia | Limity i funkcje konektora | Moduł 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
| Etap | Dane lub operacja | Warunek poprawnego wyniku | Przypadek brzegowy |
|---|---|---|---|
| Sklep do integracji | ID zamówienia, SKU, ilość i dane odbiorcy | Wymagane pola są kompletne | Brak mapowania SKU |
| Integracja do ERP | Dokument z pozycjami i ID źródłowym | ERP zwraca własny identyfikator | Powtórzone żądanie |
| ERP do sklepu | Uzgodniony status dokumentu | Status dotyczy tego samego zamówienia | Status spoza mapy |
| System wysyłkowy do sklepu | Numer przesyłki i wysłane pozycje | Częściowa wysyłka jest rozpoznana | Jedna 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 wymiany | Reguła mapowania | Reakcja na brak lub zmianę danych |
|---|---|---|---|
| Katalog produktów | Dystrybutor do sklepu | ID dostawcy i SKU sklepu | Kolejka do ręcznego dopasowania |
| Cena | Dystrybutor do sklepu | Waluta i jednostka sprzedaży | Odrzuć wartość bez waluty |
| Dostępność | Dystrybutor do sklepu | Magazyn i dostępna ilość | Oznacz nieaktualność i uruchom uzgodnioną regułę sprzedaży |
| Opis i atrybuty | Dystrybutor do sklepu | Pola katalogu sklepu | Nie 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 pola | Oczekiwany wynik | Przypadek wyjątku do testu |
|---|---|---|---|
| ID zgłoszenia | Formularz | Powiązanie z operacją CRM | Ponowne przesłanie tego samego ID |
| Dane kontaktowe | Uzgodniony system źródłowy | Nowy kontakt albo aktualizacja | Kontakt już istnieje |
| Temat zapytania | Formularz lub CRM | Sprawa przypisana do zespołu | Brak kategorii |
| Preferencje komunikacji | Administrator danych | Zapis zgodny z ustalonym procesem | Brak 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
| Kryterium | Make | Zapier | n8n | Własna integracja |
|---|---|---|---|---|
| Operacje | Sprawdź akcje i pola modułów | Sprawdź akcje i pola aplikacji | Sprawdź węzły i API | Implementuj uzgodnione operacje |
| Hosting | Sprawdź model usługi i plan | Sprawdź model usługi i plan | Ustal wariant chmurowy lub własny | Ustal środowisko utrzymania |
| Błędy | Sprawdź kolejkę i obsługę scenariusza | Sprawdź autoreplay i odtwarzanie | Sprawdź ponawianie wykonania | Zaprojektuj log i ponawianie |
| Utrzymanie | Wskaż właściciela scenariusza | Wskaż właściciela Zapów | Wskaż właściciela workflow | Wskaż 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óba | Oczekiwany wynik | Dowód do odbioru | Osoba odpowiedzialna |
|---|---|---|---|
| Poprawny przebieg | Dane pojawiają się w systemie docelowym | ID źródłowe i wynik operacji | Właściciel procesu |
| Duplikat | Brak drugiego skutku | Powiązanie z pierwszym ID | Właściciel integracji |
| Brak wymaganego pola | Rekord zatrzymany lub oznaczony | Komunikat i status błędu | Właściciel danych |
| Przerwa połączenia | Błąd jest widoczny i możliwy do obsługi | Log z czasem i przyczyną | Administrator systemu |
| Ponowienie po przerwie | Dane zostają uzgodnione bez duplikatu | Wynik ponownego przetworzenia | Wł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ą.