1

FINANČNA UPRAVA REPUBLIKE SLOVENIJE

GENERALNI FINANČNI URAD

eIzvršbe - obvestilo o plačilu

Ljubljana, 12.9.2014

2

NADZOR DOKUMENTA

Naziv projekta :

Vsebina : eIzvršbe - obvestilo o plačilu

Kratek naziv projekta: eIzvršbe

Oznaka dokumenta : P:\CURS\eIzvršbe\03. Analiza\08. Zunanji\08. Predlagatelji\04. Info

o plačilu\CURS_eIzvršbe_obvestilo_o_placilu_v3 0.docx

Kreiranje : 10.4.2012

Zadnja sprememba : 12.9.2014

Status dokumenta : Končni

Verzija dokumenta : 3.00

Lastnik dokumenta :

Avtor dokumenta : Katja Sirk, Aleksandar Lazarević, Goran Gajić

Priloge : Ni prilog

Spremembe :

Verzija Datum Opis

1.00 10.04.2012 Prva verzija specifikacij obvestil o plačilu.

2.00 13.04.2012 Dopolnitev priročnika

3.00 12.09.2014 Osvežitev priročnika

3

KAZALO

1. UVOD ...................................................................................................................................................... 4

2. PREVZEM OBVESTIL O PLAČILU .................................................................................................. 4

2.1. PREVZEM OBVESTIL O PLAČILU PO PREDLAGATELJIH ...................................................... 4

2.1.1. CSV FORMAT ........................................................................................................................................ 7

2.1.2. XML FORMAT ...................................................................................................................................... 8

2.2. PREVZEM OBVESTIL O PLAČILU PO UPNIKIH ....................................................................... 11

2.2.1. CSV FORMAT ...................................................................................................................................... 13

4

1. UVOD

Namen dokumenta je podati opis datotek z obvestili o plačilu predlagateljem iz sistema

eIzvršbe.

2. Prevzem obvestil o plačilu

Sistem eIzvršbe omogoča predlagateljem prevzem datotek z informacijami o prejetih plačilih

za posamezno izvršbo, na katerih je le-ta zapisan kot predlagatelj.

Predlagatelj do obvestil o plačilu dostopa preko maske »Obvestilo o plačilu po

predlagateljih« ali preko maske »Obvestilo o plačilu po upnikih«.

2.1. Prevzem obvestil o plačilu po predlagateljih

Maska omogoča informacijo o prejetih plačilih za posamezno izvršbo, na katerih je zapisan

prijavljenih predlagatelj kot predlagatelj izvršbe. Maska je narejena tako, da na podlagi

kriterijev iskanja (datum nakazila od in do) pokaže rezultate, ki ustrezajo izbranim kriterijem.

Kriteriji so lahko prazni, lahko jih tudi kombiniramo (npr.: vnesemo samo začetni datum, ali

samo končni datum).

Maska je sestavljena iz 3 delov:

Prvi del je del za vnos iskalnih parametrov:

Polja za iskanje

5

Datum nakazila od Datum nakazila od ali začetni datum. Datum za nakazilo je datum, ko

predlagatelj dobi nakazana sredstva.

Datum nakazila do Datum nakazila do ali končni datum. Datum za nakazilo je datum, ko

predlagatelj dobi nakazana sredstva.

Šifra predlagatelja Predlagatelj, za katerega se izvede iskanje (zaklenjeno polje in se

avtomatično polni).

Gumbi

S pritiskom na gumb Išči se zažene iskanje.

Delu za iskanje sledi drugi del ali osrednji del maske, kjer so prikazana različna obvestila o plačilih.

V drugem delu so prikazani rezultati oz. datoteke po datumih nakazila, ki ustrezajo izbranim

kriterijem. Predlagatelj lahko vidi za posamezen dan datoteko s prejetimi nakazili oz. za več dni ali

neomejeno glede na datum nakazila. Predlagatelje vidi pri posamezni datoteki 3 stolpce TXT, PDF in

XML z enakimi zapisi, le v drugem formatu.

Primer prikaza nakazil v pdf formatu:

Stolpci v izpisu

Upnik Šifra upnika

Naziv upnika Naziv upnika

TRR upnika TRR upnika, na katera so bila nakazana sredstva

Ref. Dolžnika Referenca dolžnika, ki se izpiše tudi v prejetem nakazilu kot referenca

6

prejemnika

LRN LRN številka vložene izvršbe

Št. izv. naslova Številka izvršilnega naslova na vloženem predlogu za izvršbo

