Magyar Psta Zrt. Hírlap Igazgatóság Budapest, XIII. Dunavirág u. 2-6. Pstacím: 1540 Budapest Telefn: (06-1) 487-1100 Fax: (06-1) 355-7584 Kiadói díjbeszedésű hírlapk előfizetői állmányának adatcseréje 1. A dkumentum célja... 2 2. Az állmányk elnevezése... 2 3. Az állmányk felépítése... 2 3.1. Az egyszerűsített állmány szerkezete... 2 3.2. A bővített állmány szerkezete... 3 4. Az állmányk típusa... 4 4.1. Teljes állmány... 4 4.2. Váltzás állmány... 4 5. Címváltzás állmány... 4 6. Pstai felvételű de kiadói díjfizetésű előfizetések címváltzásának adatcseréje... 5 7. Speciális esetek, példák... 5 7.1. Előfizető nevének megváltzása... 5 8. Az állmányk elküldése a psta részére... 6 8.1. Kiadói kísérőlevél minta... 6 9. Az állmányk betöltése... 6 9.1. Hibakódk... 6 10. Megbízó részére bejelentett előfizetői reklamációk átadása a Szlgáltató részére. 8
2 1. A dkumentum célja Ebben a dkumentumban összefglaltuk és egységesen szeretnénk leírni a kiadói állmányk cseréjének módját. A jövőben minden váltztatást ebben a dkumentumban vezetünk át, a váltzáskról a dkumentum következő, Váltzásk c. pntjában tájékztatunk majd. 2. Az állmányk elnevezése Az állmánykat a kezelhetőség érdekében a következő egységes elnevezéssel kérjük ellátni: 1-6 C : lapnév rövid váltzata 7-8 C : hónap 3. Az állmányk felépítése Az előfizetői állmány frmátuma lehet dbase (kiterjesztés: DBF), vagy Excel állmány (kiterjesztés: XLS, XLSX, ), vagy szöveg fájl (kiterjesztése csv). dbase állmány esetén nemcsak a mezők elnevezése fnts, de a táblázatkban megadtt adattípusk pnts beállítása is, beleértve a mezőhsszakat. A DBF állmány kódlapja: DOS-852 (más neveken: OS2-852, IBM852) Excel file-k esetében: nem használható az szlpk és srk elrejtése Excel funkció, mert azk, bár a felhasználó elől eltűnnek, az adatállmányban megmaradnak és az adatbetöltő prgram tvábbra is látja őket. Az Excel állmány kódlapja: WIN-1250 (más néven: ISO-8859-2, LATIN2). ne legyenek az adatk között üres srk, a betöltő prgram ugyanis az első üres srnál megáll, az adatk betöltését befejezi. A psta részére küldött Excel állmánykban ne szerepeljen a mintaként megadtt adatsr vagy kísérő szöveg az csak a tájékztatást szlgálja részünkről, a betöltést visznt akadályzza. Szöveg fájlk esetében az elválasztó karakter a ; (pntsveszző) Ugyanazt az állmány szerkezetet használjuk a Kiadótól fgadtt adatk, mint az általunk a Kiadók részére küldött szerződés szerinti teljes, illetve váltzás állmányk esetében. Attól függően, hgy milyen típusú adatk érkeznek, különböző struktúrájú állmánykat lehet küldeni. Ha a Kiadó már az állmány átadásakr megadja címzettenként a lejárati dátumt illetve prmpt előfizetéseknél kötelező megadni az indítási dátumt - ekkr a bővített szerkezetet kell használni. 3.1. Az egyszerűsített állmány szerkezete Megnevezés Mező neve Típus Hssz Kitöltése Megjegyzés CIMJ_SSZ N 8 Kötelező Induló tételnél 0, Törlésnél a visszakaptt aznsító Címzett aznsító Előnév CELO_NEV C 10 DR; PROF; ÖZVEGY; stb. Név CIMJ_NEV C 80 Kötelező Irányítószám CIMJ_IRS N 4 Kötelező Ha > 1000 - belföldi címzett irányítószám (IRÁNYÍTÓSZAMOK állmány ) Ha < 1000 - külföldi címzett rszágkód (ORSZÁGOK állmány) Helység CIMJ_VAR C 40 Kötelező Belföldi címnél irányítószám referencia Utca UTCA_NEV C 30 Ajánltt
3 Megnevezés Mező neve Típus Hssz Kitöltése Megjegyzés Közterület UTCA_KOD N 3 típus Házszám HAZSZAM C 15 Ajánltt Emelet, ajtó EM_AJTO C 10 Külföldi CKUL_IRS C 15 irányítószám Küldemény jel KIKO_KOD C 1 Tartalék TART_LEK C 9 Tartalmazhat kiadói aznsítót vagy lejárati dátumt Példányszám PELD_SZA N 3 Kötelező Mzgás kód MOZG_KOD C 1 Kötelező U - induló tétel esetén, T - lejáró tétel esetén, a CIMJ_SSZ mezőben visszakaptt aznsítóval együtt 3.2. A bővített állmány szerkezete Megnevezés Mező neve Típus Hssz Kitöltése Megjegyzés Címzett aznsító CIMJ_SSZ N 8 Törlésnél kötelező Induló tételnél 0, Törlésnél a visszakaptt aznsító Előnév CELO_NEV C 10 DR; PROF; ÖZVEGY; stb. Név CIMJ_NEV C 80 Kötelező Irányítószám CIMJ_IRS N 4 Kötelező Belföldi címzett esetén irányítószám (IRÁNYÍTÓSZAMOK állmány), egyébként 0 Helység CIMJ_VAR C 40 Kötelező Belföldi címnél irányítószám referencia Utca UTCA_NEV C 30 Ajánltt Közterület típus* UTCA_KOD N 3 Házszám* HAZSZAM C 15 Ajánltt Emelet, ajtó* EM_AJTO C 10 Külföldi CKUL_IRS C 15 irányítószám Küldemény jel KIKO_KOD C 1 Belföldi és külföldi címeknél is 1: Ajánltt, 4: Elsőbbséggel, 2: Ajánltt+Elsőbbséggel 0: sima Tartalék TART_LEK C 9 Példányszám PELD_SZA N 3 Kötelező Mzgás kód MOZG_KOD C 1 Kötelező U - induló tétel esetén, T - lejáró tétel esetén, a CIMJ_SSZ mezőben visszakaptt aznsítóval együtt C címváltzás küldése Kiadói aznsító KIAD_KOD C 15 Ajánltt Lapkód LAPKOD N 6 Ajánltt Indítási dátum INDUL D Az előfizetés kezdete Lejárati dátum LEJAR D Az előfizetés vége (hónap vége) Előfizetési ELOF_HO N 2 Az előfizetés időszaka hónap** Elkülönítő jel E_JEL C 5 Behúzásk megjelölése Közület/Magánszemély K_M C 1 K: közület esetén E: egyéni előfizető esetén Befizetés BEFIZ_D D Az előfizetési díj befizetésének dátuma** Befizetés típusa** dátuma BEFIZ_H C 1 Az előfizetési díj beérkezésének módja (Á: átutalás, P: pénzintézeti, C: csekkes, N: nyugtás)
4 Megnevezés Mező neve Típus Hssz Kitöltése Megjegyzés Ország kód ORSZ_KOD N 3 Ajánltt külföldi címzett esetén rszágkód (ORSZÁGOK állmány), egyébként 0 Címanyags/Fedőla ps C_F C 1 Különkezelt lapk esetén megadható, hgy C: címzetten vagy F: a nélkül (fedőlapn) kerüljön kézbesítésre Kapu kód KAPU_KOD C 100 Email cím EMAIL_CIM C 100 Telefnszám TELEFON C 30 Cím típus CIM_TIP C 1 Kötelező K: Kiküldési cím, I: Ideiglenes cím, H: Helyettesítő (hétvégi) cím Helyettesítés H_NAP N 1 Kötelező 1-7 ig a hét napjának srszáma napja Hiba kód HIBA_KOD N 2 A betöltés srán esetlegesen keletkező hiba kódja * Lehetőség van az utcanév mezőben adni a teljes címadatt, úgy hgy az utca név mellett a közterület típusa (pl.: u.), házszám és az emelet ajtó is szerepeljen, de lehet csak az utca nevét és a közterület típusát, és a házszámt, emelet - ajtót külön megadni. A visszaállmány minden esetben címbntva készül. ** Ezeknek a mezőknek a Kiadó részére küldött teljes vagy váltzás állmányknál van értéke 4. Az állmányk típusa 4.1. Teljes állmány A Kiadó az összes aktuális címzettet elküldi. Ebben az esetben betöltéskr az előző tételek megszüntetésre kerülnek 4.2. Váltzás állmány Csak az új címzetteket és a lemndókat küldi a Kiadó. Címváltzás esetén a váltzás állmányban el kell küldeni a régi cím előfizetői aznsítóját és a mzgás kódban T jelöléssel majd az új címet teljesen új tételként, névvel együtt, a mzgás kódban U jelöléssel. 5. Címváltzás állmány Figyelem! Ezen szerkezet használata nem kötelező! Minden kiadó szabadn dönthet, hgy használja-e az itt leírt funkciókat vagy sem. Ha igen, úgy áttérhet erre a frmátumra, ez esetben a visszaállmányt is ilyen szerkezetben kapja. Ha a kiadónak nem szükségesek ezek a többlet-szlgáltatásk, akkr nem kell az itt következő leírással fglalkznia. Amikr a Kiadó új előfizetést ad át, akkr U sr-ként érkezik (MOZG_KOD-ban U), a tétel betöltésre kerül, a visszaállmányban visszaküldjük az aznsítót (CIMJ_SSZ). Innentől kezdve erre az előfizetésre bármilyen műveletet, bármely időpntban az aznsítóval lehet kezdeményezni: Kiküldési címváltzás (végleges címváltzás) C sr érkezik (MOZG_KOD-ban C) új cím cím típusban (CIM_TIP): K Ideiglenes címváltzás (rövidebb időszakra pld. nyaralás idejére - kért címváltzás) C sr érkezik (MOZG_KOD-ban C) ideiglenes cím cím típusban (CIM_TIP): I
5 Helyettesítő (hétvégi) címváltzás (csak napilapknál értelmezhető. Az előfizető kérheti, hgy az általa előfizetett napilapt egy biznys napn más pstai címre kézbesítsük.) C sr érkezik (MOZG_KOD-ban C) hétvégi cím cím típusban (CIM_TIP): H helyettesítés napja (H_NAP): a hét napjának srszáma (hétfőtől vasárnapig, 1-től 7-ig) Tvábbi tudnivalók: Egy előfizetés esetén egy élő cím lehet minden cím típusból Minden cím törlést előíró C sr (MOZG_KOD-ban C), cím típus (CIM_TIP) és lejárati dátum adatk küldésével történik, illetve egyazn típusból új cím küldése természetesen törli a régi címet. Tehát, ha egy ideiglenes illetve helyettesítő cím esetén. A kiküldési cím törlése csak abban az esetben értelmezhető, ha új cím érkezik. Az előfizetés törlése ezután is a T sr (MOZG_KOD) küldésével történik. Lejárati dátum megadása nélkül minden cím autmatikusan végtelen lejárattal lesz betöltve. Természetesen elfgadjuk a címváltzást a régi frmában is (T sr, U sr), de az aznsító és az előfizető előéletének megtartása, kisebb adatmennyiség és a jbb szerkezeti átláthatóság érdekében inkább az új módszert (C sr) támgatjuk. 6. Pstai felvételű de kiadói díjfizetésű előfizetések címváltzásának adatcseréje Amennyiben a psta, kiadói előfizetés(ek)re vnatkzó címváltzás, vagy név-és címváltzást fgad el, annak adatcseréje a következők szerint történik. A Magyar Psta a kiadónak egy váltzásállmányban elküldi az így felvett címváltzáskat, vagy név és címváltzáskat. 1. A kiadó ezek után kétféleképpen járhat el a. A kaptt váltzásállmányból saját rendszerében rögzíti a címváltzáskat, majd a kaptt váltzásállmányt a pstának váltzatlanul visszaküldi, amit a psta ekkr, már a kiadó tudtával, betölt saját rendszerébe 1. b. A kaptt váltzásállmányból a kiadó saját rendszerében rögzíti a címváltzáskat majd a rendszeréből a szkáss váltzásállmányt előállítja, amiben már benne vannak az átadtt címváltzásk is. Ezt megküldi, amit a psta betölt saját rendszerébe. A fent leírtak értelmében a psta a kiadói előfizetésű név és címváltzáskra a váltzás bejelentési kérelmet elfgadja, arról a kiadót állmányban tájékztatja, de saját rendszerében csak abban az esetben vezeti át, ha a váltzást a kiadó a psta részére váltzásállmányban visszaadja. Amennyiben címváltzás bejelentésekr névváltzást is bejelent az ügyfél, így ezt a CIMJ_NEV mezőben küldjük el a kiadó részére. 7. Speciális esetek, példák 7.1. Előfizető nevének megváltzása Ha egy előfizető például házasság miatt vagy más elhatárzásból megváltztatja a nevét, akkr ezt a váltzást a következőképpen lehet a psta felé elküldeni: Végleges névváltzás esetén töröltetni kell az eredeti tételt és az új névvel új tételként elküldeni. 1 A kiadó visszaigazlása nélkül ugyanis az előfizetéseket nem áll módunkban beindítani.
6 Ideiglenes címváltzás esetén ha a név is megváltzik (pld: előfizető neve XX YY, ideiglenes név- és címváltzás esetén a név HOTEL Z, XX YY), akkr - a címváltzás állmányban a CIMJ_NEV mezőben kell megadni - nem címváltzás állmányban pedig a fenti módn 8. Az állmányk elküldése a psta részére Az állmánykat adathrdzón és email-ben is el lehet küldeni. 8.1. Kiadói kísérőlevél minta Az állmánykat email-ben való tvábbításakr egy ilyen tartalmú kísérőlevelet kérünk küldeni: Ez az állmány a..(lapnév).(megjelenési év és szám) számának a.(állmány típusa: teljes/váltzás) állmánya. *A teljes cím az UTCA_NEV mezőben van. *A TART_LEK mező a lejáratkat tartalmazza, kérem figyelembe venni! *Az állmány elkülönítéseket is tartalmaz, BEHU1, stb. jelzéssel. Elküldő neve, telefnszáma A *-al jelölteket csak akkr kell feltüntetni, ha valóban így is van. 9. Az állmányk betöltése Az állmányk betöltésénél a következő ellenőrzések történnek: Figyelmeztetések Hibák az utca név üres külföldi címzett esetén a külföldi irányítószám üres létezik-e az irányítószám az Irányítószámk adatbázisunkban létezik-e az rszágkód az Országk adatbázisunkban az irányítószám és a helységnév megfeleltethetősége duplikált adatk kiszűrése: ha egy állmányn belül egynél több lyan tétel van, ahl a Név és a teljes cím pntsan megegyezik, akkr csak egy tétel töltődik be Váltzás állmány esetében a már élő előfizetéssel megegyező tétel érkezésekr nem töltődik be Minden betöltés után autmatikusan készül egy visszaállmány az alábbiak szerint: a betöltött tételeknél a címzett aznsító (CIMJ_SSZ) ki van töltve és a mzgás kódban (MOZG_KOD) B (Betöltve) jelölés van a hibás tételeknél üres a címzett aznsító és mzgás kódban H (Hiba) jelölés van A hibás tételekről készül egy hibalista, a hiba kának feltüntetésével illetve igény szerint a visszaállmányban a HIBA_KOD mezőben is megjelenítjük. A hibakódkról a következő fejezet tájékztat. Minden betöltést követően kötelező a Kiadó részére elküldjük a visszaállmányt és ha van, akkr a hibalistát. 9.1. Hibakódk Kiadói Hibakód Hiba megnevezés Kiadói hibatípus 1 Betöltve Nem hiba
Kiadói Hibakód Hiba megnevezés Kiadói hibatípus 2 Hiányzik a Helység Figyelmeztetés 3 Hiányzik az Utca Figyelmeztetés 4 Hibás Lejárat a Tartalékban Figyelmeztetés 5 Már Igényelve Figyelmeztetés 6 Hibás Inditás az állmányban Figyelmeztetés 7 Van már élő Előfizetése Figyelmeztetés 8 Hiányzó Külföldi Irányítószám Figyelmeztetés 9 Kitöltött Címzett aznsító Figyelmeztetés 10 Már létező Címzett aznsító Hiba 11 Nem létező Irányítószám Hiba 12 Nem létező Országkód Hiba 13 Hiányzik a Név Hiba 14 Van már élő Előfizetése Hiba 15 Nem előfizethető Lap Hiba 16 Már Megszünt Lap Hiba 17 Értelmezhetetlen Indítás az állmányban Hiba 18 Aznsíthatatlan Helység Hiba 19 Hibás Ca. / Fl. jelölés az állmányban Hiba 20 Törölt cím Hiba 31 Címváltztatva Nem hiba 32 Hiányzó címzett aznsító Figyelmeztetés 40 Hibás címtípus Hiba 41 Hibás címváltzás dátumtól Hiba 42 Aznsíthatatlan címzett Hiba 51 Törölve Nem hiba 52 Már Szüntetve későbbi dátummal Figyelmeztetés 70 Nem létező Címzett Hiba 71 Hibás Címsrszám Hiba 72 Már Szüntetve krábbi dátummal Hiba 90 Hibás Mzgáskód Hiba 91 Hibás karakterek lecserélve Figyelmeztetés 95 Autmatikusan nem járatzható Figyelmeztetés 7
10. Megbízó részére bejelentett előfizetői reklamációk átadása a Szlgáltató részére A Megbízó által felvett előfizetői reklamációk átadását a Szlgáltató az alábbi Excel táblázat szerinti frmátumban és adattartalmmal fgadja: