Integracje API dla firm
Łączymy aplikacje z rejestrami publicznymi, płatnościami, systemami ERP i marketplace'ami: GUS, KRS, CEIDG, biała lista VAT, Przelewy24, Stripe, BaseLinker, Allegro. Dane płyną same.
Firmowe systemy rzadko działają w próżni. Dane klientów są w CRM-ie, zamówienia w sklepie i na marketplace'ach, faktury w programie księgowym, a informacje o kontrahentach w rejestrach publicznych. Integracje sprawiają, że te dane przepływają między systemami same, zamiast być przepisywane ręcznie.
Z czym integrujemy
- Rejestry publiczne — GUS (REGON), KRS, CEIDG, biała lista podatników VAT, SUDOP. Automatyczne uzupełnianie danych firmy po numerze NIP i regularna weryfikacja kontrahentów. Gdy źródło nie ma API, sięgamy po pozyskiwanie danych ze stron.
- Płatności — Przelewy24 i Stripe: płatności jednorazowe, subskrypcje, zwroty i rozliczenia między użytkownikami platformy.
- Sprzedaż — BaseLinker, Allegro i sklepy internetowe: zamówienia, stany magazynowe i statusy w jednym miejscu.
- Systemy ERP i księgowe — wymiana kontrahentów, dokumentów i faktur, także z e-fakturami w KSeF.
- Komunikacja — e-mail, SMS, platformy e-mail marketingowe, powiadomienia w czasie rzeczywistym (Pusher) i logowanie przez SSO.
- Systemy zdarzeniowe — RabbitMQ i Kafka, gdy kilka systemów musi niezawodnie wymieniać duże ilości komunikatów.
Przykład: dane z rejestrów w CRM
W CRM dla brokerów finansowych dane firm uzupełniają się automatycznie z CEIDG, SUDOP i białej listy VAT — zarówno na żądanie doradcy, jak i w masowej synchronizacji zmian, z obsługą stronicowania przy dużych wolumenach. Każde zapytanie jest logowane wraz z wynikiem. Zobacz realizację.
Jak budujemy integracje, które nie psują się po cichu
- Kolejki i ponawianie — zewnętrzne API bywa niedostępne; zapytania, które się nie udały, wracają do kolejki zamiast przepadać.
- Logowanie i monitoring — każde wywołanie jest zapisywane, a seria błędów wywołuje alert.
- Limity i koszty — pilnujemy limitów zapytań dostawcy i cache'ujemy odpowiedzi, które się nie zmieniają.
- Bezpieczeństwo — klucze i certyfikaty poza repozytorium, weryfikacja podpisów webhooków, minimalne uprawnienia.
- Testy — integracje testujemy na środowiskach testowych dostawców i atrapach ich API, żeby zmiana w naszym kodzie nie zepsuła połączenia.
Przed budową integracji sprawdzamy dokumentację i środowisko testowe dostawcy, limity zapytań oraz to, który system ma być źródłem prawdy dla danych. Te ustalenia zapisujemy w dokumentacji projektu, żeby kolejna osoba wiedziała, skąd biorą się dane i co się stanie, gdy któraś strona będzie niedostępna.
Integracje są podstawą automatyzacji procesów i większości systemów CRM na zamówienie, które budujemy.
Najczęściej zadawane pytania
Czy możecie zintegrować system, który nie ma publicznego API?
Często tak: przez eksport i import plików, bazę danych, skrzynkę e-mail albo prywatne API udostępnione przez producenta. Rozwiązanie dobieramy po sprawdzeniu, na co pozwala dany system.
Jak pobieracie dane z GUS po numerze NIP?
Przez oficjalną usługę GUS do wyszukiwania podmiotów w rejestrze REGON. Po wpisaniu NIP system uzupełnia nazwę, adres i dane rejestrowe, a w razie potrzeby weryfikuje też firmę w KRS, CEIDG i na białej liście VAT.
Co jeśli dostawca zmieni swoje API?
Monitoring wychwyci błędy po zmianie, a w ramach utrzymania aktualizujemy integrację. Dostawcy zwykle zapowiadają zmiany z wyprzedzeniem, więc większość przygotowujemy zawczasu.
Czy integracja może działać w obie strony?
Tak. Ustalamy, który system jest źródłem prawdy dla danego typu danych, i synchronizujemy zmiany w obu kierunkach bez nadpisywania nowszych danych starszymi.
Czy możecie udostępnić API naszego systemu partnerom?
Tak. Projektujemy API z dokumentacją, kluczami dostępu dla partnerów, limitami zapytań i logowaniem wywołań, żeby było wiadomo, kto i kiedy korzystał z danych.
Ile trwa zbudowanie integracji?
Prosta integracja z dobrze udokumentowanym API, np. bramką płatności, to zwykle krótki etap projektu. Najwięcej czasu zajmują integracje z systemami bez dokumentacji albo wymagające uzgodnień z ich dostawcą. Harmonogram ustalamy po przejrzeniu API.