Servicebeskrivning

Transkript

1 XML-BETALNINGSFÖRTECKNING Servicebeskrivning

2 2 Innehållsförteckning 1 Allmänt XML-betalningsförteckningens struktur... 3

3 3 1 Allmänt Detta är servicebeskrivningen om betalningsförteckningen i XML-format. I XML-betalningsförteckningen specifiseras de betalningsposter som kommit som XMLbetalningsmaterial. I XML-betalningsförteckningen rapporteras de under dagen betalda betalningssatser. Händelserna i betalningsförteckningen är SEPA-betalningar eller utlandsbetalningar eller både och, i enlighet med vad som överenskommits med kunden. I XML-betalningsförteckningen rapporteras inte SALA-betalningssatser eller ilgiron. Överenskommelse sker mellan bank och kund angående betalningsförteckningens mottagare, leveransrutt och vilka betalningstyper som rapporteras. XML-betalningsförteckningen kan fås till WebService kanalen eller till Nättjänst för företag. Materialets applikationsslag är XM. 2 XML-betalningsförteckningsmaterialets struktur XML-betalningsförteckningen levereras som Bank-to-Customer-meddelande camt (BankToCustomerDebitCreditNotificationV02). Materialets struktur: 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 Specifiseringen (=Notification) delas upp i så många Entry-strukturer som det skett debiteringar för satsen. Alla satsens SEPA-betalningar specifiseras i samma Entrystruktur, men varje utlandsbetalnings har sin egen Entry-struktur. Förklaringarna till upprepningarna i tabellen nedan 1..1 uppgiften finns alltid 0..1 uppgiften kan finnas eller fattas 1..n uppgiften finns åtminstone en gång, men kan finnas flera gånger Meddelande i XML-format: Meddelandets uppgift XML Tag Upprepning Kommentar Group Header 1..1 MessageIdentification <GrpHdr><MsgId> 1..1 Identifieringskod som bildas när filen skapas CreationDateTime <GrpHdr><CreDtTm> 1..1 Tidpunkt då filen skapats enligt hämtningstidpunkt AdditionalInformation Notification <GrpHdr><AddtlInf> 1..n Ej i bruk Identification <Ntfctn><Id> 1..1 Identifieringskod CreationDateTime <Ntfctn><CreDtTm> 1..1 Tidpunkt för skapande av materialet CopyDuplicateIndicator <Ntfctn><CpyDplctInd> 0..1 Ej i bruk Account Currency <Ntfctn ><Acct> <Id><IBAN> <Ntfctn><Acct><Ccy> 1..1 Kontot, vilka händelser rapporteras Kontovaluta. OwnerIdentification <Ntfctn><Acct> <Ownr><Id><OrgId> <Othr><Id> 1..1 Tjänsten ID från Utgående betalningar-kontrakt. Servicer/ FinancialInstitutionIdentification <Ntfctn><Acct> <Svcr><FinnInstnId> <BIC> 1..1 Betalarens banks BIC

5 5 TransactionSummary/ NumberOfEntries <Ntfctn><TxSummry> <TtlNtries> <NbOfNtries> 0..1 Antal Postens framgångsrika transaktioner avtal totalt Entry (1/debitering av postens transaktioner) 1..n Amount / AmountCurrency <Ntry><Amt Ccy 1..1 Transaktioners (Entry ingående TransactionDetails) penningsbelopp totalt. Det här beloppet motsvarar transaktionens belopp. Ccy-attribut anmälas beloppets valuta. CreditDebitIndicator Status BookingDate ValueDate AccountServicer Reference <Ntry><CdtDbtInd> <Ntry><Sts> <Ntry><BookgDt><Dt> <Ntry><ValDt><Dt> <Ntry><AcctSvcrRef> 1..1 Beloppets tecken (=debitering). Konstant DBIT Konstant BOOK 0..1 Bokningsdag i form åååå-mm-dd Ej i bruk 0..1 Debiterings arkiveringskod ( SEPA-betalningar totalt - debiterings eller utländsbetalnings). Domain FamilyCode SubFamilyCode Proprietary Code Issuer <Ntry><BkTxCd> 1..1 Konstant PMNT <Domn><Cd> <Ntry><BkTxCd> <Domn><Family><Cd> 1..1 Konstant för SEPAbetalning -entry RCDT, Konstant för utlansbetalning -entry ICDT <Ntry><BkTxCd> <Domn><Family> <SubFmlyCd> <Ntry><BkTxCd> <Prtry><Cd> <Ntry><BkTxCd> <Prtry><Issr> Konstant för SEPA betalning -entry Ej i bruk Ej i bruk Entry Details 1/Entry

6 6 MessageIdentification <Btch><MsgId> Kundens ID för ingående XML-betalningsmaterial. PaymentInformation Identification NumberOfTransactions <Btch><PmtInfId> <Btch><NbOfTxs> Kundens ID för ingående XMLbetalningsmaterialposten Antalet transaktioner. OBS: I fallet med utländsbetalnings -entry alltid 1. TotalAmount <Btch><TtlAmt> 1..1 Betalningarnas penningbelopp totalt i SEPAbetalningar -entry. CreditDebitIndicator <Btch><CdtDbtInd> Transaktions penningsbelopp i utländsbetalnings -entry. Ccy-attribut anmälas debiteringskontovaluta Förtecken för penningbeloppet. Konstant DBIT TransactionDetails (1/avbetalning betald transaktion) 1..n AccountServicer Reference <TxDtls><Refs> <AcctSvcrRef> 0..1 Transaktions arkiveringskod InstructionIdentification EndToEndIdentification InstructedAmount <TxDtls> <Refs> <InstrId> <TxDtls><Refs> <EndToEndId> <InstdAmt> 0..1 Kundens ID för transaktion i ingående XMLbetalningsmaterial Kundens ID för transaktion i ingående XMLbetalningsmaterial. Belopp och valuta.

