Megbízói díjbeszedésű hírlapok előfizetői állományának adatcseréje

Átírás

1 Magyar Psta Zrt. Hírlap Igazgatóság Budapest, XIII. Dunavirág u Pstacím: 1540 Budapest Telefn: (06-1) Fax: (06-1) Megbízói díjbeszedésű hírlapk előfizetői állmányának adatcseréje 1. A dkumentum célja Az állmányk elnevezése Az állmányk felépítése Az egyszerűsített állmány szerkezete A bővített állmány szerkezete Az állmányk típusa Teljes állmány Váltzás állmány Címváltzás állmány Pstai felvételű de megbízói díjfizetésű előfizetések címváltzásának adatcseréje 5 7. Speciális esetek, példák Előfizető nevének megváltzása Az állmányk átadása a Psta részére Megbízói kísérőlevél Az állmányk betöltése Hibakódk Megbízó részére bejelentett előfizetői reklamációk átadása a Szlgáltató részére. 9

2 2 1. A dkumentum célja Ez a dkumentum a megbízói adatállmányk cseréjének módját fglalja össze. 2. Az állmányk elnevezése Az állmánykat a kezelhetőség érdekében a következő egységes elnevezéssel kell 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 (más néven: ISO , 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 átadtt 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, a betöltést visznt akadályzza. Szöveg fájlk esetében az elválasztó karakter a ; (pntsvessző) Ugyanazt az állmány szerkezetet használj a Psta a Megbízótól fgadtt adatk, mint a Psta által a Megbízók részére átadtt 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 átadni. Amennyiben a Megbízó 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 Az egyszerűsített állmány szerkezete Megnevezés Mező neve Típus Hssz Kitöltése Megjegyzés Címzett aznsító CIMJ_SSZ N 8 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ő Ha > belföldi címzett irányítószám (IRÁNYÍTÓSZAMOK állmány ) 2/9

3 3 Megnevezés Mező neve Típus Hssz Kitöltése Megjegyzés Ha < 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 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 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ípu Hssz Kitöltése Megjegyzés 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 átadása Kiadói aznsító KIAD_KOD C 15 Ajánltt 3/9

4 4 Megnevezés Mező neve Típu Hssz Kitöltése Megjegyzés s 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 hónap** ELOF_HO N 2 Az előfizetés időszaka 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 dátuma** BEFIZ_D D Az előfizetési díj befizetésének dátuma Befizetés típusa** 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) 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ől aps 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 cím _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 napja H_NAP N 1 Kötelező 1-7 ig a hét napjának srszáma 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 visszállmány minden esetben címbntva készül. ** Ezeknek a mezőknek a Megbízó részére átadtt teljes vagy váltzás állmányknál van értéke 4. Az állmányk típusa 4.1. Teljes állmány A Megbízó az összes aktuális címzettet átadja a Szlgáltató részére. Ebben az esetben betöltéskr az előző tételek megszüntetésre kerülnek Váltzás állmány A Megbízó az új címzetteket és a lemndókat adja át a Szlgáltató részére. Címváltzás esetén a váltzás állmányban meg kell adni 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. 4/9

5 5 5. Címváltzás állmány Figyelem! Ezen szerkezet használata nem kötelező! Minden Megbízó 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 visszállmányt is ilyen szerkezetben kapja. Ha a Megbízó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 Megbízó ú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 visszállmányban visszaadásra kerül az aznsí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 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 átadásával 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 megbízói díjfizetésű előfizetések címváltzásának adatcseréje Amennyiben a Psta, megbízó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. 5/9

6 6 A Psta a Megbízónak egy váltzásállmányban átadja az így felvett címváltzáskat, vagy név és címváltzáskat. A Megbízó ezek után kétféleképpen járhat el. 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 visszaadja, amit a Psta ekkr, már a Megbízó tudtával, betölt saját rendszerébe 1. A kaptt váltzásállmányból a Megbízó 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 átadja a Psta részére, ahl betöltésre kerül a saját rendszerbe. A fent leírtak értelmében a Psta a megbízói előfizetésű név és címváltzáskra a váltzás bejelentési kérelmet elfgadja, arról a Megbízót állmányban tájékztatja, de saját rendszerében csak abban az esetben vezeti át, ha a váltzást a Megbízó 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 adja át a Psta a Megbízó 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 Pstának átadni. 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 kell átadni. 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 1 A Megbízó visszaigazlása nélkül ugyanis az előfizetéseket nem áll módunkban beindítani. 6/9

7 7 8. Az állmányk átadása a Psta részére Az állmánykat a Partnerwebre lehet feltölteni Megbízói kísérőlevél Az állmányk feltöltésekr az alábbi tartalmú kísérőlevél küldhető -ben a Psta részére a tagkhirlapadat@psta.hu címre, vagy a Partnerwebre feltöltött dkumentum frmájában: - egyértelmű beaznsíthatóság érekében lapnév, megjelenési szám, vagy hónap, - teljes, vagy váltzás állmány, - összes tételszám, ezen belül indulók és törlők, - élő előfizetés figyelése szükséges vagy sem, - lejárati dátum figyelése, amennyiben szükséges, - Tartlek, vagy dátum mezők kezelésére vnatkzó utasítás. 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 az utca név üres külföldi címzett esetén a külföldi irányítószám üres Hibák 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ítésre kerül. A hibakódkat a 9.1. pnt tájékztat. A betöltést követően a Psta munkatársai feltöltik a visszállmányt/hibalistát a Partnerwebre, amelyről autmatikus értesítés kerül tvábbításra a Megbízó által megjelölt címzettek részére. 7/9

8 Hibakódk Megbízói Hibakód Hiba megnevezés Kiadói hibatípus 1 Betöltve Nem hiba 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 8/9

9 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: