Perintätoimistoliittymä

Transkriptio

1 Perintätoimistoliittymä 1 (28) [Avainsanat] Perintätoimistoliittymä

2 Perintätoimistoliittymä 2 (28) Versiohistoria: Versio Päiväys Muutosperuste Tekijä/Hyväksyjä Alustava versio TJ Versio perintätoimistojen kommentoitavaksi. TJ Täsmennetty toimeksiantoa sekä alustava muutossanoma. TJ Täydennetty saatujen kommenttien perusteella TJ Täydennetty saatujen kommenttien perusteella TJ Täydennetty saatujen kommenttien perusteella TJ Täydennetty muutossanomaa ( lisätty katkaisuvaroituksella ilmoitettu vakuuden määrä). LETL Tarkennettu muutossanoman tilakoodeja Lisätty muutossanomalle kenttä AssignmentEnds LETL Tarkennettu muutossanoman tilakoodeja Lisätty toimeksiantosanomalle kenttä IsConsolidatedInvoice (koontilasku) Lisätty toimeksiantosanomalle kenttä IsFinalInvoice (Loppulasku) Lisätty toimeksiannon muutossanomalle laskutusosoitteen muutos Lisätty toimeksiannon muutossanomalle käyttöpaikan irtikytkentäsääntö ja asiakkaan tyyppi. Lisätty uudet sanomatyypit. TJ TJ TJ LETL Lisätty luottotappion syykoodit TIR Lisätty saatavalle liiketoimintotieto LETL Lisätty uusi toimeksiannon tila CollectionInProgress TIR Päivitetty ajan tasalle TIR

3 Perintätoimistoliittymä 3 (28) Sisältö 1 Johdanto Määrittelydokumentin tarkoitus Enerim CIS perintätoimisto Taulukon notaatio 6 2 Enerim CIS:stä perintätoimistoon siirrettävät tiedot Toimeksianto Ohimaksusuoritukset Muutokset toimeksiantoihin (Maskusopimukset) 7 3 Perintätoimistosta siirrettävät tiedot Toimeksiantojen muutokset Suoritukset 8 4 Sanomien kuvaukset Toimeksiantosanoma Toimeksianto Toimeksiannon kuittaus Toimeksiannon muutossanoma Toimeksiannon muutossanoma Toimeksiannon muutoksen kuittaus Perinnän suoritukset Kohdistusviite Perinnän suorituksen Peräkkäistiedosto (KTL:n pohjalta) Perinnän suorituksen peräkkäissanoman kuittaus Perinnän suorituksen XML rajapinta (NDCAMT54L pohjalta) Perinnän suorituksen XML sanoman kuittaus 25 5 Kooditukset Sopimustyypit Saatavalajit Toimeksiantojen tilat 26

4 Perintätoimistoliittymä 4 (28) 1 Johdanto 1.1 Määrittelydokumentin tarkoitus Tämä määrittelydokumentti täydentää Finvoice osalta Ellarex_WP5_Bill_xml dokumenttiä ja kuvaa perintätoimistoliittymän E3:ssa. 1.2 Enerim CIS perintätoimisto Enerim CIS:stä perintätoimistoon siirrettävät tiedot Toimeksiannot, xml pohjainen rajanpinta (korvaa aiemmin Ellarex 2:ssa käytössä olleet peräkkäistiedostot) Ohimaksusuoritukset Muutokset toimeksiantoihin: Tila (velkajärjestely, konkurssi), sopimukset, nimi/osoitemuutokset (Maskusopimukset) (Vakuudet) Perintätoimistosta siirrettävät tiedot Toimeksiantojen muutokset (tila, osoite, nimi, maksusopimukset) Perinnän suoritukset (pohjautuen pankin peräkkäistiedostoon + xml tiedostoon), täydennettynä käyttöpaikka/sopimus/tyyppitiedoilla (pääoma, korko, maksumuistutus) Irtikytkentäpyynnöt Luottatappioehdokkaat (Vakuuksien kuittaukset) Käytännössä viestintä hoidetaan 3 eri tyyppisellä viestillä 1) Perintätoimistoon lähetettävä toimeksiantosanoma (+kuittaus) 2) Toimeksiannon muutos (+kuittaus) 3) Suoritus (+kuittaus)

5 Perintätoimistoliittymä 5 (28) Energiayhtiö lähettää toimeksiannon perintätoimistolle, toimeksianto voi sisältää tietoja vakuudesta ja irtikytkennästä, mikäli osapuolten sopima prosessi niitä tarvitsee (ei pakollisia tietoja sanomassa) Mikäli Energiayhtiö vastaanottaa lähettämäänsä toimeksiantoon liittyvän suorituksen joko pankista tai suoraan asiakkaalta, päivitetään saatavien tiedot (ja koko suorituksen ollessa kyseessä myös lasku maksetuksi) sekä lähetetään suorituksen tiedot edelleen perintätoimistolle. Mikäli perintä päättyy tässä vaiheessa, kuittaa perintätoimisto toimeksiannon päättyneeksi. Mikäli perintätoimisto vastaanottaa suorituksen, välittää se suorituksen tiedot energiayhtiölle sekä kuittaa tarvittaessa perintätoimeksiannon päättyneeksi. Maksusopimukset hoidetaan rajapinnan ulkopuolisina toiminteina esim. sähköpostitse tai käyttäen rajapinnan viestinvälitystä Perintätoimistosta ei välity ennakoita, pl. Ylisuuret suoritukset.

