Business Central moduli

API integracije i ERP: dva uspešna primera

Integracije za potrebe dobavljača medicinskih sredstava koje je COMING-ov tim za aplikativne servise izvršio u sklopu Business Central ERP-a pokazale su se kao veoma korisne. One na najbolji način pokazuju da dobro dizajniran API može biti isplativ za sve i da se na ovaj način mogu pokriti najrazličitiji poslovni procesi.

Prva paradigma upotrebe softvera jesu korisnički interfejsi, i dok su prvi korisnički interfejsi bili tekstualni, danas se najčešće koriste grafički. Upravo korisnički interfejs je ono što omogućava osobi da koristi softver. Za razliku od korisničkog interfejsa, aplikativni programski interfejsi (API) omogućavaju softveru da koristi softver. U najširem smislu, API je dokumentacija (specifikacija) o načinu komunikacije dva ili više softverskih sistema ili realizacija takve komunikacije. Samu realizaciju API-ja dva nezavisna softvera često nazivamo i integracija. Korisnički interfejs je uvek važna tema pri razvoju softvera, jer predstavlja sve ono što će krajnji korisnik u softveru videti. Svi korisnici softvera mogu uticati na dizajn istog. S druge strane, (ljudski) korisnici API-ja su samo programeri, koji pomoću API-ja moraju da uspostave integracije koje će (uz dodatni kod) biti korisne krajnjim korisnicima. Kao i mnoge stvari u IT-ju, dobro uspostavljena integracija je neprimetna, a korisnici razmišljaju o njoj tek ako nešto ne radi. Zbog toga je ponekad teško opravdati trošak za razvoj kvalitetne (stabilne, brze, sigurne, sveobuhvatne) integracije.

Integracija javne nabavke u ERP

COMING-ov tim za aplikativne servise, iza koga je bogato iskustvo, izvršio je tokom prošle godine, u sklopu Business Central ERP-a, dve integracije za potrebe dobavljača medicinskih sredstava. Ove integracije pokazale su se kao veoma korisne i na najbolji način pokazuju kako dobro dizajniran API može biti isplativ za sve i da se na ovaj način mogu pokriti najrazličitiji poslovni procesi. Prva od njih je integracija ERP-a sa API-jem Republičkog fonda za zdravstveno osiguranje (RFZO). Nabavka medicinskih sredstava preko RFZO realizuje se kroz tripartitne ugovore, koji se potpisuju između fonda, dobavljača i kupaca (zdravstvenih ustanova). Ovim ugovorima definisane su prvenstveno količine i cene medicinskih sredstava po kojima će se nabavka odvijati, kao i period važenja ugovora, farmaceutski podaci o medicinskim sredstvima itd. Sama realizacija tripartitnih ugovora odvija se kroz naloge za nabavku, koje zdravstvene ustanove svakodnevno šalju dobavljačima. Dokument naloga za nabavku sadrži količine medicinskih sredstava, a vezuje se isključivo za određeni tripartitni ugovor. Nakon isporuke konkretnog naloga (pod uslovom da je taj nalog prihvaćen), API integracije i ERP: dva uspešna primera Integracije za potrebe dobavljača medicinskih sredstava koje je COMING-ov tim za aplikativne servise izvršio u sklopu Business Central ERP-a pokazale su se kao veoma korisne. One na najbolji način pokazuju da dobro dizajniran API može biti isplativ za sve i da se na ovaj način mogu pokriti najrazličitiji poslovni procesi. Business Central moduli 39 nastaju dokumenti prijema, odnosno dokumenti povrata. Tripartitni ugovori, sa svim dokumentima koji iz njih nastaju, grupišu se u okvirne sporazume, od kojih svaki može imati više partija. Ceo opisan proces može se ispratiti kroz korisnički portal koji je RFZO razvio. Čitaocima koji do sada nisu imali iskustva sa javnim nabavkama opisani proces mogao bi delovati isuviše složeno, ali u pitanju je zapravo jedan logičan i efikasan sistem. Ono što nije efikasno jeste sama upotreba korisničkog portala. Ručno kopiranje podataka sa korisničkog portala u ERP sistem iziskuje mnogo vremena i podložno je greškama, koje mogu imati ozbiljne posledice. Na sreću, RFZO je prepoznao priliku da se ovaj proces olakša korišćenjem API-ja i dobavljačima medicinskih sredstava ponudio JSON API, kroz koji se svi opisani dokumenti mogu preuzeti, uz mogućnost da se izvrše i određene izmene i odobravanja. COMING je za RFZO izradio Business Central modul koji integriše proces javne nabavke u ERP. Osim što korisniku omogućava da u ERP sistemu vidi sve dokumente dostupne na portalu (i sve podatke u tim dokumentima), pri čemu se dokumenti preuzimaju automatski i gotovo bez kašnjenja, ovaj modul dozvoljava korisniku i da vrši odobravanja koja su podržana od strane API-ja. Takođe, u modul su uključeni i izveštaji, pomoću kojih se prati realizacija okvirnih sporazuma ili pojedinačnih tripartitnih ugovora. Međutim, ovaj modul nije nezavisan unutar ERP-a i upravo zbog toga nije ograničen na prosto preuzimanje i slanje dokumenata. Osim što je integrisan sa drugim modulima, poput modula za e-fakture ili modula za nabavku, on je dovoljno fleksibilan da podrži neke izuzetne situacije koje nisu opisane kroz API. Na primer, zbog hitnosti, koja je karakteristična za zdravstveni sistem, određena sredstva mogu biti isporučena i pre nego što se nalog kreira na portalu. Modul pokriva i ovakav scenario, čuvajući podatke o isporukama unutar modula reversa i povezujući ih kasnije u naloge. Drugi primer su ugovori sklopljeni sa zdravstvenim ustanovama na Kosovu i Metohiji, gde modul dozvoljava primenu poreskih olakšica pri fakturisanju, u skladu sa zakonskim odredbama.

