POVRATAK

Metoda: prijedlozi - POST request

URL (test): https://e-ovrhe-test.pravosudje.hr/api/veliki-korisnici/prijedlozi
URL (produkcija): https://e-ovrhe.pravosudje.hr/api/veliki-korisnici/prijedlozi

1. Kontrola prava pristupa

Za kontrolu prava korištenja metode u 098 se provjerava slijedeća operacija:

Aplikacija Broj operacije Kontrolirana metoda
192 LC192PEovr Priprema i slanje eOvrha

2. Opis rada metode

Metoda vrši slanje podataka o pojedinačnim ovrhama u servis eOvrha.

Koraci obrade:

1. Vrši se dohvat parametara iz LCSPI tablice LCZAJ_VanjskiSustavi za VsID = eOvrhe.
URL servisa - adresa servisa.
Token - za autentifikaciju na servis eOvrha.

2. Vrši se priprema podataka pojedinačnih ovrha iz LCSPI tablica LC192_TuzbeSPartnera i LC192_TuzbeSStavke.

3. Vrši se priprema podataka obračunatih kamata za svaki pojedini pripremljeni dokument iz tablice LC192_TuzbeSStavke.
Priprema se vrši kroz godine iz tablice LC194_KamateStavkeObracunaPocetno i to na način:
- sumiranje iznosa obračunate kamate - kolona LC194_KamateStavkeObracunaPocetno.obrkamata
- dohvaćanje zadnjeg datuma obračuna kamate - kolona LC194_KamateStavkeObracunaPocetno.obrkamata

4. Dohvaća se vjerodostojna isprava spremljena u DMS za pojedinačnu ovrhu.

5. Vrši se punjenje POST metode prijedlozi prema specifikaciji.
Metoda se puni i šalje za svaku pojedinačnu ovrhu (jedan request za jednu pojedinačnu ovrhu).

6. Vrši se spremanje jedinstvenog identifikatora iz responsea metode u tablicu LC192_TuzbeSPartnera.

3. Punjenje ulaznog JSON-a metode:

Opis O
.
ovrhovoditelji1..n
tip"PRAVNA_OSOBA"DA
oibLCZAJ_OsobniIdentifikacijskiBrojevi.OIB preko LCZAJ_Korisnici.OsobniIdentifikacijskiBrojeviIDDA
nazivLCZAJ_Korisnici.NAZIV + LCZAJ_Korisnici.NAZIV2NE
adresaDA
ulicaIKbrLCZAJ_Korisnici.ULICAIBROJDA
postanskiBrojLCZAJ_Korisnici.PTTBROJDA
naseljeŠalje se jedan od elementa id ili jednoznačni naziv naselja.DA
idIdentifikator naselja iz šifarnika eOvrha. Dohvaća se metodom GET naselja.DA
nazivNaziv naselja.NE
drzavaŠalje se jedan od elementa id ili oznaka.DA
idIdentifikator države iz šifarnika eOvrha.Dohvaća se metodom GET drzave.DA
oznakaAko je LCZAJ_Drzave.Sifra2 <> NULL tada LCZAJ_Drzave.Sifra2 - preko LCZAJ_Korisnici.DrzaveIDNE
ovrsenici1..n
tipAko je LCZAJ_Partneri.Osoba = 'P' tada "PRAVNA_OSOBA" inače "FIZICKA_OSOBA"DA
oibLCZAJ_OsobniIdentifikacijskiBrojevi.OIB preko LCZAJ_Partneri.OsobniIdentifikacijskiBrojeviID (LC192_TuzbeSPartnera.Partner)DA
imeAko je tip = "FIZICKA_OSOBA" tada uzeti prvi dio LCZAJ_Partneri.Naziv + LCZAJ_Partneri.NazivII (do prvog ' ') inače NULLNE
prezimeAko je tip = "FIZICKA_OSOBA" tada uzeti drugi dio LCZAJ_Partneri.Naziv + LCZAJ_Partneri.NazivII (od prvog ' ' do kraja) inače NULLNE
nazivAko je tip = "PRAVNA_OSOBA" tada LCZAJ_Partneri.Naziv + LCZAJ_Partneri.NazivII inače NULLNE
adresaDA
ulicaIKbrUlica i kućni brojDA
postanskiBrojBroj pošteDA
naseljeŠalje se jedan od elementa id ili jednoznačni naziv naselja.DA
idIdentifikator naselja iz šifarnika eOvrha. Dohvaća se metodom GET naselja.DA
nazivNaziv naselja.NE
drzavaŠalje se jedan od elementa id ili oznaka.DA
idIdentifikator države iz šifarnika eOvrha.Dohvaća se metodom GET drzave.DA
oznakaAko je LCZAJ_Drzave.Sifra2 <> NULL tada LCZAJ_Drzave.Sifra2 - preko LCZAJ_Partneri.DifraDrzaveNE
sredstvaOvrheDA
idLC192_OvrheSredstva.IdentifikatorIzEOvrha preko LC192_TuzbeSkupne.OvrheSredstvaIDDA
vjerodostojneIsprave1..n
vrstaDA
idIdentifikator vrste vjerodostojne isprave iz šifarnika eOvrha.
Puniti 2 (Izvadak iz poslovnih knjiga)
DA
oznakaLC192_TuzbeSPartnera.Korisnik + '-' + LC192_TuzbeSPartnera.Nivo + '-' + LC192_TuzbeSPartnera.Broj + '-' + LC192_TuzbeSPartnera.BrojTuzbeNE
datumLC192_TuzbeSPartnera.DatumNE
opisTrazbina"Dugovanja po otvorenim stavkama"NE
datotekaDA
nazivDatotekeLC192_TuzbeSPartnera.Korisnik + '-' + LC192_TuzbeSPartnera.Nivo + '-' + LC192_TuzbeSPartnera.Broj + '-' + LC192_TuzbeSPartnera.BrojTuzbe + 'izvadak.poslovne.knjige.pdf'DA
sadrzajTip"PDF"DA
brojStranicaBroj stranica kreiranog PDF.DA
trazbinePune se iz tablice LC192_TuzbeSStavke1..n
ovrhovoditeljRbr1DA
valutaŠalje se jedan od elementa id ili oznaka.DA
idIdentifikator valute iz šifarnika eOvrha.Dohvaća se metodom GET valute.DA
oznaka"HRK"NE
glavnicaLC192_TuzbeSStavke.DUGDA
obracunKamatneStope"ZAKONSKA_ZATEZNA_KAMATA"DA
vrstaZakonskeZatezneKamateDA
id2 - (Kamatna stopa prema članku 29. Zakona o obveznim odnosima za ostale odnose)DA
datumPocetkaTijekaKamateDatum od zadnjeg obračuna kamata do naplate potraživanja.NE
kamataIznos prethodno obračunate kamate.NE
prethodnoObracunataKamataSUM(LC194_KamateStavkeObracunaPocetno.obrkamata) za dokument iz LC192_TuzbeSStavke
PRETRAŽIVANJE KROZ GODINE
NE
prethodnoObracunataKamataDatumMAX(LC194_KamateStavkeObracunaPocetno.datumDo) za dokument iz LC192_TuzbeSStavke
PRETRAŽIVANJE KROZ GODINE
NE
podaciZaIsplatuDA
brojRacunaLCZAJ_Korisnici.ZIRORACUNDA
modelLC192_TuzbeSPartnera.ModelPNBONE
pnbLC192_TuzbeSPartnera.PNBONE
uDomacuBankutrueDA
troskoviPostupkaPovrattrueNE
troskoviPostupkaKamataPovrattrueNE
troskoviPostupkaOdvjetnikIOstaloNE
opisSastavljanje prijedlogaDA
jedinicnaCijenaOvisno o visini duga:
0,00 do 250,00 = 37.50
250,01 do 1.000,00 = 75.00
1.000,01 do 2.500,00 = 125.00
2.500,01 do 5.000,00 = 250.00
5.000,01 do 10.000,00 = 750.00
10.000,01 do 100.000,00 = 1000.00
100.000,01 do 250.000,00 = 2500.00
250.000,01 do 500.000,00 = 5000.00
DA
kolicina1DA
pdvStopa0.25DA
troskoviPostupkaJavniBiljeznikŠalju se minimalno dva troška (vidi primjer)NE
opis"Predujam naknade javnog bilježnika";
"Ostatak naknade";
"Trošak daljnjih dostava"
DA
jedinicnaCijena"Predujam naknade javnog bilježnika" - 25.00
"Ostatak naknade" - Ovisno o visini duga:
0,00 do 5.000,00 = 100.00 - Predujam naknade
5.000,01 do 50.000,00 = 150.00 - Predujam naknade
preko 50.000,00 = 200.00 + 1 posto na razliku iznad 50.000,00 kn, ali ne više od 5.000,00 kn. - Predujam naknade
DA
kolicina1DA
pdvStopa0.25DA
troskoviPostupkaPrimateljUloga"OVRHOVODITELJ"NE
troskoviPostupkaPrimateljRbr1NE
troskoviPostupkaPodaciZaIsplatuNE
brojRacunaLCZAJ_Korisnici.ZIRORACUNDA
modelLC192_TuzbeSPartnera.ModelPNBONE
pnbLC192_TuzbeSPartnera.PNBONE
uDomacuBankutrueDA

