Perintätoimistoliittymä

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

Perintätoimistoliittymä 2 (28) Versiohistoria: Versio Päiväys Muutosperuste Tekijä/Hyväksyjä 0.90 2014-09-12 Alustava versio TJ 0.91 2014-09-19 Versio perintätoimistojen kommentoitavaksi. TJ 0.92 2014-09-29 Täsmennetty toimeksiantoa sekä alustava muutossanoma. TJ 0.93 2014-10-05 Täydennetty saatujen kommenttien perusteella TJ 0.94 2014-10-10 Täydennetty saatujen kommenttien perusteella TJ 0.95 2014-10-22 Täydennetty saatujen kommenttien perusteella TJ 0.96 2015-01-20 Täydennetty muutossanomaa ( lisätty katkaisuvaroituksella ilmoitettu vakuuden määrä). LETL Tarkennettu muutossanoman tilakoodeja 0.97 2015-01-22 Lisätty muutossanomalle kenttä AssignmentEnds LETL Tarkennettu muutossanoman tilakoodeja 0.98 2015-02-06 Lisätty toimeksiantosanomalle kenttä IsConsolidatedInvoice (koontilasku) 0.99 2015-03-20 Lisätty toimeksiantosanomalle kenttä IsFinalInvoice (Loppulasku) 1.00 2015-07-01 Lisätty toimeksiannon muutossanomalle laskutusosoitteen muutos 1.01 2016-04-17 Lisätty toimeksiannon muutossanomalle käyttöpaikan irtikytkentäsääntö ja asiakkaan tyyppi. Lisätty uudet sanomatyypit. TJ TJ TJ LETL 1.02 2016-05-30 Lisätty luottotappion syykoodit TIR 1.03 2016-09-20 Lisätty saatavalle liiketoimintotieto LETL 1.04 2016-11-17 Lisätty uusi toimeksiannon tila CollectionInProgress TIR 1.05 2017-04-05 Päivitetty ajan tasalle TIR

Perintätoimistoliittymä 3 (28) Sisältö 1 Johdanto 4 1.1 Määrittelydokumentin tarkoitus 4 1.2 Enerim CIS perintätoimisto 4 1.3 Taulukon notaatio 6 2 Enerim CIS:stä perintätoimistoon siirrettävät tiedot 6 2.1 Toimeksianto 6 2.2 Ohimaksusuoritukset 7 2.3 Muutokset toimeksiantoihin 7 2.4 (Maskusopimukset) 7 3 Perintätoimistosta siirrettävät tiedot 8 3.1 Toimeksiantojen muutokset 8 3.2 Suoritukset 8 4 Sanomien kuvaukset 9 4.1 Toimeksiantosanoma 9 4.1.1 Toimeksianto 9 4.1.2 Toimeksiannon kuittaus 15 4.2 Toimeksiannon muutossanoma 15 4.2.1 Toimeksiannon muutossanoma 15 4.2.2 Toimeksiannon muutoksen kuittaus 19 4.3 Perinnän suoritukset 19 4.3.1 Kohdistusviite 19 4.3.2 Perinnän suorituksen Peräkkäistiedosto (KTL:n pohjalta) 20 4.3.3 Perinnän suorituksen peräkkäissanoman kuittaus 21 4.3.4 Perinnän suorituksen XML rajapinta (NDCAMT54L pohjalta) 21 4.3.5 Perinnän suorituksen XML sanoman kuittaus 25 5 Kooditukset 25 5.1 Sopimustyypit 25 5.2 Saatavalajit 26 5.3 Toimeksiantojen tilat 26

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)

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.

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).

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.. 2.2 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.

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.

Perintätoimistoliittymä 9 (28) 4 Sanomien kuvaukset 4.1 Toimeksiantosanoma 4.1.1 Toimeksianto Elementti Kuvaus ja säännöt Esimerkki Toimeksiannon tunnistetiedot Toimeksiannon yksilöivä tunnus 12345678 Identification Toimeksiannon muodostamisaika 2014-12-31T23:59:59.99999Z CreationTimeStamp Principal/ Identification Toimeksiantajan tunnus Toimeksiantajan tunnus perintätoimiston järjestelmässä, arvona käytetään toimeksiantajan y-tunnusta ilman väliviivaa. 12345678 Principal/ PhoneNumber CustomerKey CustomerIdentification CustomerType VatNumber CustomerLanguage CustomerName CustomerName2 Tarkoituksena kertoa perintätoimistolle, kuka on lähettänyt toimeksiannon. Toimeksiantajan puhelinnumero 0401234567 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 639-1 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 134110 010150-123A Person FI1234567 fi Mehiläinen Maija (C/O Matti) Velallisen puhelinnumero. 0401234567