6 Perintätoimistoliittymä 6 (28) 1.3 Taulukon notaatio XML tiedoston kuvauksessa on käytetty XPath notaatiota Esimerkiksi: <Assignment> <Principal> <Identification>Data<Identification>... </Principal>... </Assignment> Kuvataan: Principal/Identification 2 Enerim CIS:stä perintätoimistoon siirrettävät tiedot 2.1 Toimeksianto Energiayhtiö käynnistää perintätoimeksiannon lähettämällä XML pohjaisen Toimeksiantosanoman perintätoimistoon. Enerim CIS:iin talletetaan tieto perintää hoitavasta tahosta. Toimeksiantosanoman lähettäminen automatisoidaan parametrisoituna, esimerkiksi: Kun perintäuhka on erääntynyt, odotetaan muutama pankkipäivä (parametri) ja nostetaan tapaus työjonolle. Toimeksiantoa muodostettaessa voidaan useampia laskuja yhdistää samalle toimeksiannolle (laskutussopimus, asiakasnumero) esim. loppulaskun lähettämisen jälkeen. Mikäli laskun tulostus ja jakelu on kokonaisuudessaan ulkoistettu, välittyvät tarpeelliset tuodot laskun jakelun yhteydessä, tällöin jokaisesta laskusta muotoutuu oma toimeksianto ja saatavahallinnan moduuleita voidaan käyttää tilanteen seuraamiseen. Tämän lisäksi on mahdollista käyttää myös manuaalista lähetystä (eräpäiväväli, laskun tila, asiakas, laskutusperuste), tällöin kuitataan myös mahdolliset työjonoviestit. Ellarex E2:ssa käytössäolleita päämiesnumeroita ei käytetä (kuluttaja/yritys, sopimus voimassa/ei).

7 Perintätoimistoliittymä 7 (28) Perintätoimisto kuittaa lähetetyn sanoman. Mikäli kuittaus indikoi poikkeustilannetta, viedään tieto työjonolle. OK kuittauksessa talletaan kuittauksen aikaleima Ohimaksusuoritukset Ohimaksusuorituksessa asiakas maksaa suoraan energiayhtiöön perintätoimeksiantona lähetetyn laskun kokonaan tai osittain. Mikäli perintätoimistossa on aktiivinen toimeksianto, välitetään tieto suorituksesta yhtiöstä perintätoimistoon. Samoin menetellään myös, mikäli suoritus tulee pankin kautta ja saatavaan liittyy perintätoimeksianto. Mikäli asiakas maksaa yli laskun suuruisen määrän, välitetään perintätoimistoon alkuperäisen laskun suuruinen suoritus ja kirjataan loput ennakoksi. Mikäli suoritus jää hieman vajaaksi (pyöristyssääntöjen/pienten saldojen sääntöjen puitteissa), toimitetaan perintätoimistoon 2 suoritusta: asiakkaan suorituksen ja pyöristyssuorituksen. Tieto välitetään perintätoimistoon Perinnän suoritus -sanomalla. 2.3 Muutokset toimeksiantoihin Energiayhtiö voi muuttaa toimeksiannosta seuraavia tietoja: Toimeksiannon velallisen nimi- ja osoitetietoja. Toimeksiannon tila Sopimuksien päättyminen Toimeksiantoon liittyen lisätietoja/viestejä 2.4 (Maskusopimukset) Mahdolliset maksusopimukset ja niihin liittyvä tiedonvaihto hoidetaan järjestelmän ulkopuolella esim. sähköposteilla.

8 Perintätoimistoliittymä 8 (28) 3 Perintätoimistosta siirrettävät tiedot 3.1 Toimeksiantojen muutokset Perintätoimisto voi päivittää toimeksiannosta seuraavia tietoja Velallisen nimi- ja osoitetietoja, sisältäen myös sähköpostin ja puhelinnumeron päivitysmahdollisuuden. Toimeksiannon tila Irtikytkentäpyyntö, Enerim CIS:ssä muodostuu ehdotustilainen irtikytkentäpyyntö, joka menee työjonolle. Vakuuksista voidaan välittää tarvittaessa tekstimuotoista informaatiota. Toimeksiantoon liittyen lisätietoja/viestejä, jotka nostetaan työjonolle ja talletetaan toimeksiannon alle. Esimerkkeinä esim. saldotodistuspyyntö, maksusopimukset. Näiden hoitamiseen voidaan tarvittaessa kättää myös rajapinnan ulkopuolisia medioita, esim. sähköpostia, jolloin käsittely hoidetaan järjestelmän ulkopuolella. 3.2 Suoritukset Suorituksen yhteydessä asiakas maksaa perintätoimistoon laskun kokonaan tai osittain. Perintätoimisto voi ohjata laskun saatavien keskinäistä kohdistumista kohdistuviitteen avulla, sen puuttuessa suoritus kohdistetaan koko laskulle.

9 Perintätoimistoliittymä 9 (28) 4 Sanomien kuvaukset 4.1 Toimeksiantosanoma Toimeksianto Elementti Kuvaus ja säännöt Esimerkki Toimeksiannon tunnistetiedot Toimeksiannon yksilöivä tunnus Identification Toimeksiannon muodostamisaika T23:59: Z CreationTimeStamp Principal/ Identification Toimeksiantajan tunnus Toimeksiantajan tunnus perintätoimiston järjestelmässä, arvona käytetään toimeksiantajan y-tunnusta ilman väliviivaa Principal/ PhoneNumber CustomerKey CustomerIdentification CustomerType VatNumber CustomerLanguage CustomerName CustomerName2 Tarkoituksena kertoa perintätoimistolle, kuka on lähettänyt toimeksiannon. Toimeksiantajan puhelinnumero Velallisen tiedot (sopimusasiakas) Velallisen asiakasnumero toimeksiantajan järjestelmässä. Deptor elementissä on sopimusasiakkan tiedot. Perintätoimet kohdistuvat velallisiin, ei laskun vastaanottajaan. Yhden CustomerKeyn alla voi olla useampia velallisia (sisältää minimissään tunnuksen ja nimen) Velallisen tunnus Y-tunnus, henkilötunnus, joissakin tapauksissa syntymäaika Velallisen tyyppi Organisation / Person Velallisen ALV-tunnus Yritykselle Velallisen kieli Kooditus ISO standardin mukaisesti. fi=suomi, sv=ruotsi, en=englanti Velallisen nimi Velallisen c/o nimi Käytössä joissakin tapauksissa esim. asuntoosakeyhtiöillä, kuolinpesillä ja holhouksen alaisilla A Person FI fi Mehiläinen Maija (C/O Matti) Velallisen puhelinnumero