7 7 TransactionAmount <TxAmt > 0..1 Transaktions belopp och debiteringskontos valuta. SourceCurrency TargetCurrency UnitCurrency ExchangeRate ContractIdentification DebtorName <SrcCcy> <TrgtCcy> <UnitCcy> <XchgRate> <CtrctId> <Dbtr><Nm> Betalnings valuta debiteringskontos valuta konstant EUR Valutakurs Kursreferens 0..1 Betalarens namn UltimateDebtorName <UltmtDbtr><Nm> 0..1 Ursprungliga betalarens namn InstructionIdentification EndToEndIdentification InstructedAmount <TxDtls> <Refs> <InstrId> <TxDtls><Refs> <EndToEndId> <InstdAmt> 0..1 Kundens ID för transaktion i ingående XMLbetalningsmaterial Kundens ID för transaktion i ingående XMLbetalningsmaterial. Belopp och valuta.

8 8 TransactionAmount SourceCurrency TargetCurrency UnitCurrency ExchangeRate ContractIdentification DebtorName <TxAmt > <SrcCcy> <TrgtCcy> <UnitCcy> <XchgRate> <CtrctId> <Dbtr><Nm> 0..1 Transaktions penningbelopp och debiteringskontos valuta. Betalnings valuta Debiteringskontos valuta konstant EUR Valutakurs Kursreferens 0..1 Betalarens namn UltimateDebtorName <UltmtDbtr><Nm> 0..1 Ursprungliga betalarens namn CreditorName <Cdtr><Nm> 0..1 Mottagarens namn CreditorAddress/ CountryCode <Cdtr><PstlAdr><Ctry> 0..1 Mottagaradressens landskod CreditorAddress/ AdrLine <Cdtr><PstlAdr> <AdrLine> 0..1 Mottagarens adress

9 9 CreditorAccount <CdtrAcct><Id><IBAN> 0..1 Mottagarens konto i IBANform CreditorAccount CreditorAccount, SchmeName <CdtrAcct><Id> <Othr><Id> <CdtrAcct><Id><Othr> <SchmeNm><Cd> 0..1 Bara i utländsbetalning, om mottagarens konto är inte IBAN. Mottagarens kontos form CreditorAccountType UltimateCreditorName <CdtrAcct><Id><Tp> <Prtry> <UltmtCdtr><Nm> 0..1 Ej i bruk. Konstant BBAN, om mottagarens konto är i BBAN-form Slutlig mottagarens namn CreditorAgent,BIC CreditorAgent, ClearingSystemIdentification CreditorAgent Name CreditorAgent,Country CreditorAgent,Address <TxDtls><RltdAgts> <CdtrAgt><FinInstnId> <BIC> <TxDtls><RltdAgts> <CdtrAgt><FinInstnId> <ClrSysMmbId> <ClrSysId><Cd> <TxDtls><RltdAgts> <CdtrAgt><FinInstnId> <Nm> <TxDtls><RltdAgts> <CdtrAgt> <FinInstnId><PstlAdr><Ctry> <TxDtls><RltdAgts> <CdtrAgt><FinInstnId> <PstlAdr><AdrLine> 0..1 Mottagarens bank, BIC 0..1 Bara i utländsbetalning Mottagarens bank, clearingkod 0..1 Bara i utländsbetalning Mottagarens banks namn 0..1 Bara i utländsbetalning Mottagarens banks land 0..1 Bara i utländsbetalning Mottagarens banks adress

10 10 RemittanceInformation = transaktions meddelande 1..n när betalning har haft bara 1 remittance info (Ustrd tai Strd) RemittanceInformation Unctructured <Ustrd> CreditorReferenceInformation, Code Issuer <Strd><CdtrRefInf> <Tp><CdOrPrty><Cd> <Strd><CdtrRefInf> <Tp><Issr> 0..1 Fri meddelande 0..1 SCOR, när betalning behandlades med referens 0..1 När referens är genom internationell referensstandard, finns här: ISO Reference <Strd><CdtrRefInf> <Ref> 0..1 Referens Remittance information, ReferredDocumentInformation = transaktions differentieringsmeddelande 1..n Bara i SEPA-betalning, inte i utländsbetalning. ReferredDocument Information, Code ReferredDocument Information, Number ReferredDocument Information, CreditNoteAmount ReferredDocument Information, Code Issuer Reference <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> 0..1 Fakturaslag/typ CINV/CREN 0..1 Fakturanummer 0..1 Belopp, kreditfaktura 0..1 Belopp, faktura 0..1 Ej i bruk Ej i bruk Referens

11 11 AdditionalRemittanceInformation <Strd><AddtlRmtInf> 0..1 Meddelande

12 12 EXEMPEL AV XML-BETALNINGSFÖRTECKNING: Kundens betalningspost innehåller 1 SEPA-betalning och 1 utländsbetalning: <?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> <Cd>RCDT</Cd>

13 13 <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> <CdtDbtInd>DBIT</CdtDbtInd>

14 14 <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> <Id>

15 15 <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> Kundens betalningspost innehåller 3 SEPA-betalningar: <?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>

16 16 </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>

17 17 </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>

18 18 </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>

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