====== 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 =====

<code>
https://ws.melany.rs/api/rest/edi/upload/{type}
</code>

===== 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
<code>

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)

</code>

Body

<code>
 <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">

</code>