Perintätoimistoliittymä 10 (28) PhoneNumber Emailaddress 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 maija.mehilainen@outlook.com MUHOS Velallisen postinumero 91500 Velallisen maakoodi ISO 3166 mukaisesti Laskun tiedot Toimeksiannon laskun numero 12130001254 Laskun alkuperäinen päivä 20131012 Laskun alkuperäinen eräpäivä 20131030 Laskun viitenumero 121300012541341109 Laskun avoin summa Attribute: Ccy="EUR" FI 590.27 Laskutusperuste (Laskutussopimus). 2001268550 Koronlaskentapäivä 20131105 Perinnän vakiokorvaus Myöhästymismaksu, käytössä vain yrityksille. Yritykselle on voitu asettaa myöhästymismaksu, 40

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 Emailaddress 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 12130001254.pdf false false Mehiläinen Maija (C/O Matti) Puhelinnumero 0407654321 Sähköposti. Katuosoite tai postilokero Montantie 10 Postitoimipaikka maija.mehilainen@outlook.com MUHOS

Perintätoimistoliittymä 12 (28) Zip CountryCode ContractObjectIdentifier ContractObjectOwner ContractObjectName DisconnectionRule Postinumero 91500 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 441382 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 50 300 false 123456

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 20110120

Perintätoimistoliittymä 14 (28) <Assignment> <Identification>12345678</Identification> <CreationTimeStamp>2014-12-31T23:59:59.99999Z<CreationTimeStamp> <Principal> <Identification>12345678</Identification> <PhoneNumber>0401234567</PhoneNumber> </Principal> <Deptors> <Deptor> <CustomerKey>134110</CustomerKey> <CustomerIdentification>010150-123A</CustomerIdentification> <CustomerType>Person</CustomerType> <VatNumber>FI1234567</VatNumber> <CustomerLanguage>fi</CustomerLanguage> <CustomerName>Mehiläinen Maija</CustomerName> <CustomerName2>(C/O Matti)</CustomerName2> <PhoneNumber>0401234567</PhoneNumber> <Emailaddress>maija.mehilainen@outlook.com</Emailaddress> <PostalAddressDetails> <Address>Montantie 10</Address> <City>MUHOS</City> <Zip>91500</Zip> <CountryCode>FI</CountryCode> </PostalAddressDetails> </Deptor> <! Mahdollinen toinen Deptor? </Deptors> <Invoices> <Invoice> <InvoiceHeader> <InvoiceNumber>12130001254</InvoiceNumber> <InvoiceDate>20131012</InvoiceDate> <InvoiceDueDate>20131030</InvoiceDueDate> <PaymentReferenceNumber>121300012541341109</PaymentReferenceNumber> <Amount>590.27</Amount> <BillingAgreement>2001268550</BillingAgreement> <InterestCalculationDate>20131105</InterestCalculationDate> <LateCharge>40</LateCharge> <InterestRate>7,5</InterestRate> <InvoicePDF>12130001254.pdf</InvoicePDF> <IsConsolidatedInvoice>false</IsConsolidatedInvoice> <IsFinalInvoice>false</IsFinalInvoice> </InvoiceHeader> <InvoiceReceiver> <InvoiceName>Mehiläinen Maija</InvoiceName> <InvoiceName2>(C/O Matti)</InvoiceName2> <PhoneNumber>0407654321</PhoneNumber> <Emailaddress>maija.mehilainen@outlook.com</Emailaddress> <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>

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>20110120</ContractEndingDate> </Contract> </Claim> <!-- Mahdollinen toinen saatavarivi --> </Claims> </ContractObject> </ContractObjects> </Invoice> <!-- Mahdollinen toinen lasku --> </Invoices> </Assignment> 4.1.2 Toimeksiannon kuittaus Elementti Kuvaus ja säännöt Esimerkki Toimeksiantokuittauksen tunnistetiedot AssignmentAck/ Toimeksiannon yksilöivä tunnus 12345678 Identification Vastaanotettu toimeksianto AssignmentAck / Toimeksiannon muodostamisaika 2014-12-31T23:59:59.99999Z CreationTimeStamp Vastaanotetun toimeksiannon luontiaika kuittaus AssignmentAck / Kuittauskoodi 1 Reason/ Code 1=Tieto vastaanotettu onnistuneesti 2=Error AssignmentAck / Reason/ Kuittauksen muodostumisaika 2015-01-01T12:59:59.12345Z CreationTimeStamp AssignmentAck / Reason/ Text Kuittauksen ilmoitus selvälielisenä Virhetilanteessa pyritään kuvaamaan epäonnistumisen syy. <AssignmentAck> <Identification>12345678</Identification> <CreationTimeStamp>2014-12-31T23:59:59.99999Z<CreationTimeStamp> <Reason> <Code>1</Code> <CreationTimeStamp>2015-01-01T12:59:59.12345Z<CreationTimeStamp> <Text>OK</Text> </Reason> </AssignmentAck> OK 4.2 Toimeksiannon muutossanoma 4.2.1 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

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 12345678 Identification Toimeksiannon muutoksen muodostamisaika 2014-12-31T23:59:59.99999Z CreationTimeStamp Sanoman lähettäjä 23456789 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 134110 010150-123A Velallisen nimi Mehiläinen Maija CustomerName Velallisen c/o nimi (C/O Matti)

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

