Record description XML File Transfer Foreign Payment Feedback camt

Transcription

1 Record description XML File Transfer Foreign Payment Feedback camt

2 Page 2 of 14 Change date Version Changed Added currency fields in Name chaged as Danske Bank This document covers the interpretation of the BankToCustomerDeditCreditNotificationV02 Camt.054 as described by the 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. -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 standard. Column Header Description Danske Bank M / C / N Description Example Content The index used by 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 -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) Description of the field Example of the content 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 = " Camt.054 Description 1.0 GrpHdr Group Header [1..1] M 1.1 +MsgId MessageIdentification [1..1] Text M Unique reference. 21 characters long YMUAGYTI2T2P 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 Ntfctn Notification [1..n] M 2.1 +Id Identification [1..1] Text M Unique reference. 12 characters long 2.2 +ElctrncSeqNb ElectronicSequenceNumber[0.. 1] Number 18 M Electronic sequential number, starts from number one when service is established. (Will be developed later if customers require this. YMUAGYTI2T2P, LglSeqNb LegalSequenceNumber[0..1] Number 18 N Not used 2.4 +CreDtTm CreationDateTime [1..1] IsoDateTime M Time of creation T11:56: FrToDt FromToDate [0..1] IsoDateTime N ++FrDtTm FromDateTime [1..1] IsoDateTime N Not used ++ToDtTm ToDateTime [1..1] IsoDateTime N Not used 2.6 +CpyDplctInd CopyDuplicateIndicator[0..1] Code N Not used 2.7 +RptgSrc ReportingSource[0..1] N Not used Cd Code[1..1] Code N Not used Prtry Proprietary[1..1] Text N Not used Acct Account [1..1] M ++Id Identification [1..1] M +++IBAN IBAN [1..1] IBAN M Debtor account number from FI

4 Page 4 of 14 Camt.054 Description Pain.001: PmtInf/DbtrAcct/Id/IBAN ++Ccy Currency [0..1] Code M Account currency EUR ++Nm Name [0..1] Text N Not used ++Ownr Owner [0..1] M +++Nm Name [0..1] Text M Account owner s name Yritys Oy +++PstlAdr PostalAddress [0..1] N Not used ++++StrtNm StreetName [0..1] Text N Not used ++++BldgNb BuildingNumber[0..1] Text N Not used ++++PstCd PostCode [0..1] Text N Not used ++++TwnNm TownName [0..1] Text N Not used ++++Ctry Country [0..1] Code N Not used +++Id Identification C ++++OrdIg OrganisationIdentification [0..1] C +++++Othr Other [0..n] C Id Identification [1..1] Text C Corporate customer s identification from Pain.001:PmtInf/Dbtr/Id/OrgId/BkPtyId SchmeNm SchemeName [0..1] N Cd Code[1..1] Code N Not used ++Svcr Servicer [0..1] M +++FinInstnld FinancialInstitutionIdentification [1..1] M ++++BIC BIC [0..1] Identifier M Debtor bank BIC DABAFIHH ++++Nm Name [0..1] Text N Not used Intrst Interest [0..n] N Not used TxsSummry TransactionsSummary [0..1] M TtlNtries TotalEntries [0..1] N Not used NbOfNtries NumberOfEntries [0..1] Text N Not used Sum Sum [0..1] Quantity N Not used TtlNetNtryAmt TotalNetEntryAmount [0..1] Quantity N Not used CdtDbtInd CreditDebitIndicator [0..1] Code N Not used TtlCdtNtries TotalCreditEntries [0..1] N Not used NbOfNtries NumberOfEntries [0..1] Text N Not used Sum Sum [0..1] Quantity N Not used TtlDbtNtries TotalDebitEntries [0..1] M NbOfNtries NumberOfEntries[0..1] Text M Calculated number of debit entries in the file. 1

5 Page 5 of 14 Camt.054 Description 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 Unique consecutive number 1 Calculated within statement starting from Amt Amount[1..1] Amount M Amount of transaction CdtDbtInd CreditDebitIndicator[1..1] Code M Valid value: DBIT = Debit DBIT RvslInd ReversalIndicator [0..1] Indicator N Not used Sts Status [1..1] Code M BOOK = booked entry BOOK BookgDt BookingDate [0..1] DateTime M Booking date ValDt ValueDate [0..1] DateTime M Value date AcctSvcrRef AccountServicerReference Text M Filing code = Arkivkode from booked transaction E [0..1] BkTxCd BankTransactionCode [1..1] M Domn Domain [0..1] M Cd Code [1..1] Code M PMNT = Payments PMNT Fmly Family [1..1] M Cd Code [1..1] Code M ICDT = Issued Credit Transfers ICDT SubFmlyCd SubFamilyCode [1..1] Code M NTAV = not available NTAV SALA = recurrent payments Prtry Proprietary [1..1] M Cd Code [1..1] Code M Equal to the current TITO document codes and texts 720 ULKOMAANMAKSU by payment type Syntax [999 XXXXXXXX ] Text part always in capital letters e.g 720 ULKOMAANMAKSU Issr Issuer [0..1] Code M FFFS FFFS AddtlInfInd AdditionalInformationIndicator N [0..1] MsgNmId MessageNameIdentification[0.. Text N Not used 1] AmtDtls AmountDetails [0..1] N Not used Chrgs Charges [0..n] N Not used NtryDtls EntryDetails[0..n] M Btch Batch [0..1] N Not used MsgId MessageIdentification [0..1] Text N Not used

