This is an old revision of the document!
Manipulacija šifarnicima sistema
WSDL: http://bort.melany.rs:8081/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 |
---|---|
StocksAvailable | Kolekcija dostupnih i vidljivih skladišta (objekata) sistema. |
UpdatedStocks | Kolekcija dostupnih skladišta otvorenih/izmenjenih nakon zadatog datuma. |
StockLevel | Upit trenutnog stanja lagera. |
GetStockTypes | Spisak mogućih vrsta skladišta (odnosno, StockTypes parametra) |
Artikli i usluge
Metod | Funkcionalnost |
---|---|
GroupsAvailable | Kolekcija dostupnih grupa (kataloga) artikala, opciono sa pripadajućim podgurpama. |
SubgroupsAvailable | Kolekcija podgrupa (podkataloga) pripadajućih traženoj grupi (katalogu). |
CategoriesAvailable | Kolekcija kategorija artikala. |
ManufacturersAvailable | Kolekcija proizvođača (brendova) artikala. |
ItemsAvailable | Kolekcija artikala zadate grupe/podgrupe/kategorije i brenda. |
UpdatedItems | Kolekcija artikala otvorenih/izmenjenih nakon zadataog datuma. |
ItemPrices | Cenovnik artikala i usluga prema zadatim kriterijumima. |
UpdatedPrices | Izmenjene cene artikala i usluga nakon zadatog datuma. |
STRUKTURA SOAP ZAHTEVA I ODGOVORA
Ova grana BORT web servisa koristi SOAP (Simple Object Access Protocol) za komunikaciju koji se prenosti uoibičajenim HTTP transportom. SOAP zapravo potpada pod REST protokol koji uvek koristi HTTP POST metod da dostavi tzv. Request Body (sadržaj) poslate poruke, a onda sama poruka predaje instrukcjie primaocu šta se traži od njega. RB 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:
<?xml version="1.0" encoding="UTF-8"?><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>