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 parametra:
- type - Tip dokumenta koji se dostavlja servisu
- requestId - Jedinstevni idnetifikator dokumenta iz eksternog sistema
Podržani tipovi dokumenata:
- ubl-sales-invoice - Ulazni račun
- ubl-purchase-invoice - Izlazni račun
- oagis-purchase-order - Porudžbina
- upss-invoice - Faktura
Rezultat
String msgRes; Niz karaktera koji označavaju stanje u kom se nalazi sistem po prijemu dokumenta. Neposredno nakon prijema dokument prolazi osnovne provere:
- ispravnost XML-a
- dupliranje zahteva
Mogući su sledeći rezultati provere:
| Rezultat | Vrednost | Opis |
|---|---|---|
| BEDI_STDRES_OK | “0” | Označava da je dokument primljen bez grešaka. |
| BEDI_STDRES_DUPLICATE | “1” | Označava da je dokument već primljen i da je pošiljka duplikat postojećeg dokumenta. |
| BEDI_STDRES_INVALID_FMT | “1000” | Označava da je dokument pogrešnog formata |
Napomena: Rezultati provere od “1” do “999” su benigni i mogu se ignorisati. Rezultati od “1000” do “9999” su opasni i ne bi se smeli ignorisati.
Parametri
| Naziv | Vrsta | Opis |
|---|---|---|
| docMessage | String | Elektronski dokument, u XML zapisu određenog formata. |
| xmlFmt | String | Format zapisa XML fajla. Podrazumevana vrednost je “XML_FMT_OAGIS”. Moguće vrednosti: “XML_FMT_OAGIS”; Fajl je u OAGIS formatu. |
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">