XML account report CAMT Service description April 2013

Transcription

1 XML account report CAMT Service description April 2013

2 Content 1 Purpose of the document Account report as an XML file Downloading of files Technical information Elements in the message... 3

3 1 Purpose of the document This document describes the XML message and the elements which are used to report the intraday account report electronically. The description can be supplemented and changes are possible. 2 Account report as an XML file The account report is used to inform the account owner, or authorised party, of the entries reported to the account, and/or to provide the owner with balance information on the account at a given point in time. 2.1 Downloading of files The customer downloads the electronic account report from the bank's file transfer service. The file type of the files retrieved from Nordea's file transfer is NCDXBAL0L. A customer using the Web Services protocol selects downloadable files based on the DownloadFileList. 3 types of camt.052 messages are available: 1) Only account balances (BALANCE) 2) Only new transactions and account balances (NEW) 3) All transactions for current date and account balances (ALL) Each camt.052 message type has different subtype value in ApplicationResponse. SubType for account balances is BALANCE, for new transactions NEW and for all transactions ALL. <c2b:applicationresponse xmlns:c2b=" <c2b:customerid123</c2b:customerid <c2b:subtypebalance</c2b:subtype Subtype ALL is available for last 8 days. Detailed instructions can be found in the service description of the Web Services data transmission. A customer using Nordea's Netbank services for companies or Corporate Netbank selects the downloadable files from the file transfer download menu in Netbank. The customer selects accounts and days to be downloaded. Information is delivered in one message within one Group Header when the message size is not over 50 MB. If the message exceeds the maximum size, the request for download will get an error message and the customer must download accounts and/or days separately or in smaller groups. 3 Technical information Message name: BankToCustomerAccountReportV02 Scheme name of the message: <camt ISO documentation:

4 3.1 Elements in the message The following elements are used in the account report message. The receiving software should be able to process the message with all the information in accordance with the scheme, not only the information in the elements described in this document. It is recommended that all information is directed into error reports or a user interface to be utilised if needed eg for investigations or corrections in the reconciliation process. Message item XML tag Mult Content example Comment A. GroupHeader <GrpHdr [1..1] MessageIdentification <MsgId [1..1] NDEA-CAMT T09:46:1894 CreationDateTime <CreDtTm [1..1] T09:46:18Z MessagePagination <MsgPgtn [0..1] Not in use Report <Rpt [1..n] Identifier given when the message was created Creation time according to the download Identification <Id [1..1] ElectronicSequenceNumber <ElctrncSeqN b [0..1] 7 CAMT52- FI CreationDateTime <CreDtTm [1..1] T08:06:00Z FromToDate <FrToDt [0..1] FromDateTime <FrDtTm [1..1] T00:00:00Z ToDateTime <ToDtTm [1..1] T00:00:00Z Account <Acct [1..1] Unique identification within at least three months Running number which begins from 1 when camt.052 is taken in use and grows independently of transactions. Time when statement was created. Reporting period Daily statement has same day in FromDateTime as in ToDateTime. Starting time of reported period Time when last reported transaction was booked on account Identification <Id [1..1] IBAN <IBAN [1..1] LV62NDEA Type <Tp [0..1] Code <Cd [1..1] CASH Currency <Ccy [0..1] EUR Used codes: CACC = Current SACC = Settlement ODTF = Overdraft SVGS = Savings CASH = Accounts of Group Account service Owner <Ownr [0..1] Name <Nm [0..1] Oy Company Ab Account owner s name as registered in the bank s customer information Servicer <Svcr [0..1] April

