POČETNA SPI SC servis

Metoda dohvatiERacune

OpisDohvaćanje zaprimljenih eRačuna kao internih naloga u aplikaciji 192 – Salda konti prema zadanim filterima u ulaznom parametru.

Specifikacija ulaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
dohvatiERacuneRequest
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
eracuni0..1
DatumRacunaOdDatum računa od kojega se žele dohvatiti e računidate0..1
DatumRacunaDoDatum računa do kojega se žele dohvatiti e računidate0..1
ParSifraŠifra partnera iz LC SPI sustava. Za filtriranje partnera prema poslanim šiframa.
Ako nije poslano ne vrši se filtriranje po ovom elementu.
string(10)0..1
ParOIBOIB partnera. Za filtriranje partnera prema poslanim OIB – ima.
Ako nije poslano ne vrši se filtriranje po ovom elementu.
string(11)0..1
ParPDVIDPDV ID broj partnera. Za filtriranje partnera prema poslanim PDVID brojevima.
Ako nije poslano ne vrši se filtriranje po ovom elementu.
string(22)0..1
ParNazivNaziv partnera. Za dodatno filtriranje partnera po dijelu naziva odnosno po elementima ParNaziv i ParNazivII iz odgovora (responsa) ove metode.
Ako nije poslano ne vrši se filtriranje po ovom elementu
string(40)0..1
KlasaFiltriranje e računa po klasifikacijskoj oznaci.
Ako nije poslano ne vrši se filtriranje po ovom elementu.
string(30)0..1
DatumIzmjeneOdFiltriranje eRačuna prema početnom datumu izmjene u katalogu.
Ako nije poslano ne vrši se filtriranje po ovom elementu.
datetime0..1
DatumIzmjeneDoFiltriranje eRačuna prema završnom datumu izmjene u katalogu.
Ako nije poslano ne vrši se filtriranje po ovom elementu.
datetime0..1
StatusKnjizenjaFiltriranje eRačuna prema statusu knjiženja eRačuna.
Ako nije poslano ne vrši se filtriranje po ovom elementu.
Vrijednosti elementa:
S – svi eRačuni (bez obzira na status knjiženja)
N – samo eRačuni koji nisu knjiženi u SC
K – samo eRačuni koji su knjiženi u SC
string(1)0..1
DatumVrijemePreuzimanjaOdFiltriranje e računa prema datumu preuzimanja eRačuna od posrednika u LC SPI sustav (početni datum).
Ako nije poslano ne vrši se filtriranje po ovom elementu.
datetime0..1
DatumVrijemePreuzimanjaDoFiltriranje e računa prema datumu preuzimanja eRačuna od posrednika u LC SPI sustav (završni datum).
Ako nije poslano ne vrši se filtriranje po ovom elementu.
datetime0..1
eracun0..n
DokGUIDGlobalni jedinstveni identifikator. Koristi se za identifikaciju dokumenta u LC SPI sustavustring(36){Or1..1
UrBrojFiltriranje e računa po urudžbenom broju dokumenta.
Ako nije poslano ne vrši se filtriranje po ovom elementu.
string(30)Or}1..1
/eracun
/eracuni
DohvatiPrilogeParametar koji govori da li se žele ili ne žele prilozi eRačuna u odgovoru metode.
NE – ne vraća priloge eRačuna (inicijalno)
DA – vraća priloge eRačuna
string(2)0..1
VratiOriginalniXMLParametar koji govori da li se želi ili ne želi originalni UBL format eRačuna u odgovoru metode.
NE – ne vraća originalni UBL format eRačuna (inicijalno)
DA – vraća originalni UBL format eRačuna
string(2)0..1
/dohvatiERacuneRequest

* Filteri filtriraju response listu na način da se iz kataloga dokumenata LC SPI sustava izdvajaju samo podaci koji sadrže vrijednost poslanu u navedenim filterima.
* Tagovi eracuni i eracun nisu obavezni, a u slučaju da je jedan od njih poslan tada je minimalno jedan filter unutar poslanog taga obavezan, a može se kombinirati više filtera.

Specifikacija izlaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
dohvatiERacuneResponse
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
eracuni0..1
Eracun1..n
DokGUIDGlobalni jedinstveni identifikator. Koristi se za identifikaciju dokumenta u LC SPI sustavustring(36){Or1..1
DatumRacunaDatum računadate1..1
ParSifraŠifra partnera iz LC SPI sustava.string(10)0..1
ParOIBOIB partnera.string(11)0..1
ParPDVIDPDV ID broj partnera.string(22)0..1
ParNazivNaziv partnerastring(40)0..1
KlasaKlasifikacijska oznaka e računastring(30)0..1
UrBrojUrudžbeni broj dokumenta.string(30)0..1
IzvorPodatakaŠifra izvora podatka:
1 – HPD iRačun
2 – ePošta
3 - HT
4 - FINA eRačun
5 – Moj eRačun
6 – DB informatika
tinyint1..1
DatumIzmjeneDatum zadnje izmjene e računadatetime1..1
izvorniXML0..1
IZVORNI XML POJEDINOG POSREDNIKA
/izvorniXML
Prilozi0..1
Prilog1..n
NazivNaziv prilogastring(30)1..1
MimeCodeFormat (extenzija) prilogastring(20)1..1
VrijednostSadržaj prilogaBase64Binary1..1
/Prilog
/Prilozi
/Eracun
/eracuni
greskaOr}0..1
Greska1 – greškatinyint1..1
OpisGreskeOpis greške prilikom dohvata podatkastring(300)1..1
/greska
/dohvatiERacuneResponse

* U odgovoru metode dohvatiERacune se vraća unija podataka iz kataloga prema poslanim filterima.

Primjer requesta:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v0="http://www.spi.hr/ws/razmjena/sc/razmjenasc/v0.1"> <soapenv:Header/> <soapenv:Body> <v0:dohvatiERacuneRequest> <v0:VsID>SC</v0:VsID> <!--Zero or more repetitions:--> <v0:eracuni> <!--Zero or more repetitions:--> <v0:ERacun> <!--Optional:--> <v0:DokGUID>74736B1C-E4BE-43FA-8E04-F6D983A60F8E</v0:DokGUID> </v0:ERacun> </v0:eracuni> <!--Optional:--> <v0:VratiOriginalniXML>NE</v0:VratiOriginalniXML> </v0:dohvatiERacuneRequest> </soapenv:Body> </soapenv:Envelope>

Primjer responsea:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns3:dohvatiERacuneResponse xmlns:ns7="http://www.spi.hr/ws/razmjena/sc/v0.1" xmlns:ns6="urn:iso:std:iso:20022:tech:xsd:camt.053.001.02" xmlns:ns5="http://www.spi.hr/ws/razmjena/sc/razmjenalc125/v0.1" xmlns:ns4="http://www.spi.hr/ws/razmjena/sc/razmjenalc127/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"> <ns3:VsID>SC</ns3:VsID> <ns3:eracuni> <ns3:ERacun> <ns3:DokGUID>74736B1C-E4BE-43FA-8E04-F6D983A60F8E</ns3:DokGUID> <ns3:DatumRacuna>2022-12-31</ns3:DatumRacuna> <ns3:ParSifra>0003395</ns3:ParSifra> <ns3:ParOIB>87311810356</ns3:ParOIB> <ns3:ParPDVID/> <ns3:ParNaziv>HRVATSKA POŠTA D.D.</ns3:ParNaziv> <ns3:Klasa>401-01/23-01/98</ns3:Klasa> <ns3:UrBroj>15-23-1</ns3:UrBroj> <ns3:IzvorPodataka>2</ns3:IzvorPodataka> <ns3:DatumIzmjene>2023-01-23T10:48:35</ns3:DatumIzmjene> </ns3:ERacun> </ns3:eracuni> </ns3:dohvatiERacuneResponse> </soap:Body> </soap:Envelope>