Perintätoimistoliittymä 18 (28) Address City Zip CountryCode ContractObjectIdentifier ContractObjectOwner DisconnectionRequested DisconnectionLimit DepositAmountOnRequest DepositDescription DisconnectionRule Postitoimipaikka MUHOS Postinumero 91500 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 441382 MON001 True 50 200 Allowed Contracts/ Contract/ ContractIdentifier Contracts/ Contract/ ContractType Sopimusnumero Sopimuksen tyyppi MON_934653M EnergyDelivering

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 20110120 4.2.2 Toimeksiannon muutoksen kuittaus Elementti Kuvaus ja säännöt Esimerkki Toimeksiannon tunnistetiedot Toimeksiannon yksilöivä tunnus 12345678 Identification Toimeksiannon muutoksen muodostamisaika 2014-12-31T23:59:59.99999Z 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. 2015-01-01T12:59:59.12345Z OK 4.3 Perinnän suoritukset Perinnän suoritukset pohjautuu pankin KTL peräkkäistiedostoon sekä CAMT XML tiedostoon. 4.3.1 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. 12345678+123456

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). 4.3.2 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) 0 2-7 (pituus 6) Aineoston päiväys (YYMMDD) 141231 8-11 (pituus 4) Aineiston kellonaika (HH24MI) 2359 12-13 (pituus 2) Lähettävä rahalaitos, ei käytössä perintärajapinnassa 14 22 (pituus 9) Välittäjän (perintätoimiston) tunnus (y-tunnus tai y- 1234567-8 tunnus ilman väliviivaa etunollalla varustettuna 23-23 (pituus 1) Rahayksikön koodi, 1=Euro 1 24-32 (pituus 9) Tilinomistajan tunnus, ei käytössä perintärajapinnassa 0 / 33-90 (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 3. 2-15 (pituus 14) Toimeksiantajan tilinumero. 12345678901234 Huom, BBAN muodossa 14 numeroisena. 16-21 (pituus 6) Kirjauspäivä (YYMMDD) 141231 22-27 (pituus 6) Maksupäivä (YYMMDD) 141231 28-43 (pituus 16) Arkistointitunnus (esim. Lähettäjän viite 7 merkkiä, 12345671234 yhtiötunnus 4 merkkiä) 44-63 (pituus 20) Viitenumero 12100012549 64-75 (pituus 12) Maksajan nimi (lyhennetty, mikäli yli 12 merkkiä) Mehiläinen M 76-76 (pituus 1) Valuutta, 1=Euro 1

Perintätoimistoliittymä 21 (28) 77-77 (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 78-87 (pituus 10) Rahamäärä, ilmoitetaan sentteinä. 0000059027 88-88 (pituus 1) Oikaisutunnus, 0=normaali, 1=oikaisutapahtuma, 0 käytetään 0. 89-89 (pituus 1) Maksun välitystapa, (A=Asiakkaalta koneellisesti, J J= pankin rekisteristä tilinumeron perusteella, K=pankin konttorissa näppäilty). Käytetään J 90-90 (pituus 1) Palautekoodi, ei käytössä. 91-130 (pituus 40) Kohdistusviite. katso selitys yläpuolisesta kappaleesta. Huom: tämä kenttä poikkeaa KTL:stä. 12345678+123456 Summatietue (9) Positio (pituus) Kuvaus Esimerkki 1-1 (pituus 1) Tietueen tunniste (9) 9 2-7 (pituus 6) Tapahtumien kappalemäärä 001234 8-18 (pituus 11) Maksujen rahamäärä, tilitettävä pääoma yhteensä 00000000000 sentteinä 19-24 (pituus 6) Oikaisujen kappalemäärä, Ei käytössä 25-35 (pituus 11) Oikaisujen rahamäärä, Ei käytössä 36-52 (pituus 6+11) Ei käytössä 53-90 (pituus 38) Varalla, ei käytössä Ei käytössä, suositus nollia, voi jättää myös tyhjäksi. 4.3.3 Perinnän suorituksen peräkkäissanoman kuittaus Peräkkäistiedosto on jäämässä pois, sille ei rakenneta kuittaussanomaa. 4.3.4 Perinnän suorituksen XML rajapinta (NDCAMT54L pohjalta) XML tiedosto pohjautuu pankien määrittelemään camt.054.001.02 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. 12345678 GrpHdr/ MsgId Tiedoston noutohetki 2014-12-31T23:59:59.99999Z

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) 12345678 Tapahtumaraportin luontiaika IBAN Tapahtumien (panojen) lukumäärä sanomassa 1234 Tapahtumien (panojen) summa euroissa 1234.67 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 2014-12-31T23:59:59.99999Z FI1234567890123456 12345678+123456 590.27 CRDT BOOK Kirjauspäivä 2014-12-31 Arvopäivä (maksupäivä) 2014-12-31 Viitenumero 12100012549 PMNT = maksut RCDT = hyvitetyt tilisiirrot NTAV = ei tiedossa PMNT RCDT

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 12345671234 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. 590.27 Maija Mehiläinen SCOR 121300012549 2014-12-31T00:00:00 <?xml version="1.0"?> <Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.054.001.02" xmlns:xsd="http://www.w3.org/2001/xmlschema" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <BkToCstmrDbtCdtNtfctn> <GrpHdr> <MsgId>12345678</MsgId> <CreDtTm>2014-09-18T07:16:41.7909931Z</CreDtTm> </GrpHdr> <Ntfctn>

Perintätoimistoliittymä 24 (28) <Id>1</Id> <CreDtTm>2014-0918T10:16:41.7909931Z</CreDtTm> <Acct> <Id> <IBAN>FI1234567890123456</IBAN> </Id> </Acct> <TxsSummry> <TtlCdtNtries> <NbOfNtries>1</NbOfNtries> <Sum>590.27</Sum> </TtlCdtNtries> </TxsSummry> <Ntry> <NtryRef>12345678+123456</NtryRef> <Amt Ccy="EUR">590.27</Amt> <CdtDbtInd>CRDT</CdtDbtInd> <Sts>BOOK</Sts> <BookgDt> <Dt>2014-12-31</Dt> </BookgDt> <ValDt> <Dt>2014-12-31</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>121300012549</Ref> </CdtrRefInf> </Strd> </RmtInf> <RltdDts> <AccptncDtTm>2014-12-31T00:00:00</AccptncDtTm> </RltdDts> </TxDtls> </NtryDtls> </Ntry> <!-- Toinen tapahtuma

Perintätoimistoliittymä 25 (28) <Ntry>... </Ntry> --> </Ntfctn> </BkToCstmrDbtCdtNtfctn> </Document> 4.3.5 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 20160420062010_11600003715+189 2005 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. 1 2015-01-01T12:59:59.12345Z OK <?xml version= 1.0 encoding= UTF-8?> <BkToCstmrAcctRptAck> <GrpHdr> <MsgId>20160420062010_11600003715+1892005</MsgId> </GrpHdr> <Reason> <Code>1</Code> <CreationTimeStamp>2015-01-01T12:59:59.12345Z</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

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)

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 20110120 - 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

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