XML-MAKSULUETTELO. Palvelukuvaus

Transkriptio

1 XML-MAKSULUETTELO Palvelukuvaus

2 2 Sisällysluettelo 1 Yleistä XML-maksuluetteloaineiston rakenne... 3

3 3 1 Yleistä Tämä on palvelukuvaus XML-muotoisesta maksuluettelosta. XML-maksuluettelossa eritellään XML-maksuaineistona saapuneita maksueriä. XML-maksuluettelolla raportoidaan päivän aikana maksetut maksuerät. Maksuluettelon tapahtumat ovat SEPA-maksuja tai ulkomaan maksuja tai molempia, sen mukaan mitä asiakkaan kanssa on sovittu. XML-maksuluettelolla ei raportoida SALA- maksuerän maksuja eikä pikasiirtoja. Maksuluettelon vastaanottajasta, toimitusreitistä ja raportoitavista maksutyypeistä sovitaan asiakkaan ja pankin välillä. XML-maksuluettelon voi saada WebService kanavaan tai Yritysverkkopalveluun. Aineiston sovellustunnus on XM. 2 XML-maksuluetteloaineiston rakenne Xml-maksuluettelo toimitetaan Bank-to-Customer-sanomatyyppinä camt (BankToCustomerDebitCreditNotificationV02). Aineiston rakenne: BkToCstmrD- 1:1 1:n GrpHdr Ntfctn 1:1 1:n Acct Ntry 1:1 1:1 BkTxCd NtryDtls 1:1 1:n Btch TxDtls Refs AmtDtls RldtPties RltdAgts RmtInf

4 4 Yhden maksuerän osalta erittely (=Notification) jakaantuu niin moneksi Entryrakenteeksi kuin erää koskien on tehty veloituksia. Kaikki erän SEPA-maksut eritellään yhdessä Entry-rakenteessa, mutta jokainen ulkomaan maksu omassa Entryrakenteessaan. Alla olevan taulukon sarakkeen toistuvuus selitykset ovat seuraavat: 1..1 tieto käytössä aina 0..1 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: Sanoman tieto XML Tag Toistuvuus 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 Notification <GrpHdr><AddtlInf> 1..n Ei käytössä Identification <Ntfctn><Id> 1..1 Tunniste CreationDateTime CopyDuplicateIndicator Account Currency OwnerIdentification Servicer/ FinancialInstitutionIdentification TransactionSummary/ NumberOfEntries <Ntfctn><CreDtTm> <Ntfctn><CpyDplctInd> <Ntfctn ><Acct> <Id><IBAN> <Ntfctn><Acct><Ccy> <Ntfctn><Acct> <Ownr><Id><OrgId> <Othr><Id> <Ntfctn><Acct> <Svcr><FinnInstnId> <BIC> <Ntfctn><TxSummry> <TtlNtries> <NbOfNtries> 1..1 Aineiston luontiajankohta 0..1 Ei käytössä 1..1 Tili, jonka tapahtumia raportoidaan Tilin valuutta Palvelutunnus. Lähtevät maksutpalvelu- sopimukselta Maksajan pankin BIC 0..1 Kpl-määrä Erän onnistuneesti maksettujen tapahtumien kpl-määrä yhteensä

