Šta je API?

API je skraćenica za Application Programming Interface i označava programski interfejs.

API pomaže pri komunikaciji između dva različita  programa, ukoliko se pri komunikaciji  upotrebljava isti jezik (isti API), razumeće se, u suprotnom je potreban „prevodilac“. Načinima prevoda se obično bave stručnjaci koje  nazivamo integratorima. Oni moraju proučiti specifičnosti oba API-ja i osigurati pravilan prevod između njih.

SAOP API trenutno podržava "XML i JSON" jezik sa kodiranjem "UTF-8 BOM".

Tehnička dokumentacija:  https://icwebsvc.saop.si/SI/API

Evo nekoliko uobičajenih primera upotrebe SAOP API-a:

Kada kao korisnici spoljnjeg sistema želimo da prenesemo predloge izdatih računa u ERP, sa namerom da izvršim izdavanje.

Spoljna aplikacija priprema podatke o pojedinačnom računu (stranka, datumi, artikal, količina, cena) i sa pozivom odgovarajuće metode (AddInvoice) zapiše u ERP. Dokument se preračunava u ERP-u i proknjiži u skladu sa postupkom.

Spoljna aplikacija može čitati takav dokument pomoću GetInvoice metode. U slučaju da spoljna aplikacija želi promeniti predlog računa, onda za tu namenu može koristiti ModifyInvoice metodu.

Kada želimo da evidentiramo u ERP-u finansijski događaj izdatih računa koji su nastali u spoljnjoj aplikaciji.

Obzirom na to da se račun pripremio i izdao u spoljnjoj aplikaciji, prenosi se samo finansijska temeljnica (nalog) u ERP sa pozivanjem AddJournal metode.

Kada kao korisnici spoljne aplikacije želimo da se primljeni račun prenese u ERP radi dalje obrade.

Primljeni račun se prenosi u ERP sa AddIncomingInvoice metodom. U slučaju da primljeni račun ima jedan ili više priloga, onda se oni dodaju u dokumentacioni sistem pomoću AddDocument metode, a ako je primljeni račun u obliku eRačuna, onda se može koristiti jedan od elektronskih pošti ePoštara.

Kada kao korisnici online trgovine želimo da prenesemo narudžbenicu u ERP radi dalje obrade (izdavanja robe, računa, finansijskog knjiženja).

Narudžbenica se prenese u ERP sa metodom AddOrder, ali je potrebno pre toga pribaviti matične i ostale podatke:

Artikli: GetItems  

Stranke: GetCustomer (ako stranka ne postoji, doda se sa AddCustomer)

Zalihe: GetStock

Cene: GetPrices

Narudžbenica se može promeniti,sve dok je u odgovarajućem statusu, sa metodom ModifyOrder. 

Kada kao korisnici WMS želimo izvesti prijem naručene robe.

U ERP-u se na osnovu narudžbenice dobavljaču pripremi predlog prijema. Spoljni sistem pomoću metode GetReceivingAdviceStatus proverava koji je dokument u statusu primeren za prenos. Ako takav dokument postoji, onda ga očita sa metodom GetReceivingAdvice i na to sa ModifyReceivingAdvice metodom postavi u status koji onemogućava promenu dokumenta unutar ERPa.

Kad se prijem u skladištu zaključi, onda se sa metodom ModifyReceivingAdvice uredi dokument u ERPu i sa metodom PostReceivingAdvice materijalno proknjiži.

Kada kao korisnici WMS želimo izvesti prijem nenajavljene robe.

Kada se prijem u skladištu zaključi, onda se sa metodom AddReceivingAdvice unese dokument u ERP i sa metodom PostReceivingAdvice materijalno proknjiži.

Kada kao korisnici spoljnog sistema želimo evidentirati izdavanje robe u ERPu.

U spoljnjem sistemu kao što je na primer WMS, roba je pripremljena za izdavanje kao i prateći pripadajući dokument. Kad se operacija u spoljnom sistemu zaključi, onda je potrebno preneti dokument u ERP.

U zavisnosti od tipa izdavanja (najavljeno, otvoreno, naručeno) se upotrebljavaju sledeće metode:

            WMS pripremi izdavanje na osnovu primljene najave izdavanja, koji je obezbedio ERP. Kada se u ERPu zaključe aktivnosti onda se sa metodom ModifyDispatchAdvice unesu podaci o stvarnim izdatim količinama u ERPu.

 Izdavanje se desi u WMS i pošto je aktivnost započeta u ERPu, dokument se unosi sa metodom AddDispatchAdvice.

 ERP prosleđuje u  WMS jednu ili više narudžbenice. Na osnovu prosleđenih narudžbenica se pripreme izdavanja. Kada se zaključe aktivnosti u spoljnom sistemu, onda se koristi metoda AddDispatchAdvice da se unesu dokumenti izdavanja robe a zatim se delimično ili u  potpunosti zatvore narudžbenice.

U slučaju, ako jedna narudžbina važi za jedno izdavanje, onda spoljni sistem može koristiti metodu MoveOrderToDispatchAdvice za pripremu izdavanja u ERP i da ga sa metodom PostDispatchAdvice proknjiži.