10 Perintätoimistoliittymä 10 (28) PhoneNumber address Address City Zip CountryCode InvoiceHeader/ InvoiceNumber InvoiceHeader/ InvoiceDate InvoiceHeader/ InvoiceDueDate InvoiceHeader/ PaymentReferenceNumber InvoiceHeader/ Amount InvoiceHeader/ BillingAgreement InvoiceHeader/ InterestCalculationDate Velallisen sähköposti. Velallisen katuosoite tai postilokero Montantie 10 Velallisen postitoimipaikka MUHOS Velallisen postinumero Velallisen maakoodi ISO 3166 mukaisesti Laskun tiedot Toimeksiannon laskun numero Laskun alkuperäinen päivä Laskun alkuperäinen eräpäivä Laskun viitenumero Laskun avoin summa Attribute: Ccy="EUR" FI Laskutusperuste (Laskutussopimus) Koronlaskentapäivä Perinnän vakiokorvaus Myöhästymismaksu, käytössä vain yrityksille. Yritykselle on voitu asettaa myöhästymismaksu, 40

11 Perintätoimistoliittymä 11 (28) InvoiceHeader/ LateCharge joka näkyy jollakin laskulla. Tietona näytetään kuittaamatta oleva osuus. Perintätoimisto voi periä lisäkuluja vain ylittävän summan osalta. InvoiceHeader/ InterestRate InvoiceHeader/ InvoicePDF InvoiceHeader/ IsConsolidatedInvoice InvoiceHeader/ IsFinalInvoice InvoiceName InvoiceName2 PhoneNumber address Address City Viivästyskorko % 7,5 Alkuperäisen laskun PDF tiedoston viite Liittymään voidaan parametrisoida, välitetäänko lasku PDF toimeksiannon mukana perintätoimistoon. Onko lasku koontilasku vai ei true=koontilasku false=yhden käyttöpaikan lasku Kentän sisältönä on tieto siitä, onko kyseinen kyseinen lasku koontilasku. Eli mikäli laskutusperuste on koontilaskutusperuste ja lasku ei ole koonti (on vian yksi käyttöpaikka esim. siksi, että toisen käyttöpaikan mittaus on myöhästynyt ja saapunutta käyttöpaikkaa koskeva lasku lähetetään), on tämän kentän arvona laskun mukainen eli false. Onko lasku loppu vai ei true=loppulasku false=ei ole loppulasku Laskun vastaanottaja / Laskulla esiintyneet tiedot (esitetään, vaikka olisi sama kuin velallinen) Laskutusnimi c/o nimi Käytössä joissakin tapauksissa esim. asuntoosakeyhtiöillä, kuolinpesillä ja holhouksen alaisilla pdf false false Mehiläinen Maija (C/O Matti) Puhelinnumero Sähköposti. Katuosoite tai postilokero Montantie 10 Postitoimipaikka maija.mehilainen@outlook.com MUHOS

12 Perintätoimistoliittymä 12 (28) Zip CountryCode ContractObjectIdentifier ContractObjectOwner ContractObjectName DisconnectionRule Postinumero Maakoodi ISO 3166 mukaisesti Saatavan kuvaus Käyttöpaikka/liittymätunnus Tunnus muodostaa yksilöllisen käsitteen yhdessä ContractObjectOwner tiedon kanssa Koontilaskulla voi olla useita käyttöpaikkoja. Käyttöpaikkatunnuksen omistaja Esim. sähkön siirtoyhtiön tunnus FI MON001 Käyttöpaikan nimi (osoite) Montantie 10 Irtikytkennän sääntö Koodistossa irtikytkennän vaihtoehdot Not allowed = Ei saa irtikytkeä Allowed = Irtikytkettävissä NotAllowedDuringWinter = Estetty talvella AllowedRiskOfAccident = Irtikytkettävissä, onnettomuusvaara Allowed DisconnectionLimit ProposedDepositAmount ExistingDeposit Turvaraja Käyttöpaikan irtikytkennän kustannus vaihtelee sen mukaan, onko käyttöpaikka releohjattu vai ei. Toimeksiantoon voidaan liittää turvaraja eli minimi velkamäärä, jolloin irtikytkentä kannattaa suorittaa. Tietoa ei ole Ellarex E2:ssa eikä vielä Enerim CIS E3:ssa, mutta tiedon käyttöönottoon varaudutaan rajapinnassa. Attribute: Ccy= Eur Ennakkotieto vakuussummasta Tieto siitä, paljonko vakuutta pyydetään mahdollisessa irtikytkentätilanteessa. Attribute: Ccy= Eur Onko vakuus olemassa. Saatavarivin tunniste Enerim CIS sisäinen tunniste, ei näy loppuasiakkaalle false