5 5 Entry (1/erän tapahtumia koskeva veloitus) 1..n Amount / AmountCurrency CreditDebitIndicator Status BookingDate ValueDate AccountServicer Reference Domain FamilyCode SubFamilyCode Proprietary Code Issuer Entry Details 1/Entry MessageIdentification <Ntry><Amt Ccy <Ntry><CdtDbtInd> <Ntry><Sts> <Ntry><BookgDt><Dt> <Ntry><ValDt><Dt> <Ntry><AcctSvcrRef> <Ntry><BkTxCd> <Domn><Cd> <Ntry><BkTxCd> <Domn><Family><Cd> <Ntry><BkTxCd> <Domn><Family> <SubFmlyCd> <Ntry><BkTxCd> <Prtry><Cd> <Ntry><BkTxCd> <Prtry><Issr> <Btch><MsgId> 1..1 Tapahtumien (Entryyn sisältyvien TransactionDetails:ien) rahamäärä yhteensä. Summa vastaa tilitapahtuman rahamäärää. Ccy-attribuutilla ilmoitetaan rahamäärän valuutta 1..1 Rahamäärän etumerkki (=veloitus). Vakio DBIT vakio BOOK 0..1 Kirjauspäivä muodossa vvvv-kk-pp ei käytössä 0..1 Tiliveloituksen arkistointitunnus ( SEPA-maksut yhteensä - veloituksen tai ulkomaan maksun) vakio PMNT 1..1 SEPA-maksutentryllä vakio RCDT, Ulkomaan maksu entryllä vakio ICDT SEPA-maksu entryllä vakio ei käytössä ei käytössä Asiakkaan aineistolle antama tunnus saapuneesta XMLmaksuaineistosta.

6 6 PaymentInformation Identification NumberOfTransactions TotalAmount <Btch><PmtInfId> <Btch><NbOfTxs> <Btch><TtlAmt> Asiakkaan erällä antama tunnus saapuneesta XML- maksuaineistosta Tapahtumien kappalemäärä yhteensä. Huom: Ulkomaan maksu- entryn tapauksessa aina Sepa maksut-entryllä tapahtumien rahamäärä yhteensä. Ulkomaan maksu-entryllä tapahtuman rahamäärä. Ccy-attribuutilla ilmoitetaan veloitustilin valuutta. CreditDebitIndicator <Btch><CdtDbtInd> 1..1 Rahamäärän etumerkki. Vakio DBIT TransactionDetails (1/maksuerän maksettu tapahtuma) 1..n AccountServicer Reference <TxDtls><Refs> <AcctSvcrRef> 0..1 Tapahtuman arkistointitunnus InstructionIdentification EndToEndIdentification InstructedAmount TransactionAmount <TxDtls> <Refs> <InstrId> <TxDtls><Refs> <EndToEndId> <InstdAmt> <TxAmt > 0..1 Maksajan tapahtumalle antama tunnus saapuneesta XMLmaksuaineistosta 0..1 Maksajan tapahtumalle antama tunnus saapuneesta XMLmaksuaineistosta 0..1 VAIN Ulkomaan maksulla Maksun määrä ja valuutta 0..1 Tapahtuman rahamäärä ja valuutta veloitustilin valuutassa.

7 7 SourceCurrency TargetCurrency UnitCurrency ExchangeRate ContractIdentification DebtorName <SrcCcy> <TrgtCcy> <UnitCcy> <XchgRate> <CtrctId> <Dbtr><Nm> 0..1 VAIN ulkomaan maksulla: Maksun valuutta 0..1 VAIN ulkomaan maksulla: Veloitustilin valuutta 0..1 VAIN ulkomaan maksulla: vakio EUR 0..1 VAIN ulkomaan maksulla Valuuttakurssi 0..1 VAIN ulkomaan maksulla Kurssiviite 0..1 Maksajan nimi UltimateDebtorName <UltmtDbtr><Nm> 0..1 Alkuperäisen maksajan nimi InstructionIdentification EndToEndIdentification InstructedAmount TransactionAmount <TxDtls> <Refs> <InstrId> <TxDtls><Refs> <EndToEndId> <InstdAmt> <TxAmt > 0..1 Maksajan tapahtumalle antama tunnus saapuneesta XMLmaksuaineistosta 0..1 Maksajan tapahtumalle antama tunnus saapuneesta XMLmaksuaineistosta 0..1 VAIN Ulkomaan maksulla Maksun määrä ja valuutta 0..1 Tapahtuman rahamäärä ja valuutta veloitustilin valuutassa.

