POČETNA SPI SC servis

Metoda spremiPrivitke

OpisSprema privitke uz dokumente u LC SPI sustav.

Specifikacija ulaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiPrivitkeRequest
VsIDIdentifikator sustava koji upućuje zahtijevstring(36)1..1
DokVrstaVrsta dokumenta u LC SPI sustavu
Enumeracija:
„UGO125“ – ugovori
„DOK223“ – dokument urudžbenog zapisnika
„ERA156“ – izlazni eRačun
„INA192“ – ulazni eRačun
„SCD192“ – salda konti dokument (ulazni račun ili knjižni zapis)
„NAR127" – narudžbenica
string(40)1..1
privitci1..1
privitak1..n
DokGUIDGlobalni jedinstveni identifikator dokumenta za kojeg se privitak vežestring(36)1..1
PrivitakGUIDGlobalni jedinstveni identifikator privitkastring(36)1..1
PrivitakNazivNaziv privitkastring(30)1..1
PrivitakMimeCodeFormat (extenzija) privitkastring(20)1..1
PrivitakSadrzajSadržaj privitkaBase64Binary1..1
/privitak
/privitci
/spremiPrivitkeRequest

Specifikacija izlaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiPrivitkeResponse
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
DokVrstaVrsta dokumenta u LC SPI sustavu
Enumeracija:
„UGO125“ – ugovori
„DOK223“ – dokument urudžbenog zapisnika
„ERA156“ – izlazni eRačun
„INA192“ – ulazni eRačun
„SCD192“ – salda konti dokument (ulazni račun ili knjižni zapis)
„NAR127" – narudžbenica
string(40)1..1
privitci{Or0..1
privitak1..n
DokGUIDGlobalni jedinstveni identifikator dokumentastring(36)1..1
PrivitakGUIDGlobalni jedinstveni identifikator privitkastring(36)1..1
PrivitakNazivNaziv privitkastring(30)1..1
status1..1
Greska0 – nema greške;
1 – greška (nije spremljeno);
2 – već postoji u LC SPI sustavu
tinyint1..1
OpisGreskeOpis greške u slučaju da prilog nije uspješno spremljen u LC SPI sustavu.
– obavezan za Greska <> 0
string(300)Greska = 00..1
/status
/privitak
/privitci
greskaOr}0..1
Greska1 – greškatinyint1..1
OpisGreskeOpis greške prilikom spremanja podatka – globalna greškastring(300)1..1
/greska
/spremiPrivitkeResponse

* Spremanje privitaka u LC SPI bazu se vrši samo za one privitke koji uspješno prođu provjeru podataka dok se oni privitci koji imaju bilo kakvu grešku u podacima ne spremaju.
* U odgovoru metode se u oba slučaja vraća status greške za svaki pojedini privitak kako je u specifikaciji navedeno.
* Ukoliko dođe do globalne greške (nedostupan servis, neuspjela prijava i sl.) tada se ista vraća u odgovoru bez povratnih podataka o privitcima i u tom slučaju nije došlo do nikakve obrade unutar LC SPI sustava.

Primjer requesta:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v0="http://www.spi.hr/ws/razmjena/sc/razmjenalc125/v0.1"> <soapenv:Header/> <soapenv:Body> <v0:spremiPrivitkeRequest> <v0:VsID>SC</v0:VsID> <v0:DokVrsta>UGO125</v0:DokVrsta> <v0:privitci> <!--1 or more repetitions:--> <v0:privitak> <v0:DokGUID>F8D2D449-A70E-4472-A849-25EAEADF50F6</v0:DokGUID> <v0:PrivitakGUID>F8D2D449-A70E-4472-A949-25EAEADF50F7</v0:PrivitakGUID> <v0:PrivitakNaziv>Sken ugovora</v0:PrivitakNaziv> <v0:PrivitakMimeCode>.pdf</v0:PrivitakMimeCode> <v0:PrivitakSadrzaj>aGVyb25neWFuZy5jb20=</v0:PrivitakSadrzaj> </v0:privitak> </v0:privitci> </v0:spremiPrivitkeRequest> </soapenv:Body> </soapenv:Envelope>

Primjer responsea:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns4:spremiPrivitkeResponse xmlns:ns6="http://www.spi.hr/ws/razmjena/sc/v0.1" xmlns:ns5="urn:iso:std:iso:20022:tech:xsd:camt.053.001.02" xmlns:ns4="http://www.spi.hr/ws/razmjena/sc/razmjenalc125/v0.1" xmlns:ns3="http://www.spi.hr/ws/razmjena/sc/razmjenasc/v0.1" xmlns:ns2="http://www.spi.hr/ws/razmjena/sc/razmjenarp/v0.1"> <ns4:VsID>SC</ns4:VsID> <ns4:DokVrsta>UGO125</ns4:DokVrsta> <ns4:privitci> <ns4:privitak> <ns4:DokGUID>F8D2D449-A70E-4472-A849-25EAEADF50F6</ns4:DokGUID> <ns4:PrivitakGUID>F8D2D449-A70E-4472-A949-25EAEADF50F7</ns4:PrivitakGUID> <ns4:PrivitakNaziv>Sken ugovora</ns4:PrivitakNaziv> <ns4:status> <ns4:Greska>0</ns4:Greska> </ns4:status> </ns4:privitak> </ns4:privitci> </ns4:spremiPrivitkeResponse> </soap:Body> </soap:Envelope>