Integracja systemów i API: jak połączyć narzędzia

Kluczowy wniosek

Integracja systemów polega na tym, że narzędzia, których już używasz, wymieniają dane same, przez API lub webhooki, zamiast przez człowieka, który je przepisuje. Najwięcej daje w miejscach, gdzie te same dane wpisuje się ręcznie więcej niż raz. Dobra integracja musi przy tym radzić sobie z limitami zapytań, duplikatami i awariami po drugiej stronie.

W prawie każdej firmie jest ktoś, kto przez część dnia działa jak „ludzkie API": kopiuje dane z maila do CRM, z CRM do faktury, z faktury do arkusza. To praca, która nie wnosi nic poza ryzykiem pomyłki. Integracja systemów usuwa ją u źródła.

Czym jest API, bez żargonu?

API to umówiony sposób, w jaki jeden program prosi drugi o dane albo o wykonanie czynności. Zamiast człowieka, który loguje się do systemu A, kopiuje numer faktury i wkleja go w systemie B, system B sam pyta system A: „daj mi nowe faktury z dzisiaj".

Są dwa podstawowe wzorce:

Odpytywanie (polling). Twój system co jakiś czas pyta drugi: „czy jest coś nowego?". Proste, ale z opóźnieniem.
Webhook. Drugi system sam wysyła powiadomienie, gdy coś się wydarzy. Szybsze i tańsze, bo nikt nie pyta na próżno.

Przykład z naszego podwórka: formularze na stronie lunolab.pl wysyłają zgłoszenie webhookiem do naszego panelu. Strona i panel to dwa osobne projekty, celowo bez wspólnej bazy. Endpoint jest zabezpieczony tokenem i działa w trybie „fail-closed": bez poprawnego tokenu jest po prostu zamknięty.

Co warto zintegrować w pierwszej kolejności?

Zacznij od miejsc, w których dane wpisuje się ręcznie więcej niż raz. Najczęściej to trzy obszary.

Kanały kontaktu i CRM

W PrimeMedHub zapytania spływały z formularza, Facebook Messengera, WhatsApp Business i maila. Połączyliśmy wszystkie te kanały z jednym CRM przez API Meta i obsługę skrzynek pocztowych, a nowe leady trafiają dodatkowo jako alert na Telegram, ze wskazaniem źródła. Efekt: zero ręcznego przepisywania i zero utraconych leadów.

Finanse: bank, KSeF, kursy walut

W naszym panelu operacyjnym faktury kosztowe pobieramy wprost z rządowego KSeF, przepływy z banku przez licencjonowanego pośrednika open bankingu (PSD2), kursy walut z NBP, a dane kontrahentów z Białej Listy podatników VAT. Dzięki temu nikt nie przepisuje kwot z PDF-ów, a VAT i koszty zgadzają się z rzeczywistością.

Kalendarz i komunikacja

Kalendarze kont firmowych czytamy przez CalDAV i automatycznie dopinamy spotkania do właściwego klienta po adresie e-mail albo domenie uczestników. Publiczne domeny, jak Gmail, system pomija, żeby nie przypisać spotkania do przypadkowej firmy.

Na jakie pułapki trafisz na pewno?

Każda z poniższych to realna sytuacja z naszych wdrożeń. Żadnej nie widać w dokumentacji na pierwszy rzut oka.

Limity zapytań

Bank w open bankingu pozwala na około 4 zapytania na konto dziennie. Jeśli integracja będzie pytać przy każdym otwarciu ekranu, po południu przestanie działać. Rozwiązanie: transakcje zapisujemy we własnej bazie i synchronizujemy w nocy.

Ograniczenia zakresu

KSeF przyjmuje zapytania o okres maksymalnie 3 miesięcy, a odpowiedzi przychodzą stronami. Pobranie roku faktur to więc kilka okien 89-dniowych i stronicowanie każdego z nich, z deduplikacją po numerze KSeF.

Duplikaty