Distribucija medicinskih sredstava

Još jedan uspešan projekat je i integracija sa API-jem kompanije Farmalogist, koja se bavi distribucijom medicinskih sredstava. Kao i u slučaju RFZO-a, Farmalogist je kroz JSON API učinio procese dostupnim preko korisničkog portala, s tim što ti procesi u ovom slučaju podrazumevaju kreiranje naloga za prevoz medicinskih sredstava. Modul koji je COMING razvio omogućuje da se od jedne ili više proknjiženih otpremnica (ili proknjiženih faktura) kreira tiket za Farmalogist, na kom se mogu uneti podaci o robi (način na koji je roba upakovana, broj pakovanja, različiti temperaturni režimi i sl.), kao i „zakačiti“ dodatni dokumenti (fakture, servisni nalozi i dr.) koji će kupcu biti poslati uz robu. Nakon slanja tiketa, u ERP-u je dostupna štampa nalepnica koje se lepe na pakete. Prema tome, korisnik čitav proces obavlja u ERP-u, sa minimalnim brojem klikova i bez potrebe za ulaskom na portal. Osim funkcionalnosti koje su predviđene API-jem, i ovde postoje opcije koje korisnicima dodatno olakšavaju rad. Na primer, podaci o tiketu (ime kupca, adresa isporuke) preuzimaju se iz dokumenta, te korisnik izborom jedne fakture ili otpremnice može automatski da popuni sve neophodne podatke. Zatim, sistem obaveštava korisnika ako postoji više otvorenih isporuka za istog kupca, što je korisno da bi se umanjio broj isporuka ka istoj adresi u toku jednog dana. Takođe, vidimo i „low hanging fruit“ za dalji razvoj: podaci o pakovanjima mogli bi optimalno da se popune na osnovu podataka o ambalaži u ERP sistemu, a podaci o temperaturnom režimu mogli bi da se popune na osnovu istog podatka sa kartice artikla.

API – trendovi razvoja

Oba opisana modula uspešno se koriste od početka ove godine. Uz pomoć ovih integracija odgovarajući procesi su značajno ubrzani, što bi čitaocima trebalo da sugeriše koliko ovakve integracije mogu biti isplative, ako uzmemo u obzir da se na dnevnom nivou obrađuju desetine, pa i stotine ovakvih dokumenata. Uspostavljanje integracija poput opisanih ima smisla kad god se podaci kopiraju iz jednog sistema u drugi. Čak i ako se podaci kopiraju poluautomatski (npr. Excelom kroz mail) ili retko (jednom nedeljno), integracije štede vreme zaposlenih i značajno smanjuju greške. Pri razvoju API-ja uvek treba krenuti malim koracima, ali i biti spreman na neprestana proširivanja, koja će obuhvatiti dodatne procese. Takođe, API je koristan samo onoliko koliko korisnika ima, stoga ga treba dizajnirati tako da partneri ne moraju da ulažu velika sredstva da bi započeli sa korišćenjem istog. Za kraj, ako se osvrnemo na dosadašnja iskustva, drago nam je da vidimo trend prelaska na API-je zasnovane na JSON formatu, kao i modernim praksama za autentifikaciju. S druge strane, voleli bismo da vidimo i moderne prakse u dokumentovanju API-ja (jer API jeste dokumentacija). Umesto PDF dokumentacije, koja se i dalje najčešće sreće (barem u domaćem okruženju), voleli bismo da vidimo i OpenAPI specifikacije. Ovakve specifikacije će biti korisne, ne samo za efikasno kreiranje klijenata i testiranje, već i za razvoj AI agenata, koji su danas u fokusu čitave IT zajednice.

Nikola Ubavić, COMING