Differences

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

--- kb:web_api:module_edi [2024/11/14 15:15] – ognjen.bogicevic
+++ kb:web_api:module_edi [2024/11/20 10:07] (current) – ognjen.bogicevic
@@ Line 1: / Line 1: @@
 ====== Balans Web API - Edi ======
-===== 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.
+===== REST API Zahtev =====
 <code>
@@ Line 7: / Line 10: @@
 </code>
-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.
+===== Ulazni parametri =====
-===== Sintaksa =====
+Funkcija ima dva obavezna ulazna URL parametra:
+  * **type** - Tip dokumenta koji se dostavlja servisu
+  * **requestId** - Jedinstevni idnetifikator dokumenta iz eksternog sistema
-UploadDocument(docMessage, xmlFmt)
+^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 =====
-**String** msgRes; Niz karaktera koji označavaju stanje u kom se nalazi sistem po prijemu dokumenta. Neposredno nakon prijema dokument prolazi osnovne provere:
+^HTTP Kod^Opis^Revizija|
+|200|Dokument uspešno primljen ili procesiran.|24-11-15|
-   * ispravnost XML-a
+|201|Greška pri obradi dokumenta.|24-11-15|
-  * dupliranje zahteva
+|202|Dokument nije ispravno inicijalizovan.|24-11-15|
+|400|Dokument je odbijen zbog greške u podacima.|24-11-15|
-Mogući su sledeći rezultati provere:
+|403|Dokument je odbijen.|24-11-15|
+|404|Nije predat obavezan parametar **requestId** ili **type**.|24-11-15|
-^Rezultat^Vrednost^Opis|
+|422|Nije predat ili nije podržan predat tip dokumenta.|24-11-15|
-|BEDI_STDRES_OK|"0"|Označava da je dokument primljen bez grešaka.|
+|500|Nepoznata serverska greška.|24-11-15|
-|BEDI_STDRES_DUPLICATE|"1"|Označava da je dokument već primljen i da je pošiljka duplikat postojećeg dokumenta.|
+|503|Greška pri povezivanju na bazu podataka.|24-11-15|
-|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>