This is an old revision of the document!
Balans Web API - Edi
Metod omogućava slanje dokumenata (trenutno samo u OAGIS formatu) na procesiranje u Balans EDI procesor. Procesor će omogućiti da primljeni dokument bude preveden u odgovarajući Balans ERP zapis i prosleđen na dalju obradu kroz Balans ERP informacioni sistem.
REST API Zahtev
https://ws.melany.rs/api/rest/edi/upload/{type}
Ulazni parametri
Funkcija ima dva obavezna ulazna URL parametra:
- type - Tip dokumenta koji se dostavlja servisu
- requestId - Jedinstevni idnetifikator dokumenta iz eksternog sistema
| Standard | Ključ | Format | Opis |
|---|---|---|---|
| UBL | ubl-sales-invoice | UBL INVOICE | Ulazni račun |
| UBL | ubl-purchase-invoice | UBL INVOICE | Izlazni račun |
| OAGIS | oagis-purchase-order | PURCHASE ORDER | Porudžbina |
| UPSS | upss-invoice | DOKUMENT | UPSS XML za prenos faktura |
Rezultat
| HTTP Kod | Opis | Revizija |
|---|---|---|
| 200 | Dokument uspešno primljen ili procesiran. | 24-11-15 |
| 201 | Greška pri obradi dokumenta. | 24-11-15 |
| 202 | Dokument nije ispravno inicijalizovan. | 24-11-15 |
| 400 | Dokument je odbijen zbog greške u podacima. | 24-11-15 |
| 403 | Dokument je odbijen. | 24-11-15 |
| 404 | Nije predat obavezan parametar requestId ili type. | 24-11-15 |
| 422 | Nije predat ili nije podržan predat tip dokumenta. | 24-11-15 |
| 500 | Nepoznata serverska greška. | 24-11-15 |
| 503 | Greška pri povezivanju na bazu podataka. | 24-11-15 |
Primer funkcije (SOAP request)
Header
POST https://<url>:<port>/<putanja> HTTP/1.1 Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "" Content-Length: 15877 Host: ws.melany.rs:8191 Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5)
Body
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.balansedi.com/">
<soapenv:Header/>
<soapenv:Body>
<ser:UploadDocument>
<!--Optional:-->
<docMessage>
<![CDATA[<ProcessPurchaseOrder revision="8.0" environment="Production" xsi:schemaLocation="http://www.openapplications.org/oagis http://b2bdocs.agrokor.hr/schemas/oagis/8.0/BODs/ShowShipment.xsd http://agrokor.hr/agr http://b2bdocs.agrokor.hr/schemas/agr/oagis/8.0/UserArea/ShowShipment_UserArea.xsd" xmlns="http://www.openapplications.org/oagis" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:agr="http://agrokor.hr/agr" xmlns:mel="https://www.melany.rs/mel">