uvoz spremnic - opremljanje paketnih in pisemskih...
TRANSCRIPT
Pošta Slovenije d.o.o.
Slomškov trg 10
2500 MARIBOR
e–pošta: [email protected]
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 - 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 protected];;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