POČETNA SPI SC servis

Metoda kreiraj105Racune

OpisSprema izlazne račune u LC SPI Fakturiranje

Specifikacija ulaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
kreiraj105RacuneRequest
VsID Identifikator vanjskog sustava (dogovara se) string(36) 1..1
racuni1..1
racun1..n
RnGUIDJedinstveni identifikator računastring(36)1..1
RnSifraZaRasporedivanjeNa osnovu ovog podatka je moguće u LC SPI sustavu vršiti dodatno raspoređivanje u financijama po organizacijskim nivoima
Prethodno je potrebno dogovoriti pravila za raspoređivanje
Za korištenje vanjski sustav treba na osnovu dogovorenih pravila ovaj podatak puniti
string(20)0..1
DatRacunaDatum računadate1..1
DatDospijecaDatum dospijeća računadate1..1
DatIsporukeDatum isporukedate1..1
ParSifraŠifra poslovnog partnera iz LC SPI sustavastring(10)1..1
RnTipRacunaŠifra tipa dokumenta iz kataloga koji se dohvaća putem metode web servisa dohvatiTipoveDokumenatastring(2)1..1
DevValutaŠifra (ISO oznaka) strane valutestring(3)0..1
DevDatumDatum tečaja strane valutedate0..1
DevTecajIznos tečaja strane valutedecimal(18,6)0..1
PredujamIznos plaćenog predujma za koji se umanjuje iznos za platiti po računudecimal(18,2)0..1
NaTemeljuTemelj izdavanja računastring(255)0..1
NarudzbenicaBroj narudžbenicestring(20)0..1
NacinPlacanjaŠifra načina plaćanja iz kataloga koji se dohvaća putem metode web servisa dohvatiNacinePlacanjastring(7)1..1
RnMTSifraŠifra mjesta troška iz kataloga koji se dohvaća putem metode web servisa dohvatiKatalogMjestaTroskastring(15)0..1
RazdobljeRazdoblje isporuke u formatu mm/gggg ili mm-mm/ggggstring(9)0..1
VRPSifraŠifra vrste prihoda prema Naputku o načinu uplaćivanja prihoda proračuna, obveznih doprinosa te prihoda za financiranje drugih javnih potrebastring(4)0..1
RnProstorŠifra prostora obveznika
Obavezno ako se šalje KOMIS naknada ili Vrsta rada
string(20)RnNaknada, VrstaRada0..1
RnNaknadaŠifra KOMIS naknade
Šalju KOMIS korisnici
Ne može se poslati u kombinaciji s VrstaRada
Ako se šalje mora se obavezno poslati i odgovarajući podatak u polju RnSifraZaRasporedivanje
string(3)0..1
VrstaRadaŠifra vrste rada
Šalju USZ korisnici
Ne može se poslati u kombinaciji s Naknada i/ili VrstaKnjizenja
string(10)0..1
VrstaKnjizenjaŠifra vrste knjiženja
Šalju KOMIS korisnici
Ne može se poslati u kombinaciji s VrstaRada
string(6)0..1
SifraNamjeneČetveroslovna oznaka transakcije prema standardu ISO 2002string(4)0..1
VezaNaUgovorNačin unosa veze na ugovor
1 - Upis broja ugovora
2 - Preuzimanje broja ugovora sa partnera iz LC SPI kataloga partnera
3 - Veza na ugovor iz LC SPI Registar ugovora
string(1)0..1
BrojUgovoraUpis broja ugovora bez veze na LC SPI Registar ugovora
Šalje se obavezno kada je VezaNaUgovor = 1, u suprotnom se ne šalje
string(26)VezaNaUgovor = 10..1
UgovoriGUIDIdentifikator ugovora iz LC SPI Registr ugovora koji se dohvaća metodom web servisa dohvatiUgovore
Šalje se obavezno kada je VezaNaUgovor = 3, u suprotnom se ne šalje
string(36)VezaNaUgovor = 30..1
VrstaPoslovnogProcesaŠifra vrste poslovnog procesa iz kataloga vrsta poslovnih procesa definiranih normom HRN EN 16931-1
P1 - Izdavanje računa za isporuke robe i usluga prema narudžbenicama, na temelju ugovora
P2 - Izdavanje računa za isporuke robe i usluga na temelju ugovora
P3 - Izdavanje računa za isporuku prema samostalnoj narudžbenici
P4 - Plaćanje unaprijed
P5 - Plaćanje na licu mjesta
P6 - Plaćanje prije isporuke
P7 - Računi s referencijama na otpremnice
P8 - Računi s referencijama na otpremnicu i primku
P9 - Odobrenja ili računi s negativnim iznosima, izdani zbog raznih razloga, uključujući i povrat prazne ambalaže
P10 - Izdavanje korektivnog računa (storniranje/ispravak računa)
P11 - Izdavanje djelomičnoga i konačnog računa
P12 - Samoizdavanje računa
string(3)1..1
stavkeRacuna1..1
stavkaRacuna1..n
StSifraZaRasporedivanjeNa osnovu ovog podatka je moguće u LC SPI sustavu vršiti dodatno raspoređivanje u financijama po organizacijskim nivoima
Prethodno je potrebno dogovoriti pravila za raspoređivanje
Za korištenje vanjski sustav treba na osnovu dogovorenih pravila ovaj podatak puniti
Ako se šalje za stavku računa tada se ne smije slati za račun i obrnuto
string(20)0..1
UslOznakaOznaka usluge iz kataloga koji se dohvaća putem metode web servisa dohvati dohvatiUslugestring(15)1..1
JMSifraŠifra jedinice mjere iz kataloga koji se dohvaća putem metode web servisa dohvati dohvatiJediniceMjerestring(7)1..1
KolicinaKoličina jedinica mjeredecimal(18,3)1..1
JedCijenaJedinična neto cijena - neto cijena jedne jedinice mjeredecimal(18,2)1..1
StPopustPostotak popusta (rabata) stavke računadecimal(18,4)0..1
StCassaScontoPostotak cassa sconto stavke računadecimal(18,4)0..1
StMTSifraŠifra mjesta troška na stavci računa iz kataloga koji se dohvaća putem metode web servisa dohvatiKatalogMjestaTroskastring(15)0..1
StTipRacunaŠifra tipa dokumenta na stavci računa iz kataloga koji se dohvaća putem metode web servisa dohvatiTipoveDokumenatastring(2)0..1
NapomenaNapomena za ispis uz stavku računastring(4000)0..1
StProstorŠifra prostora obveznika na stavci računa
Obavezno ako se šalje KOMIS naknada
string(20)StNaknada0..1
StNaknadaŠifra KOMIS naknade na stavci računa
Obavezno ako se šalje Prostor
string(3)0..1
/stavkaRacuna
/stavkeRacuna
privitci0..1
privitak1..n
PrivitakGUIDGlobalni jedinstveni identifikator privitkastring(36)1..1
PrivitakNazivNaziv privitkastring(30)1..1
PrivitakMimeCodeFormat (extenzija) privitkastring(20)1..1
PrivitakSadrzajSadržaj privitkaBase64Binary1..1
/privitak
/privitci
/racun
VratiSvePodatkeRacunaDefinira koji set podataka se vraća u odgovoru
True - vraća sve podatke o računu i stavkama računa
False ili nije poslano - vraća se osnovi set podataka o računu
boolean0..1
/racuni
/kreiraj105RacuneRequest