5 FinancialInstitutionIdentificat ion <FinInstnId [1..1] BIC <BIC [0..1] Name <Nm [0..1] Balance <Bal [1..n] NDEALV2X NDEALT2X NDEAEE2X Nordea Bank Latvia Nordea Bank Lithuania Nordea Bank Estonia Type <Tp [1..1] CodeOrProprietary <CdOrPrtry [1..1] Code <Cd [1..1] ITAV CreditLine <CdtLine [0..1] Included <Incl [1..1] true Amount <Amt [0..1] EUR CreditDebitIndicator <CdtDbtInd [1..1] CRDT ITAV = InterimAvailable ITBD = InterimBooked Presented only for balance type ITAV true = Account has a credit line false = Account has no credit line Amount and currency of credit line CRDT = Credit balance DBIT = Debit balance Date <Dt [1..1] Date of balance TransactionsSummary TotalCreditEntries <TxsSummry <TtlCdtNtries [0..1] [0..1] NumberOfEntries <NbOfNtries [0..1] 20 Sum <Sum [0..1] Credit entries reported in the statement including corrections related to debits TotalDebitEntries <TtlDbtNtries [0..1] NumberOfEntries <NbOfNtries [0..1] 15 Debit entries reported in the statement including corrections related to credits Sum <Sum [0..1] Entry <Ntry [0..n] EntryReference <NtryRef [0..1] Amount <Amt [1..1] EUR CreditDebitIndicator <CdtDbtInd [1..1] DBIT Status <Sts [1..1] BOOK BookingDate <BookgDt [0..1] Date or DateTime ValueDate <ValDt [0..1] Running number inside the statement in case CRDT = credit entry DBIT = debit entry BOOK = booked into the account <Dt [0..1] Booking date <DtTm [0..1] T17:16:00 Booking date and time Date <Dt [0..1] Value date April

6 BankTransactionCode <BkTxCd [1..1] Domain <Domn [0..1] Code <Cd [1..1] PMNT Family <Fmly [1..1] Code <Cd [1..1] ICDT SubFamilyCode <SubFmlyCd [1..1] ESCT PMNT = payments LDAS = interests of deposits and loans CAMT = transactions related to liquidity management DERV = Derivatives FORX = Foreign Exchange TRAD = Trade Service SECU = Securities ACMT = Account Management MDOP = Miscellaneous Debit Operations CNTR = Counter Transactions MCOP = Miscellaneous CreditOperations ICDT = Issued Credit Transfer RCDT = Received Credit Transfer IDDT = Issued Direct Debit CCRD = Customer Card Transactions SWAP = Swaps OTHR = Other SPOT = Spots FTDP = Fixed Term Deposits FTLN = Fixed Term Loans MGLN = Mortgage Loans GUAR = Guarantees MCRD = Merchant Card Transactions RDDT = Received Direct Debit CAPL = Cash Pooling ACCB = Account Balancing ESCT = SEPA credit transfer DMCT = national credit transfer SALA = salary, pension PMDD = national direct debit STDO = standing order CHRG = charge OTHR = other RIMB = payment such as April

7 Proprietary <Prtry [0..1] Code <Cd [1..1] TII Issuer <Issr [0..1] Nordea EntryDetails <NtryDtls [0..n] TransactionDetails <TxDtls [0..n] References <Refs [0..1] loan repayment INTR = interest NTAV = not available CWDL = Cash Withdrawal COMM = Commission FEES = Fees TAXE = Taxes CDPT = Cash Deposit BOOK = Internal Book Transfer RRTN = Reversal due to Payment Return XBCT = Cross-Border Credit Transfer POSC = Credit Card Payment DPST = Deposit DDWN = Drawdown PPAY = Principal Payment RPMT = Repayment POSD = Point-of-Sale (POS) Payment POSP = Point-of-Sale (POS) Payment Entry definition codes used by Finnish banks are delivered In the Proprietary element during the SEPA transition period. The same transaction code which are provided on MT940 and MT942 messages AccountServicerReference <AcctSvcrRef [0..1] CEAG0003 InstructionIdentification <InstrId [0..1] E EndToEndIdentification <EndToEndId AmountDetails <AmtDtls [0..1] [0..1] E2E-AOS Filing code given in the bank s payment or booking process. InstructionIdentification originates from debtor and reported only for the debtor. EndToEndIdentification originates from debtor and reported for both parties, the debtor and the creditor. Used only for SEPA payments and interbank payments initiated by PAIN messages InstructedAmount <InstrdAmt [0..1] April

