Record description XML File Transfer Balance and Transaction list camt

Transcription

1 Record description XML File Transfer Balance and Transaction list camt

2 Page 2 of 14 Change date Version Changed Identification kentän pituus muuttunut, tarkennus kenttään AmtDtls, korjaus kenttään 2.313AddtlTxInf Name changed as Danske Bank This document covers the interpretation of the BankToCustomerAccountReportV02 Camt.052 as described by the ISO camt standard. Files produced and received from Danske Bank will adhere to these standards and will be valid according to the XML Schema for camt as published on the website. The interpretation is documented in a table. ISO-columns refers to the official description of Payments Standards Initiation. Danske Bank columns contains the interpretation made by Danske Bank. There may be tags that are not used by Danske Bank but still has to be specified to adhere to the ISO standard. Column Header ISO ISO Tag-name ISO Description ISO Type Danske Bank M / C / N Special Danske Bank Interpretation Danske Bank Comments Content The index used by ISO in the official description of Payments Standards Initiation The name of the XML-tag preceded by a number of plus (+) signs showing the nested level the tag is used on The corresponding ISO-name of the tag (full name) followed by the cardinality. [0..1] means that the tag is optional there can be either zero or one instance of the tag. [1..1] means mandatory field one occurrence. [0..n] means optional field there can be from zero to many occurrences. The content type of the tag How does Danske Bank use this tags: M = Mandatory field, C = Conditionally (or optionally) used, N = Not used (ignored) Specific limitations and naming of the content filled in by Danske Bank. Other comments that may be helpful when reading camt files from Danske Bank Abbreviations (1..1) Mandatory and only once in a message. (1..n) Mandatory, can be several times (0..1) Optional and only once in a message (0..n) Optional and can be several times >> The element is under the previous level, {Or..Or} Alternative elements (Choice) M Mandatory C Optional N Not in use

3 Page 3 of 14 XML Header The XML Header should follow the recommendation from <?xml version = "1.0" encoding = "UTF-8"?> <Document xmlns = "urn:iso:std:iso:20022:tech:xsd:camt " xmlns:xsi = " ISO ISO Tag-name ISO Description ISO Danske Bank 1.0 GrpHdr Group Header [1..1] M 1.1 +MsgId MessageIdentification [1..1] Text M Unique reference 21 characters long GXXFFD9UGT2P CreDtTm CreationDateTime [1..1] IsoDateTime M Time of creation T11:56: MsgRcpt MessageRecipient[0..1] Text N Not used 1.4 +MsgPgntn MessagePagination [0..1] Text N Not used 1.5 +AddtlInf AdditionalInformation [0..1] Text N Not used 2.0 Rpt Report [1..n] M 2.1 +Id Identification [1..1] Text M Unique reference 21 characters long GXXFFD9UGT2P ElctrncSeqNb ElectronicSequenceNumber[0..1] Number 18 M Always LglSeqNb LegalSequenceNumber[0..1] Number 18 M Always CreDtTm CreationDateTime [1..1] IsoDateTime M Current date and time in IsoDateTime format T11:56: FrToDt FromToDate [1..1] IsoDateTime M FrDtTm FromDateTime [1..1] IsoDateTime M Date and time of first booked transaction T08:20: ToDtTm ToDateTime [1..1] IsoDateTime M Report date in IsoDateTime format where time T11:56:00 is the time of request Acct Account [1..1] M ++Id Identification [1..1] M +++IBAN IBAN [1..1] IBAN M IBAN account number FI Ccy Currency [0..1] Code M Account currency EUR ++Nm Name [0..1] Text M Name of the account product in the bank application. ++Ownr Owner [0..1] M +++Nm Name [0..1] Text M Account owner s name Yritys Oyj +++PstlAdr PostalAddress [0..1] Text M Account owner s address ++++StrtNm StreetName [0..1] Text C Street name Kuusitie ++++BldgNb BuildingNumber[0..1] Text C Building number 6 A ++++PstCd PostCode [0..1] Text M Postal code TwnNm TownName [0..1] Text M Town name Helsinki ++++Ctry Country [0..1] Code M Country code FI Maksuliiketili 1

