Tietuekuvaus 1 (7) Tietuekuvaus lähiosoite komponentteina (pilkottuna)
Tietuekuvaus 2 (7) Sisällysluettelo 1 Johdanto... 2 2 Yleiset vaatimukset... 2 3 Toimitettavat tiedot... 2 3.1 Kuvaus toimitettavista tiedoista... 3 4 Esimerkkejä suomalaisista lähiosoitteista... 6 4.1 Osoite yksittäisellä talonumerolla... 6 4.2 Osoite talonumerovälillä... 7 1 Johdanto Tietuekuvaus on tarkoitettu yrityksille ja yhteisöille, jotka käyttävät Postin a ja vastaanottavat aineiston erotinmerkkipohjaisena tai määrämuotoisena kiinteämittaisena tiedostona. Komponenttimuodossa katuosoitteen eri osat, kuten kadunnimi, kiinteistönumero ja porraskirjain esitetään omina erillisinä tietoina. Tietuekuvauksessa kuvataan n tuottamat tiedot. Tietuekuvauksessa Asiakkaalla tarkoitetaan a käyttävän yrityksen tai yhteisön kuluttaja-/yritysasiakkaita tai jäseniä. 2 Yleiset vaatimukset Aineistot toimitetaan ISO-Latin-1 (ISO 8859-1) merkistöllä. Tiedot voidaan toimittaa erotinmerkeillä (;) eroteltuina ts. csv (comma-separated-value)-tiedostona tai kiinteämittaisena txt- tiedostona. Jos tiedonsiirrossa käytetään Kontaktia, niin käytetään erotinmerkeillä eroteltua csv-tiedostoa. 3 Toimitettavat tiedot Posti toimittaa ssa havaitut muutostiedot yritykselle tai yhteisölle tämän kuvauksen mukaisilla tiedostoilla. Yksittäisen muutostapahtuman tiedot tallennetaan yhdelle riville. Erotinmerkkisessä esitystavassa rivin pituus vaihtelee. Puuttuva tieto esitetään kahdella peräkkäisellä puolipisteellä. Kiinteämittaisessa aineistossa rivin pituus on 666 merkkiä. Puuttuva valinnainen tieto korvataan välilyönneillä.
Tietuekuvaus 3 (7) 3.1 Kuvaus toimitettavista tiedoista Pakollinen tieto on kuvattu taulukossa sarakkeessa Pak. ID Sarake Tieto Alkupos. Pituus Pak Selite 1. A Postin tilausasiakasnumero 1 (x) 11 P 2. B Palvelunumero 12 (x) 3 P numero 3. C Tiedon tallennuspäivä 15 (x) 8 P VVVVKKPP. 4. D Asiakkaan tyyppi 23 (x) 1 P 1 = henkilö, 2 = yritys 5. Henkilön nimet Kenttä 4 = 1 5.1. E Nimi 24 (x) 70 5.2. F Henkilön entinen sukunimi 94 (x) 30 6. Yrityksen tai yhteisön nimi Kenttä 4 = 2 6.1. E Yrityksen tai yhteisön yritysnimi 6.2. F Yrityksen tai yhteisön käyttönimi 24 (x) 50 74 (x) 50 7. G Yksilöintitieto 124 (x) 25 Asiakasnumero, kampanjanumero tai muu vastaanottajan yksilöivä tieto. Tämän tiedon perusteella yritys kohdistaa päivitykset oikeaan asiakkaaseensa. 8. H Asiakkaan status 149 (9) 4 0 = kuollut henkilö tai toimintansa päättänyt yritys/yrityksen toimipiste 1 = täysi-ikäinen henkilö tai toimiva yritys/yrityksen toimipiste 2 = alaikäinen henkilö 9 = ei tietoa 9. I Tapahtumakoodi 1) 153 (x) 1 Katso kohta Selitykset. 10. J Osoitteen päivämäärä 154 (x) 8 Asiakkaan osoitteen voimaantulopäivämäärä Postissa. Esitetään muodossa VVVVKKPP. 11. Asiakkaan uusi/korjattu osoite Kotimaan osoite 11.1. K Postinumero 162 (9) 5 11.2. L Postitoimipaikan nimi 167 (x) 30 11.3. M Kadun nimi 197 (x) 50 11.4. N Talonumero-1 247 (x) 5 Saa arvon, kun kiinteistöllä on vain yksi numero, esimerkiksi
Tietuekuvaus 4 (7) Torikatu 3 11.5. O Talojakokirjain-1 252 (x) 1 Saa arvon, kun kiinteistöllä on ns. jakokirjain, esimerkiksi Torikatu 5a 11.6. P Talovälimerkki 253 (x) 1 Arvona on - tai /, ks. kappale 4. 11.7. Q Talonumero-2 254 (x) 5 Saa arvon, kun kiinteistöllä on osoitteessa talonumeroväli, esimerkiksi Mannerheimintie 13-15 11.8. R Talojakokirjain-2 259 (x) 1 Kuten 11.5. 11.9. S Porrastunnus 260 (x) 3 Ilmaisee moniportaisissa kiinteistöissä portaan, esimerkiksi Kirkkokatu 5 A 11.10. T Huoneiston numero 263 (x) 4 Ilmaisee monia huoneistoja sisältävässä kiinteistössä huoneiston. Esimerkiksi Koulukatu 8 F 20 11.11. U Huoneiston jakokirjain 267 (x) 1 Ilmaisee monia huoneistoja sisältävässä kiinteistössä huoneiston. Esimerkiksi Koulukatu 6 A 10a 11.12. V Osoiteperhe-ID 268 (x) 30 Postinjakelupisteen numeerinen tunniste, joka on sama esim. osoitteen eri kieliversioilla tai kulmataloosoitteilla 12. W AH Lähetyksessä ollut osoite 298 (x) 136 Rakenne on sama kuin kentässä 11 (Asiakkaan uusi/korjattu osoite). Kirjoitusasu Postin osoitetietojärjestelmän mukainen. 13. Ulkomaan osoite Kenttä 9 = 3 13.1. AI AJ AK AL Ulkomaan osoite 434 (x) 4*50 Asiakkaan uusi osoite tilanteessa, jossa asiakas on muuttanut ulkomaille. Osoite on tallennettu, kuten henkilö on sen osoitteenmuutosilmoituksessa ilmoittanut. 13.2. AM Maatunnus 634 (x) 3 13.3. AN Maan nimi 637 (x) 30 Selitykset: 1) Tapahtumakoodi Koodi Selitys 0 kielisyys tunnistamatta
Tietuekuvaus 5 (7) 1 suomenkielinen kotimaan osoite 2 ruotsinkielinen kotimaan osoite 3 ulkomaan osoite 4 perillesaamaton lähetys, eli lähetystä ei ole voitu jakaa vastaanottajalle tai se on palautettu Postille 5 uutta osoitetta ei voida toimittaa (osoite ei ole tiedossa tai se on luovutuskiellossa)
Tietuekuvaus 6 (7) 4 Esimerkkejä suomalaisista lähiosoitteista Alla löytyy esimerkkejä suomalaisista lähiosoitteista komponenttimuodossa. Kohdassa 4.1 on esimerkkejä, joissa lähiosoitteessa on yksittäinen talonumero. Kohdassa 4.2 on esimerkkejä, joissa lähiosoite sisältää talonumerovälin. Huom: Postin osoitetietojärjestelmässä ns. asunto-osoitteet ovat talletettu siten, että porraskirjain on tyhjää ja huoneiston numero-kentässä on asunnon numero. Esim. Kadun nimi Koekatu / Provgatan Talonumero-1 5 Porrastunnus tyhjä Huoneiston numero 4 Yrityksen tulee tässä tapauksessa lisätä osoitteen tulostuksessa talonumero-1 ja huoneistonumeron väliin as tai bst osoitteen kielen mukaan. Yllä olevan esimerkin kohdalla on siis tulostettava joko Koekatu 5 as 4 tai Provgatan 5 bst 4. 4.1 Osoite yksittäisellä talonumerolla Esimerkkiosoite Kadun nimi Talonro 1 Pikku-Pukki 1 20100 TURKU Kalliotie 11a 02730 ESPOO Tarkk'ampujankatu 2b A 13 00120 HELSINKI Runeberginkatu 4c As 108 00100 HELSINKI Helsingintie 1a as 24a 49460 HAMINA Tarkk'ampujankatu 5 B 9 00120 HELSINKI Isoympyräkatu 17 A 3a 49400 HAMINA Tarkk'ampujankatu 12 as 45 00120 HELSINKI Pikku-Pukki 1 kirj.-1 Kalliotie 11 a Talonro -2 kirj. -2 Talovälimrk Porrastunnus Hsto nro Tarkk'ampujankatu 2 b A 13 Runeberginkatu 4 c 108 Hston jakokirj. Helsingintie 1 a 24 a Tarkk'ampujankatu 5 B 9 Isoympyräkatu 17 A 3 a Tarkk'ampujankatu 12 45
Tietuekuvaus 7 (7) 4.2 Osoite talonumerovälillä Esimerkkiosoite Kadun nimi Talonro 1 Kehrääjänkatu 6-8 05800 HYVINKÄÄ Majankulmantie 160/10 39810 LINNANKYLÄ Rannankyläntie 4-38a 75890 SARAMO Linnankatu 9b-11a 20100 TURKU Sairaalatie 50b/3 54915 SAIMAANHARJU Erätie 4-6a A 1 74700 KIURUVESI Teiskontie 35z/3 A 19 33520 TAMPERE Lakkakuja 2-4a as 1 40340 JYVÄSKYLÄ Metsätie 25/4 as 3 92430 PAAVOLA Runeberginkatu 14-16 A 1 00100 HELSINKI Onttolantie 20/23 B 4 80510 JOENSUU Kirkkokatu 48-50 B 22b 70100 KUOPIO Runeberginkatu 20-24 As 1 00100 HELSINKI Kauppakatu 40-42 as 22a 70110 KUOPIO kirj.-1 Talonro 2 Kehrääjänkatu 6-8 Majankulmantie 160 / 10 kirj. -2 Rannankyläntie 4-38 a Linnankatu 9 b - 11 a Sairaalatie 50 b / 3 Talovälimrk Porrastunnus Erätie 4-6 a A 1 Hsto nro Teiskontie 35 z / 3 A 19 Lakkakuja 2-4 a 1 Metsätie 25 / 4 3 Runeberginkatu 14-16 A 1 Onttolantie 20 / 23 B 4 Hston jakokirj. Kirkkokatu 48-50 B 22 b Runeberginkatu 20-24 1 Kauppakatu 40-42 22 a