Specifikacija izlaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
kreiraj105racuneResponse
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
racuni0..1
racun1..n
osnovniPodaci1..1
RnGUIDJedinstveni identifikator računastring(36)1..1
RnOrgNivoOrganizacijski nivo na koji je račun knjiženstring(9)1..1
BrojRacunaBroj računastring(10)1..1
DatRacunaDatum računadate1..1
DatDospijecaDatum dospijeća računadate1..1
DatIsporukeDatum isporukedate1..1
ParSifraŠifra poslovnog partnera iz LC SPI sustavastring(10)1..1
Neto2Neto iznos računa umanjen za popust i cassa scontodecimal(18,2)1..1
PDVIznosIznos PDV-a na računudecimal(18,2)1..1
BrutoBruto iznos računadecimal(18,2)1..1
PredujamIznos plaćenog predujma za koji se umanjuje iznos za platiti po računudecimal(18,2)0..1
ZaPlatitiIznos računa za plaćanjedecimal(18,2)1..1
/osnovniPodaci
dodatniPodaci0..1
RnTipRacunaŠifra tipa dokumenta iz kataloga koji se dohvaća putem metode web servisa dohvatiTipoveDokumenatastring(2)1..1
Neto1Neto iznos računadecimal(18,2)1..1
PopustIznosIznos popusta (rabata)decimal(18,2)1..1
CassaScontoIznosIznos cassa scontodecimal(18,2)1..1
DevValutaŠifra (ISO oznaka) strane valutestring(3)0..1
DevDatumDatum tečaja strane valutedate0..1
DevTecajIznos tečaja strane valutedecimal(18,6)0..1
DevIznosIznos u stranoj valutidecimal(18,2)0..1
BrStavakaBroj stavki na računushort1..1
OdgodaPlacanjaOdgoda plaćanja računa u broju danashort1..1
NaTemeljuTemelj izdavanja računastring(255)0..1
NarudzbenicaBroj narudžbenicestring(20)0..1
NacinPlacanjaŠifra načina plaćanja iz kataloga koji se dohvaća putem metode web servisa dohvatiNacinePlacanjastring(7)1..1
RnMTSifraŠifra mjesta troška iz kataloga koji se dohvaća putem metode web servisa dohvatiKatalogMjestaTroskastring(15)0..1
RazdobljeRazdoblje isporuke u formatu mm/gggg ili mm-mm/ggggstring(9)0..1
VRPSifraŠifra vrste prihoda prema Naputku o načinu uplaćivanja prihoda proračuna, obveznih doprinosa te prihoda za financiranje drugih javnih potrebastring(4)0..1
RnProstorŠifra prostora obveznika
Obavezno ako se šalje KOMIS naknada ili Vrsta rada
string(20)Naknada, VrstaRada0..1
RnNaknadaŠifra KOMIS naknade
Šalju KOMIS korisnici
Ne može se poslati u kombinaciji s VrstaRada
string(3)0..1
VrstaRadaŠifra vrste rada
Šalju USZ korisnici
Ne može se poslati u kombinaciji s Naknada i/ili VrstaKnjizenja
string(10)0..1
VrstaKnjizenjaŠifra vrste knjiženja
Šalju KOMIS korisnici
Ne može se poslati u kombinaciji s VrstaRada
string(2)0..1
SifraNamjeneČetveroslovna oznaka transakcije prema standardu ISO 2002string(4)0..1
BrojUgovoraUpis broja ugovora bez veze na LC SPI Registar ugovora
Šalje se obavezno kada je VezaNaUgovor = 1, u suprotnom se ne šalje
string(1)VezaNaUgovor = 10..1
UgovoriGUIDIdentifikator ugovora iz LC SPI Registr ugovora koji se dohvaća metodom web servisa dohvatiUgovore
Šalje se obavezno kada je VezaNaUgovor = 3, u suprotnom se ne šalje
string(36)VezaNaUgovor = 30..1
VrstaPoslovnogProcesaŠifra vrste poslovnog procesa iz kataloga vrsta poslovnih procesa definiranih normom HRN EN 16931-1
P1 - Izdavanje računa za isporuke robe i usluga prema narudžbenicama, na temelju ugovora
P2 - Izdavanje računa za isporuke robe i usluga na temelju ugovora
P3 - Izdavanje računa za isporuku prema samostalnoj narudžbenici
P4 - Plaćanje unaprijed
P5 - Plaćanje na licu mjesta
P6 - Plaćanje prije isporuke
P7 - Računi s referencijama na otpremnice
P8 - Računi s referencijama na otpremnicu i primku
P9 - Odobrenja ili računi s negativnim iznosima, izdani zbog raznih razloga, uključujući i povrat prazne ambalaže
P10 - Izdavanje korektivnog računa (storniranje/ispravak računa)
P11 - Izdavanje djelomičnoga i konačnog računa
P12 - Samoizdavanje računa
string(3)1..1
stavkeRacuna1..1
stavkaRacuna1..n
RBSRedni broj stavke na računushort1..1
StOrgNivoOrganizacijski nivo na koji je knjižena stavkastring(9)1..1
UslOznakaOznaka usluge iz kataloga koji se dohvaća putem metode web servisa dohvati dohvatiUslugestring(15)1..1
JMSifraŠifra jedinice mjere iz kataloga koji se dohvaća putem metode web servisa dohvati dohvatiJediniceMjerestring(7)1..1
KolicinaKoličina jedinica mjeredecimal(18,3)1..1
JedCijenaJedinična neto cijena - neto cijena jedne jedinice mjeredecimal(18,2)1..1
StNeto1Neto iznos stavke računadecimal(18,2)1..1
StPopustPostotak popusta (rabata) stavke računadecimal(18,4)1..1
StPopustIznosIznos popusta (rabata) stavke računadecimal(18,2)1..1
StCassaScontoPostotak cassa sconto stavke računadecimal(18,4)1..1
StCassaScontoIznosIznos cassa sconto stavke računadecimal(18,2)1..1
StNeto2Neto iznos stavke računa umanjen za popust i cassa scontodecimal(18,2)1..1
StPDVPostotak PDV-a stavke računadecimal(18,4)1..1
StPDVIznosIznos PDV-a stavke računadecimal(18,2)1..1
StBrutoBruto iznos stavke računadecimal(18,2)1..1
StMTSifraŠifra mjesta troška na stavci računa iz kataloga koji se dohvaća putem metode web servisa dohvatiKatalogMjestaTroskastring(15)0..1
StTipRacunaŠifra tipa dokumenta na stavci računa iz kataloga koji se dohvaća putem metode web servisa dohvatiTipoveDokumenatastring(2)0..1
NapomenaNapomena za ispis uz stavku računastring(4000)0..1
StProstorŠifra prostora obveznika na stavci računa
Obavezno ako se šalje KOMIS naknada
string(20)StNaknada0..1
StNaknadaŠifra KOMIS naknade na stavci računa
Obavezno ako se šalje Prostor
string(3)0..1
/stavkaRacuna
/stavkeRacuna
privitci0..1
privitak1..n
PrivitakGUIDGlobalni jedinstveni identifikator privitkastring(36)1..1
PrivitakNazivNaziv privitkastring(30)1..1
PrivitakMimeCodeFormat (extenzija) privitkastring(20)1..1
/privitak
/privitci
/dodatniPodaci
/racun
/racuni
greska0..1
Greska1 – greškatinyint1..1
OpisGreskeOpis greške prilikom dohvata podatkastring(300)1..1
/greska
/dohvatiUslugeResponse
*Zbroj iznosa PDV-a i bruto iznosa na stavkama može se razlikovati od iznosa PDV-a i bruto iznosa na glavi računa zbog zaokruživanja. Relevantni su iznosi na glavi računu.

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:kreiraj105RacuneRequest> <v0:VsID>SC</v0:VsID> <v0:racuni> <v0:racun> <v0:DatRacuna>2024-10-10</v0:DatRacuna> <v0:DatDospijeca>2024-10-15</v0:DatDospijeca> <v0:DatIsporuke>2024-10-10</v0:DatIsporuke> <v0:ParSifra>1234567</v0:ParSifra> <v0:RnTipRacuna>TI</v0:RnTipRacuna> <v0:NacinPlacanja>TR</v0:DatRacuna> <v0:VrstaPoslovnogProcesa>P2</v0:VrstaPoslovnogProcesa> <v0:stavkeRacuna> <v0:stavkaRacuna> <v0:UslOznaka>01</v0:UslOznaka> <v0:JMSifra>KOM</v0:JMSifra> <v0:Kolicina>1.000</v0:Kolicina> <v0:JedCijena>15.00</v0:JedCijena> </v0:stavkaRacuna> </v0:stavkeRacuna> </v0:racun> <v0:VratiSvePodatkeRacuna>1</v0:VratiSvePodatkeRacuna> </v0:racuni> </v0:kreiraj105RacuneRequest> </soapenv:Body> </soapenv:Envelope>