Prilozi

Dodatne upute - Upute.pdf.

Šifarnici su dostupni preko linkova u nastavku, a dodatno se nalaze i u Excel tablicama u datoteci Šifarnici.xlsx.

Metode za pozivaju GET requestovima na sljedeće URL-ove:

  • https://e-ovrhe-test.pravosudje.hr/api/veliki-korisnici/sifrarnici/vrste-zakonske-zatezne-kamate
  • https://e-ovrhe-test.pravosudje.hr/api/veliki-korisnici/sifrarnici/vrste-vjerodostojne-isprave
  • https://e-ovrhe-test.pravosudje.hr/api/veliki-korisnici/sifrarnici/valute
  • https://e-ovrhe-test.pravosudje.hr/api/veliki-korisnici/sifrarnici/sredstva-ovrhe
  • https://e-ovrhe-test.pravosudje.hr/api/veliki-korisnici/sifrarnici/pravne-osnove-za-zastupanje
  • https://e-ovrhe-test.pravosudje.hr/api/veliki-korisnici/sifrarnici/naselja
  • https://e-ovrhe-test.pravosudje.hr/api/veliki-korisnici/sifrarnici/drzave
  • Za adrese je bitno da naselja iz Hrvatske moraju biti šifrirana. Naselja iz drugih država unose se slobodnim unosom naziva naselja.

    Šifrirane stavke koje su specifične za sustav e-Ovrhe moguće je unijeti samo navođenjem internih ID-eva sustava e-Ovrhe,dok je sljedeće entitete dodatno moguće unositi i na prirodnije načine:

  • naselja u HR, navođenjem naziva naselja (naziv u tom slučaju mora biti jedinstven u HR), naziva naselja i naziva općine (ova kombinacija nije jedinstvena za 4 naselja: dva Novigrada iz općine Novigrad i dvije Privlake iz općine Privlaka) ili naziva naselja, općine i županije (ova trojka je jedinstvena za sva naselja ih Republike Hrvatske)
  • države, navođenjem dvoslovnih ili troslovnih oznaka
  • valute, navođenjem troslovne oznake
  • Nekoliko poslovnih i tehničkih pravila:

  • prijedlog mora sadržavati barem jednog ovrhovoditelja
  • prijedlog mora sadržavati barem jednog ovršenika
  • ako prijedlog sadrži više od jednog ovršenika, potrebno je poslati i vrijednost u fieldu vrstaOdgovornostiOvrsenika
  • prijedlog mora sadržavati barem jednu vjerodostojnu ispravu
  • vjerodostojna isprava mora sadržavati barem jednu tražbinu
  • ako su sve tražbine u kunama, fieldovi ukupniInformativniIznosGlavniceUKunama i ukupniInformativniIznosDugaUKunama mogu biti prazni - sustav će ih u tom slučaju sam izračunati
  • ako postoje tražbine koje nisu u kunama, za prijedlog je potrebno navesti i vrijednosti za fieldove ukupniInformativniIznosGlavniceUKunama i ukupniInformativniIznosDugaUKunama , s time da u njih idu iznosi izračunati u kunama - detalje o korištenim tečajevima za izračune kod pojedine tražbine koja nije u kunama mogu se navesti u fieldu Trazbina.obracunTecaja
  • ako se kamata traži, field datumPocetkaTijekaKamate mora sadržavati vrijednost
  • ako se kamata traži, vrijednosti u fieldovima prethodnoObracunataKamataDatum i prethodnoObracunataKamata dolaze "u paru": ili su obje prazne, ili su obje navedene
  • ako je datum u fieldu prethodnoObracunataKamataDatum unesen, on mora biti strogo manji od datuma iz fielda datumPocetkaTijekaKamate
  • ako kod tražbina za obračun kamata odaberete opciju ZAKONSKA_ZATEZNA_KAMATA, potrebno je postaviti i field vrstaZakonskeZatezneKamate, a fieldovi ugovornaKamatnaStopa, kamataPoRanijemZakonuOpis i kamataPoRanijemZakonuDatoteka trebaju biti prazni
  • ako u fieldu vrstaZakonskeZatezneKamate odabere stavke s ID-evima 5 i 6, onda je potrebno poslati i podatke u fieldu kamataPoRanijemZakonuOpis
  • ako kod tražbina za obračun kamata odaberete opciju UGOVORNA_ZATEZNA_KAMATA, potrebno je postaviti i field ugovornaKamatnaStopa, a fieldovi vrstaZakonskeZatezneKamate, kamataPoRanijemZakonuOpis i kamataPoRanijemZakonuDatoteka trebaju biti prazni
  • na mjestima na kojima se referencira objekt iz neke liste po rednom broju, prvi element iz liste ima redni broj 1

  • Primjer JSON - POST request:

    	
    	{
    		"ovrhovoditelji": [
    			{
    				"tip": "PRAVNA_OSOBA",
    				"oib": "65670034238",
    				"naziv": "Ovrhovoditeljstvo d.o.o.",
    				"adresa": {
    					"ulicaIKbr": "Slavonska avenija 1",
    					"postanskiBroj": "10000",
    					"naselje": {
    						"id": 72150
    					},
    					"drzava": {
    						"id": 55
    					}
    				}
    			}
    		],
    		"ovrsenici": [
    			{
    				"tip": "FIZICKA_OSOBA",
    				"oib": "65670034238",
    				"ime": "Pero",
    				"prezime": "Perić",
    				"adresa": {
    					"ulicaIKbr": "Marina Držića 5",
    					"postanskiBroj": "10000",
    					"naselje": {
    						"id": 72150
    					},
    					"drzava": {
    						"id": 55
    					}
    				},
    				"sredstvaOvrhe": [{
    						"id": 2
    					}
    				]
    			}
    		],
    		"vjerodostojneIsprave": [
    			{
    				"vrsta": {
    					"id": 2
    				},
    				"oznaka": "PK-1/2021",
    				"datum": "2021-06-11",
    				"opisTrazbina": "Dugovanja po otvorenim stavkama",
    				"datoteka": {
    					"nazivDatoteke": "izvadak.poslovne.knjige.pdf",
    					"sadrzajTip": "PDF",
    					"brojStranica": 8
    				},
    				"trazbine": [
    					{
    						"ovrhovoditeljRbr": 1,
    						"valuta": {
    							"id": 1
    						},
    						"glavnica": 300.00,
    						"obracunKamatneStope": "ZAKONSKA_ZATEZNA_KAMATA",
    						"vrstaZakonskeZatezneKamate": {
    							"id": 2
    						},
    						"datumPocetkaTijekaKamate": "2021-06-12",
    						"kamata": 8,
    						"podaciZaIsplatu": {
    							"uDomacuBanku": true,
    							"brojRacuna": "HR8923600001122334455",
    							"model": "HR24",
    							"pnb": "5770-0010189"
    						}
    					}
    				]
    			}
    		],
    		"troskoviPostupkaPovrat": true,
    		"troskoviPostupkaKamataPovrat": true,
    		"troskoviPostupkaOdvjetnikIOstalo": [{
    				"opis": "Sastavljanje prijedloga",
    				"jedinicnaCijena": 75,
    				"kolicina": 1,
    				"iznos": 75,
    				"pdvStopa": 0.25,
    				"iznosSPdvom": 93.75
    			}
    		],
    		"troskoviPostupkaJavniBiljeznik": [
    		{
    		  "opis": "Predujam naknade javnog bilježnika",
    		  "jedinicnaCijena": 25,
    		  "kolicina": 1,
    		  "iznos": 25,
    		  "pdvStopa": 0.25,
    		  "iznosSPdvom": 31.25
    		},
    		{
    		  "opis": "Ostatak naknade",
    		  "jedinicnaCijena": 75,
    		  "kolicina": 1,
    		  "iznos": 75,
    		  "pdvStopa": 0.25,
    		  "iznosSPdvom": 93.75
    		},
    		{
    		  "opis": "Trošak daljnjih dostava",
    		  "jedinicnaCijena": 25,
    		  "kolicina": 0,
    		  "iznos": 0,
    		  "pdvStopa": 0.25,
    		  "iznosSPdvom": 0
    		}
    	  ],
    		"troskoviPostupkaPrimateljUloga": "OVRHOVODITELJ",
    		"troskoviPostupkaPrimateljRbr": 1,
    		"troskoviPostupkaPodaciZaIsplatu": {
    			"uDomacuBanku": true,
    			"brojRacuna": "HR8923600001122334455",
    			"model": "HR24",
    			"pnb": "5770-0010189"
    		}
    	}