Referenca Referenca za glavnico in obresti iz vloženega predloga za izvršbo

Dat. dog. Datum dogodka oz. datum prejetega plačila na CURS

Znesek plačila Znesek plačila posamezne terjatve znotraj izvršilnega naslova

Delež Delež plačila (D-delno, C-v celoti).

DŠ dolžnika Davčna številka dolžnika (enega v primeru večih dolžnikov na izvršilnem

naslovu)

Naziv dolžnika Naziv dolžnika (enega v primeru večih dolžnikov na izvršilnem naslovu)

Nato sledi še tretji del, ki omogoča listanje po zapisih in vsebuje funkcijske gumbe.

Opis gumbov (ukazov):

Gumbi

Na seznamu se prikaže zadnjih 20 datotek nakazil, ki ustrezajo pogojem za iskanje. V

kolikor več kot 20 datotek nakazil ustreza iskalnim pogojem se lahko predlagatelj

pomakne na naslednjih 20 datotek nakazil s pritiskom na gumb Naprej. Pritisk na gumb

naprej ali nazaj prikaže naslednjih 20 datotek nakazil oz. 20 predhodnih datotek z

nakazili na seznamu.

V številsko polje se vnese poljubno številko in prikaže se 20 datotek z nakazili od

vključno te številke dalje. Npr.: predlagatelj ima 70 datotek z nakazili, v številsko polje

vnese številko 35 in pritisne gumb Išči. Tako se bo prikazalo 20 datotek z nakazili od

vključno 35 do vključno 55.

Informacija koliko datotek z nakazili je prikazanih na strani od 20, ki jih gre na stran in

koliko je skupno število datotek z nakazili, ki ustrezajo izbranim kriterijem.

Sistem omogoča prevzem datoteke v naslednjih formatih:

csv format,

xml format,

pdf format.

V nadaljevanju so podani opisi datotek v csv in xml formatu.

7

2.1.1. CSV format

Datoteka v CSV formatu je navadna tekstovna datoteka sestavljena iz zapisov o posameznem

plačilu, kjer so polja v zapisu ločena s podpičjem (»;«).

Datoteka je sestavljena iz dveh tipov zapisa:

zapis o predlagatelju – v tem so zapisani podatki o predlagatelju.

zapis o predlogu – v teh so zapisani podatki o predlogu za izvršbo in izvedenem

plačilu.

Vsaka datoteka ima na vrhu en zapis o predlagatelju, temu pa sledi en ali več zapisov o

predlogu.

Polja v posameznem tipu zapisa so naslednja:

Oznaka Tip Velikost (max)

Opis

Predlagatelj

Naziv predlagatelja string 100 Naziv predlagatelja

Naslov predlagatelja string 70 Naslov predlagatelja

Datum nakazila date 10 Datum izvedbe prenakazila s strani CURS

Šifra predlagatelja string 5 Šifra predlagatelja, dodeljena s strani CURS

Davčna številka string 8 Davčna številka predlagatelja

Matična številka string 10 Matična številka predlagatelja

Predlog

Šifra upnika string 5 Šifra upnika, dodeljena s strani CURS

Naziv upnika string 100 Naziv upnika

TRR upnika string 19 TRR, na katerega se nakažejo izterjana sredstva

Ref. dolžnika String 35 Referenca dolžnika, ki se izpiše tudi v prejetem nakazilu kot referenca prejemnika

LRN string 15 Predlagateljeva oznaka oz. referenca za določen predlog izvršbe

Številka izvršilnega naslova string 30 Številka izvršilnega naslova na predlogu za izvršbo

Referenca za glavnico ali obresti string 24 Referenca za glavnico ali obresti iz vloženega predloga za izvršbo

Šifra terjatve string 5 5 – mestna šifra, določena glede na vrsto terjatve in predlagatelja (glavnico in za obresti – svoja terjatev) dodeljeno s strani CURS

Datum dogodka date 10 Datum prejetega (izterjanega) plačila na račun CURS

Znesek plačila decimal 18 Znesek prejetega (izterjanega) plačila

Delež plačila String 1 Delež izterjanega plačila, ki ima lahko dve vrednosti:

C – v celoti

D – delno

8

Davčna številka dolžnika String 8 Davčna številka dolžnika

Naziv dolžnika String 100 Naziv dolžnika

Primer csv datoteke:

Datumska polja so zapisana v obliki DD.MM.LLLL.

Številke so zapisane v obliki 9999999999999999,99.

Datoteka je zapisana v kodni strani CP1250.