13 Perintätoimistoliittymä 13 (28) Claims/ Claim/ Identification Claims/ ClaimType Claims/ Claim/ Amount Claims/ Claim/ BusinessUnit Claims/ Claim/ Contract/ ContractIdentifier Claims/ Claim/ Contract/ ContractType / Claims/ Claim/ Contract/ ContractActive Claims/ Claim/ Contract/ ContractEndingDate Saatavalaji Saatavarivin summa Attribute: Ccy="EUR" Liiketoiminto Sopimusnumero Sopimuksen tyyppi Sopimuksen on voimassa True=voimassa, false=päättynyt Sopimuksen päättymispäivä (Huom, ei määräaikaisen päättymispäivä) Tyhjä, mikäli sopimus on voimassa. Interest 123,45 Delivering_MON MON_934653M EnergyDelivering false

14 Perintätoimistoliittymä 14 (28) <Assignment> <Identification> </Identification> <CreationTimeStamp> T23:59: Z<CreationTimeStamp> <Principal> <Identification> </Identification> <PhoneNumber> </PhoneNumber> </Principal> <Deptors> <Deptor> <CustomerKey>134110</CustomerKey> <CustomerIdentification> A</CustomerIdentification> <CustomerType>Person</CustomerType> <VatNumber>FI </VatNumber> <CustomerLanguage>fi</CustomerLanguage> <CustomerName>Mehiläinen Maija</CustomerName> <CustomerName2>(C/O Matti)</CustomerName2> <PhoneNumber> </PhoneNumber> <PostalAddressDetails> <Address>Montantie 10</Address> <City>MUHOS</City> <Zip>91500</Zip> <CountryCode>FI</CountryCode> </PostalAddressDetails> </Deptor> <! Mahdollinen toinen Deptor? </Deptors> <Invoices> <Invoice> <InvoiceHeader> <InvoiceNumber> </InvoiceNumber> <InvoiceDate> </InvoiceDate> <InvoiceDueDate> </InvoiceDueDate> <PaymentReferenceNumber> </PaymentReferenceNumber> <Amount>590.27</Amount> <BillingAgreement> </BillingAgreement> <InterestCalculationDate> </InterestCalculationDate> <LateCharge>40</LateCharge> <InterestRate>7,5</InterestRate> <InvoicePDF> pdf</InvoicePDF> <IsConsolidatedInvoice>false</IsConsolidatedInvoice> <IsFinalInvoice>false</IsFinalInvoice> </InvoiceHeader> <InvoiceReceiver> <InvoiceName>Mehiläinen Maija</InvoiceName> <InvoiceName2>(C/O Matti)</InvoiceName2> <PhoneNumber> </PhoneNumber> <PostalAddressDetails> <Address>Montantie 10</Address> <City>MUHOS</City> <Zip>91500</Zip> <CountryCode>FI</CountryCode> </PostalAddressDetails> </InvoiceReceiver> <ContractObjects> <ContractObject> <ContractObjectIdentifier>441382</ContractObjectIdentifier> <ContractObjectOwner>MON001</ContractObjectOwner> <ContractObjectName>Montantie 10</ContractObjectName> <DisconnectionRule>Allowed</DisconnectionRule> <DisconnectionLimit Ccy= Eur">50</DisconnectionLimit> <DepositAmount Ccy="Eur">300</DepositAmount> <ExistingDeposit>false</ExistingDeposit> <Claims> <Claim> <Identification>123456</Identification>

15 Perintätoimistoliittymä 15 (28) <ClaimType>Capital</ClaimType> <Amount Ccy= Eur">123,45</Amount> <Contract> <ContractIdentifier>MON_934653M</ContractIdentifier> <ContractType>EnergyDelivering</ContractType> <ContractActive>false</ContractActive> <ContractEndingDate> </ContractEndingDate> </Contract> </Claim> <!-- Mahdollinen toinen saatavarivi --> </Claims> </ContractObject> </ContractObjects> </Invoice> <!-- Mahdollinen toinen lasku --> </Invoices> </Assignment> Toimeksiannon kuittaus Elementti Kuvaus ja säännöt Esimerkki Toimeksiantokuittauksen tunnistetiedot AssignmentAck/ Toimeksiannon yksilöivä tunnus Identification Vastaanotettu toimeksianto AssignmentAck / Toimeksiannon muodostamisaika T23:59: Z CreationTimeStamp Vastaanotetun toimeksiannon luontiaika kuittaus AssignmentAck / Kuittauskoodi 1 Reason/ Code 1=Tieto vastaanotettu onnistuneesti 2=Error AssignmentAck / Reason/ Kuittauksen muodostumisaika T12:59: Z CreationTimeStamp AssignmentAck / Reason/ Text Kuittauksen ilmoitus selvälielisenä Virhetilanteessa pyritään kuvaamaan epäonnistumisen syy. <AssignmentAck> <Identification> </Identification> <CreationTimeStamp> T23:59: Z<CreationTimeStamp> <Reason> <Code>1</Code> <CreationTimeStamp> T12:59: Z<CreationTimeStamp> <Text>OK</Text> </Reason> </AssignmentAck> OK 4.2 Toimeksiannon muutossanoma Toimeksiannon muutossanoma Energiayhtiö ja perintätoimisto voivat viestiä toisilleen toimeksiantojen tilamuutoksia. Nimi- ja osoitemuutokset suoritetaan lähettämällä uusi Deptor elementti, joka pitää sisällään muuttuneet tiedot sekä vanhat tiedot siltä osin, kun ne

