PC Adatcsere program – postafelügyeleti információk
Árinformációkat tartalmazó XML leírás v.1.11.Rev.1
TARTALOMJEGYZÉK 1 AZ XML STRUKTÚRÁJA .................................................................................... 3 2 SZOLGÁLTATÓ ADATAI .................................................................................... 5 2.1 SZOLGÁLTATÓ ADATAI ....................................................................................... 5 3 SZOLGÁLTATÓI ÁRINFORMÁCIÓK .................................................................. 5 3.1 TERMÉKEK ....................................................................................................... 5 3.2 ZÓNÁK ........................................................................................................... 13
2
1
Az XML struktúrája
Az XML állomány UTF-8 kódolású legyen. Az alábbi ábra szemlélteti az XML struktúrát. Az XML fában csak a konténer elemek vannak jelölve, a levelek helyén három pont áll, ahol akárhány levél elem szerepelhet. A kifejtéseket a táblázatok mutatják. <arinformacio> <szolgaltato> <…>
<…>
<szolg_arak> <szolg_ar> <…>
<…>
<meretkorlat> <…>
<…>
<…>
3
4
2
Szolgáltató adatai
2.1
Szolgáltató adatai
Szekció elem: <szolgaltato> Mező leírás
XML tag
XML típus
Kitöltése kötelező
Megjegyzés
azonosító
long
igen
a szolgáltató egyedi azonosítója. Minimum értéke 1
Név
string
igen
a szolgáltató cégjegyzék szerinti rövid neve. Minimális hossza 3, maximális hossza 250 karakter.
3
Szolgáltatói árinformációk
3.1
Termékek
Szekció elem: Az egyes sorok a tagek között szerepelnek, amelyekből több is megadható. Egy elemet a határoz meg. Mező leírás
XML tag
XML típus
Kitöltése kötelező
Megjegyzés
5
termék neve
string
igen
A termék megnevezése. Minimális hossza 5, maximális hossza 128 karakter.
termékcsoport
enumeration
igen
Értéke:
szolgáltatás tipusa
<szolg_tipus>
enumeration
igen
Értéke:
szolgáltatás árak
<szolg_arak>
complexType, sequence
igen
belföldi levél külföldi levél belföldi csomag külföldi csomag
egyetemes postai szolgáltatás egyetemest helyettesítő postai szolgáltatás egyetemest nem helyettesítő postai szolgáltatás
szolgáltatás árak megadása súly és távolság függvényében <szolg_arak> <szolg_ar>…<szolg_ar> <szolg_ar>…<szolg_ar> <szolg_arak>
szolgáltatás ár
<szolg_ar>
complexType, sequence
igen
egy szolgáltatás ára, mely súlytól és távolságtól függ <szolg_ar> <suly_gramm_tol>0 <suly_gramm_ig>50 <arzonak>…
6
… a távolság megadható árzónák használatával vagy km alapon súly (g) tól
<suly_gramm_tol>
integer
igen
pl 0 (g), 51 (g) Minimum értéke 0, Maximum értéke 40000
súly (g) ig
<suly_gramm_ig>
integer
igen
pl 50 (g), 100 (g) Minimum értéke 0, Maximum értéke 40000
ár zónák
<arzonak>
complexType, sequence
nem
árzónak megadása: <arzonak> <arzona> <ar> <arzona> <ar>
ár zóna
<arzona>
complexType, sequence
igen
árzóna megadása:
7
<arzona> <ar> zóna
string
igen
Zónák megadásához a Zónák fejezetben leírt tag használható, ez esetben annak tagjában szereplő értéket kell itt feltüntetni
ár (Ft)
<ar>
double
igen
az adott súlykorlátokhoz és célterülethez tartozó ár pl 150 (Ft) Minimum értéke 0.
km árak
complexType, sequence
nem
km táblázat alapján kalkulálható árak megadása
km ár
complexType, sequence
igen
km tartományhoz tartozó ár megadása
8
távolság (km) tól
integer
igen
pl 0 (km), 51 (km) Minimum értéke 0, Maximum értéke 30000
távolság (km) ig
integer
igen
pl 50 (km), 100 (km) Minimum értéke 1, Maximum értéke 30000
távolság ár (Ft)
double
igen
pl. 150 (Ft) Minimum értéke 0
igénybe vehető különszolgáltatás, többletszolgáltatás
vagy
complexType, sequence
igen
vagy
… … … … vagy egy többletszolgáltatáshoz négy leíró adatot kell megadni egy többletszolgáltatás egyszer szerepelhet tobbletszolg_egyeb esetén a tobbletszolg_tipus „egyéb” legfeljebb 5 egyéb többletszolgáltatás adható meg
9
igénybe vehető különszolgáltatás, többletszolgáltatás típusa
enumeration
igen
Értéke:
ajánlott tértivevény/ kézbesítés visszaigazolása a feladónak saját kézbe/ címzett kezébe kézbesítés/ bizalmas küldemény kézbesítése utánvétel/címzett fizet 10000,-Ft-ig utánvétel/címzett fizet 20000,-Ft-ig utánvétel/címzett fizet 30000,-Ft-ig utánvétel/címzett fizet 40000,-Ft-ig utánvétel/címzett fizet 50000,-Ft-ig utánvétel/címzett fizet 100000,-Ft-ig utánvétel/címzett fizet 150000,-Ft-ig utánvétel/címzett fizet 200000,-Ft-ig utánvétel/címzett fizet 300000,-Ft-ig utánvétel/címzett fizet 400000,-Ft-ig utánvétel/címzett fizet 500000,-Ft-ig utánvétel/címzett fizet 500000,-Ft felett értékbiztosítás/értéknyilvánítás/ díja 50000,-Ft-ig értékbiztosítás/értéknyilvánítás/ díja 100000,-Ft-ig értékbiztosítás/értéknyilvánítás/ díja 150000,-Ft-ig értékbiztosítás/értéknyilvánítás/ díja 500000,-Ft-ig értékbiztosítás/értéknyilvánítás/ díja 500000,-Ft felett törékeny/ speciális tartalom kezelése terjedelmes/ túlméretes küldemény elsőbbségi/ soron kívüli /expressz kezelés 1 órán belüli időgarancia 24 órán belüli időgarancia másnap reggeli kiszállítás időgarancia másnap délelőtti kiszállítás időgarancia
10
ütemezett kiszállítás időgarancia fix időponthoz kötött kézbesítés időgarancia előzetes értesítés küldemény érkezéséről ismételt kézbesítés postán maradó/csomagpontra kézbesítés utánküldés/új címre kézbesítés/ címmódosítás díja tételes átadás okmány visszaforgatás munkaidőn kívüli kiszállítás/éjszakai kiszállítás nem munkanapokon történő kézbesítés díja visszáru útdíj felár körfuvar várakozási díj/ügyintézési díj inverz csomag/csomagcsere szolgáltatás/visszáru szolgáltatás raktározási díj vámügyintézés nyomkövetés
tobbletszolg_egyeb esetén a tobbletszolg_tipus „egyéb” igénybe vehető különszolgáltatás, többletszolgáltatás leírása
string
igen
mit is jelent ez a szolgáltatás. Minimális hossza 5, maximális hossza 512 karakter.
igénybe vehető különszolgáltatás, többletszolgáltatás ára fix ár, vagy az alapár százalékában
boolean
igen
Ha értéke igaz, akkor a tobbletszolg_ertek érték fix Ft érték. Ha értéke hamis, akkor a tobbletszolg_ertek érték a szolgáltatás ár százalékát jelenti.
11
értelmezett igénybe vehető különszolgáltatás, többletszolgáltatás ára (Ft vagy %)
double
igen
A tobbletszolg_fixar logikai kapcsoló függvényében vagy egy fix Ft érték, vagy a szolgáltatás árának százaléka. Minimum értéke 0
átfutási idő
integer
nem
nap, pontos napot kell megadni. Minimum értéke 0, maximum értéke 60
méret korlát (cm)
<meretkorlat>
complexType, sequence
nem
méret korlát megadása: <meretkorlat> <szeles> <magas>
szélesség korlát (cm)
<szelesseg>
integer
igen
pl 200 (cm) Minimum értéke 0, maximum értéke 500
hosszúság korlát (cm)
integer
igen
pl 200 (cm) Minimum értéke 0, maximum értéke 500
magasság korlát (cm)
<magassag>
integer
igen
pl 200 (cm) Minimum értéke 0, maximum értéke 500
12
3.2
Zónák
A kizárólag külföldi levél és csomag esetén használt zóna táblázat XML leképezése. Szekció elem: Az egyes sorok a tagek között szerepelnek, amelyekből több is megadható. Egy elemet a határoz meg. Mező leírás
XML tag
XML típus
Kitöltése kötelező
Megjegyzés
zóna neve
string
igen
pl. Nyugat-Közép-Európa Hazai kézbesítésű termék esetén Magyarország Kulcs mező, nem szerepelhet két azonos nevű zóna
országok
complexType, sequence
igen
Ausztria Németország
orszag
enumeration
igen
Értéke (részlet, a teljes listát az XSD tartalmazza):
Afganisztán … Zöld-foki Köztársaság
13