2.1.2. XML format

Datoteka v XML formatu je podana v naslednji strukturi:

Oznaka Tip Velikost (max)

Opis

<Obvestilo>

<Predlagatelj>

<DavcnaStevilka> string 8 Davčna številka predlagatelja

<Naziv> string 100 Naziv predlagatelja

<Naslov> string 70 Naslov predlagatelja

<DatumNakazila> date 10 Datum izvedbe prenakazila s strani CURS

<SifraPredlagatelja> string 5 Šifra predlagatelja, dodeljena s strani CURS

<MaticnaStevilka> string 10 Matična številka predlagatelja

<Predlogi>

<Predlog>

<LRN> string 15 Predlagateljeva oznaka oz. referenca za določen predlog izvršbe

<IzvrsilniNaslov>

<StevilkaIzvrsilnegaNaslova> string 30 Številka izvršilnega naslova na predlogu za izvršbo

<Terjatev>

<ReferencaDolznika> string 35 Referenca dolžnika, ki se izpiše tudi v prejetem nakazilu kot referenca prejemnika

<ReferencaZaPlacilo> string 24 Referenca za glavnico ali obresti iz vloženega predloga za izvršbo

9

<VrstaTerjatve> string 5 5 – mestna šifra, določena glede na vrsto terjatve in predlagatelja (glavnico in za obresti – svoja terjatev) dodeljeno s strani CURS

<DatumPoslovnegaDogodka> date 10 Datum prejetega (izterjanega) plačila na račun CURS

<ZnesekPlacila> decimal 18 Znesek prejetega (izterjanega) plačila

<VisinaPlacila> string 1 Delež izterjanega plačila, ki ima lahko dve vrednosti:

C – v celoti

D – delno

<Upnik>

<Sifra> string 5 Šifra upnika, dodeljena s strani CURS

<Naziv> string 100 Naziv upnika

<TRR> string 19 TRR, na katerega se nakažejo izterjana sredstva

<Dolznik>

<DavcnaStevilka> String 8 Davčna številka dolžnika

<Naziv> String 100 Naziv dolžnika

Znotraj obvestila je en blok za predlagatelje in en ali več blokov podatkov o predlogu za

izvršbo.

Datumska polja so zapisana v obliki LLLL-MM-DD.

Številke so zapisane v obliki 9999999999999999,99.

Datoteka je zapisana v UTF-8 formatu.

Primer xml datoteke:

10

11

2.2. Prevzem obvestil o plačilu po upnikih

Maska omogoča informacijo o prejetih plačilih za posamezno izvršbo, na katerih je zapisan

prijavljenih predlagatelj kot upnik na izvršbi. Maska je narejena tako, da na podlagi kriterijev

iskanja (datum nakazila od in do) pokaže rezultate, ki ustrezajo izbranim kriterijem. Kriteriji

so lahko prazni, lahko jih tudi kombiniramo (npr.: vnesemo samo začetni datum, ali samo

končni datum).

Maska je sestavljena iz 3 delov:

Prvi del je del za vnos iskalnih parametrov:

Polja za iskanje

Datum nakazila od Datum nakazila od ali začetni datum. Datum za nakazilo je datum, ko

predlagatelj dobi nakazana sredstva.

Datum nakazila do Datum nakazila do ali končni datum. Datum za nakazilo je datum, ko

predlagatelj dobi nakazana sredstva.

Šifra upnika Upnik, za katerega se izvede iskanje (zaklenjeno polje in se avtomatično

polni).

Gumbi

S pritiskom na gumb Išči se zažene iskanje.

Delu za iskanje sledi drugi del ali osrednji del maske, kjer so prikazana različna obvestila o plačilih.

V drugem delu so prikazani rezultati oz. datoteke po datumih nakazila, ki ustrezajo izbranim

kriterijem. Predlagatelj lahko vidi za posamezen dan datoteko s prejetimi nakazili oz. za več dni ali

neomejeno glede na datum nakazila. Predlagatelje vidi pri posamezni datoteki 2 stolpca CSV in PDF z

enakimi zapisi, le v drugem formatu.

12

Primer prikaza nakazil v pdf formatu:

Stolpci v izpisu

Predlagatelj Šifra predlagatelja

Naziv

predlagatelja

Naziv predlagatelja

TRR upnika TRR upnika, na katera so bila nakazana sredstva

Ref. prejemnika Referenca dolžnika, ki se izpiše tudi v prejetem nakazilu kot referenca

prejemnika

LRN LRN številka vložene izvršbe

Št. izv. naslova Številka izvršilnega naslova na vloženem predlogu za izvršbo

Referenca Referenca za glavnico in obresti iz vloženega predloga za izvršbo

Dat. dog. Datum dogodka oz. datum prejetega plačila na CURS

Znesek plačila Znesek plačila posamezne terjatve znotraj izvršilnega naslova

Delež Delež plačila (D-delno, C-v celoti).

DŠ dolžnika Davčna številka dolžnika (enega v primeru večih dolžnikov na izvršilnem

naslovu)

Naziv dolžnika Naziv dolžnika (enega v primeru večih dolžnikov na izvršilnem naslovu)

Nato sledi še tretji del, ki omogoča listanje po zapisih in vsebuje funkcijske gumbe.

Opis gumbov (ukazov):

13

Gumbi

Na seznamu se prikaže zadnjih 20 datotek nakazil, ki ustrezajo pogojem za iskanje. V

kolikor več kot 20 datotek nakazil ustreza iskalnim pogojem se lahko predlagatelj

pomakne na naslednjih 20 datotek nakazil s pritiskom na gumb Naprej. Pritisk na gumb

naprej ali nazaj prikaže naslednjih 20 datotek nakazil oz. 20 predhodnih datotek z

nakazili na seznamu.

V številsko polje se vnese poljubno številko in prikaže se 20 datotek z nakazili od

vključno te številke dalje. Npr.: predlagatelj ima 70 datotek z nakazili, v številsko polje

vnese številko 35 in pritisne gumb Išči. Tako se bo prikazalo 20 datotek z nakazili od

vključno 35 do vključno 55.

Informacija koliko datotek z nakazili je prikazanih na strani od 20, ki jih gre na stran in

koliko je skupno število datotek z nakazili, ki ustrezajo izbranim kriterijem.

Sistem omogoča prevzem datoteke v naslednjih formatih:

csv format,

pdf format.

V nadaljevanju je podan opis datotek v csv formatu.

2.2.1. CSV format

Datoteka v CSV formatu je navadna tekstovna datoteka sestavljena iz zapisov o posameznem

plačilu, kjer so polja v zapisu ločena s podpičjem (»;«).

Datoteka je sestavljena iz dveh tipov zapisa:

zapis o upniku – v tem so zapisani podatki o predlagatelju.

zapis o predlogu – v teh so zapisani podatki o predlogu za izvršbo in izvedenem

plačilu.

Vsaka datoteka ima na vrhu en zapis o upniku, temu pa sledi en ali več zapisov o predlogu.

Polja v posameznem tipu zapisa so naslednja:

Oznaka Tip Velikost (max)

Opis

Predlagatelj

Naziv upnika string 100 Naziv upnika

Naslov upnika string 70 Naslov upnika

Datum nakazila date 10 Datum izvedbe prenakazila s strani CURS

Šifra upnika string 5 Šifra upnika, dodeljena s strani CURS

Davčna številka string 8 Davčna številka upnika

Matična številka string 10 Matična številka upnika

Predlog

Šifra predlagatelja string 5 Šifra predlagatelja, dodeljena s strani CURS

Naziv predlagatelja string 100 Naziv predlagatelja

14

TRR upnika string 19 TRR, na katerega se nakažejo izterjana sredstva

Ref. dolžnika String 35 Referenca dolžnika, ki se izpiše tudi v prejetem nakazilu kot referenca prejemnika

LRN string 15 Predlagateljeva oznaka oz. referenca za določen predlog izvršbe

Številka izvršilnega naslova string 30 Številka izvršilnega naslova na predlogu za izvršbo

Referenca za glavnico ali obresti string 24 Referenca za glavnico ali obresti iz vloženega predloga za izvršbo

Šifra terjatve string 5 5 – mestna šifra, določena glede na vrsto terjatve in predlagatelja (glavnico in za obresti – svoja terjatev) dodeljeno s strani CURS

Datum dogodka date 10 Datum prejetega (izterjanega) plačila na račun CURS

Znesek plačila decimal 18 Znesek prejetega (izterjanega) plačila

Delež plačila String 1 Delež izterjanega plačila, ki ima lahko dve vrednosti:

C – v celoti

D – delno

Davčna številka dolžnika String 8 Davčna številka dolžnika

Naziv dolžnika String 100 Naziv dolžnika

Primer csv datoteke:

Datumska polja so zapisana v obliki DD.MM.LLLL.

Številke so zapisane v obliki 9999999999999999,99.

Datoteka je zapisana v kodni strani CP1250.