Integracja API
Łączę Twój sklep, stronę lub aplikację z systemami zewnętrznymi, żeby dane przechodziły między nimi automatycznie, bez ręcznego przepisywania. Najczęściej są to hurtownie, systemy ERP, CRM i serwisy marketplace, a połączenie buduję sam, niezależnie od tego, jak drugi system udostępnia dane. Dostajesz integrację dwukierunkową na bieżąco albo jednokierunkową o ustalonej porze, z monitoringiem, obsługą awarii drugiej strony i dokumentacją.
Wszystkie usługi realizuję sam - bez podwykonawców i bez pracowników. Piszesz do mnie, odpowiadam ja.
Kluczowe korzyści
Co dostajesz w ramach tej usługi i co to zmienia w Twojej firmie.
Synchronizacja danych na bieżąco
Zmiana w jednym systemie od razu trafia do drugiego: stany magazynowe, ceny, zamówienia i dane klientów aktualizują się same. Nie przepisujesz niczego ręcznie.
Bezpieczne klucze i połączenia
Tokeny, hasła i klucze trzymam w zmiennych środowiskowych, nigdy w kodzie, więc nie wyciekną razem z nim. Dane idą szyfrowanym połączeniem, a każdą przychodzącą paczkę sprawdzam, zanim trafi do Twojego systemu.
Monitoring i alerty
Każdą wymianę danych zapisuję. Gdy połączenie się zerwie (timeout albo błąd serwera), integracja ponawia próbę z rosnącym odstępem. O poważnych błędach powiadamia Ciebie i mnie.
Obsługa awarii drugiej strony
Gdy zewnętrzny system nie odpowiada, zadania czekają w kolejce i wykonują się po jego powrocie, a w razie potrzeby da się je wznowić ręcznie. Klient sklepu nie widzi błędu, a zamówienie trafia do realizacji.
Mapa integracji w dokumentacji
Opisuję, skąd pochodzą dane, jak się przekształcają i w jakich formatach są. Za rok łatwo sprawdzić, jak działa integracja.
Każdy format i protokół
Łączę się tak, jak pozwala drugi system, od bezpośredniego połączenia po wymianę plików. Protokół dobieram do integracji i do tego, co udostępnia drugi system.
Podział odpowiedzialności
Po lewej to, co robię ja. Po prawej to, co zostaje po Twojej stronie.
- Sprawdzenie obu systemów: jak się logować, ile danych przyjmują naraz, w jakiej postaci i czego brakuje w ich instrukcji
- Mapa danych: które pole odpowiada któremu i jak się przekształca
- Implementacja z kolejką, ponawianiem żądań i logowaniem każdego wywołania
- Testy jednostkowe logiki i integracyjne dla scenariuszy błędnych oraz przekroczonego czasu odpowiedzi
- Klucze dostępu trzymane poza kodem, szyfrowane połączenia i sprawdzanie każdej przychodzącej paczki danych
- Uruchomienie na produkcji i codzienne sprawdzanie logów przez pierwszy miesiąc
- Dostępy do obu systemów, razem z kontem testowym, jeśli dostawca je udostępnia
- Kontakt do wsparcia technicznego drugiej strony, gdy dokumentacja czegoś nie opisuje
- Decyzja, który system jest nadrzędny przy rozbieżności danych
- Testy akceptacyjne na własnych scenariuszach i potwierdzenie wyniku
- Opłaty za konta, licencje i limity zapytań po stronie zewnętrznych dostawców
Proces realizacji
5 kroków. Po każdym wiesz, co dostajesz i co jest następne.
-
Analiza obu systemów
Sprawdzam, jak każdy system udostępnia dane, ile naraz, jak się logować i w jakiej postaci przychodzą informacje. Jeśli system nie pozwala łączyć się bezpośrednio, szukam obejścia: automatycznych powiadomień, wymiany plików, a w ostateczności odczytu danych ze strony.
-
Mapowanie danych
Spisuję, które pole w jednym systemie odpowiada któremu w drugim, razem z przekształceniami (format daty, jednostki miary, kody walut). Bez tego kroku dane się rozjeżdżają.
-
Implementacja
Buduję integrację z kolejką, ponawianiem nieudanych żądań i logowaniem, na środowisku testowym. Testy jednostkowe sprawdzają logikę, a integracyjne scenariusze zwykłe, błędne i z przekroczonym czasem odpowiedzi.
-
Testy akceptacyjne na Twoich danych
Sprawdzasz integrację na prawdziwych scenariuszach: zamawiasz produkt, zmieniasz stan, anulujesz zamówienie. Ja pilnuję, żeby dane przechodziły poprawnie w każdym kierunku.
-
Wdrożenie produkcyjne i monitoring
Włączamy integrację na produkcji. Przez pierwsze 30 dni codziennie sprawdzam logi i poprawiam drobne błędy.
- Bezpośredni kontakt - bez opiekunów klienta
- Spotkania statusowe co tydzień
- Dokumentacja techniczna w cenie
- 1 miesiąc wsparcia po wdrożeniu
Cennik
Ceny netto. Konkretną kwotę dostajesz przed startem i nie zmienia się w trakcie, chyba że rozszerzysz zakres.
- Jeden kierunek przepływu, na przykład nowy klient ze sklepu do CRM
- Uwierzytelnianie, obsługa limitów zapytań i logowanie wywołań
- Ponawianie nieudanych żądań z rosnącym odstępem
- Mapa pól: co skąd pochodzi i jak się przekształca
- Uruchomienie na produkcji i miesiąc wsparcia
- Przepływ w obie strony dla wybranych danych: produktów, stanów, zamówień, klientów
- Kolejka zadań, ponawianie i powiadomienie o poważniejszym błędzie
- Automatyczne powiadomienia zamiast ciągłego dopytywania, gdy druga strona je udostępnia
- Testy jednostkowe logiki i integracyjne dla scenariuszy błędnych oraz przekroczonego czasu odpowiedzi
- Testy akceptacyjne na realnych danych przed uruchomieniem
- Dokumentacja mapy danych i miesiąc wsparcia
- Warstwa pośrednicząca między systemami, z własnym modelem danych
- Przekształcenia formatów, jednostek, walut i kodów po obu stronach
- Kolejki, harmonogramy i wznawianie przerwanych przebiegów
- Podgląd logów i ręczne ponowienie pojedynczego zadania
- Dokumentacja integracji i procedura rotacji kluczy
Ceny netto. Wycenę podaję po przejrzeniu instrukcji obu systemów - bez tego każda kwota byłaby zgadywaniem, bo najwięcej pracy pochłania nie samo programowanie, tylko mapowanie danych i scenariusze awaryjne. Mikro-zakresy i poprawki po wdrożeniu rozliczam po 150 zł netto za godzinę, monitoring i dostosowania w razie zmian po stronie drugiego systemu to pakiet od 169 zł netto miesięcznie. Integracja zamawiana razem z budową sklepu rozliczana jest w pozycji Integracje ERP / API, czyli 500-20000 zł netto.
Czy na pewno potrzebujesz połączenia automatycznego
Wiele firm wymienia dane między systemami zwykłymi plikami i to im wystarcza. Poniżej różnice, które pokazują, kiedy warto przejść na połączenie automatyczne.
| Co porównujemy | Połączenie automatyczne | Ręczny eksport i import plików |
|---|---|---|
| Aktualność danych | Dane przechodzą na bieżąco albo w ustalonych odstępach, bez udziału człowieka. | Dane są aktualne na moment ostatniego eksportu. Między jednym a drugim systemy się rozjeżdżają. |
| Czyjś czas | Po uruchomieniu nikt nie musi nic klikać. | Ktoś musi pamiętać o eksporcie, wgraniu pliku i sprawdzeniu, czy import przeszedł. |
| Błędy | Nieudane zadanie wraca do kolejki, widać je w logach i da się je ponowić. | Błąd w pliku wychodzi zwykle dopiero wtedy, gdy klient zamówi produkt, którego nie ma. |
| Skala | Duże wolumeny danych przechodzą w tle, bez wpływu na pracę sklepu. | Przy dużych plikach import trwa długo i potrafi obciążyć sklep w godzinach sprzedaży. |
| Koszt startu | Wyższy, bo trzeba przeanalizować oba systemy i zmapować dane. | Zwykle zerowy, bo eksport i import masz wbudowane w oba systemy. |
Jeśli wymieniasz dane raz dziennie lub rzadziej, rekordów jest niewiele, a cała praca zajmuje kilkanaście minut, zwykły plik wystarczy. Zwłaszcza gdy oba systemy pozwalają zaplanować eksport i import, bo wtedy masz część korzyści z integracji bez jej kosztu. Automatyczne połączenie opłaca się, gdy dane muszą być zgodne w ciągu minut, gdy ktoś przepisuje je codziennie albo gdy rozjazd stanów kończy się anulowanymi zamówieniami. Po przejrzeniu Twoich procesów powiem, która sytuacja dotyczy Ciebie.
Czasy reakcji
To górne granice czasu. Zgłoszenia trafiają bezpośrednio do mnie.
Pytanie w trakcie projektu Wątpliwość do mapowania pól, decyzja o zachowaniu integracji przy błędzie, pytanie o postęp | do 24h |
Etap do testów akceptacyjnych Integracja na środowisku testowym, gotowa do sprawdzenia na Twoich realnych scenariuszach | zgodnie z harmonogramem etapu |
Błąd w okresie wsparcia Dane przestały przechodzić, zadania zatrzymały się w kolejce, druga strona odrzuca żądania | do 24h |
Zmiana po stronie drugiego systemu Dostawca wyłącza starą wersję interfejsu albo zmienia format danych | w ramach pakietu utrzymaniowego |
Najczęstsze pytania i odpowiedzi
Pytania, które słyszę najczęściej. Jeśli nie ma tu Twojego, napisz.
Ile kosztuje integracja API?
Jak długo trwa integracja API?
Co, jeśli zewnętrzny system nie ma API?
Czy połączysz sklep z systemem, którego nie obsługuje BaseLinker?
Co z bezpieczeństwem - klucze dostępu i hasła?
Czy integracja będzie utrzymywana po wdrożeniu?
Czy integracja poradzi sobie z awarią po drugiej stronie?
Kiedy warto
Sytuacje, w których ta usługa ma sens. Jeśli Twoja jest inna, napisz, powiem wprost.
- Sklepy, które potrzebują połączenia z systemem spoza BaseLinkera i gotowych konektorów
- Firmy z własnym ERP, CRM lub systemem magazynowym, które potrzebują integracji na zamówienie
- Platformy B2B, które muszą synchronizować dane z systemami swoich klientów
- Sklepy pobierające dane z hurtowni lub serwisów sprzedażowych w niestandardowy sposób
- Aplikacje internetowe i mobilne, które działają na wymianie danych z innymi systemami
- Firmy rozczarowane gotową integracją, która okazała się wolna, błędna albo niepełna
Kiedy nie warto
- Priorytetem jest najniższa cena - u mnie płaci się za jakość i wsparcie, nie za najtańszy gotowiec.
- Projekt ma powstać z dnia na dzień, bez ustaleń - pracuję według ustalonego procesu, nie w pośpiechu.
- Wystarczy prosty kreator lub gotowy szablon - wtedy dedykowana realizacja będzie nadmiarem.
Powiązane usługi
Usługi, które najczęściej łączę z tą.
Integracja BaseLinker
Sklep, Allegro, kurierzy i ERP w jednym panelu BaseLinker
Integracja ERP / CRM
Subiekt, Comarch, enova - synchronizacja produktów, zamówień i klientów
Integracje sklepu internetowego
BaseLinker, ERP, hurtownie, kurierzy, Allegro
Wtyczki WordPress / WooCommerce
Wtyczki WordPress i WooCommerce na zamówienie - dokładnie tak, jak potrzebujesz
Moduły PrestaShop
Moduły PrestaShop na zamówienie - logika biznesowa i integracje
Bezpłatna wycena
Pokażę Ci, co warto poprawić na Twojej stronie. Nie musisz mieć gotowego projektu ani wiedzieć, czego dokładnie potrzebujesz - podaj adres strony albo opisz problem, a odpiszę w ciągu 24h z konkretnymi uwagami i orientacyjną wyceną.