8 8 SourceCurrency TargetCurrency UnitCurrency ExchangeRate ContractIdentification DebtorName <SrcCcy> <TrgtCcy> <UnitCcy> <XchgRate> <CtrctId> <Dbtr><Nm> 0..1 VAIN ulkomaan maksulla: Maksun valuutta 0..1 VAIN ulkomaan maksulla: Veloitustilin valuutta 0..1 VAIN ulkomaan maksulla: vakio EUR 0..1 VAIN ulkomaan maksulla Valuuttakurssi 0..1 VAIN ulkomaan maksulla Kurssiviite 0..1 Maksajan nimi UltimateDebtorName <UltmtDbtr><Nm> 0..1 Alkuperäisen maksajan nimi CreditorName <Cdtr><Nm> 0..1 Saajan nimi CreditorAddress/ CountryCode <Cdtr><PstlAdr><Ctry> 0..1 Saajan osoitteen maakoodi CreditorAddress/ AdrLine CreditorAccount <Cdtr><PstlAdr> <AdrLine> <CdtrAcct><Id><IBAN> 0..1 Saajan osoite 0..1 Saajan tili IBANmuodossa

9 9 CreditorAccount CreditorAccount, SchmeName <CdtrAcct><Id> <Othr><Id> <CdtrAcct><Id><Othr> <SchmeNm><Cd> 0..1 VAIN ulkomaan maksulla, kun saajan tili muu kuin IBAN VAIN ulkomaan maksulla: Saajan tilin muoto CreditorAccountType UltimateCreditorName <CdtrAcct><Id><Tp> <Prtry> <UltmtCdtr><Nm> vakio BBAN jos saajan tili on BBAN-muotoinen 0..1 Ei käytössä Lopullisen saajan nimi CreditorAgent,BIC <TxDtls><RltdAgts> <CdtrAgt><FinInstnId> <BIC> 0..1 Saajan pankki, BIC CreditorAgent, ClearingSystemIdentification CreditorAgent Name CreditorAgent,Country CreditorAgent,Address <TxDtls><RltdAgts> <CdtrAgt><FinInstnId> <ClrSysMmbId> <ClrSysId><Cd> <TxDtls><RltdAgts> <CdtrAgt><FinInstnId> <Nm> <TxDtls><RltdAgts> <CdtrAgt> <FinInstnId><PstlAdr><Ctry> RemittanceInformation = tapahtuman viesti(t) <TxDtls><RltdAgts> <CdtrAgt><FinInstnId> <PstlAdr><AdrLine> maksulla on ollut vain1 remittance info (Ustrd tai Strd) RemittanceInformation Unctructured <Ustrd> 0..1 VAIN ulkomaan maksulla Saajan pankki, clearingkoodi 0..1 VAIN ulkomaan maksulla Saajan pankin nimi 0..1 VAIN ulkomaan maksulla Saajan pankin maa 0..1 VAIN ulkomaan maksulla 1..n kun Saajan pankin osoite 0..1 Vapaa viesti

10 10 CreditorReferenceInformation, Code Issuer <Strd><CdtrRefInf> <Tp><CdOrPrty><Cd> <Strd><CdtrRefInf> <Tp><Issr> 0..1 SCOR, kun maksu on käsitelty viitteellisenä Kun viite on kansainvälisen viitestandardin mukainen, niin tässä: ISO Reference <Strd><CdtrRefInf> <Ref> 0..1 Viite Remittance information, ReferredDocumentInformation = tapahtuman erittelyviesti 1..n Vain SEPA-maksuilla, ei ulkomaan maksuilla. ReferredDocument Information, Code ReferredDocument Information, Number ReferredDocument Information, CreditNoteAmount ReferredDocument Information, Code Issuer Reference AdditionalRemittanceInformation <Strd><RfrdDocInf> <Tp><CdOrPrtry><Cd> <Strd><RfrdDocInf> <Tp><Nb> <Strd><RfrdDocAmt> <CdtNoteAmt> <Strd><RfrdDocAmt> <Strd><CdtrRefInf> <Tp><CdOrPrty><Cd> <Strd><CdtrRefInf> <Tp><Issr> <Strd><CdtrRefInf> <Ref> <Strd><AddtlRmtInf> 0..1 Laskulaji/tyyppi CINV/CREN 0..1 Laskun numero 0..1 Rahamäärä, hyvityslasku 0..1 Rahamäärä, lasku 0..1 Ei käytössä 0..1 Ei käytössä 0..1 Viite 0..1 Viesti

