Manipulacija šifarnicima sistema
WSDL: https://ws.melany.rs:8191/Assets/Assets?WSDL
Aplikativni interfejs ove grupe ima za cilj čitanje osnovnih šifarničkih podataka Balans ERP sistema koje čine:
- otvorena i dostupna skladišta (i maloprodajni objekti)
- otvorene (vidljive) grupe, podgrupe, kategorije i proizvođači (brendovi) artikala
- otvoreni (vidljivi) artikli i usluge
- zalihe robe
- cenovnici
Skladišta i objekti
| Metod | Funkcionalnost | Revizija |
|---|---|---|
| StocksAvailable | Kolekcija dostupnih i vidljivih skladišta (objekata) sistema. | 19-6-11 |
| UpdatedStocks | Kolekcija dostupnih skladišta otvorenih/izmenjenih nakon zadatog datuma. | 19-6-11 |
| StockLevel | Upit trenutnog stanja lagera. | 19-6-11 |
| GetStockTypes | Spisak mogućih vrsta skladišta (odnosno, StockTypes parametra) | 19-6-11 |
Artikli i usluge
| Metod | Funkcionalnost | Revizija |
|---|---|---|
| GroupsAvailable | Kolekcija dostupnih grupa (kataloga) artikala, opciono sa pripadajućim podgurpama. | 19-6-11 |
| SubgroupsAvailable | Kolekcija podgrupa (podkataloga) pripadajućih traženoj grupi (katalogu). | 19-6-11 |
| CategoriesAvailable | Kolekcija kategorija artikala. | 19-6-11 |
| ManufacturersAvailable | Kolekcija proizvođača (brendova) artikala. | 19-6-11 |
| ItemsAvailable | Kolekcija artikala zadate grupe/podgrupe/kategorije i brenda. | 19-6-11 |
| UpdatedItems | Kolekcija artikala otvorenih/izmenjenih nakon zadataog datuma. | 19-6-11 |
| ItemPrices | Cenovnik artikala i usluga prema zadatim kriterijumima. | 19-6-11 |
| Metoda trenutno nije realizovana. Izmenjene cene artikala i usluga nakon zadatog datuma. | 19-11-5 |
Prateće funkcije
| Metod | Funkcionalnost | Revizija |
|---|---|---|
| UploadFile | Slanje datoteke na server | 20-10-20 |
| GetFile | Preuzimanje datoteke sa servera | 20-10-20 |
| GetZipFile | Kolektivno preuzimanje datoteka sa servera | 20-10-20 |
| GetMD5Checksum | Računanje MD5 checksum niza bajtova traženog fajla | 20-11-13 |
STRUKTURA SOAP ZAHTEVA I ODGOVORA
Ova grana BORT web servisa koristi SOAP (Simple Object Access Protocol) za komunikaciju koji se prenosti uobičajenim HTTP transportom. SOAP suštinski potpada pod REST koji uvek koristi HTTP POST metod da dostavi tzv. Request Body (sadržaj) poslate poruke. SOAP koristi XML jezik za strukturiranje poruka.
Primer upućenog zahteva (request)
Zaglavlje zahteva:
POST https://melany.rs/Assets/Assets HTTP/1.1 Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "" Content-Length: 323 Host: melany.rs Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5)
Request body:
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<S:Body>
<ns2:GroupsAvailable xmlns:ns2="http://services.bort.com/">
<sessToken>160331189525374</sessToken>
</ns2:GroupsAvailable>
</S:Body>
</S:Envelope>
Primer odgovora (response):
HTTP/1.1 200 OK Server: GlassFish Server Open Source Edition 4.1.2 X-Powered-By: Servlet/3.1 JSP/2.3 (GlassFish Server Open Source Edition 4.1.2 Java/Oracle Corporation/1.8) Server: grizzly/2.3.23 Content-Type: text/xml; charset=utf-8 Date: Wed, 06 Feb 2016 11:13:05 GMT Transfer-Encoding: chunked
Request body odgovora:
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:GroupsAvailableResponse xmlns:ns2="http://services.bort.com/">
<return>
<ID>47203523</ID>
<naziv>2Jewels</naziv>
<velicFld>0</velicFld>
</return>
<return>
<ID>3116024</ID>
<naziv>Adriatica</naziv>
<velicFld>0</velicFld>
</return>
<return>
<ID>17329905</ID>
<naziv>All Blacks</naziv>
<velicFld>0</velicFld>
</return>
</ns2:GroupsAvailableResponse>
</S:Body>
</S:Envelope>