8 Amount <Amt [1..1] USD Original amount from payment instruction. Provided only if differs from Transaction ammount TransactionAmount <TxAmt [0..1] Amount <Amt [1..1] EUR CurrencyExchange <CcyXchg [0..1] SourceCurrency <SrcCcy [0..1] USD TargetCurrency <TrgtCcy [0..1] EUR Amount booked into the account Currency of the original payment instruction Currency of the executed payment ExchangeRate <XchgRate [1..1] 1.5 Exchange rate ContractIdentification <CtrctId [0..1] RelatedParties <RltdPties [0..1] Debtor <Dbtr [0..1] Provided only for credit transactions Name <Nm [0..1] Payer Matt Mathews Payer s name PostalAddress <PstlAdr [0..1] Address information from the payment Postal address is delivered in same format as given in payment instruction Country <Ctry [0..1] FI Country code Identification <id [0..1] OrganisationIdentification <OrgId [1..1] Party identifier is delivered in the element <OrgId also when the payer is a person. Other <Othr [0..1] Identification <Id [1..1] DebtorAccount <DbtrAcct [0..1] IBAN or Other <IBAN [1..1] LV75NDEA <Othr [1..1] Identification <Id [1..1] SchemeName <SchmeNm [0..1] BBAN UltimateDebtor <UltmtDbtr [0..1] If the account number is not in the IBAN format eg BBAN = basic bank account number When the payer is paying on behalf of some other party this element group can be delivered. Name <Nm [0..1] Payer Mary Mathews Original payer s name PostalAddress <PstlAdr [0..1] Address information from the payment Postal address is delivered in same format as given in payment instruction Country <Ctry [0..1] LV Country code Identification <id [0..1] OrganisationIdentification <OrgId [1..1] Party identifier is delivered in the element <OrgId also when the payer is a person. April

9 Other <Othr [0..1] Identification <Id [1..1] Creditor <Cdtr [0..1] Name <Nm [0..1] Beneficiary Saara s Shop PostalAddress <PstlAdr [0..1] Provided only for debit transactions Delivered as given in payment instruction Country <Ctry [0..1] FI Country code Identification <id [0..1] OrganisationIdentification <OrgId [1..1] Party identifier is delivered in the element <OrgId also when the beneficiary is a person. Other <Othr [0..1] Identification <Id [1..1] FI CreditorAccount <CdtrAcct [0..1] Identification <Id [1..1] IBAN or Other <IBAN [1..1] FI <Othr [1..1] Identification <Id [1..1] SchemeName <SchmeNm [0..1] BBAN UltimateCreditor <UltmtCdtr [0..1] Name <Nm [0..1] Financed customer XYZ PostalAddress <PstlAdr [0..1] If the account number is not in the IBAN format eg BBAN = basic bank account number Can be delivered eg in factoring cases Delivered as given in payment instruction Country <Ctry [0..1] FI Country code Identification <Id [0..1] OrganisationIdentification <OrgId [1..1] Party identifier is delivered in the element <OrgId also when the beneficiary is a person. Other <Othr [0..1] Identification <Id [1..1] FI RelatedAgents <RltdAgts [0..1] CreditorAgent <CdtrAgt [0..1] FinancialInstitutionIdentificat ion <FinInstnId [1..1] BIC <BIC [0..1] NDEAFIHH Purpose <Purp [0..1] Proprietary <Prtry [1..1] 1111 RemittanceInformation <RmtInf [0..1] Unstructured <Ustrd [0..1] Invoices 111, 222 and 333 Code or text originating from the pain.001 message Used only in Lithuania to provide Tax code One occurrence (max 140 characters) free-form April

10 Structured <Strd [0..1] text CreditorReferenceInformatio n <CdtrRefInf [0..1]. Type <Tp [0..1] CodeOrProprietasy <CdOrPrtry [0..1] Code <Cd [1..1] SCOR SCOR = Structured communication reference Reference <Ref April