16 Perintätoimistoliittymä 16 (28) ovat vielä voimassa. CustomerKey ja CustomerIdentification elementit ovat avaintietoja ja niitä ei voi päivittää. Elementti Kuvaus ja säännöt Esimerkki Toimeksiannon tunnistetiedot Toimeksiannon yksilöivä tunnus Identification Toimeksiannon muutoksen muodostamisaika T23:59: Z CreationTimeStamp Sanoman lähettäjä Originator Tietona käytetään y-tunnusta ilman väliviivaa. Tilamuutos AssignmentUpdate / Uusi tila Cancelled NewStatus Toimeksiantoa koskeva uusi statustieto AssignmentUpdate / NewStatusDescritpion Tilan tarkenne Esim. estototodistuksen syy Jos uusi tila luottotappioehdokas, niin syykoodi joko tekstillä tai sitä vastaavalla koodinumerolla (suluissa): - Konkurssi (84001) - Perintä ei ole johtanut tulokseen (84002) - Muu syy (84003) - Velkajärjestely (84004) - Pieni pääoma/ei maksukykyä (84005) - Asiakas varaton (84006) - Vanhentunut saatava (84008) AssignmentUpdate / AssignmentEnds AssignmentUpdate / Information CustomerKey CustomerIdentification Kertoo päättyykö toimeksianto tämän laskun osalta tähän vai jatkuuko se edelleen. Toimeksiannon lisäinformaatio Vapaamuotoinen lisäinformaatio toimeksiannolle, voidaan käyttää esim. saldonhallintatodistuksien käsittelyssä Velallisen tiedot (sopimusasiakas) Velallisen asiakasnumero toimeksiantajan järjestelmässä. Deptor elementissä on sopimusasiakkan tiedot. Velallisen tunnus Y-tunnus, henkilötunnus, joissakin tapauksissa syntymäaika true/false Vapaata infoa A Velallisen nimi Mehiläinen Maija CustomerName Velallisen c/o nimi (C/O Matti)

17 Perintätoimistoliittymä 17 (28) CustomerName2 PhoneNumber address Address City Zip CountryCode CustomerType InvoiceHeader/ InvoiceNumber InvoiceName InvoiceName2 PhoneNumber address Käytössä joissakin tapauksissa esim. asuntoosakeyhtiöillä, kuolinpesillä ja holhouksen alaisilla Velallisen puhelinnumero Velallisen sähköposti.. Velallisen katuosoite tai postilokero Montantie 10 Velallisen postitoimipaikka MUHOS Velallisen postinumero Velallisen maakoodi ISO 3166 mukaisesti Velallisen tyyppi Organisation / Person FI Person Laskun vastaanottaja / Laskulla esiintyneet tiedot Toimeksiannon laskun numero Laskutusnimi c/o nimi Käytössä joissakin tapauksissa esim. asuntoosakeyhtiöillä, kuolinpesillä ja holhouksen alaisilla Mehiläinen Maija (C/O Matti) Puhelinnumero Sähköposti. Katuosoite tai postilokero Montantie 10 maija.mehilainen@outlook.com

18 Perintätoimistoliittymä 18 (28) Address City Zip CountryCode ContractObjectIdentifier ContractObjectOwner DisconnectionRequested DisconnectionLimit DepositAmountOnRequest DepositDescription DisconnectionRule Postitoimipaikka MUHOS Postinumero Maakoodi ISO 3166 mukaisesti Saatavan kuvaus Käyttöpaikka/liittymätunnus Tunnus muodostaa yksilöllisen käsitteen yhdessä ContractObjectOwner tiedon kanssa Koontilaskulla voi olla useita käyttöpaikkoja. Käyttöpaikkatunnuksen omistaja Esim. sähkön siirtoyhtiön tunnus Irtikytkentäpyyntö Käyttöpaikkaan kohdistuu irtikytkentäpyyntö Turvaraja rajapinnassa. Attribute: Ccy= Eur Vakuuden määrä Katkaisuvaroituksella ilmoitettu vakuuden määrä, joka on maksettava ennen takaisinkytkentää Vakuus Info energiayhtiölle, esim.. Kuitatkaa vakuudesta, osin irtikytkennän sijasta Irtikytkennän sääntö Koodistossa irtikytkennän vaihtoehdot Not allowed = Ei saa irtikytkeä Allowed = Irtikytkettävissä NotAllowedDuringWinter = Estetty talvella AllowedRiskOfAccident = Irtikytkettävissä, onnettomuusvaara FI MON001 True Allowed Contracts/ Contract/ ContractIdentifier Contracts/ Contract/ ContractType Sopimusnumero Sopimuksen tyyppi MON_934653M EnergyDelivering

19 Perintätoimistoliittymä 19 (28) / Contracts/ Contract/ ContractActive Contracts/ Contract/ ContractEndingDate Sopimuksen on voimassa True=voimassa, false=päättynyt Sopimuksen päättymispäivä (Huom, ei määräaikaisen päättymispäivä) Tyhjä, mikäli sopimus on voimassa. false Toimeksiannon muutoksen kuittaus Elementti Kuvaus ja säännöt Esimerkki Toimeksiannon tunnistetiedot Toimeksiannon yksilöivä tunnus Identification Toimeksiannon muutoksen muodostamisaika T23:59: Z CreationTimeStamp Kuittaus AssignmentUpdateAck / Reason/ Code Kuittauskoodi 1=Tieto vastaanotettu onnistuneesti 2=Error 1 AssignmentUpdateAck / Reason/ CreationTimeStamp AssignmentUpdateAck / Reason/ Text 3=.. Tähän täsmennetään tunnistettuja tilanteita. Kuittauksen muodostumisaika Kuittauksen ilmoitus selvälielisenä Virhetilanteessa pyritään kuvaamaan epäonnistumisen syy T12:59: Z OK 4.3 Perinnän suoritukset Perinnän suoritukset pohjautuu pankin KTL peräkkäistiedostoon sekä CAMT XML tiedostoon Kohdistusviite Mikäli suoritus poikkeaa toimeksiannon mukaisesta laskusta, voidaan kulujen kohdistus suorittaa kohdistusviitteen avulla. Kohdistusviitteen tietoina käytetään toimeksiantonumeroa, välimerkki + sekä 1) joko toimeksiannon mukana saatua saatavarivin tunnistetta (numeerinen) 2) tai tekstuaalisen toimeksiantoa täydentävänä tekstinä saatavalaji ja mahdollinen tuotekoodi (joka on sovittu perintätoimiston kanssa) Esim