Primjer responsea:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v0="http://www.spi.hr/ws/razmjena/sc/razmjenasc/v0.1"> <soapenv:Header/> <soap:Body> <v0:kreiraj105RacuneResponse <v0:VsID>SC</ns3:VsID> <v0:racuni> <v0:racun> <v0:osnovniPodaci> <v0:RnGUID>c044bab4-1fe4-41aa-88a9-0472956875c1</v0:RnGUID> <v0:RnOrgNivo></v0:OrgNivo> <v0:BrojRacuna>24/0000001</v0:BrojRacuna> <v0:DatRacuna>2024-10-10</v0:DatRacuna> <v0:DatDospijeca>2024-10-15</v0:DatDospijeca> <v0:DatIsporuke>2024-10-10</v0:DatIsporuke> <v0:ParSifra>1234567</v0:ParSifra> <v0:Neto2>15.00</v0:Neto2> <v0:PDVIznos>3.75</v0:PDVIznos> <v0:Bruto>18.75</v0:Bruto> <v0:ZaPlatiti>18.75</v0:ZaPlatiti> </v0:osnovniPodaci> <v0:dodatniPodaci> <v0:RnTipRacuna>TI</v0:RnTipRacuna> <v0:Neto1>15.00</v0:Neto1> <v0:PopustIznos>0.00</v0:PopustIznos> <v0:CassaScontoIznos>0.00</v0:CassaScontoIznos> <v0:BrStavaka>1</v0:BrStavaka> <v0:OdgodaPlacanja>5</v0:OdgodaPlacanja> <v0:NacinPlacanja>TR</v0:DatRacuna> <v0:VrstaPoslovnogProcesa>P2</v0:VrstaPoslovnogProcesa> <v0:stavkeRacuna> <v0:stavkaRacuna> <v0:RBS>1</v0:RBS> <v0:StOrgNivo></v0:StOrgNivo> <v0:UslOznaka>01</v0:UslOznaka> <v0:JMSifra>KOM</v0:JMSifra> <v0:Kolicina>1.000</v0:Kolicina> <v0:JedCijena>15.00</v0:JedCijena> <v0:StNeto1>0.00</v0:StNeto1> <v0:StPopust>0.00</v0:StPopust> <v0:StPopustIznos>0.00</v0:StPopustIznos> <v0:StCassaSconto>0.00</v0:StCassaSconto> <v0:StCassaScontoIznos>0.00</v0:StCassaScontoIznos> <v0:StNeto2>15.00</v0:StNeto2> <v0:StPDV>25.0000</v0:StPDV> <v0:StPDVIznos>3.75</v0:StPDVIznos> <v0:StBruto>18.75</v0:StBruto> </v0:stavkaRacuna> </v0:stavkeRacuna> </v0:dodatniPodaci> </v0:racun> </v0:racuni> </v0:kreiraj105RacuneResponse> </soap:Body> </soap:Envelope>