6 Page 6 of 14 Camt.054 Description PmtInfId PaymentInformationIdentificati Text N Not used on [0..1] NbOfTxs NumberOfTransactions [0..1] Text N Not used TtlAmt TotalAmount [0..1] Amount N Not used CdtDbtInd CreditDebitIndicator [0..1] Code N Not used TxDtls TransactionDetails [0..n] M Refs References [0..1] C MagId MessageIdentification [0..1] Text N Not used AcctSvcrRef AccountServicerReference [0..1] Text N Not used PmtInfId PaymentInformationIdentificati Text C Pain.001: PmtInf/PmtInfId on [0..1] InstrId InstructionIdentification [0..1] Text C Pain.001: CdtTrfTxInf/PmtId/InstrId Sisäinen tieto EndToEndId EndToEndIdentification [0..1] Text C Pain.001: CdtTrfTxInf/PmtId/EndToEndId TxId TransactionIdentification [0..1] Text C OTU-reference number from OTU-system MndtId MandateIdentification [0..1] Text N Not used +++++Prtry Proprietary [0..1] N Not used Ref Reference [1..1] Text AmtDtls AmountDetails [0..1] M +++++InstdAmt InstructedAmount [0..1] C Amt Amount Amount C Amount used between payer and payee. USD TxAmt TransactionAmount [0..1] Amount C Amt Amount Amount C Amount in account currency. EUR CcyXchg CurrencyExchange [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. Currency in which the rate of exchange EUR is expressed in a currency exchange. Eg. 1EUR=xxx USD -> Unit currency =EUR XchgRate ExchangeRate [0..1] Rate C Exchange rate

7 Page 7 of 14 Camt.054 Description +++++PrtryAmount ProprietaryAmount [0..n] Amount O In case instructed and transaction amount are not euros the eur counter values are documented in this structure BkTxCd BankTransactionsCode [0..1] N Not used Domn Domain [0..1] N Cd Code [1..1] Code N Not used Fmly Family [1..1] N Cd Code[1..1] Code N Not used. I SubFmlyC SubfamilyCode [1..1] Code N Not used. d Prtry Proprietary [0..1] N Cd Code [1..1] Code N Not used Issr Issuer [0..1] Code N Not used RltdPties RelatedParties [0..1] C Dbtr Debtor [0..1] C Nm Name [0..1] Text N Not used PstlAdr PostalAddress[0..1] Not used AdrTp Address [0..1] Code N Not used Dept Department [0..1] Text N Not used SubDept SubDepartment [0..1] Text N Not used StrtNm StreetName[0..1] Text N Not used BldgNb BuildingNumber[0..1] Text N Not used PstCd PostCode[0..1] Text N Not used TwnNm TownName[0..1] Text N Not used CtrySubDv CountrySubDivision[0..1] Text N Not used sn Ctry Country[0..1] Code N Not used AdrLine AddressLine[0..7] Text N Not used Id Identification[0..1] N Not used OrgId OrganisationIdentification[1..1] N Not used BICOrBEI BICOrBEI[0..1] Identifier N Not used Othr Other[0..n] N Not used

8 Page 8 of 14 Camt.054 Description Id Identification[1..1] Text N Not used Schem SchemeName[0..1] N Not used enm Cd Code[1..1] Code N Not used Prtry Proprietary[1..1] Text N Not used Issr Issuer[0..1] Text N Not used DbtrAcct DebtorAccount [0..1] N Not used Id Identification [0..1] Text N Not used Iban IBAN Account number [0..1] N Not used UltmtDbtr UltimateDebtor [0..1] C Nm Name [0..1] Text C Name of ultimate debtor. If exists in original payment will be shown always. Alkuperäinen maksaja Oy, PstlAdr PostalAddress[0..1] N Not used AdrTp Address [0..1] Code N Not used Dept Department [0..1] Text N Not used SubDept SubDepartment [0..1] Text N Not used StrtNm StreetName[0..1] Text N Not used BldgNb BuildingNumber[0..1] Text N Not used PstCd PostCode[0..1] Text N Not used TwnNm TownName[0..1] Text N Not used CtrySubDv CountrySubDivision[0..1] Text N Not used sn Ctry Country[0..1] Code N Not used AdrLine AddressLine[0..7] N Not used Id Identification N Not used OrgId OrganisationIdentification[1..1] N Not used BICOrBEI BICOrBEI[0..1] Identifier N Not used Othr Other[0..n] N Not used Id Identification[1..1] Text N Not used Schem SchemeName[0..1] N Not used enm Cd Code[1..1] Code N Not used Prtry Proprietary[1..1] Text N Not used Issr Issuer[0..1] Text N Not used Cdtr Creditor [0..1] C Nm Name [0..1] Text C Name of the creditor. Saaja Oy PstlAdr PostalAddress[0..1]

9 Page 9 of 14 Camt.054 Description AdrTp Address [0..1] Code N Not used Dept Department [0..1] Text N Not used SubDept SubDepartment [0..1] Text N Not used StrtNm StreetName[0..1] Text C Pain.001: CdtTrfTxInf/Cdtr/PstlAdr/StrtNm BldgNb BuildingNumber[0..1] Text C Pain.001: CdtTrfTxInf/Cdtr/PstlAdr/BldgNb PstCd PostCode[0..1] Text C Pain.001: CdtTrfTxInf/Cdtr/PstlAdr/PstCd TwnNm TownName[0..1] Text C Pain.001: CdtTrfTxInf/Cdtr/PstlAdr/TwnNm CtrySubDv CountrySubDivision[0..1] Text N Not used sn Ctry Country[0..1] Code C Pain.001: CdtTrfTxInf/Cdtr/PstlAdr/Ctry AdrLine AddressLine[0..7] Text C Pain.001: CdtTrfTxInf/Cdtr/PstlAdr/AdrLine Id Identification[0..1] C OrgId OrganisationIdentification[1..1] C Corporate customer s id if present BICOrBEI BICOrBEI[0..1] Identifier N Not used Othr Other[0..n] N Not used Id Identification[1..1] Text N Not used Schem SchemeName[0..1] N Not used enm Cd Code[1..1] Code N Not used Prtry Proprietary[1..1] Text N Not used Issr Issuer[0..1] Text N Not used PrvtId PrivateIdentification[1..1] Othr Other[0..n] Id Identification [1..1] Text C Private id if present A Schme SchemeName [0..1] Not used Nm Cd Code Code N Not used Prtry Proprietary Text N Not used CdtrAcct CreditorAccount [0..1] C Id Identification [0..1] Text C Iban IBAN Account number C Creditor account number in IBAN-format FI Othr Other Id Id Text C Creditor account number in BBAN-format

10 Page 10 of 14 Camt.054 Description UltmtCdtr UltimateCreditor [0..1] C Nm Name [0..1] Text C, Name of the ultimate creditor. If exists in original payment will be shown always. Lopullinen saaja Oy PstlAdr PostalAddress[0..1] N Not used AdrTp Address [0..1] Code N Not used Dept Department [0..1] Text N Not used SubDept SubDepartment [0..1] Text N Not used StrtNm StreetName[0..1] Text N Not used BldgNb BuildingNumber[0..1] Text N Not used PstCd PostCode[0..1] Text N Not used TwnNm TownName[0..1] Text N Not used CtrySubDv CountrySubDivision[0..1] Text N Not used sn Ctry Country[0..1] Code N Not used AdrLine AddressLine[0..7] Text N Not used Id C OrgId OrganisationIdentification[1..1] C Corporate customer s Id if present BICOrBEI BICOrBEI[0..1] Identifier C Othr Other[0..n] C Id Identification[1..1] Text C Eg. LY-number, Schem SchemeName[0..1] N Not used enm Cd Code[1..1] Code N Not used Prtry Proprietary[1..1] Text N Not used Issr Issuer[0..1] Text N Not used PrvtId PrivateIdentification[1..1] Text Private Id Othr Other[0..n] Text Id Identification [1..1] Text C Social security number A Schme SchemeName [0..1] Not used Nm Cd Code Code N Not used Prtry Proprietary Text Not used TradgPty TradingParty [0..1] N Not used Prtry Proprietary [0..n] N Not used Tp [1..1] N Not used

11 Page 11 of 14 Camt.054 Description Pty Party [1..1] N Not used RltdAgts RelatedAgents [0..1] C Not used DbtrAgt DebtorAgent [0..1] N Not used CdtrAgt CreditorAgent [0..1] FinInstnId FinancialInstitutionIdentification [1..1] BIC BIC Identifier C Creditor s BIC from booked transaction. DABAFIHH. Pain.001:CdtTrfTxInf/CdtrAgt/FinInstnId/BIC ClrSysMm ClearingSystemMemberIdentifi bid cation ClrSysId ClearingSystemIdentification Cd Code C Pain.001:CdtTrfTxInf/CdtrAgt/FinInstnId/CmbndId/Clr SysMmbId/Id Nm Name C Pain.001:CdtTrfTxInf/CdtrAgt/FinInstnId/CmbndId/Na me PstlAdr PostalAddress C StrtNm C Pain.001:CdtTrfTxInf/CdtrAgt/FinInstnId/CmbndId/Ps tladr/strtnm BldgNb C Pain.001:CdtTrfTxInf/CdtrAgt/FinInstnId/CmbndId/Ps tladr/bldgnb PstCd C Pain.001:CdtTrfTxInf/CdtrAgt/FinInstnId/CmbndId/Ps tladr/pstcd TwnNm C Pain.001:CdtTrfTxInf/CdtrAgt/FinInstnId/CmbndId/Ps tladr/twnnm Ctry C Pain.001:CdtTrfTxInf/CdtrAgt/FinInstnId/CmbndId/Ps tladr/ctry AdrLine C Pain.001:CdtTrfTxInf/CdtrAgt/FinInstnId/CmbndId/Ps tladr/adrline Purp Purpose [0..1] C Cd Code [1..1] Code C Recurring payment type, Eg. PENS PENS Pain.001: CdtTrfTxInf/Purp/Cd Prtry Proprietary [1..1] Text N Not used RmtInf RemittanceInformation [0..1] C Ustrd Unstructured [0..n] Text C Free format info Vapaata viestiä Strd Structured [0..n] C

12 Page 12 of 14 Camt.054 Description RfrdDocInf ReferredDocumentInformation [0..n] N Not used Tp [0..1] N Not used CdOrPrtr CodeOrProprietary [1..1] N Not used y Cd Code [1..1] Code N Not used Prtry Proprietary [1..1] N Not used Issr Issuer [0..1] Text N Not used Nb Number [0..1] Text N Not used RltdDt RelatedDate [0..1] DateTime N Not used RfrfDocAmt ReferredDocumentAmount [0..1] N Not used DuePyblA mt DuePayableAmount [0..1] Amount N Not used DscntApld DiscountAppliedAmount [0..1] Amount N Not used Amt CdtNoteA CreditNoteAmount [0..1] Amount N Not used mt TaxAmt TaxAmount [0..1] Amount N Not used AdjstmntAAdjustmentAmtAndRsn [0..n] N Not used mtandrsn Amt Amount [0..1] Amount N Not used CdtDbtIn CreditDebitIndicator [0..1] Code N Not used d Rsn Reason [0..1] Text N Not used AddtlInf AdditionalInformation [0..1] Text N Not used RmtdAmt RemittedAmount [0..1] Amount N Not used CdtrRefInf CreditorReferenceInformation C [0..1] Tp [1..1] C CdOrPrtr CodeOrProprietary [1..1] C y Cd Code [1..1] Code C Pain.001: SCOR CdtTrfTxInf/RmtInf/Strd/CdtrRefInf/Cdtr/RefTp/Cd Prtry Proprietary [1..1] Text C Not used Issr Issuer [0..1] Text C if RF reference, otherwise tag not present Ref Reference [0..1] Text C RF or national reference. RF

13 Page 13 of 14 Camt.054 Description Pain.001: CdtTrfTxInf/RmtInf/Strd/CdtrRefInf/CdtrRef Invcr Invoicer [0..1] N Not used Invcee Invoicee [0..1] N Not used AddtlRmtInf AdditionalRemittanceInformatio n [0..3] Text C Free format message Viestiä RltdDts RelatedDates [0..1] C AccptncDtT m AcceptanceDateTime [0..1] DateTime Payment date T01:01: IntrBkSttlmD InterbankSettlementDate [0..1] Date Time C Interbank settlement date. t +++++TtlTaxAmt TotalTaxAmount [0..1] N Not used +++++Dt Date [0..1] N Not used RtrInf ReturnInformation [0..1] N Rsn Reason [0..1] C Cd Code [1..1] C Value ACSC in accepted payments Prtry Proprietary [1..1] N Not used AddtlInf AdditionalInformation [0..n] C Value PROCESSED in accepted payments 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 AdditionalTransactionInformati C Receiver charges on OUR-payments on [0..1] AddtlNtryInf AdditionalEntryInformation [0..1] N Not used AddtlStmtInf AdditionalStatementInfromatio n [0..1] Text Not used

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