11 11 ESIMERKKEJÄ XML-MAKSULUETTELOISTA Asiakkaan maksuerästä on maksettu 1 sepa-maksu ja 1 ulkomaan maksu: <?xml version="1.0" encoding="utf-8"?> <Document xmlns:xsi=" xsi:schemalocation="urn:iso:std:iso:20022:tech:xsd:camt camt xsd" xmlns="urn:iso:std:iso:20022:tech:xsd:camt "> <BkToCstmrDbtCdtNtfctn> <GrpHdr> <MsgId> XM </MsgId> <CreDtTm> T09:43:08+02:00</CreDtTm> </GrpHdr> <Ntfctn> <Id>XM </Id> <CreDtTm> T09:43:08+02:00</CreDtTm> <Acct> <Id> <IBAN>FI </IBAN> </Id> <Ccy>EUR</Ccy> <Ownr> <Id> <OrgId> <Othr><Id> </Id></Othr> </OrgId> </Id> </Ownr> <Svcr> <FinInstnId> <BIC>BANKFIHH</BIC> </FinInstnId> </Svcr> </Acct> <TxsSummry> <TtlNtries> <NbOfNtries>2</NbOfNtries> </TtlNtries> </TxsSummry> <Ntry> <Amt Ccy="EUR">8.00</Amt> <CdtDbtInd>DBIT</CdtDbtInd> <Sts>BOOK</Sts> <BookgDt> <Dt> </Dt> </BookgDt> <AcctSvcrRef> LX000008</AcctSvcrRef> <BkTxCd> <Domn> <Cd>PMNT</Cd> <Fmly>

12 12 <Cd>RCDT</Cd> <SubFmlyCd>ESCT</SubFmlyCd> </Fmly> </Domn> </BkTxCd> <NtryDtls> <Btch> <MsgId>Asiakkaan_oma_tunniste1</MsgId> <PmtInfId>Asiakkaan_oma_eran_tunniste1</PmtInfId> <NbOfTxs>1</NbOfTxs> <TtlAmt Ccy="EUR">8.00</TtlAmt> <CdtDbtInd>DBIT</CdtDbtInd> </Btch> <TxDtls> <Refs> <AcctSvcrRef> LX000007</AcctSvcrRef> <InstrId>Asiakkaan_lahettama_Instrid1</InstrId> <EndToEndId>Asiakkaan_lahettama_E2EId1</EndToEndId> </Refs> <AmtDtls> <InstdAmt> <Amt Ccy="EUR">8.00</Amt> </InstdAmt> </AmtDtls> <RltdPties> <Dbtr> <Nm>Matti Maksaja oy</nm> </Dbtr> <Cdtr> <Nm>Saaja Saksalainen</Nm> <PstlAdr> <Ctry>DE</Ctry> </PstlAdr> </Cdtr> <CdtrAcct> <Id> <IBAN>DE </IBAN> </Id> </CdtrAcct> </RltdPties> <RltdAgts> <CdtrAgt> <FinInstnId> <BIC>DEUTDEDD</BIC> </FinInstnId> </CdtrAgt> </RltdAgts> <RmtInf> <Ustrd>Vapaa viesti</ustrd> </RmtInf> </TxDtls> </NtryDtls> </Ntry> <Ntry> <Amt Ccy="EUR">9.00</Amt>