Gdy dane płyną z kilku źródeł, ten sam klient pojawi się wielokrotnie. Dlatego firmy deduplikujemy w trzech krokach: po NIP, po znormalizowanej nazwie i po domenie służbowej. Transakcje po identyfikatorze z banku, faktury po numerze KSeF.

Waluty i „równe kwoty"

Reguła „dopasuj płatność do faktury po tej samej kwocie" przestaje działać przy obcych walutach. Faktura na 18,00 EUR pojawia się na wyciągu jako 80,52 PLN. W naszym panelu 42 z 71 faktur kosztowych były w USD lub EUR. Dopasowanie robimy więc po kontrahencie, dacie i kwocie przeliczonej kursem NBP z dnia płatności, a przeliczenie liczy kod, nie model AI.

Awarie po drugiej stronie

Zewnętrzny serwis kiedyś nie odpowie. Dlatego projektujemy integracje jako opcjonalne przez konfigurację: brak klucza albo awaria jednej usługi wyłącza tylko tę funkcję, a reszta systemu działa dalej. Zadania nocne pamiętają datę ostatniego uruchomienia, więc po restarcie nadrabiają zaległości, ale bez dubli, na przykład bez wysłania tego samego przypomnienia dwa razy.

Bezpieczeństwo

Integracja otwiera drzwi między systemami, więc musi mieć zamek. Tokeny zamiast haseł w adresach, domyślnie zamknięte endpointy, prywatne strefy plików z linkami, które wygasają, i zasada najmniejszych uprawnień: integracja widzi tylko to, czego potrzebuje.

Integracja czy nowy system?

Często firmy, które przychodzą po nowy system, potrzebują w rzeczywistości integracji. Jeśli narzędzia, których używasz, robią swoją robotę dobrze, a problemem jest przepisywanie danych między nimi, integracja jest tańsza i szybsza. Nowy system ma sens dopiero wtedy, gdy któreś z narzędzi samo w sobie nie pasuje do procesu.

Jak zacząć?

Narysuj, skąd i dokąd płyną dane w Twojej firmie, choćby na kartce.
Zaznacz każde miejsce, w którym człowiek przenosi dane ręcznie.
Przy każdym zapisz, ile to trwa i jak często się zdarza.
Sprawdź, czy systemy po obu stronach mają API albo webhooki.
Zacznij od połączenia, które zjada najwięcej czasu i niesie największe ryzyko pomyłki.

Zdaniem autora

Z perspektywy finansów najgroźniejsze w ręcznym przepisywaniu nie jest nawet to, ile trwa, tylko błędy, których nikt nie zauważa. Źle dopasowana płatność w obcej walucie potrafi po cichu zafałszować koszty i odliczenie VAT. Dlatego w naszym panelu obowiązuje zasada, że fałszywe dopasowanie jest gorsze niż brak dopasowania: gdy system nie ma pewności, zostawia sprawę człowiekowi. Moim zdaniem dobra integracja nie tylko oszczędza czas. Przede wszystkim sprawia, że liczbom w firmie można ufać.

Jan Zachorowski, CFO i COO LUNOLAB

Zobacz, jak realizujemy integracje systemów i API i automatyzację procesów. Jeśli chcesz sprawdzić, które połączenia dadzą Ci najwięcej, umów bezpłatną konsultację.

Źródła

Jan Zachorowski

CFO, COO i współzałożyciel LUNOLAB

CFO, COO i współzałożyciel LUNOLAB. Odpowiada za finanse i operacje firmy, a przy tym pracuje technicznie w projektach. Łączy perspektywę kosztów i procesów z wiedzą, jak je zautomatyzować: od rozliczeń i przepływów pieniędzy po integracje systemów. Pisze o automatyzacji procesów, zwrocie z inwestycji w technologię i o tym, jak liczyć jej realny koszt.

Masz pomysł na wdrożenie technologii u siebie?

Umów bezpłatną rozmowę