20 Perintätoimistoliittymä 20 (28) Kohdistusviitteen jälkimmäinen osa voidaan jättää nollaksi, mikäli suoritus vastaa toimeksiannon mukaista laskua tai summaa ei haluta kohdistaa tarkemmin. Toimeksiannosta löytyy saatavarivin tunnisteen takaa tieto käyttöpaikasta (verkkotunnus+tunnus), sopimuksesta sekä saatavalajista (pääoma, korko, kulu) Perinnän suorituksen Peräkkäistiedosto (KTL:n pohjalta) Peräkkäistiedosto pohjautuu pankien määrittelemään KTL kuvaukseen. KTL kuvaus ei tue SEPA maskujen uusia tietoja, tilinumerot ovat BBANmuodossa. Viitetuki rajoittuu suomalaiseen viitteeseen. Erätietue (0) Tapahtumatietuetta on laajennettu KTL kuvauksesta kohdistusviitteellä ja tietutunniste muutettu (3->4). Peräkkäistiedoston asemasta suositellaan käytetäväksi XML pohjaista rajapintaa, KTL peräkkäistiedosto on tarkoitettu lähinnä määrittelyvaiheen tueksi ja tavoitteena on, että rajapintana käytetään XML pohjaista rajapintaa. Positio (pituus) Kuvaus Esimerkki 1-1 (pituus 1) Tietueen tunniste (0) (pituus 6) Aineoston päiväys (YYMMDD) (pituus 4) Aineiston kellonaika (HH24MI) (pituus 2) Lähettävä rahalaitos, ei käytössä perintärajapinnassa (pituus 9) Välittäjän (perintätoimiston) tunnus (y-tunnus tai y tunnus ilman väliviivaa etunollalla varustettuna (pituus 1) Rahayksikön koodi, 1=Euro (pituus 9) Tilinomistajan tunnus, ei käytössä perintärajapinnassa 0 / (pituus 58) Ei käytössä, suositus nollia, voi jättää myös tyhjäksi. Perinnän tapahtumatietue (4) Positio (pituus) Kuvaus Esimerkki 1-1 (pituus 1) Tietueen tunniste (4). 4 Huom, KTL:ssä tunniste on (pituus 14) Toimeksiantajan tilinumero Huom, BBAN muodossa 14 numeroisena (pituus 6) Kirjauspäivä (YYMMDD) (pituus 6) Maksupäivä (YYMMDD) (pituus 16) Arkistointitunnus (esim. Lähettäjän viite 7 merkkiä, yhtiötunnus 4 merkkiä) (pituus 20) Viitenumero (pituus 12) Maksajan nimi (lyhennetty, mikäli yli 12 merkkiä) Mehiläinen M (pituus 1) Valuutta, 1=Euro 1

21 Perintätoimistoliittymä 21 (28) (pituus 1) Maksajan nimen lähde (A=Asiakkaalta J koneellisesti, J= pankin rekisteristä tilinumeron perusteella, K=pankin konttorissa näppäilty). Käytetään J (pituus 10) Rahamäärä, ilmoitetaan sentteinä (pituus 1) Oikaisutunnus, 0=normaali, 1=oikaisutapahtuma, 0 käytetään (pituus 1) Maksun välitystapa, (A=Asiakkaalta koneellisesti, J J= pankin rekisteristä tilinumeron perusteella, K=pankin konttorissa näppäilty). Käytetään J (pituus 1) Palautekoodi, ei käytössä (pituus 40) Kohdistusviite. katso selitys yläpuolisesta kappaleesta. Huom: tämä kenttä poikkeaa KTL:stä Summatietue (9) Positio (pituus) Kuvaus Esimerkki 1-1 (pituus 1) Tietueen tunniste (9) (pituus 6) Tapahtumien kappalemäärä (pituus 11) Maksujen rahamäärä, tilitettävä pääoma yhteensä sentteinä (pituus 6) Oikaisujen kappalemäärä, Ei käytössä (pituus 11) Oikaisujen rahamäärä, Ei käytössä (pituus 6+11) Ei käytössä (pituus 38) Varalla, ei käytössä Ei käytössä, suositus nollia, voi jättää myös tyhjäksi Perinnän suorituksen peräkkäissanoman kuittaus Peräkkäistiedosto on jäämässä pois, sille ei rakenneta kuittaussanomaa Perinnän suorituksen XML rajapinta (NDCAMT54L pohjalta) XML tiedosto pohjautuu pankien määrittelemään camt kuvaukseen. Sanomassa voi olla useita Entryjä (Ntry) ja niissä yksi TransaktioDetails (TxDtls). Normaalissa tapauksessa yhden laskun suoritus = Entry. Mikäli yhdelle laskulle tulee useampia tapahtumia (esim. kohdistetaan maksu osaan laskun riveistä), tehdään jokaisesta kohdistuksesta oma Entry/TransaktionDetails ja tarkempi kohdistaminen suoritetaan kohdistusviitteen (NtryRef) elementin pohjalta (eli yhdestä laskusta tulee useampi entry). Toinen vaihtoehto olisi ollut käyttää yhtä Entryä ja useampaa TransaktioDetails elementtiä, mutta soveltuvaa kohdistusviitteen elementtiä ei ole tunnistettu TransaktioDetailsin alta. Elementti Kuvaus ja säännöt Esimerkki Tiedoston luonnissa muodostettu tunniste GrpHdr/ MsgId Tiedoston noutohetki T23:59: Z

22 Perintätoimistoliittymä 22 (28) GrpHdr/ CreDtTm Id CreDtTm Acct/ Id/ IBAN TxsSummry/ TtlCdtNtries/ NbOfNtries TxsSummry/ TtlNtries/ Sum NtryRef Amt CdtDbtInd Sts BookgDt/ Dt ValDt/ Dt NtryDtls/ Refs/ EndToEndId BkTxCd/ Domn/ Cd BkTxCd/ Viestin yksilöivä tunniste (vähintään 3 kk ajan) Tapahtumaraportin luontiaika IBAN Tapahtumien (panojen) lukumäärä sanomassa 1234 Tapahtumien (panojen) summa euroissa Kohdistusviite. Huom: tämä kenttä ei ole käytössä normaalissa pankkiaineistossa. Suorituksen summa euroissa Attribute: Ccy="EUR" Credit/Debit CRDT=Pano, DBIT=Otto Status BOOK=kirjattu tilille T23:59: Z FI CRDT BOOK Kirjauspäivä Arvopäivä (maksupäivä) Viitenumero PMNT = maksut RCDT = hyvitetyt tilisiirrot NTAV = ei tiedossa PMNT RCDT

23 Perintätoimistoliittymä 23 (28) Fmly/ Cd BkTxCd/ Fmly/ SubFmlyCd TxDtls/ Refs/ AcctSvcrRef TxDtls/ AmtDtls/ TxAmt/ Amt TxDtls/ RltdPties/ Dbtr/ Nm TxDtls/ RmtInf/ Strd/ CdtrRefInf/ Tp/ CdOrPrtry/ Cd TxDtls/ RmtInf/ Strd/ CdtrRefInf/ Tp/ CdOrPrtry/ Ref TxDtls/ RltdDts/ AccptncDtTm ESCT = SEPA-tilisiirto NTAV = ei tiedossa NTAV Arkistotunnus Rahamäärä euroina Attribuutti: Ccy="EUR Rakenteessa Entry=TransacitonDetails, joten tieto esiintyy tuplana. Maksajan nimi SCOR=rakenteellinen viite Viitenumero (Suomalainen) RF viitteessä pitää välittää myös elementti Issr/ISO. Maksupäivä Rakenteessa Entry=TransacitonDetails, joten tieto esiintyy tuplana Maija Mehiläinen SCOR T00:00:00 <?xml version="1.0"?> <Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt " xmlns:xsd=" xmlns:xsi=" <BkToCstmrDbtCdtNtfctn> <GrpHdr> <MsgId> </MsgId> <CreDtTm> T07:16: Z</CreDtTm> </GrpHdr> <Ntfctn>

24 Perintätoimistoliittymä 24 (28) <Id>1</Id> <CreDtTm> T10:16: Z</CreDtTm> <Acct> <Id> <IBAN>FI </IBAN> </Id> </Acct> <TxsSummry> <TtlCdtNtries> <NbOfNtries>1</NbOfNtries> <Sum>590.27</Sum> </TtlCdtNtries> </TxsSummry> <Ntry> <NtryRef> </NtryRef> <Amt Ccy="EUR">590.27</Amt> <CdtDbtInd>CRDT</CdtDbtInd> <Sts>BOOK</Sts> <BookgDt> <Dt> </Dt> </BookgDt> <ValDt> <Dt> </Dt> </ValDt> <BkTxCd> <Domn> <Cd>PMNT</Cd> <Fmly> <Cd>RCDT</Cd> <SubFmlyCd>NTAV</SubFmlyCd> </Fmly> </Domn> </BkTxCd> <NtryDtls> <TxDtls> <Refs> <AcctSvcrRef>19943f8c9d9b43d0894f644fe3ac0aa0</AcctSvcrRef> </Refs> <AmtDtls> <TxAmt> <Amt Ccy="EUR">590.27</Amt> </TxAmt> </AmtDtls> <RltdPties> <Dbtr> <Nm>Mehiläinen Maija</Nm> </Dbtr> </RltdPties> <RmtInf> <Strd> <CdtrRefInf> <Tp> <CdOrPrtry> <Cd>SCOR</Cd> </CdOrPrtry> </Tp> <Ref> </Ref> </CdtrRefInf> </Strd> </RmtInf> <RltdDts> <AccptncDtTm> T00:00:00</AccptncDtTm> </RltdDts> </TxDtls> </NtryDtls> </Ntry> <!-- Toinen tapahtuma

25 Perintätoimistoliittymä 25 (28) <Ntry>... </Ntry> --> </Ntfctn> </BkToCstmrDbtCdtNtfctn> </Document> Perinnän suorituksen XML sanoman kuittaus Elementti Perinnän suoritussanoman tunnistetiedot Esimerkki BkToCstmrAcctRptAck/ GrpHdr/ MsgId Enerim lähettää tässä kentässä ohisuoritussanomassa tunnisteen: toimeksiantotunniste+suoritustunniste _ BkToCstmrAcctRptAck/ Reason/ Code BkToCstmrAcctRptAck/ Reason/ CreationTimeStamp BkToCstmrAcctRptAck/ Reason/ Text Tämä pitää palauttaa samassa arvossa kuittaussanomassa, jotta kuittaus voidaan kohdistaa oikeaan toimeksiantoon ja suoritukseen kuittaus Kuittauskoodi 1=Tieto vastaanotettu onnistuneesti 2=Error Kuittauksen muodostumisaika Kuittauksen ilmoitus selvälielisenä Virhetilanteessa pyritään kuvaamaan epäonnistumisen syy T12:59: Z OK <?xml version= 1.0 encoding= UTF-8?> <BkToCstmrAcctRptAck> <GrpHdr> <MsgId> _ </MsgId> </GrpHdr> <Reason> <Code>1</Code> <CreationTimeStamp> T12:59: Z</CreationTimeStamp> <Text>OK</Text> </Reason> </BkToCstmrAcctRptAck> 5 Kooditukset 5.1 Sopimustyypit EnergySelling EnergyDelivering HeatSelling WaterSelling GasSelling GasDelivering SteamSelling 1 Sähkön myyntisopimus 2 Sähkön siirtosopimus 3 Kaukolämmön myyntisopimus 4 Veden myyntisopimus 5 Kaasun myyntisopimus 6 Kaasun siirtosopimus 7 Höyryn myyntisopimus

26 Perintätoimistoliittymä 26 (28) EnergyJunction HeatConnection WaterJunction GasJunction SteamJunction LocalHeatSelling EnergyJunctionMaintenance HeatContract ProductionEnergySelling ProductionEnergyDelivering GasContract SteamContract AreaNetworkEnergyDelivering OtherContract HeatMaintenance GasMaintenance 8 Sähkön liittymissopimus 9 Kaukolämmön liittymissopimus 10 Veden liittymissopimus 11 Kaasun liittymissopimus 12 Höyryn liittymissopimus 13 Aluelämmön myyntisopimus 14 Sähköliittymän ylläpitosopimus 15 Lämpösopimus 16 Tuotannon myyntisopimus 17 Tuotannon siirtosopimus 18 Kaasusopimus 19 Höyrysopimus 20 Alueverkko siirtosopimus 21 Muu sopimus 22 Kaukolämmön ylläpitosopimus 23 Kaasun ylläpitosopimus 5.2 Saatavalajit Capital = Pääoma Interest = Korko Security = Kulu Security2 = Maksusopimuskulu 5.3 Toimeksiantojen tilat Tilamuutokset Perintätoimistolta Energiayhtiölle: - Odottaa lisätietoja (WaitingForInformation) - varattu Energiayhtiön ja Perintätoimiston väliseen viestintään - käyttötapaukset tarkentuvat myöhemmin - Maksumuistutus lähetetty (PaymentReminderSent) - Maksuvaatimus lähetetty (CollectionThreatSent) - Katkaisuvaroitus lähetetty (DisconnectionThreatSent) - Maksettu (Paid) - tieto toimeksiannon päättymisestä kerrotaan erillisessä kentässä - Irtikytkettäväksi (DisconnectionCandidate) - erillisessä kentässä kerrotaan, päättyykö toimeksianto vai ei - Luottotappioehdokas (CreditLossCandidate) - tarkempi syy Tilan tarkenne kentässä - tieto toimeksiannon päättymisestä kerrotaan erillisessä kentässä - Siirretty perintään (CollectionInProgress)

27 Perintätoimistoliittymä 27 (28) - toimeksianto siirtyy pikaperinnästä tavalliseen perintään, jolloin laksujen tilat päivitetään tilaan Perintätoimiston perittävänä Tilamuutokset Energiayhtiöltä Perintätoimistolle: - Peruttu (Cancelled) - tarkempi syy Tilan tarkenne-kentässä - tieto toimeksiannon päättymisestä kerrotaan erillisessä kentässä - Odottaa lisätietoja (WaitingForInformation) - varattu Energiayhtiön ja Perintätoimiston väliseen viestintään - käyttötapaukset tarkentuvat myöhemmin - Katkaisua ei suoritettu (NotDisconnected) - tarkempi syy Tilan tarkenne kentässä - Sopimus päättynyt (ContractEnded) - Sanomalla lähtee tieto, että käyttöpaikan sopimus on päättynyt sekä sopimuksen päättymispäivä. / Contracts/ Contract/ ContractActive Contracts/ Contract/ ContractEndingDate Sopimuksen on voimassa True=voimassa, false=päättynyt Sopimuksen päättymispäivä (Huom, ei määräaikaisen päättymispäivä) Tyhjä, mikäli sopimus on voimassa. True Asiakkaan tyyppi muuttunut (CustomerTypeChanged) - Jos asiakkaan tyyppi (Kuluttaja/Yritys) muuttuu, ja asiakkaalla on voimassaolevia perintätoimeksiantoja, lähtee toimeksiannoille muutosviesti asiakkaan tyypin muutoksesta. Viestissä välittyy uusi asiakastyyppi. CustomerType Velallisen tyyppi Organisation / Person Person - Iritkytkentätapa muuttunut (DisconnectionRuleChanged) - Lämmitystavan muutoksen yhteydessä käyttäjä päivittää käyttöpaikan voimassaolevan sopimuksen irtikytkentäsääntöä. Mikäli sopimukseen liittyy voimassaolevia toimeksiantoja, perintätoimistoon välittyy tieto irtikytklentäsäännön muuttumisesta. DisconnectionRule Irtikytkennän sääntö Koodistossa irtikytkennän vaihtoehdot Not allowed = Ei saa irtikytkeä Allowed = Irtikytkettävissä NotAllowedDuringWinter = Estetty talvella AllowedRiskOfAccident = Irtikytkettävissä, onnettomuusvaara Allowed

28 Perintätoimistoliittymä 28 (28) - Kytketty (Connected) - Toimeksiantoon liittyvä käyttöpaikka Kytketty - Irtikytketty (Disconnected) - Toimeksiantoon liittyvä käyttöpaikka Irtikytketty