Integracja API pozwala używanym przez Państwa programom wysyłać do siebie dane i odbierać je nawzajem. Jeśli strona internetowa, sklep internetowy, system płatności, firma kurierska, konta na marketplace’ach, integrator e-Fatura i program księgowy przechowują te same informacje osobno, Państwa zespół codziennie ręcznie wpisuje te same dane na kilku ekranach. Łączymy te systemy przez ich API, aby dane trafiały we właściwe miejsce, we właściwym czasie i w sposób możliwy do prześledzenia.
Typowe przykłady tej usługi to automatyczne utworzenie przesyłki kurierskiej dla opłaconego zamówienia i wysłanie numeru śledzenia klientowi, wystawienie faktury jako e-Fatura lub e-Arşiv, aktualizacja produktów na Trendyol i Hepsiburada po zmianie stanu magazynowego czy przekazanie nowego zgłoszenia z formularza do CRM. Połączenia, do których gotowa wtyczka nie wystarcza i które muszą działać według Państwa reguł biznesowych, tworzymy na zamówienie.
Na tej stronie znajdą Państwo systemy, z którymi możemy się zintegrować, pogrupowane według kategorii i z nazwami firm: integracja API z firmami kurierskimi, integracja wirtualnego POS, integracja z marketplace’ami, integracja e-Fatura, połączenia z systemami księgowymi i ERP, SMS, WhatsApp, mapy, sztuczna inteligencja i wiele więcej. Przy każdej karcie wyjaśniamy też, do czego dana integracja służy w praktyce.
Dla kogo jest integracja API?
- Firmy e-commerce: Sklepy, które chcą z jednego miejsca zarządzać produktami, stanami, cenami i zamówieniami we własnym sklepie oraz na marketplace’ach, takich jak Trendyol, Hepsiburada, N11 i Amazon.
- Firmy codziennie nadające przesyłki: Przedsiębiorstwa, które chcą przestać ręcznie kopiować kody kreskowe, etykiety i numery śledzenia z panelu firmy kurierskiej.
- Zespoły finansowe i księgowe: Firmy, które zamiast wprowadzać każdą sprzedaż osobno do Logo, Mikro, Paraşüt lub integratora e-Fatura, chcą automatycznego przesyłania danych.
- Firmy usługowe i subskrypcyjne: Wszyscy, którzy chcą połączyć płatności online, płatności cykliczne, automatyczne faktury i powiadomienia dla klientów w jeden proces.
- Firmy udostępniające swoje oprogramowanie na zewnątrz: Przedsiębiorstwa, które chcą zapewnić bezpieczne i udokumentowane API dla swojej aplikacji mobilnej, dealerów lub partnerów biznesowych.
- Organizacje korzystające z wielu systemów: Zespoły, w których CRM, ERP, strona internetowa i narzędzia wewnętrzne przechowują różne wersje tych samych danych.
Co obejmuje nasza usługa API i integracji?
Podłączanie gotowych usług
Analizujemy dokumentację API usług płatniczych, kurierskich, marketplace’ów, księgowych i komunikacyjnych, ustalamy warunki dostępu i limity użycia, a następnie dodajemy połączenie do Państwa strony, panelu administracyjnego lub aplikacji mobilnej. Jeśli oprogramowanie stworzyła inna firma, najpierw sprawdzamy strukturę kodu i dostęp do serwera.
Projektowanie REST API i dokumentacja
Jeśli chcą Państwo udostępnić własny system na zewnątrz, projektujemy endpointy, struktury danych, kody błędów oraz zasady paginacji i autoryzacji. Dla każdego endpointu przygotowujemy dokumentację z przykładowymi żądaniami i odpowiedziami, dzięki czemu Państwa zespół mobilny lub partnerzy biznesowi konfigurują połączenie bez zgadywania.
Webhooki i przepływy oparte na zdarzeniach
Sprawiamy, że zdarzenie w jednym systemie natychmiast uruchamia działanie w drugim: zamówienie zostaje potwierdzone po zatwierdzeniu płatności, a klient dostaje powiadomienie, gdy zmienia się status przesyłki. Weryfikujemy podpis przychodzących webhooków i wykonujemy operację tylko raz, nawet jeśli to samo powiadomienie dotrze dwukrotnie.
Mapowanie danych i synchronizacja dwukierunkowa
W pisemnej tabeli mapowania ustalamy, które pole odpowiada któremu, który system jest źródłem nadrzędnym i co obowiązuje w razie konfliktu. Różnice w kategoriach, wariantach, stawkach podatku i jednostkach rozwiązujemy na tym etapie, zanim powstanie kod.
Zadania harmonogramowane i import zbiorczy
Dla systemów, które nie wysyłają powiadomień w czasie rzeczywistym, konfigurujemy zadania uruchamiane w określonych odstępach. Dzięki nim pliki XML od dostawców, zbiorcze cenniki, kursy walut i pliki stanów magazynowych są regularnie importowane lub eksportowane.
Ekrany w panelu i monitoring
Aby mogli Państwo śledzić stan integracji w panelu administracyjnym, możemy dodać logi operacji, listy błędów i ekrany ręcznej ponownej wysyłki. Gdy zamówienie nie zostanie przesłane, Państwa zespół sam widzi przyczynę i sposób ponownego wysłania rekordu.
Integracje płatności i wirtualnych POS
Integracja systemu płatności
Dodajemy płatności kartą do Państwa strony lub aplikacji: weryfikację 3D Secure, płatności ratalne, zwroty pełne i częściowe, a jeśli dostawca to obsługuje, także zapisane karty i płatności cykliczne. Wyniku płatności nie opieramy wyłącznie na przekierowaniu w przeglądarce, lecz potwierdzamy go powiadomieniem, które dostawca wysyła bezpośrednio z serwera na serwer. Dane kart nie są przechowywane na Państwa serwerze, lecz pobierane przez bezpieczny formularz płatności dostawcy.
Integracja bankowego wirtualnego POS
Jeśli mają Państwo bezpośrednią umowę z bankiem na wirtualny POS, łączymy płatności z infrastrukturą banku bez pośrednika. Zakres obejmuje proces 3D Secure, tabelę rat według programów kartowych, preautoryzację z późniejszym rozliczeniem, a także anulowanie i zwroty. Jeśli współpracują Państwo z kilkoma bankami, można skonfigurować kierowanie transakcji do właściwego POS według typu karty.
Integracje API z firmami kurierskimi i logistycznymi
Integracja API z krajowymi firmami kurierskimi
Po potwierdzeniu zamówienia przesyłka automatycznie powstaje w systemie firmy kurierskiej; kod kreskowy i etykietę drukuje się z Państwa panelu, a numer śledzenia trafia do zamówienia oraz do wiadomości e-mail lub SMS dla klienta. Statusy przesyłek są aktualizowane przez webhook lub regularne zapytania. Obliczanie wagi gabarytowej (desi) i kosztu, generowanie kodów zwrotu oraz informacje o płatności przy odbiorze konfigurujemy w zakresie, na jaki pozwala API przewoźnika. Najczęściej zamawiane są integracje z Yurtiçi Kargo, Aras Kargo i MNG Kargo.
Integracja z międzynarodowymi firmami kurierskimi
Jeśli wysyłają Państwo przesyłki za granicę, łączymy z Państwa systemem pobieranie wycen, tworzenie przesyłek, przygotowanie etykiet i dokumentów celnych, zamawianie kuriera oraz śledzenie międzynarodowe. W integracji API z DHL Express waga, wymiary i dane produktów potrzebne do odprawy celnej są pobierane automatycznie z zamówienia; to samo podejście stosujemy dla UPS, FedEx, Aramex i Royal Mail.
Integracje z marketplace’ami, e-Fatura i księgowością
Integracja z marketplace’ami
Zarządzają Państwo produktami w jednym miejscu, a my przesyłamy je na marketplace’y: mapowanie kategorii i atrybutów, aktualizacja stanów i cen, pobieranie zamówień do Państwa panelu, odsyłanie danych przesyłki na marketplace oraz obsługa anulowań i zwrotów. Najczęściej zamawiane są integracja API z Trendyol, integracja z Hepsiburada i połączenie z Amazon SP-API. Można też zdefiniować osobne reguły cen lub stanów dla poszczególnych marketplace’ów.
Integracja z platformami e-commerce
Jeśli Państwa sklep działa na Shopify, WooCommerce lub innej platformie, łączymy zamówienia z programem księgowym, a stany magazynowe z systemem magazynowym lub ERP. Te same połączenia wykorzystujemy przy migracji danych o produktach, klientach i zamówieniach z jednej platformy na drugą.
Integracja e-Fatura, e-Arşiv i e-İrsaliye
Po zakończeniu sprzedaży system sprawdza, czy nabywca jest zarejestrowanym użytkownikiem e-Fatura; w zależności od wyniku faktura e-Fatura lub e-Arşiv jest wystawiana przez Państwa prywatnego integratora, plik PDF trafia do klienta, a numer faktury zapisuje się w zamówieniu. Dla wysyłek konfigurujemy również e-İrsaliye, import faktur przychodzących oraz procesy anulowania, zgodnie z API integratora.
Integracja z systemami księgowymi i ERP
Kontrahenci, kartoteki towarowe, zamówienia, faktury i wpłaty są automatycznie przesyłane do Państwa systemu księgowego lub ERP; w razie potrzeby stany i ceny wracają w przeciwnym kierunku do sklepu. Ponieważ rekordy są powiązane kluczami mapowania, ta sama faktura nie powstanie dwa razy. Dla firm z Wielkiej Brytanii możemy też skonfigurować połączenia z Xero, QuickBooks, QuickFile i Sage.
Komunikacja, mapy, logowanie i inne API
CRM i narzędzia biznesowe
Formularze na stronie, zapytania ofertowe i rejestracje nowych klientów trafiają do Państwa CRM jako kontakty i szanse sprzedaży; gdy zmienia się etap sprzedaży, zespół otrzymuje powiadomienie na Slacku lub w Teams. Zgłoszenia serwisowe mogą automatycznie stawać się kartami w Jira lub Trello.
SMS, WhatsApp i komunikatory
Potwierdzenia zamówień, numery śledzenia przesyłek, przypomnienia o wizytach i jednorazowe kody weryfikacyjne są wysyłane SMS-em lub przez WhatsApp. W WhatsApp Business Platform (Cloud API) konfigurujemy zatwierdzone szablony wiadomości, a przy komunikacji handlowej przestrzegamy zgód odbiorców.
Wysyłka e-maili
Wiadomości transakcyjne, takie jak potwierdzenia zamówień, faktury i resetowanie hasła, łączymy z usługą wysyłkową, a konfigurując rekordy SPF, DKIM i DMARC, zmniejszamy ryzyko trafienia do folderu spam. Listy newslettera można synchronizować z Mailchimp lub Brevo.
Mapy i usługi lokalizacyjne
Wyszukiwarkę oddziałów i dealerów, autouzupełnianie adresów, wyznaczanie współrzędnych na podstawie adresu, opłatę za dostawę zależną od odległości i sprawdzanie strefy dostawy realizujemy za pomocą usług mapowych.
Uwierzytelnianie i logowanie
Państwa klienci mogą logować się kontem Google, Apple, Microsoft lub Facebook bez zakładania hasła; w aplikacjach firmowych centralne logowanie zapewniają OAuth 2.0 i OpenID Connect. W razie potrzeby dodajemy też weryfikację tureckiego numeru identyfikacyjnego T.C. kimlik.
Narzędzia Google i wyszukiwarki
Łączymy zdarzenia Google Analytics 4 i Tag Manager do śledzenia konwersji, feed Merchant Center dla list produktów, Kalendarz Google dla rezerwacji wizyt i Arkusze Google dla raportów. Nowe i zaktualizowane strony można zgłaszać do Bing i Yandex przez IndexNow.
Integracja sztucznej inteligencji
Łączymy duże modele językowe z Państwa systemem do takich zadań jak szkice opisów produktów, klasyfikacja zgłoszeń, streszczanie dokumentów i wyszukiwanie semantyczne we własnych treściach. Do modelu trafiają tylko niezbędne dane, a wyniki przed publikacją mogą być zatwierdzane przez człowieka.
Wideo, spotkania i rezerwacje
Filmy szkoleniowe są publikowane przez YouTube, Vimeo lub Bunny Stream, a przy wizytach online link do Zoom lub Google Meet tworzy się automatycznie. W obiektach noclegowych dane o pokojach, cenach i rezerwacjach są synchronizowane z channel managerem.
Powiadomienia mobilne i usługi aplikacji
Łączymy z Państwa aplikacją mobilną powiadomienia push, weryfikację zakupów w aplikacji i subskrypcji, raportowanie awarii oraz monitorowanie błędów. Zakupy są weryfikowane po stronie serwera sklepu z aplikacjami.
Inne źródła danych i protokoły
Zakres obejmuje też codzienną aktualizację cen według kursów walut TCMB (Banku Centralnego Republiki Turcji), zbiorczy import produktów z plików XML dostawców oraz plików Excel lub CSV, wymianę plików przez FTP lub SFTP, usługi SOAP w starszych systemach firmowych oraz API GraphQL.
O firmach na listach: są to systemy, z którymi możemy się zintegrować przez ich API; nie oznacza to partnerstwa, autoryzowanej sprzedaży ani oficjalnej rekomendacji. Do integracji potrzebne są Państwa własne konto i dostęp do API u danej firmy. Możemy też podłączyć systemy spoza listy, jeśli udostępniają API.
REST, SOAP, webhook czy wymiana plików: którą metodę wybrać i kiedy?
| Metoda | Jak działa | Kiedy się sprawdza | Na co zwracamy uwagę |
|---|---|---|---|
| REST API | Żądania i odpowiedzi przez HTTPS, najczęściej w formacie JSON | Większość usług płatniczych, marketplace’ów, kurierskich i CRM | Limity użycia, odświeżanie tokenów, zmiany wersji |
| SOAP | Wywołania usług opartych na XML, opisanych w WSDL | Niektóre usługi bankowe, kurierskie, e-Fatura i publiczne, starsze systemy firmowe | Walidacja schematu, certyfikaty, obsługa przekroczenia czasu |
| Webhook | System zewnętrzny wysyła powiadomienie na Państwa adres, gdy wystąpi zdarzenie | Zdarzenia w czasie rzeczywistym, takie jak potwierdzenie płatności, status przesyłki czy zmiana zamówienia | Weryfikacja podpisu, powtórzone powiadomienia, odpytywanie o pominięte zdarzenia |
| Wymiana plików (XML / CSV / FTP) | Pliki są przygotowywane, wysyłane lub pobierane w określonych odstępach | Listy produktów od dostawców, zbiorcze ceny i stany, systemy bez API | Kontrola formatu, kodowanie znaków, niekompletne pliki |
W większości projektów metody te stosuje się łącznie: zamówienie jest wysyłane przez REST, zmiana statusu przychodzi webhookiem, a zbiorczy plik stanów jest pobierany raz dziennie. O wyborze decydują możliwości systemu zewnętrznego i to, jak aktualne muszą być dane.
Nasze podejście techniczne do integracji
- Walidacja po stronie serwera: Wszystkie dane z systemu zewnętrznego są sprawdzane pod kątem formatu, typu i pól obowiązkowych; błędne rekordy nie trafiają do systemu.
- Odporność na powtórzone żądania: Nawet jeśli to samo zamówienie lub powiadomienie dotrze kilka razy, operacja zostaje wykonana tylko raz.
- Kolejka i ponowne próby: Gdy system zewnętrzny chwilowo nie odpowiada, żądania są ponawiane w kontrolowany sposób, a błędy trwałe są zgłaszane.
- Logi operacji: Można prześledzić, jakie dane, kiedy i do którego systemu zostały wysłane, więc źródło problemu łatwo znaleźć.
- Najpierw środowisko testowe: Połączenia płatności, kurierów i e-Fatura testujemy najpierw w środowiskach testowych dostawców, a dopiero potem uruchamiamy produkcyjnie.
- Ochrona kluczy tajnych: Klucze API przechowujemy nie w kodzie, lecz w plikach konfiguracyjnych niedostępnych z internetu; uprawnienia nadajemy zgodnie z zasadą najmniejszych uprawnień.
- Dbałość o dane osobowe: Przesyłane dane ograniczamy do tego, czego wymaga zadanie, połączenia zestawiamy szyfrowanymi kanałami i przestrzegamy zasad KVKK oraz RODO.
- Przestrzeganie limitów użycia: Operacje zbiorcze dzielimy zgodnie z limitami żądań dostawców, a zbędne zapytania ograniczamy dzięki pamięci podręcznej.
Jak przebiega projekt integracji API?
- Analiza potrzeb: Wspólnie ustalamy, z jakich systemów Państwo korzystają, jakie czynności wykonuje się ręcznie i jakie dane mają dokąd płynąć.
- Analiza techniczna: Sprawdzamy dokumentację API usług do podłączenia, warunki dostępu, środowiska testowe i limity użycia.
- Zakres i oferta: Przedstawiamy pisemną ofertę z tabelą mapowania danych, schematem przepływu, terminem i ceną.
- Wdrożenie i testy: Budujemy integrację w środowisku testowym i sprawdzamy ją na realistycznych scenariuszach oraz w sytuacjach błędów.
- Uruchomienie: Uruchamiamy integrację z prawdziwymi danymi dostępowymi i razem z Państwem obserwujemy pierwsze operacje.
- Monitoring i wsparcie: Śledzimy zmiany wersji po stronie dostawców i planujemy niezbędne aktualizacje.
Od czego zależy cena integracji?
- Liczba systemów: Liczba usług do podłączenia i struktura API każdej z nich.
- Kierunek przepływu danych: Czy potrzebny jest transfer jednokierunkowy, czy synchronizacja dwukierunkowa.
- Wymagana aktualność: Czy dane mają być przesyłane w czasie rzeczywistym, czy w określonych odstępach.
- Złożoność mapowania: Ile konwersji wymagają różnice w kategoriach, wariantach, podatkach i jednostkach.
- Możliwości dostawcy: Jakość dokumentacji API oraz dostępność środowiska testowego i obsługi webhooków.
- Panel i raportowanie: Czy zakres obejmuje ekrany monitoringu, listę błędów i ręczną ponowną wysyłkę.
Termin i cena zostają doprecyzowane w pisemnej ofercie po analizie potrzeb i analizie technicznej.
Dlaczego ADK Yazılım?
- Metody, których używamy we własnej infrastrukturze: W naszym systemie zamówień płatności kartą, powiadomienia o potwierdzeniu płatności, automatyczne faktury oraz powiadomienia e-mail i SMS działają jako jeden połączony proces.
- Jasny zakres, termin i cena: W ofercie zapisujemy, jakie dane i w którym kierunku będą przesyłane oraz co wykracza poza zakres.
- Przetestowany, bezpieczny kod: Każdą integrację testujemy wraz ze scenariuszami błędów, a dane poufne są chronione.
- Systemy lokalne i międzynarodowe: Oprócz wirtualnych POS, e-Fatura i krajowych kurierów podłączamy też usługi międzynarodowe, takie jak Stripe, Xero i Royal Mail.
- Wsparcie po uruchomieniu: Aktualizujemy integracje przy zmianach u dostawców, a zgłoszenia serwisowe przesyłają Państwo przez panel klienta.