13 13 <CdtDbtInd>DBIT</CdtDbtInd> <Sts>BOOK</Sts> <BookgDt> <Dt> </Dt> </BookgDt> <AcctSvcrRef> U60003</AcctSvcrRef> <BkTxCd> <Domn> <Cd>PMNT</Cd> <Fmly> <Cd>ICDT</Cd> <SubFmlyCd>XPCT</SubFmlyCd> </Fmly> </Domn> </BkTxCd> <NtryDtls> <Btch> <MsgId> Asiakkaan_oma_tunniste1</MsgId> <PmtInfId> Asiakkaan_oma_eran_tunniste1</PmtInfId> <NbOfTxs>1</NbOfTxs> <TtlAmt Ccy="EUR">9.00</TtlAmt> <CdtDbtInd>DBIT</CdtDbtInd> </Btch> <TxDtls> <Refs> <AcctSvcrRef> U60002</AcctSvcrRef> <InstrId> Asiakkaan_lahettama_Instrid2</InstrId> <EndToEndId> Asiakkaan_lahettama_E2EId2</EndToEndId> </Refs> <AmtDtls> <InstdAmt> <Amt Ccy="GBP">8.10</Amt> </InstdAmt> <TxAmt> <Amt Ccy="EUR">9.00</Amt> <CcyXchg> <SrcCcy>GBP</SrcCcy> <TrgtCcy>EUR</TrgtCcy> <UnitCcy>EUR</UnitCcy> <XchgRate> </XchgRate> </CcyXchg> </TxAmt> </AmtDtls> <RltdPties> <Dbtr> <Nm>Matti Maksaja Oy</Nm> </Dbtr> <Cdtr> <Nm>Saaja Britti</Nm> <PstlAdr> <Ctry>GB</Ctry> <AdrLine>Accrington</AdrLine> </PstlAdr> </Cdtr> <CdtrAcct>

14 14 <Id> <IBAN> </IBAN> </Id> </CdtrAcct> </RltdPties> <RltdAgts> <CdtrAgt> <FinInstnId> <ClrSysMmbId> <ClrSysId> <Cd>SC010</Cd> </ClrSysId> <MmbId>004</MmbId> </ClrSysMmbId> </FinInstnId> </CdtrAgt> </RltdAgts> <RmtInf> <Ustrd>Free message</ustrd> </RmtInf> </TxDtls> </NtryDtls> </Ntry> </Ntfctn> </BkToCstmrDbtCdtNtfctn> </Document> Asiakkaan maksuerästä on maksettu 3 sepa-maksua: <?xml version="1.0" encoding="utf-8"?> <Document xmlns:xsi=" xsi:schemalocation="urn:iso:std:iso:20022:tech:xsd:camt camt xsd" xmlns="urn:iso:std:iso:20022:tech:xsd:camt "> <BkToCstmrDbtCdtNtfctn> <GrpHdr> <MsgId> XM </MsgId> <CreDtTm> T09:43:08+02:00</CreDtTm> </GrpHdr> <Ntfctn> <Id>XM </Id> <CreDtTm> T09:43:08+02:00</CreDtTm> <Acct> <Id> <IBAN>FI </IBAN> </Id> <Ccy>EUR</Ccy> <Ownr> <Id> <OrgId> <Othr><Id> </Id></Othr>

15 15 </OrgId> </Id> </Ownr> <Svcr> <FinInstnId> <BIC>BANKFIHH</BIC> </FinInstnId> </Svcr> </Acct> <TxsSummry> <TtlNtries> <NbOfNtries>3</NbOfNtries> </TtlNtries> </TxsSummry> <Ntry> <Amt Ccy="EUR">30.88</Amt> <CdtDbtInd>DBIT</CdtDbtInd> <Sts>BOOK</Sts> <BookgDt> <Dt> </Dt> </BookgDt> <AcctSvcrRef> LX000004</AcctSvcrRef> <BkTxCd> <Domn> <Cd>PMNT</Cd> <Fmly> <Cd>RCDT</Cd> <SubFmlyCd>ESCT</SubFmlyCd> </Fmly> </Domn> </BkTxCd> <NtryDtls> <Btch> <MsgId> Asiakkaan_oma_tunniste2</MsgId> <PmtInfId> Asiakkaan_oma_eran_tunniste1</PmtInfId> <NbOfTxs>3</NbOfTxs> <TtlAmt Ccy="EUR">30.88</TtlAmt> <CdtDbtInd>DBIT</CdtDbtInd> </Btch> <TxDtls> <Refs> <AcctSvcrRef> LX000002</AcctSvcrRef> <InstrId> Asiakkaan_lahettama_Instrid3</InstrId> <EndToEndId> Asiakkaan_lahettama_E2EId3</EndToEndId> </Refs> <AmtDtls> <InstdAmt> <Amt Ccy="EUR">8.90</Amt>

