ÁSzF 1. számú melléklet Megbízó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ásk pcinális lehetőségei...4 5.1. A címváltzás állmány szerkezete...5 6. Szlgáltató által felvett, de Megbízói díjfizetésű előfizetések címváltzásának adatcseréje...6 7. Speciális esetek, példák...6 7.1. Előfizető nevének megváltzása...6 8. Az állmányk elküldése a Szlgáltató részére...7 8.1. Megbízói kísérőlevél minta...7 9. Az állmányk betöltése...7 9.1. Hibakódk...7
2 1. A dkumentum célja Ebben a dkumentumban összefglalásra került a Megbízói adatállmányk cseréjének módja. 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). 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: Micrsft Excel 2003 illetve Micrsft Office 2003 Excel verzió számnál magasabb xls állmányt a Szlgáltató nem fgad el. Kérjük, ennek használata esetén valamelyik előző frmátumba menteni. 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 Szlgáltató 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, a betöltést visznt akadályzza. Ugyanazt az állmány szerkezetet használjuk a Megbízótól fgadtt adatk, mint az általunk a Megbízó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 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. Ha a Megbízó az általa felvett reklamációkat állmányban kívánja átadni, akkr a bővített adatstruktúrát kell használni, és ebben a kiadói aznsítót a KIAD_KÓD mezőben szerepeltesse. 3.1. Az egyszerűsített állmány szerkezete Megnevezés Mező neve Típus Hssz Kitöltése Megjegyzés
3 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 > 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 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 irányítószám CKUL_IRS C 15 Küldemény jel KIKO_KOD C 1 Tartalék TART_LEK C 9 Tartalmazhat Megbízó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 irányítószám CKUL_IRS C 15 Küldemény jel KIKO_KOD C 1 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 Kiadói aznsító KIAD_KOD C 15 Ajánltt Kiadói aznsító 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/Egyéni előfizető 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
4 Megnevezés Mező neve Típu s Hssz Kitöltése Megjegyzés (ORSZÁGOK állmány), egyébként 0 Címanyags/Fedőlaps 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 * 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 Megbízó 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 Megbízó 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 Megbízó. 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ásk pcinális lehetőségei Megbízói igények alapján kialakításra került egy új módszer, ami által az előfizetés szüntetése nélkül lehetőség van címváltzásra és egy előfizetéshez több cím hzzárendelésére is. 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 visszaállmányt is ilyen szerkezetben kapja. Ha a Megbízónak nem szükségesek ezek a többletszlgá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 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 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)
5 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. 5.1. A címváltzás á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 irányítószám CKUL_IRS C 15 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 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őlaps C_F C 1 Különkezelt lapk esetén megadható, hgy
6 Megnevezés Mező neve Típus Hssz Kitöltése Megjegyzés C: címzetten vagy F: a nélkül (fedőlapn) kerüljön kézbesítésre 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 visszaállmány minden esetben címbntva készül. ** Ezeknek a mezőknek a Megbízó részére küldött teljes vagy váltzás állmányknál van értéke 6. Szlgáltató által felvett, de Megbízói díjfizetésű előfizetések címváltzásának adatcseréje Amennyiben a Szlgáltató, 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. A Szlgáltató a Megbízó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 Megbízó 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 Szlgáltató ekkr, már a Megbízó tudtával, betölt saját rendszerébe 1. b. 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 megküldi, amit a Szlgáltató betölt saját rendszerébe. A fent leírtak értelmében a Szlgáltató 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 Szlgáltató 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üldi el a Szlgáltató 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 Szlgáltató 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. 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.
7 8. Az állmányk elküldése a Szlgáltató részére Az állmánykat adathrdzón és email-ben is el lehet küldeni. 8.1. Megbízói kísérőlevél minta Az állmánykat email-ben való tvábbításakr az alábbi tartalmú kísérőlevelet küld el a Megbízó: 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 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ítjük. A hibakódkról a következő fejezet tájékztat. Minden betöltést követően kötelező a Megbízó részére a Szlgáltató elküldi 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 2 Hiányzik a Helység Figyelmeztetés 3 Hiányzik az Utca Figyelmeztetés
Kiadói Hibakód Hiba megnevezés Kiadói hibatípus 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 8