Pošta Slovenije d.o.o.

Slomškov trg 10

2500 MARIBOR

e–pošta: info@posta.si

www.posta.si

Uvoz spremnic Navodila za pripravo CSV-datoteke po strukturi podatkovnega modela spremnic

Maribor, september 2018

2

KAZALO

Opis dokumenta........................................................................................................................................................ 3

Podatkovni model – Spremnica .......................................................................................................................... 4

Šifranti ........................................................................................................................................................................... 6

Vrste pošiljk ............................................................................................................................................................ 6

Dodatne storitve ................................................................................................................................................... 8

Id držav .................................................................................................................................................................. 12

CSV-oblika ................................................................................................................................................................. 18

Kazalo tabel............................................................................................................................................................... 19

3

OPIS DOKUMENTA

Dokument opisuje strukturo podatkovnega modela spremnic, ki se uporablja za uvoz

podatkov v sklopu informacijskih rešitev oz. aplikacij »eSpremnica«, »eWebOddaja« ter

»Spletnega servisa CSV«

Datum Avtor Opomba

1. 10. 2014 Andrej Majcen Priprava dokumentacije

Tabela 1 – Spremembe dokumenta

4

PODATKOVNI MODEL – SPREMNICA Struktura podatkovnega modela »Spremnica« je namenjena uvozu podatkov za avtomatsko

kreiranje dokumentov za opremljanje pošiljk.

Tabela 2 – Podatkovni model

Naziv polja Opis polja Obvezno

VrstaPosiljke Vrsta pošiljke (šifrant vrste pošiljk – tabela 3) O

CrtnaKoda Črtna koda pošiljke N *

Naziv Naziv naslovnika O

DodatenNaziv Dodaten naziv naslovnika N

Naslov Naslov naslovnika P/O

PostnaSt Pošta naslovnika O

NazivPoste Naziv pošte O

Drzava

Id države (šifrant držav – tabela 5 oziroma Seznam

aktivnih držav na

http://espremnica.posta.si/?id=SpremnicaNavodila)

O

TelSt Telefonska številka P/O **

EMail Elektronski naslov N

IdNaslovnika Opomba naslovnika – ID naslovnika N

Opomba Opomba za spremnico N

Masa Masa pošiljke (vrednost v g) N

DodatneStoritve Seznam dodatnih storitev (šifrant dodatnih storitev –

tabela 4) P/O

Odkupnina Znesek odkupnine P/O ***

Vrednost Znesek vrednosti pošiljke P/O ***

VrstaVplDok Vrsta vplačilnega dokumenta P/O ****

RefX Dopolnilno polje N

Model Model P/O

Sklic Sklic P/O

Namen Namen plačila P/O

OdkupninaVValuti Znesek odkupnine v tuji valuti P/O

Valuta Oznaka tuje valute P/O

Navodilo Navodilo za vročanje P/O *****

O Obvezen podatek

P/O Pogojno obvezen podatek, pri pripravi CSV-datoteke lahko to polje

vsebuje podatek ali prazno mesto

5

N Podatek ni obvezen

* Če ima pogodbenik že določen nabor črtnih kod (sprejemnih številk). V primeru

vpisanih podatkov se izvede kontrola. ** Če je naslovnik iz tujine, potem je podatek zaželen. *** Če ima pošiljka opredeljene dodatne storitve, potem je treba pravilno vpisati

odkupnino in vrednost v EUR. **** Če ima pošiljka vplačilni dokument. Možnost izpisa UPN- ali HUB-obrazca (za

naslovnike na Hrvaškem). Za izpis UPN z OCR se vnese številka 2 (maks. znesek

odkupnine za izpis UPN z OCR znaša 1.000 EUR, za zneske nad 1.000 EUR je možen

samo izpis UPN brez OCR), za izpis UPN brez OCR se vnese številka 3, za izpis HUB-

obrazca se vnese številka 4, za izpis UPN s QR kodo se vnese številka 5, za izpis UPN

brez QR kode se vnese številka 6. Velja za uvoz podatkov v sklopu aplikacije

»eSpremnica«. ***** V primeru mednarodnega paketa za naslovnike v državah EU. V sklopu navodil za

vročanje se vnese številka 1 (pošiljka se vrne pošiljatelju) ali številka 4 (pošiljatelj se

pošiljki odpoveduje). Velja za uvoz podatkov v sklopu aplikacije »eSpremnica«.

Pri kreiranju CSV-datotek za uvoz podatkov, v podatkih o naslovniku (ime, priimek naslovnika,

naziv podjetja, naslov naslovnika itd.) ter v opombah ni dovoljeno uporabljati znakov, kot so:

[ _ , : , ~ , " , $ , % ,* , ; , < , > , # , ´]. Uvoz CSV-datoteke, ki vsebuje navedene nedovoljene

znake, je onemogočen.

6

ŠIFRANTI Seznam vseh aktivnih šifrantov, ki se uporabljajo za pravilno pripravo CSV-datoteke. Vsebine

iz določenih šifrantov se uporabljajo glede na pogodbene obveznosti pogodbenika.

Vrste pošiljk

Šifrant se uporablja za pravilno označevanje vrste pošiljke. Dovoljene vrste pošiljk so

določene v pogodbi in so osnova za izdajo računov.

Id Naziv NAJVEČJA teža

(g)

101 Poslovni paket – notranji 50.000

102 Poslovni paket večjih dimenzij – notranji 100.000

103 Mednarodni poslovni paket * 30.000 (za

Hrvaško in Srbijo

50.000)

104 PPIN – notranji****

50.000 (največja

teža serije

500.000)

105 PPIN Hrvaška – mednarodni****

50.000 (največja

teža serije

500.000)

106 Paket dobavitelj ** 50.000

107 Paket – mednarodni * 30.000

108 PG pošiljka na kos ** 1.000.000

109 Mali poslovni paket do 500 g ** 500

201 Paleta – notranji 600.000

202 Mednarodna paleta Hrvaška – Zagreb *** 600.000

203 Tovor 600.000

204 Mednarodna paleta Hrvaška – ostalo *** 600.000

205 Mednarodna paleta Hrvaška – otoki *** 600.000

301 Priporočeno pismo – notranji 2.000

302 Priporočeno pismo – mednarodni 2.000

303 Vrednostno pismo – notranji 2.000

304 Vrednostno pismo – mednarodni 2.000

305 Standardno pismo – notranji 20

7

306 Standardno pismo – mednarodni 20

307 Navadno pismo – notranji 2.000

308 Navadno pismo – mednarodni 2.000

309 Tiskovina 2.000

310 ZUP 2.000

311 Tiskovina – mednarodni 2.000

312 ZKP – posredno 2.000

313 ZPP – osebno 2.000

314 ZPP – posredno 2.000

315 ZKP – osebno 2.000

316 ZSReg / ZFPPIPP 2.000

317 Poslovno vrednostno pismo 2.000

317 Poslovno vrednostno pismo - notranji 2.000

318 Priporočeno pismo za dostavo v hišni predalčnik 2.000

319 Dopisnica - notranji 20

320 Dopisnica - mednarodni 20

401 Hitra pošta po Sloveniji 50.000

402 Hitra pošta znotraj mest 105.000

403 Hitra pošta EMS paket 30.000 (za

Hrvaško 50.000 )

404 Hitra pošta EMS pismo 2.000

405 Hitra pošta znotraj mest – isti naslovnik ****

50.000 (največja

teža serije

500.000) Tabela 2 – Vrste pošiljk

* Možnost samo za naslovnike v državah EU.

** Možnost samo v primeru, da je vrsta pošiljk posebej določena v pogodbi.

*** Možnost uvoza podatkov samo v aplikacijo eWebOddaja ter preko Spletnega servisa CSV

(se ne uporablja za uvoz podatkov v aplikacijo eSpremnica).

**** V sklopu uporabe vrste pošiljke PPIN je v CSV-datoteki treba podatke za istega naslovnika

zapisati skupaj.

8

Dodatne storitve

Šifrant se uporablja za pravilno označevanje dodatnih storitev. Za določitev dodatnih storitev

posameznim pošiljkam se uporabijo kratki nazivi storitev, ki so navedeni v tabeli 4 – Dodatne

storitve. Kratki nazivi storitev se zapišejo z velikimi tiskanimi črkami in so med seboj ločeni z

vejico brez presledka. Dodatne storitve, ki se lahko uporabijo za določene vrste pošiljk, so

zapisane v Navodilih za delo z aplikacijo eSpremnica (točka 5.2 Sprejem po posameznih vrstah

pošiljk).

Posebnosti, ki se nanašajo na poslovne pakete isti naslovnik

Oddaja CSV-datoteke v aplikaciji eSpremnica:

Pri poslovnem paketu isti naslovnik (PPIN), Hitri pošti znotraj mest – isti naslovnik ter pri

mednarodnem poslovnem paketu isti naslovnik – Hrvaška (MPPIN Hrvaška) se skupne

storitve zapišejo za vsak paket v isti seriji, posamične storitve pa poljubno za posamične

pakete v isti seriji (npr. označena vrednost – V, pazljivejše ravnanje – PR itd.). Znesek

odkupnine za PPIN, Hitro pošto znotraj mest – isti naslovnik ter MPPIN Hrvaška se zapiše

samo pri zadnjem paketu iste serije. V CSV-datoteki je treba »zadnji« paket v isti seriji vedno

zapisati v zadnjo postavko iste serije PPIN, Hitre pošte znotraj mest – isti naslovnik oz. MPPIN.

Slika 1: Primer CSV-datoteke za PPIN za oddajo v eSpremnici

Oddaja CSV-datoteke v aplikaciji eWebOddaja ali prek Spletnega servisa CSV:

Pri poslovnem paketu isti naslovnik (PPIN), Hitri pošti znotraj mest – isti naslovnik ter pri

mednarodnem poslovnem paketu isti naslovnik – Hrvaška (MPPIN Hrvaška) se skupne

storitve zapišejo samo za zadnji paket v isti seriji, posamične storitve pa poljubno za

posamične pakete v isti seriji (npr. označena vrednost – V, pazljivejše ravnanje – PR itd.).

Znesek odkupnine za PPIN, Hitro pošto znotraj mest – isti naslovnik ter MPPIN Hrvaška se

zapiše samo pri zadnjem paketu iste serije. V CSV-datoteki je treba »zadnji« paket v isti seriji

vedno zapisati v zadnjo postavko iste serije PPIN, Hitre pošte znotraj mest – isti naslovnik oz.

MPPIN.

Slika 2: Primer CSV-datoteke za PPIN za oddajo v eWebOddaji ali prek Spletnega servisa CSV

9

Kratek naziv Naziv storitve Opis

VPLPG Vplačnina po pogodbi ***

Storitev, pri kateri poravna vplačnino za pošiljke s

storitvijo Odkupnina pošiljatelj. V tem primeru se s

pošiljateljem sklene posebna pogodba.

DOB Dobavnica Storitev, pri kateri se pošiljatelju vrne od naslovnika

potrjena dobavnica.

DO10.URE Dostava do 10. ure ** Storitev, pri kateri lahko pošiljatelj izbere okvirni čas

dostave v okviru ponudbe izvajalca.

PO16.URI Dostava po 16. uri ** Storitev, pri kateri lahko pošiljatelj izbere okvirni čas

dostave v okviru ponudbe izvajalca.

PNP Prevzem na pošti ** Storitev, pri kateri lahko pošiljatelj izbere za

naslovnika možnost prevzema pošiljke na pošti.

PR Pazljivejše ravnanje Storitev, pri kateri se s pošiljko ravna še posebej

pazljivo.

ODK Odkupnina ***** Storitev, pri kateri se vroči pošiljko naslovniku proti

predhodnemu plačilu zneska odkupnine.

PPN Poštnino plača naslovnik Storitev, pri kateri poštnino plača naslovnik.

V Označena vrednost Storitev, pri kateri pošiljatelj označi vrednost pošiljke.

KLIC2 Klic 2 *

Storitev, pri kateri se pošiljka najprej poskuša vročiti z

redno dostavo. Če pošiljke ni bilo mogoče vročili ob

redni dostavi in je naslovnik ni dvignil v dveh dneh,

se pokliče naslovnik in se dogovori brezplačna druga

dostava ali prevzema pošiljke na pošti.

AR Povratnica

Storitev, pri kateri naslovnik vročitev potrdi na

posebnem obrazcu, ki se imenuje Povratnica – Advice

of receipt. Povratnica se pošiljatelju pošiljke pošlje

kot navadno pismo.

OS Osebna vročitev Storitev, pri kateri se pošiljka vroči osebno

naslovniku.

A Prednostno Storitev, pri kateri ima pošiljka prednost pri prenosu

(v mednarodnem prometu).

POD Podpis dokumentov

Storitev, pri kateri se pošiljatelju vrne od naslovnika

potrjen dokument, kot je npr. pogodba, aneks,

naročilnica ipd.

1URALJ Dostava v 1 uri znotraj

Ljubljane

Storitev, pri kateri lahko pošiljatelj izbere okvirni čas

dostave v okviru ponudbe izvajalca (samo Hitra pošta

znotraj mest).

D.18-20.U Dostava med 18. in 20.

uro **

Storitev, pri kateri lahko pošiljatelj izbere okvirni čas

dostave v okviru ponudbe izvajalca (za naslovnike v

Ljubljani).

eMAIL Obveščanje e-mail **** Storitev, pri kateri se naslovnik po e-pošti obvesti o

prispetju pošiljke.

8DNI Vračanje po 8 dneh

Storitev, pri kateri lahko pošiljatelj izbere, da se mu

pošiljka v primeru nevročitve naslovniku vrne po

osmih dneh.

OSB Odvoz starega blaga Storitev, pri kateri lahko pošiljatelj izbere, da ob

10

****** dostavi pošiljke odpeljemo staro blago. V tem

primeru s pošiljateljem sklenemo posebno pogodbo.

ORB Odvoz reklamiranega

blaga ******

Storitev, pri kateri lahko pošiljatelj izbere, da ob

dostavi pošiljke odpeljemo reklamirano blago. V tem

primeru s pošiljateljem sklenemo posebno pogodbo.

DVS Dostava z vnosom v

stanovanje ******

Storitev, pri kateri lahko pošiljatelj izbere možnost, da

pošiljko prinesemo v stanovanje. V tem primeru s

pošiljateljem sklenemo posebno pogodbo.

ZAV Zavarovanje vsebine

Storitev, pri kateri lahko pošiljatelj, ki v priporočenem

pismu za mednarodni promet pošilja blago in

dokumente, zavaruje vsebino v vrednosti do 100,00

EUR.

OSBDVS

Odvoz starega blaga in

dostava v stanovanje

******

Storitev, pri kateri lahko pošiljatelj izbere možnost, da

odpeljemo staro blago in pošiljko prinesemo v

stanovanje. V tem primeru s pošiljateljem sklenemo

posebno pogodbo.

ORBDVS

Odvoz reklamiranega

blaga in dostava v

stanovanje ******

Storitev, pri kateri lahko pošiljatelj izbere možnost, da

odpeljemo reklamirano blago in pošiljko prinesemo v

stanovanje. V tem primeru s pošiljateljem sklenemo

posebno pogodbo.

ODKBN Odkupnina brez naloga

*****

Storitev, pri kateri se naslovniku vroči pošiljka proti

predhodnemu plačilu zneska odkupnine. Pošiljatelj

prejme nakazilo zneska odkupnine na TRR, ne da bi

pošiljki priložil vplačilni dokument. V tem primeru s

pošiljateljem sklenemo posebno pogodbo.

Tabela 3 – Dodatne storitve

* Dodatne storitve se med seboj izključujejo.

** Dodatne storitve se med seboj izključujejo.

*** Dodatne storitve se med seboj izključujejo.

**** Dodatna storitev se izvaja samo za mednarodni poslovni paket Hrvaška in mednarodni

poslovni paket - isti naslovnik Hrvaška.

***** Dodatne storitve se med seboj izključujejo.

****** Dodatne storitve se med seboj izključujejo.

V primeru uporabe storitve Odkupnina brez naloga (ODKBN) se kratki naziv storitve ODKBN v

CSV-datoteko vnese v stolpec Dodatne storitve, v stolpec Odkupnina pa znesek odkupnine. V

stolpec Sklic se lahko vnese poljuben sklic za zapiranje računov ob nakazilu zneskov odkupnin

(vnos sklica ni obvezen). Pregled nakazanih zneskov odkupnin je možen na Poslovnem

portalu na http://espremnica.posta.si/?id=prijava. Za pridobitev dostopa do Poslovnega

11

portala ter sklenitev pogodbe za uporabo storitve Odkupnina brez naloga se lahko obrnete

na vašega skrbnika pogodbe.

12

Id držav

Šifrant se uporablja za pravilno označevanje Id držav.

IdDrzave Drzava

004 Afganistan

008 Albanija

010 Antarktika

012 Alžirija

016 Ameriška Samoa

020 Andora

024 Angola

028 Antigua in Barbuda

031 Azerbjadžan

032 Argentina

036 Avstralija

040 Avstrija

044 Bahami

048 Bahrain

050 Bangladeš

051 Armenija

052 Barbados

056 Belgija

060 Bermudi

064 Butan

068 Bolivija

070 Bosna in Hercegovina

072 Bocvana

074 Bouvetov otok

076 Brazilija

084 Belize

086 Britansko ozemlje Indijskega Oceana

090 Salomonovi otoki

092 Deviški otoki (britanski)

096 Brunei

100 Bolgarija

104 Mjanmar

108 Burundi

112 Belorusija

116 Kambodža

120 Kamerun

124 Kanada

132 Kapverdski otoki

136 Kajmanski otoki

140 Centralnoafriška republika

13

144 Šrilanka

148 Čad

152 Čile

156 Kitajska

158 Tajvan

162 Božični otok

166 Kokosovi (Keeling) otoki

170 Kolumbija

174 Komori

175 Mayotte

178 Kongo

180 Demokratična republika Kongo

184 Kukovi otoki

188 Kostarika

191 Hrvaška

192 Kuba

196 Ciper

203 Češka

204 Benin

208 Danska

212 Dominika

214 Dominikanska republika

218 Ekvador

222 Salvador

226 Ekvatorialna Gvineja

230 Etiopija

232 Eritreja

233 Estonija

234 Ferski otoki

238 Falklandski otoki (Malvini)

239 Južna Georgia in ot. Južni Sandwich

242 Fidži

246 Finska

248 Alandski otoki

250 Francija

254 Francoska Gvajana

258 Francoska Polinezija

260 Francosko južna ozemlja

262 Džibuti

266 Gabon

268 Gruzija

270 Gambija

275 Palestinsko ozemlje, zasedeno

276 Nemčija

288 Gana

14

292 Gibraltar

296 Kiribati

300 Grčija

304 Grenlandija

308 Grenada

312 Guadeloupe

316 Guam

320 Gvatemala

324 Gvineja

328 Gvajana

332 Haiti

334 Heardov otok in McDonaldovi otoki

336 Vatikan

340 Honduras

344 Hong Kong

348 Madžarska

352 Islandija

356 Indija

360 Indonezija

364 Iran

368 Irak

372 Irska

376 Izrael

380 Italija

384 Slonokoščena obala

388 Jamajka

392 Japonska

398 Kazahstan

400 Jordanija

404 Kenija

408 Demokratična ljudska rep. Koreja

410 Koreja

414 Kuvajt

417 Kirgizistan

418 Laos

422 Libanon

426 Lesoto

428 Latvija

430 Liberija

434 Libija

438 Liechtenstein

440 Litva

442 Luksemburg

446 Makao

450 Madagaskar

15

454 Malavi

458 Malezija

462 Maldivi

466 Mali

470 Malta

474 Martinik

478 Mavretanija

480 Mauritius

484 Mehika

492 Monako

496 Mongolija

498 Moldavija

499 Črna gora

500 Montserrat

504 Maroko

508 Mozambik

512 Oman

516 Namibija

520 Nauru

524 Nepal

528 Nizozemska

530 Nizozemski Antili

533 Aruba

540 Nova Kaledonija

548 Vanuatu

554 Nova Zelandija

558 Nikaragva

562 Niger

566 Nigerija

570 Niue

574 Norfolški otok

578 Norveška

580 Severni Marianski otoki

581 Stranski zunanji otoki ZDA

583 Mikronezija

584 Maršalovi otoki

585 Palaos

586 Pakistan

591 Panama

598 Papua Nova Gvineja

600 Paragvaj

604 Peru

608 Filipini

612 Pictarin

616 Poljska

16

620 Portugalska

624 Gvineja Bissau

626 Vzhodni Timor

630 Portoriko

634 Katar

638 Reunion

642 Romunija

643 Rusija

646 Ruanda

654 Sv. Helena, Ascension in Tristan da

659 Sveta Kitts in Nevis

660 Anguilla

662 Sveta Lucija

666 Sveti Peter in Miquelon

670 Sveta Vincent in Grenadine

674 San Marino

678 Sao Tome in Principe

682 Saudova Arabija

686 Senegal

688 Srbija

690 Sejšeli

694 Sierra Leone

702 Singapur

703 Slovaška

704 Vietnam

705 Slovenija

706 Somalija

710 Južna Afrika

716 Zimbabve

724 Španija

728 Južni Sudan

729 Sudan

732 Zahodna Sahara

740 Surinam

744 Svalbard in Jan Mayen

748 Svazi

752 Švedska

756 Švica

760 Sirija

762 Tadžikistan

764 Tajska

768 Togo

772 Tokelau

776 Tonga

780 Trinidad in Tobago

17

784 Združeni arabski emirati

788 Tunizija

792 Turčija

795 Turkmenistan

796 Turks in Caicos

798 Tuvalu

800 Uganda

804 Ukrajina

807 Makedonija

818 Egipt

826 Velika Britanija (Združeno kraljest

831 Guernsey

832 Jersey

833 Otok Man

834 Tanzanija

840 ZDA

850 Deviški otoki (ZDA)

854 Burkina Faso

858 Urugvaj

860 Uzbekistan

862 Venezuela

876 Otočje Wallis in Futuna

882 Samoa

887 Jemen

894 Zambija

901 Kosovo Tabela 5 – Id držav

18

CSV-OBLIKA Kodiranje: 1250 - ANSI Central European

Primeri vsebine CSV-datoteke z osnovnimi in dodatnimi podatki naslovnika, dodatnimi

storitvami ter plačilnim dokumentom UPN oz. HUB. CSV-datoteka, ki je predmet Spletnega

servisa CSV, je brez vodilne vrstice.

VrstaPosiljke;CrtnaKoda;Naziv;DodatniNaziv;Naslov;PostnaSt;NazivPoste;Drzava;TelSt;EMail;IdNaslovnik

a;Opomba;Masa;DodatneStoritve;Odkupnina;Vrednost;VrstaVplDok;Ref.X;Model;Sklic;Namen;Odkupnin

aVValuti;Valuta;Navodilo

101;;Naslovnik1;Dodatni1;Ulica 1;2222;Miklavž;705;136365;;;;;;;;;;;;;;;

101;;Naslovnik2;Dodatni2;Ulica 2;2204;Miklavž;705;;;;;;PR,ODK, DOB;15;;;;;;;;;

101;;Naslovnik3;Dodatni3;Ulica 3;2204;Miklavž;705;;;;;;V;;200;;;;;;;;

101;;Naslovnik4;Dodatni4;Naslov4;2327;Rače;705;41235689;;;opomba4;50000;VPLPG,DOB,DO10.URE,PR

,ODK,V,;500;500;2;;SI12;1457894561236;plačilo;;;

103;;Naziv;Dodatni;Zagrebška12;10000;Zagreb;191;123456789;email@email.com;;opomba;50000;V,eM

AIL,ODK,DOB,PR;300;400;4;;HR11;123654;plačilo;2315;HRK;1

104;;Naslovnik5;Dodatni5;Ulica5;2000;Maribor;705;123456789;;;opomba5;50000;PR,DOB,ODK,,POD,V;;1

51,36;;;;;;;;

104;;Naslovnik5;Dodatni5;Ulica5;2000;Maribor;705;123456789;;;opomba5;2050;PR,DOB,ODK,,POD;;;;;;;;;;

104;;Naslovnik5;Dodatni5;Ulica5;2000;Maribor;705;123456789;;;opomba5;8500;PR,DOB,ODK,,POD,V;500

,12;300;2;;SI12; 1457894561236;plačilo;;;

19

KAZALO TABEL

Tabela 1 – Spremembe dokumenta .................................................................................................................. 3

Tabela 2 – Podatkovni model .................................................................. Error! Bookmark not defined.

Tabela 3 – Vrste pošiljk ........................................................................................................................................... 7

Tabela 4 – Dodatne storitve................................................................................................................................ 10

Tabela 5 - Id držav..…………………………………………………………………………………………………………………16