16 16 </InstdAmt> </AmtDtls> <RltdPties> <Dbtr> <Nm>Matti Maksaja oy</nm> </Dbtr> <Cdtr> <Nm>Sakke Saaja</Nm> <PstlAdr> <Ctry>FI</Ctry> </PstlAdr> </Cdtr> <CdtrAcct> <Id> <IBAN>FI </IBAN> </Id> </CdtrAcct> </RltdPties> <RltdAgts> <CdtrAgt> <FinInstnId> <BIC>NDEAFIHH</BIC> </FinInstnId> </CdtrAgt> </RltdAgts> <RmtInf> <Ustrd>vapaata viestiä</ustrd> </RmtInf> </TxDtls> <TxDtls> <Refs> <AcctSvcrRef> LX000003</AcctSvcrRef> <InstrId> Asiakkaan_lahettama_Instrid4</InstrId> <EndToEndId> Asiakkaan_lahettama_E2EId4</EndToEndId> </Refs> <AmtDtls> <InstdAmt> <Amt Ccy="EUR">11.99</Amt> </InstdAmt> </AmtDtls> <RltdPties> <Dbtr> <Nm>Samlink</Nm> </Dbtr> <Cdtr> <Nm>Matti Maksaja oy</nm> <PstlAdr> <Ctry>FI</Ctry>

17 17 </PstlAdr> </Cdtr> <CdtrAcct> <Id> <IBAN>FI </IBAN> </Id> </CdtrAcct> </RltdPties> <RltdAgts> <CdtrAgt> <FinInstnId> <BIC>DABAFIHH</BIC> </FinInstnId> </CdtrAgt> </RltdAgts> <RmtInf> <Strd> <CdtrRefInf> <Tp> <CdOrPrtry><Cd>SCOR</Cd></CdOrPrtry> </Tp> <Ref> </Ref> </CdtrRefInf> </Strd> </RmtInf> </TxDtls> <TxDtls> <Refs> <AcctSvcrRef> LX000001</AcctSvcrRef> <InstrId> Asiakkaan_lahettama_Instrid5</InstrId> <EndToEndId> Asiakkaan_lahettama_E2EId5</EndToEndId> </Refs> <AmtDtls> <InstdAmt> <Amt Ccy="EUR">9.99</Amt> </InstdAmt> </AmtDtls> <RltdPties> <Dbtr> <Nm>Samlink</Nm> </Dbtr> <Cdtr> <Nm>Niilo Nordea</Nm> <PstlAdr> <Ctry>FI</Ctry> </PstlAdr> </Cdtr> <CdtrAcct>

18 18 <Id> <IBAN>FI </IBAN> </Id> </CdtrAcct> </RltdPties> <RltdAgts> <CdtrAgt> <FinInstnId> <BIC>NDEAFIHH</BIC> </FinInstnId> </CdtrAgt> </RltdAgts> <RmtInf> <Strd> <CdtrRefInf> <Tp> <CdOrPrtry> <Cd>SCOR</Cd></CdOrPrtry> </Tp> <Ref> </Ref></CdtrRefInf> </Strd> </RmtInf> </TxDtls> </NtryDtls> </Ntry> </Ntfctn> </BkToCstmrDbtCdtNtfctn> </Document>