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> </szolgaltato> <termekek> <termek> <szolg_arak> <szolg_ar> </szolg_ar> </szolg_arak> <tobbletszolgok> </tobbletszolgok> <meretkorlat> </meretkorlat> </termek> </termekek> <zonak> <zona> <orszagok> </orszagok> </zona> </zonak> </arinformacio> 3
4
2 Szolgáltató adatai 2.1 Szolgáltató adatai Szekció elem: <szolgaltato></szolgaltato> Mező leírás XML tag XML típus Kitöltése kötelező Megjegyzés azonosító <id> long igen a szolgáltató egyedi azonosítója. Minimum értéke 1 Név <nev> 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: <termekek></termekek> Az egyes sorok a <termek></termek> tagek között szerepelnek, amelyekből több is megadható. Egy <termek> elemet a <termeknev> határoz meg. Mező leírás XML tag XML típus Kitöltése kötelező Megjegyzés 5
termék neve <termeknev> string igen A termék megnevezése. Minimális hossza 5, maximális hossza 128 karakter. termékcsoport <termekcsoport> enumeration igen Értéke: belföldi levél külföldi levél belföldi csomag külföldi csomag szolgáltatás tipusa <szolg_tipus> enumeration igen Értéke: egyetemes postai szolgáltatás egyetemest helyettesítő postai szolgáltatás egyetemest nem helyettesítő postai szolgáltatás szolgáltatás árak <szolg_arak> complextype, szolgáltatás ár <szolg_ar> complextype, igen igen 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> egy szolgáltatás ára, mely súlytól és távolságtól függ <szolg_ar> <suly_gramm_tol>0</suly_gramm_tol> <suly_gramm_ig>50</suly_gramm_ig> <arzonak> </arzonak> 6
<km_arak> </km_arak> </szolg_ar> 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, ár zóna <arzona> complextype, nem igen árzónak megadása: <arzonak> <arzona> <zona></zona> <ar></ar> </arzona> <arzona> <zona></zona> <ar></ar> </arzona> </arzonak> árzóna megadása: 7
<arzona> <zona></zona> <ar></ar> </arzona> zóna <zona> string igen Zónák megadásához a Zónák fejezetben leírt <zonak></zonak> tag használható, ez esetben annak <zonanev> 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 <km_arak> complextype, km ár <km_ar> complextype, nem igen km táblázat alapján kalkulálható árak megadása <km_arak> <km_ar> <km_tol></km_tol> <km_ig></km_ig> <km_ar></km_ar> </km_ar> <km_arak> km tartományhoz tartozó ár megadása <km_ar> 8
<km_tol></km_tol> <km_ig></km_ig> <km_ar></km_ar> </km_ar> távolság (km) tól <km_tol> integer igen pl 0 (km), 51 (km) Minimum értéke 0, Maximum értéke 30000 távolság (km) ig <km_ig> integer igen pl 50 (km), 100 (km) Minimum értéke 1, Maximum értéke 30000 távolság ár (Ft) <km_ar> double igen pl. 150 (Ft) Minimum értéke 0 igénybe vehető különszolgáltatás, többletszolgáltatás <tobbletszolg> vagy <tobbletszolg_egyeb> complextype, igen <tobbletszolg> vagy <tobbletszolg_egyeb> <tobbletszolg_tipus> </tobbletszolg_tipus> <tobbletszolg_leiras> </tobbletszolg_leiras> <tobbletszolg_fixar> </tobbletszolg_fixar> <tobbletszolg_ertek> </tobbletszolg_ertek> </tobbletszolg> vagy </tobbletszolg_egyeb> 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 <tobbletszolg_tipus> 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 igénybe vehető különszolgáltatás, többletszolgáltatás ára fix ár, vagy az alapár százalékában <tobbletszolg_leiras> string igen mit is jelent ez a szolgáltatás. Minimális hossza 5, maximális hossza 512 karakter. <tobbletszolg_fixar> 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 %) <tobbletszolg_ertek> double igen A tobbletszolg_fixar logikai kapcsoló függvényében vagy egy fix Ft érték, vagy a szolgáltatás árának <tobbletszolg_ertek> százaléka. Minimum értéke 0 átfutási idő <atfutasiido> integer nem nap, pontos napot kell megadni. Minimum értéke 0, maximum értéke 60 méret korlát (cm) <meretkorlat> complextype, nem méret korlát megadása: <meretkorlat> <szeles></szeles> <hossz></hossz> <magas></magas> </meretkorlat> szélesség korlát (cm) hosszúság korlát (cm) magasság korlát (cm) <szelesseg> integer igen pl 200 (cm) Minimum értéke 0, maximum értéke 500 <hosszusag> integer igen pl 200 (cm) Minimum értéke 0, maximum értéke 500 <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: <zonak></zonak> Az egyes sorok a <zona></zona> tagek között szerepelnek, amelyekből több is megadható. Egy <zona> elemet a <zonanev> határoz meg. Mező leírás XML tag XML típus Kitöltése kötelező Megjegyzés zóna neve <zonanev> 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 <orszagok> complextype, igen <orszagok> <orszag>ausztria</orszag> <orszag>németország</orszag> </orszagok> orszag <orszag> enumeration igen Értéke (részlet, a teljes listát az XSD tartalmazza): Afganisztán Zöld-foki Köztársaság 13