XML VIITELUETTELO. Palvelukuvaus. Kesäkuu

Transkriptio

1 XML VIITELUETTELO Palvelukuvaus Kesäkuu 2012

2 OY SAMLINK AB PALVELUKUVAUS 2 (8) Sisällysluettelo Sisällysluettelo 1 Yleistä

3 OY SAMLINK AB PALVELUKUVAUS 3 (8) 1 Yleistä 1 Yleistä Tämä on palvelukuvaus XML-muotoisesta viiteluettelosta. Tämä palvelukuvaus koskee Aktia Pankkia, Handelsbankenia, Itella Pankkia, POP Pankkeja ja Säästöpankkeja. XML-viiteluettelo on vaihtoehtoinen aineistomuoto perinteisen Saapuvat Viitemaksutluettelon (SVM) rinnalle. XML-muotoinen viiteluettelo voidaan ohjata WebService kanavaan tai Yritysverkkopalveluun. Aineiston sovellustunnus on XE. Viiteluettelon vastaanottajasta, toimitusreitistä, toimitusajasta ja aineiston muodosta sovitaan asiakkaan ja pankin välillä. Aineisto sisältää saapuvia viitemaksuja ja niiden oikaisuja sekä suoraveloituksia ja niiden oikaisuja sekä epäonnistuneita suoraveloituspyyntöjä. Xml-viiteluettelo toimitetaan Bank-to-Customer-sanomatyyppinä camt (BankToCustomerDebitCreditNotificationV02). Aineiston rakenne on kuvattu alla olevassa kuvassa GrpHrd BkToCstmrDbtCdtNtfctn Ntfctn Acct 0..n 1..1 Ntry BkTxCd NtryDtls Btch 1..n TxDtls Refs AmtDtls BkTxCd RltdPties RmtInf RltdDts RtrInf

4 OY SAMLINK AB PALVELUKUVAUS 4 (8) Alla olevan taulukon sarakkeen toistuvuus selitykset ovat seuraavat: 1..1 tieto käytössä aina tieto voi olla käytössä tai puuttua 1..n tieto on vähintään yhden kerran, mutta voi olla useamminkin XML-muotoisen sanoman tiedot: Arvo, Selite, Käsittely Group Header 1..1 MessageIdentification <GrpHdr><MsgId> 1..1 Aineiston yksilöivä tunniste CreationDateTime <GrpHdr><CreDtTm> 1..1 Aineiston luontiajankohta AdditionalInformation <GrpHdr><AddtlInf> Notification 1..1 Identification <Ntfctn><Id> 1..1 Tunniste ElectronicSequence Number CreationDateTime Sanoman tieto XML Tag Toistuvuus FromToDate/FromDateTime FromToDate/ ToDateTime CopyDuplicateIndicator Account Account Type Currency <Ntfctn> <ElctrnSeqNb> <Ntfctn><CreDtTm> <Ntfctn><FrToDt> <FrDtTm> <Ntfctn><FrToDt> <ToDtTm> <Ntfctn> <CpyDplctInd> <Ntfctn ><Acct> <Id><IBAN> <Ntfctn><Acct> <Tp><Cd> <Ntfctn><Acct><Ccy> 1..1 Aineiston luontiajankohta 1..1 Tili, jonka tapahtumia raportoidaan Aina CACC (= Current) 1..1 Tilin valuutta. Aina EUR

5 OY SAMLINK AB PALVELUKUVAUS 5 (8) OwnerIdentification Servicer/ FinancialInstitutionIdentification <Ntfctn><Acct> <Ownr><Id><OrgId> <Othr><Id> <Ntfctn><Acct> <Svcr><FinnInstnId> <BIC> 1..1 Palvelutunnus Saapuvat viitemaksut- palvelusopimukselta Pankin BIC Entry (1/ kirjauspäivä, tapahtumatyyppi) Amount / AmountCurrency <Ntry><Amt Ccy> 1..n 1..1 Tapahtumien rahamäärä yhteensä + valuutta. Valuuttana EUR. CreditDebitIndicator ReversalIndicator Status BookingDate ValueDate <Ntry><CdtDbtInd> <Ntry><RvslInd> <Ntry><Sts> <Ntry><BookgDt> <Dt> <Ntry><ValDt><Dt> Tämä yhteissumma vastaa tiliotteella olevaa yhteisvientiä Rahamäärän etumerkki CRDT = Kun edellisen kentän rahamäärä on positiivinen DBIT = Kun edellisen kentän rahamäärä on negatiivinen 1..1 Jos sisältää oikaisutapahtumia TRUE Muuten FALSE 1..1 Jos sisältää epäonnistuneita suoraveloitustapahtumia INFO Muilla tapahtumilla BOOK 1..1 Kirjauspäivä Arvopäivä (= kirjauspäivä)

6 OY SAMLINK AB PALVELUKUVAUS 6 (8) AccountServicer Reference Domain FamilyCode SubFamilyCode Proprietary Code Issuer Entry Details MessageIdentification NumberOfTransactions TotalAmount CreditDebitIndicator <Ntry><AcctSvcrRef> <Domn><Cd> <Domn><Family> <Cd> <Domn><Family> <SubFmlyCd> <Prtry><Cd> <Prtry><Issr> <Btch><MsgId> <Btch><NbOfTxs> <Btch><TtlAmt> <Btch><CdtDbtInd> Aina PMNT 1..1 Jos sisältää saapuvia viitemaksuja RCDT Jos sisältää suoraveloitustapahtumia IDDT 1..1 Jos sisältää saapuvia viitemaksuja DMCT Jos sisältää suoraveloitustapahtumia PMDD Jos sisältää viitemaksuja 705 Saapuvat viitemaksut FFFS Jos sisältää suoraveloitustapahtumia 704 Suoraveloituspalvelu 1..1 Tapahtumien kappalemäärä yhteensä 1..1 Rahamäärä yhteensä ja valuutta 1..1 Rahamäärän etumerkki CRDT = Kun edellisen kentän rahamäärä on positiivinen

7 OY SAMLINK AB PALVELUKUVAUS 7 (8) DBIT = Kun edellisen kentän rahamäärä on negatiivinen TransactionDetails = tapahtuma 1..n AccountServicer Reference <TxDtls><Refs> <AcctSvcrRef> Tapahtuman arkistointitunnus. Amount <TxDtls><AmtDtls> <TxAmt > Tapahtuman rahamäärä ja valuutta. Valuuttana EUR. Debtor Name Code Issuer Reference AcceptanceDateTime ReturnInformation/ Reason ReturnInformation/ Reason <TxDtls><RltdPties> <Dbtr><Nm> <TxDtls><RmtInf> <Strd> <CdtrRefInf><Tp> <CdOrPrty><Cd> <TxDtls><RmtInf> <Std><CdtrRefInf> <Tp><Issr> <TxDtls> <RmtInf><Strd> <CdtrRefInf><Ref> <TxDtls><RltdDts> <AccptncDtTm> <TxDtls><RtrInf> <Rsn><Cd> <TxDtls><RtrInf> <AddtlInf> Maksajan nimi 1..1 Aina SCOR Jos kyseessä on RF-viite tulee ISO 1..1 Maksun viite Maksupäivä Hylkäämisen syykoodi. Käytössä vain epäonnistuneella suoraveloituksella. Hylkäämisen syy selväkielisenä. Käytössä vain epäonnistuneella suoraveloituksella

8 OY SAMLINK AB PALVELUKUVAUS 8 (8)