Differences

This shows you the differences between two versions of the page.

--- kb:web_api:module_edi [2024/11/14 15:13] – created ognjen.bogicevic
+++ kb:web_api:module_edi [2024/11/20 10:07] (current) – ognjen.bogicevic
@@ Line 1: / Line 1: @@
 ====== Balans Web API - Edi ======
-====== UploadDocument() metod ======
+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.
-===== Akcija =====
+===== REST API Zahtev =====
-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.
-===== Sintaksa =====
-UploadDocument(docMessage, xmlFmt)
-===== 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>
+https://ws.melany.rs/api/rest/edi/upload/{type}
-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
+===== Ulazni parametri =====
-<code>
+Funkcija ima dva obavezna ulazna URL parametra:
- <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.balansedi.com/">
+  * **type** - Tip dokumenta koji se dostavlja servisu
-    <soapenv:Header/>
+  * **requestId** - Jedinstevni idnetifikator dokumenta iz eksternog sistema
-    <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>
+^Standard^Ključ^Format^Opis|
+|UBL|ubl-sales-invoice|[[:kb:doc_ubl_invoice|UBL INVOICE]]|Ulazni račun|
+|UBL|ubl-purchase-invoice|[[:kb:doc_ubl_invoice|UBL INVOICE]]|Izlazni račun|
+|OAGIS|oagis-purchase-order|[[:kb:web:balans_edi_oagis_opis|PROCESS PURCHASE ORDER]]|Porudžbina|
+|UPSS|upss-invoice|[[:kb:doc_upss_faktura|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|