Integracje w aplikacji firmowej: płatności, ERP, API

„A to musi się spinać z naszym programem magazynowym". Gdybyśmy dostawali złotówkę za każde takie zdanie na spotkaniu, moglibyśmy budować aplikacje charytatywnie. I bardzo dobrze, że ono pada, bo aplikacja firmowa rzadko żyje w próżni: prawie zawsze coś do niej wpływa (zamówienia, płatności, stany magazynowe) i coś z niej wypływa (faktury, etykiety, powiadomienia). Te połączenia to integracje — często połowa wartości całego projektu i spora część jego kosztu. Poniżej: co firmy podpinają najczęściej, czemu to bywa droższe niż niejedna funkcja i jak się przygotować, żeby nie przepłacić.

Co firmy podpinają najczęściej

Lista u każdego wygląda nieco inaczej, ale trzon powtarza się od lat:

• Płatności online — klient płaci kartą, BLIK-iem czy przelewem, a aplikacja sama odnotowuje wpłatę i rusza z realizacją. Prowizja bramki to zwykle ok. 1–2% i tyle kosztuje koniec ręcznego sprawdzania przelewów.
• Fakturowanie i księgowość — dane z zamówienia lecą prosto do programu księgowego. Koniec przepisywania NIP-ów i kwot, koniec literówek w fakturach.
• ERP i magazyn — stany, ceny, rezerwacje towaru. Najgrubszy temat na tej liście, bo firmowe ERP-y bywają wiekowe i każdy jest obrośnięty innym zestawem przyzwyczajeń.
• Mailing i SMS — automatyczne statusy zamówień, przypomnienia o terminach, wiadomości do zespołu. Krótki SMS „zamówienie gotowe do odbioru" potrafi wyraźnie odciążyć telefon w biurze.
• Kurierzy — zamawianie przesyłek i etykiety generowane jednym kliknięciem, ze śledzeniem paczki w tle.
• Mapy i geokodowanie — strefy dostaw, planowanie tras, podpowiadanie adresów w formularzach.

Przy każdej pozycji z tej listy ma znaczenie kierunek przepływu. Czym innym jest samo wysyłanie danych (aplikacja przekazuje fakturę do księgowości), czym innym pełna synchronizacja w obie strony, gdzie zmiana po dowolnej stronie musi się odbić echem w drugiej. Ta druga wersja potrafi kosztować kilka razy więcej — i nierzadko wcale nie jest potrzebna. Dlatego na spotkaniach dopytujemy nie „z czym się integrujemy", tylko co dokładnie ma przepływać i w którą stronę.

Zwykle w pierwszej wersji aplikacji wystarczą jedna, dwie integracje. Resztę dokłada się etapami, kiedy podstawa okrzepnie — i to jest zdrowa kolejność.

Dlaczego integracja bywa droższa niż nowa funkcja

Nowa funkcja w aplikacji to nasza piaskownica: wszystko zależy od nas i od jakości naszej roboty. Integracja to praca w cudzym ogródku — trochę jak dobudowanie garażu do cudzego domu. Niby ściana to ściana, ale wszystko zależy od tego, co zastaniesz pod tynkiem i czy właściciel odbiera telefony. Ile potrwa, dyktuje jakość cudzego API — czyli, mówiąc po ludzku, tego okienka, przez które inne programy mogą rozmawiać z danym systemem. Bywa okienko szerokie, opisane i z obsługą; bywa lufcik zabity gwoździami, do którego dokumentacja zaginęła dekadę temu.

Do tego dochodzi tłumaczenie pojęć. U Ciebie „towar", u nich „indeks"; u nas kilogramy, u nich sztuki; tu ceny netto, tam brutto. Każdą taką różnicę trzeba wyłapać i obsłużyć, a najwięcej pracy robią wyjątki: co ma zrobić aplikacja, gdy magazyn nie odpowiada? Czekać, ponowić, odłożyć do kolejki, kogoś powiadomić? Właśnie w tych scenariuszach — a nie w „szczęśliwej ścieżce" — siedzi różnica między integracją solidną a taką, która sypie się co środę.

I rzecz ostatnia, o której mało kto myśli przy wycenie: integracja żyje. Dostawca zmienia wersję API, wyłącza starą — trzeba dostosować kod po naszej stronie. Dlatego dobrze, żeby system po starcie miał opiekę, choćby w małym pakiecie utrzymaniowym, a nie był „oddany i zapomniany".

O co zapytać dostawcę swojego systemu

Zanim w ogóle przyjdziesz do nas, wyślij swojemu dostawcy jeden mail z kilkoma pytaniami. Czy system ma API? Czy jest publiczna dokumentacja i można ją dostać bez podpisywania cyrografu? Czy istnieje środowisko testowe, na którym można bezpiecznie próbować? Czy dostęp do API jest dodatkowo płatny (bywa, że to osobny moduł w cenniku)? I kto po ich stronie odpowiada na pytania techniczne?

Dwa pytania bonusowe, które lubimy najbardziej: czy są limity liczby zapytań (przy większym ruchu można w nie wpaść) i czy dostawca planuje w najbliższym czasie zmianę wersji API. Odpowiedzi rzadko cokolwiek przekreślają, ale pozwalają ułożyć pracę bez niespodzianek.

Same odpowiedzi wyznaczą pole gry. „Mamy API, dokumentacja pod linkiem, sandbox na życzenie" — pięknie, będzie sprawnie. „Możemy wystawiać plik z danymi raz na dobę" — też się da, tylko synchronizacja będzie działać w rytmie dobowym, nie na żywo. A czasem okazuje się, że API nie ma wcale. Wtedy uczciwie mówimy, że są trzy drogi: wymiana plikowa, praca półautomatyczna albo — bywa, że najtańsza w dłuższej perspektywie — zmiana narzędzia na takie, które umie rozmawiać ze światem.

Jak my to wyceniamy

Zasada pierwsza: nie wyceniamy integracji w ciemno. Typowe rzeczy — bramki płatności, popularne programy do faktur, kurierzy — robiliśmy wielokrotnie, więc podajemy godziny od ręki. Przy nietypowym ERP najpierw robimy krótki rekonesans: czytamy dokumentację, zaglądamy do środowiska testowego i dopiero wtedy mówimy, ile to realnie pracy. Taki zwiad kosztuje kilka godzin, a chroni przed wycenami z sufitu — w obie strony.

Rozliczenie jest takie samo jak przy całej budowie: 125 zł netto za godzinę pracy zespołu, integracje wchodzą w miesięczne pakiety godzin obok pozostałych zadań. W praktyce koszt zależy od trzech rzeczy: jakości API po drugiej stronie, liczby scenariuszy wyjątkowych i tego, czy synchronizacja ma działać na żywo, czy okresowo.

Bywa też, że po rekonesansie odradzamy integrację w pierwszym etapie. Jeśli miałaby pochłonąć połowę budżetu podstawy, a przez pierwsze miesiące dane może przenosić człowiek w dziesięć minut dziennie — zaczynamy od reszty systemu, a połączenie dokładamy, gdy skala zacznie go wymagać. Automatyzacja ma się zwracać, a nie być trofeum.

Masz już listę programów, z którymi aplikacja musi się dogadać? Dołącz ją do zapytania o wycenę — nazwy wystarczą, resztę sprawdzimy sami. A jeśli dopiero układasz plan, napisz do nas; podpowiemy, które integracje wziąć do pierwszej wersji, a które spokojnie poczekają.