4 ISO ISO Tag-name ISO Description ISO Danske Bank +++Id Identification [0..1] M ++++OrdIg OrganisationIdentification [0..1] C Filled if corporate customer +++++Othr Other [0..n] C Id Identification [1..1] Text C Corporate customer s identification SchmeNm SchemeName [0..1] C Cd Code[1..1] Code C CUST if LY number BANK in case the account owner id is given by the Danske Bank (technical id ++++PrvtId PrivateIdentification [1..1] N Not used ++Svcr Servicer [0..1] M +++FinInstnld FinancialInstitutionIdentification [1..1] M ++++BIC BIC [0..1] Code M DABAFIHH Can be also DABAFIHX(Danske Bank Helsinki Branch) Bal Balance [1..n] M Tp Type [1..1] M CdOrPrtry CodeOrProprietary [1..1] M Cd Code [1..1] Code M The following values are possible: ITAV Available balance calculated at the time of request. Includes booked transactions, reservations and credit limit. ITBD Booked balance calculated at the time of request. CUST DABAFIHH Prtry Proprietary [1..1] Text N Not used SubTp SubType [0..1] N Not used Cd Code [1..1] Code N Not used Prtry Proprietary [1..1] Text N Not used CdtLine CreditLine[0..1] C Used if credit limit exists and the balance code ITAV Incl Included[1..1] Indicator C If true, the credit line is included in the balance. true Amt Amount [0..1] Amount C Amount of the limit EUR Amt Amount [1..1] Amount M Amount of the balance EUR CdtDbtInd CreditDebitIndicator [1..1] Code M Following values are valid: DBIT = Debit CRDT = Credit Dt Date [1..1] Date M Balance date TxsSummry TransactionsSummary [0..1] M TtlNtries TotalEntries [0..1] M Status BOOK only included. ITAV CRDT Page 4 of 14

5 ISO ISO Tag-name ISO Description ISO Danske Bank NbOfNtries NumberOfEntries [0..1] Text M Calculated number of entries in the file Sum Sum [0..1] Quantity N Not used TtlNetNtryAmt TotalNetEntryAmount [0..1] Quantity M Resulting amount of the netted amounts for all CRDT debit and credit entries CdtDbtInd CreditDebitIndicator [0..1] Code M Following values are valid: CRDT DBIT = Debit CRDT = Credit TtlCdtNtries TotalCreditEntries [0..1] M NbOfNtries NumberOfEntries [0..1] Text M Calculated number of credit entries in the file Sum Sum [0..1] Quantity M Calculated sum of included credit entries in the file TtlDbtNtries TotalDebitEntries [0..1] M NbOfNtries NumberOfEntries[0..1] Text M Calculated number of debit entries in the file Sum Sum [0..1] Quantity M Calculated sum of included debit entries in the file Ntry Entry [0..n] M NtryRef EntryReference [0..1] Text M Calculated within report starting from Amt Amount[1..1] Amount M Amount of transaction EUR CdtDbtInd CreditDebitIndicator[1..1] Code M Following values is valid: DBIT DBIT = Debit CRDT = Credit RvslInd ReversalIndicator [0..1] Indicator C If reversal the value is set to true, else tag does true not exist Sts Status [1..1] Code M Always set to BOOK BOOK BookgDt BookingDate [0..1] DateTime M Booking date ValDt ValueDate [0..1] DateTime M Value date AcctSvcrRef AccountServicerReference [0..1] Text M Filing code E BkTxCd BankTransactionCode [1..1] M Domn Domain [0..1] M Cd Code [1..1] Code M PMNT = Payments PMNT LDAS = Loans, Deposits & Syndications CAMT = Cash management Fmly Family [1..1] M Cd Code [1..1] Code M ICDT = Issued Credit Transfers RCDT = Received Credit Transfers MCRD = Merchant Card Transactions IDDT = Issued Direct Debits RDDT = Received direct debits ICHQ = Issued Cheques CCRD = Customer card transactions ICDT Page 5 of 14

6 Page 6 of 14 ISO ISO Tag-name ISO Description ISO Type Danske Bank Description Example M / C / N 1 MDOP= Miscellaneous Debit Operations ACCB = Account Balancing SubFmlyCd SubFamilyCode [1..1] Code M SALA = recurring payment PMDD = Direct debit BBDD = SEPA B2B Direct Debit ESDD = SEPA Core Direct debit CHRG = Charges INTR = Interest OTHR = Other ZABA = Zero Balancing NTAV = Not available Prtry Proprietary [1..1] M Cd Code [1..1] Code M Equal to the current TITO document codes and texts by payment type Syntax [999 XXXXXXXX ] Text part always in capital letters Issr Issuer [0..1] Code M Always FFFS FFFS MsgNmId MessageNameIdentification[0..1] Text C Not for customer usage NtryDtls EntryDetails[0..n] C Btch Batch [0..1] C Used in case Bulk Debits MsgId MessageIdentification [0..1] Text C Pain.001: Messagid of the received payment file (1.1 MsgId) NTAV 700 SIIRTO MSGIDFiFi02 Legacy files: not present PmtInfId PaymentInformationIdentification [0..1] Text C Pain.001: 2.1 PmtlnfId Identifikaatio 1 Legacy files: LM02/03 batch id from batch record(field 11), PELL payers information from total record (field 10), NbOfTxs NumberOfTransactions [0..1] Text C Number of booked transactions included into 20 this entry TtlAmt TotalAmount [0..1] Amount C Filled on ly on bulk debits with posting amount CdtDbtInd CreditDebitIndicator [0..1] Code C Following values are valid: DBIT = Debit CRDT = Credit Filled if TtlAmt is filled TxDtls TransactionDetails [0..n] M Refs References [0..1] C MagId MessageIdentification [0..1] Text N Not used AcctSvcrRef AccountServicerReference [0..1] Text N Archivenumber of the itemisation transaction E

7 Page 7 of 14 ISO ISO Tag-name ISO Description ISO Danske Bank PmtInfId PaymentInformationIdentification [0..1] Text N Not used InstrId InstructionIdentification [0..1] Text C Instruction Id from the payment. Sisäinen tieto T18/19 field from the LM02/ EndToEndId EndToEndIdentification [0..1] Text C EndToEndId from the payment. If does not exist, tag is not present TxId TransactionIdentification [0..1] Text C TxId from the payment. If does not exist, tag is not present MndtId MandateIdentification [0..1] Text C MndtId from the payment. If does not exist, tag is not present. At present used only in case of SEPA direct debits ChqNb ChequeNumber [0..1] Text N ClrSysRef ClearingSystemReference[0..1] Text N Prtry Proprietary [0..1] C Tp Type [1..1] Text C ORIG if original achive number is given in Ref. CARD if card number is given in Ref Ref Reference [1..1] Text C Card number. Only the six first and four last numbers of the card number can be shown. Others are replaced by character X. Original archive number of corrected transaction AmtDtls AmountDetails [0..1] M +++++InstdAmt InstructedAmount [0..1] C Amount used between payer and payee. Originates from various channels Amt Amount Amount C USD TxAmt TransactionAmount [0..1] Amount C Amount in account currency. Is present always in single and itemization transaction Amt Amount Amount C EUR CcyXchg CurrencyExhange [0..1] C SrcCcy SourceCurrency [0..1] Code C Payment currency USD TrgtCcy TargetCurrency [0..1] Code C Account currency EUR UnitCcy UnitCurrency [0..1] Code C Unit currency EUR XchgRate ExchangeRate [0..1] Rate C Exchange rate CntrValAmt CounterValueAmount [0..1] Amount C Not used.

8 ISO ISO Tag-name ISO Description ISO Danske Bank +++++PrtryAmount ProprietaryAmount [0..n] Amount C In case instructed and transaction amount are not euros the eur counter values are documented in this structure Tp Type Text C AOS AOS Amt Amount Amount C CcyXchg ExchangeRate [0..1] C SrcCcy SourceCurrency [0..1] Code C Payment currency USD TrgtCcy TargetCurrency [0..1] Code C Euro EUR UnitCcy UnitCurrency [0..1] Code C Unit currency EUR XchgRate ExchangeRate [0..1] Rate C Exchange rate BkTxCd BankTransactionsCode [0..1] N Not used Domn Domain [0..1] N Not used Cd Code [1..1] Code N Not used Fmly Family [1..1] N Not used Cd Code[1..1] Code N Not used SubFmlyCd SubfamilyCode [1..1] Code N Not used Prtry Proprietary [0..1] N Not used Cd Code [1..1] Text N Not used Issr Issuer [0..1] Text N Not used RltdPties RelatedParties [0..1] C InitgPty InitiatingParty [0..1] N Not used Dbtr Debtor [0..1] C Present in case of credit Nm Name [0..1] Text C Name of the debtor Maksaja Matti PstlAdr PostalAddress[0..1] C Debtors address if present AdrTp AddressType [0..1] Code C Dept Department [0..1] Text C SubDept SubDepartment [0..1] Text C StrtNm StreetName[0..1] Text C BldgNb BuildingNumber[0..1] Text C PstCd PostCode[0..1] Text C TwnNm TownName[0..1] Text C CtrySubDvs CountrySubDivision[0..1] Text C n Ctry Country[0..1] Code C AdrLine AddressLine[0..7] Text C Id Identification[0..1] C Debtor s Id OrgId OrganisationIdentification[1..1] C Corporate customer s Id if present. Shown only on payer s report BICOrBEI BICOrBEI[0..1] Identifier C Eg. DABAFIHH DABAFIHH Page 8 of 14

9 ISO ISO Tag-name ISO Description ISO Danske Bank Othr Other[0..n] C Id Identification[1..1] Text C Eg. LY-number Scheme SchemeName[0..1] C Nm Cd Code[1..1] Code C Codes: CUST BANK = Bank Party Identification from pain or pacs. CUST = LY number Prtry Proprietary[[1..1] Text C Issr Issuer[0..1] Text C DbtrAcct DebtorAccount [0..1] C Present in case of sweepings Id Identification [0..1] Text C Iban IBAN Account number [0..1] Identifier C Account number of debtor in case of sweepings UltmtDbtr UltimateDebtor [0..1] C Nm Name [0..1] Text C If exists in original payment will be shown always. Can be given in various channels. LM02/03 field 10 is shown in this tag PstlAdr PostalAddress[0..1] C AdrTp AddressType [0..1] Code C Dept Department [0..1] Text C SubDept SubDepartment [0..1] Text C StrtNm StreetName[0..1] Text C BldgNb BuildingNumber[0..1] Text C PstCd PostCode[0..1] Text C TwnNm TownName[0..1] Text C Ultimate debtor s address, if exists. Alkuperäinen maksaja Oy CtrySubDvs CountrySubDivision[0..1] Text C n Ctry Country[0..1] Code C AdrLine AddressLine[0..7] Text C Id Identification[0..1] C Ultimate debtor s Id OrgId OrganisationIdentification[1..1] C Corporate customer s Id if present. Shown only on payer s report BICOrBEI BICOrBEI[0..1] Identifier C Eg. DABAFIHH Othr Other[0..n] C Id Identification[1..1] Text C Eg. LY-number Scheme SchemeName[0..1] C Nm Cd Code[1..1] Code C Codes: BANK = Bank Party Identification from pain or pacs. Page 9 of 14

10 ISO ISO Tag-name ISO Description ISO Type Danske Bank Description Example M / C / N 1 CUST = LY number Prtry Proprietary[1..1] Text C Issr Issuer[0..1] Text C Cdtr Creditor [0..1] C Nm Name [0..1] Text C Name of the creditor. Saaja Oy PstlAdr PostalAddress[0..1] AdrTp AddressType [0..1] Code C Dept Department [0..1] Text C SubDept SubDepartment [0..1] Text C StrtNm StreetName[0..1] Text C BldgNb BuildingNumber[0..1] Text C PstCd PostCode[0..1] Text C TwnNm TownName[0..1] Text C Creditor s address CtrySubDvs CountrySubDivision[0..1] Text C n Ctry Country[0..1] Code C AdrLine AddressLine[0..7] Text C Id Identification[0..1] C Creditor s Id OrgId OrganisationIdentification[1..1] C Corporate customer s Id if present BICOrBEI BICOrBEI[0..1] Identifier C Eg. DABAFIHH DABAFIHH Othr Other[0..n] C Id Identification[1..1] Text C Eg. LY-number Scheme SchemeName[0..1] C Nm Cd Code[1..1] Code C Codes: BANK = Bank Party Identification from pain or pacs. CUST = LY number Prtry Proprietary[1..1] Text C Issr Issuer[0..1] Text C PrvtId PrivateIdentification[1..1] Text Private Id Othr Other[0..n] Text Id Identification [1..1] Text C Social security number A SchmeN SchemeName [0..1] m Cd Code Code C SOSE Prtry Proprietary Text C CdtrAcct CreditorAccount [0..1] C Id Identification [0..1] Text C Iban IBAN Account number C Creditor s account CUST Page 10 of 14

11 ISO ISO Tag-name ISO Description ISO Danske Bank UltmtCdtr UltimateCreditor [0..1] C Nm Name [0..1] Text C If exists in original payment will be shown always.can be given in various channels PstlAdr PostalAddress[0..1] AdrTp AddressType [0..1] Code C Dept Department [0..1] Text C SubDept SubDepartment [0..1] Text C StrtNm StreetName[0..1] Text C BldgNb BuildingNumber[0..1] Text C PstCd PostCode[0..1] Text C TwnNm TownName[0..1] Text C Ultimate creditor s address CtrySubDvs CountrySubDivision[0..1] Text C n Ctry Country[0..1] Code C AdrLine AddressLine[0..7] C Id Identification[0..1] C OrgId OrganisationIdentification[1..1] C Corporate customer s Id if present BICOrBEI BICOrBEI[0..1] Identifier C Eg. DABAFIHH Othr Other[0..n] C Id Identification[1..1] Text C Eg. LY-number Scheme SchemeName[0..1] C Nm Cd Code[1..1] Code C BANK = Bank Party Identification from pain or CUST pacs. CUST = LY number Prtry Proprietary[1..1] Text C Issr Issuer[0..1] Text C PrvtId PrivateIdentification[1..1] Text Private Id Othr Other[0..n] Text Id Identification [1..1] Text C Social security number A SchmeN SchemeName [0..1] m Cd Code Code C SOSE Prtry Proprietary Text TradgPty TradingParty [0..1] N Not used Prtry Proprietary [0..n] N Not used Tp Type [1..1] N Not used Pty Party [1..1] N Not used RltdAgts RelatedAgents [0..1] C DbtrAgt DebtorAgent [0..1] N Page 11 of 14

12 ISO ISO Tag-name ISO Description ISO Danske Bank CdtrAgt CreditorAgent [0..1] C Creditor s BIC from booked transaction. Only shown on payer s report FinInstnId FinancialInstitutionIdentification[1..1] BIC BIC Identifier C DABAFIHH DABAFIHH Purp Purpose [0..1] C Cd Code [1..1] Code C Recurring payment type. Eg. PENS PENS Prtry Proprietary [1..1] Text C RmtInf RemittanceInformation [0..1] C Ustrd Unstructured [0..n] Text C Free format info Vapaata viestiä Strd Structured [0..n] C Filled with info from pain, pacs, pmj or legacy files RfrdDocInf ReferredDocumentInformation [0..n] C Tp Type [0..1] C CdOrPrtry CodeOrProprietary [1..1] C Cd Code [1..1] Code C CINV = Invoice CREN CREN = Credit note Prtry Proprietary [1..1] Text C Issr Issuer [0..1] Text C Nb Number [0..1] Text C RltdDt RelatedDate [0..1] DateTime C RfrfDocAmt ReferredDocumentAmount [0..1] C DuePyblAmt DuePayableAmount [0..1] Amount C DscntApldA DiscountAppliedAmount [0..1] Amount C mt CdtNoteAmt CreditNoteAmount [0..1] Amount C Credit note amount EUR TaxAmt TaxAmount [0..1] Amount C AdjstmntA AdjustmentAmountAndReason[0..n] C mtandrsn Amt Amount [0..1] Amount C CdtDbtInd CreditDebitIndicator [0..1] Code C Rsn Reason [0..1] Text C AddtlInf AdditionalInformation [0..1] Text C RmtdAmt RemittedAmount [0..1] Amount C Invoice amount EUR CdtrRefInf CreditorReferenceInformation [0..1] C Tp Type [1..1] C CdOrPrtry CodeOrProprietary [1..1] C Cd Code [1..1] Code C SCOR SCOR Prtry Proprietary [1..1] Text C Issr Issuer [0..1] Text C ISO if RF reference, otherwise tag not present. ISO Ref Reference [0..1] Text C RF or national reference RF Page 12 of 14

13 Page 13 of 14 ISO ISO Tag-name ISO Description ISO Danske Bank Invcr Invoicer [0..1] + N Invcee Invoicee [0..1] + N AddtlRmtInf AdditionalRemittanceInformation [0..3] Text C Filled with info from incomming posting RltdDts RelatedDates [0..1] C AccptncDtTm AcceptanceDateTime [0..1] DateTime C Payment date T01:01: RtrInf ReturnInformation [0..1] N OrgnlBkTxCd OriginalBankTransactionCode [0..1] N Domn Domain [0..1] N Cd Code [1..1] N Fmly Family [1..1] N Cd Code [1..1] N SubFmlyC SubFamilyCode [1..1] N d Prtry Proprietary [0..1] N Cd Code [1..1] N Issr Issuer [0..1] N Orgtr Originator [0..1] N Rsn Reason [0..1] N Cd Code [1..1] Code N Return reason code AC Prtry Proprietary [1..1] Text N AddtlInf AdditionalInformation [0..n] Text N Reason code and text 1+Account does not exist CorpActn CorporateAction [0..1] N Not used Cd Code [0..1] N Not used Nb Number [0..1] N Not used Prtry Proprietary [0..1] N Not used SfkpgAcct SafekeepingAccount [0..1] N Not used AddtlTxInf AdditionalTransactionInformation C Additional information for a transaction [0..1] AddtlNtryInf AdditionalEntryInformation [0..1] N Not used AddtlRptInf AdditionalReportInfromation [0..1] N Not used

14 Page 14 of 14 Appendix A: Data Types. ISO Type Text INTE FLOA DateTime Code Amount Identifier Description Text in Unicode Format Integer number Floating point number ISO date/time format. ISO Code. Amount of money with currency specified as an XML attribute called Ccy Format depends on the context Rate Rate expressed as a decimal, eg, 0.7 is 7/10 and 70%. Format: fractiondigits: 10, totaldigits: 11