Skip to main content
Skip table of contents

ISO20022Validator

ISO20022 represents financial message standards used in communication between financial institutions, their clients and the domestic or international market infrastructures involved in the processing of financial transactions. ISO20022Validator is a component to validate message structure and data of ISO20022 standard compliant XML messages.

Configuration and Testing

Component Configuration


Figure 1: ISO20022Validator Configuration properties in the CPS

Attributes

Error Handling Configuration

Actions that have to be taken when an error occurs are defined in the Error Handling panel.

Refer to the Error Handling section the Common Configurations page for details regarding the various error handling configuration properties as below:

  • JMS Error
  • Response Generation Error
  • Request Processing Error
  • Invalid Request Error
Message Type

Select message type of the incoming message which needs to be validated according to ISO20022 message standard. Message types that are supported by the component include the following:

  • Category - Cash Management
    • camt.052.001.02 - BankToCustomerAccountReportV02
    • camt.053.001.02 - BankToCustomerStatementV02
  • Category - Payments Clearing and Settlement
    • pacs.008.001.03 - FIToFICustomerCreditTransferV03
    • pacs.009.001.03 FinancialInstitutionCreditTransferV03


Figure 2: ISO20022 Message Type

Expert Properties

Enable the Show Expert Properties checkbox to configure these properties.

Expert properties are meant for advanced users; use it with caution.


Figure 2: ISO20022Validator CPS with the Expert properties enabled and highlighted

Pre Processing XSL Configuration

Pre Processing XSL configuration can be used to transform request message before processing it. Click the ellipses button against the property to configure the properties.

Refer to the Pre/Post Processing XSL Configuration section in the Common Configurations page for details regarding Pre Processing XSL configuration and Post Processing XSL configuration (below).

Post Processing XSL Configuration 

Post Processing XSL configuration can be used to transform response message before sending it to the output port.

Process Message Based on Property

The property helps components to skip certain messages from processing.

Refer to the Process Message Based On a Property section in the Common Configurations page.

Threadpool Configuration

 This property is used when there is a need to process messages in parallel within the component, still maintaining the sequence from the external perspective. 

Refer to the Threadpool Configuration section in the Common Configurations page.

Testing

Validation

ISO20022Validator does two kinds of validation:

  • Schema Validation: The component first validates the incoming XML message against respective schemas defined by ISO20022. These schemas are bundled with the installer and are present in %FIORANO_HOME%\xml-catalog\fiorano\swift\iso20022.
  • Data Validation: Validation is performed on the data according to the Rules and Guidelines defined in Message Definition Report, also issued by ISO20022.

Input and Output

Sample Input

An XML instance of message type camt.052.001.02

XML
 <?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.052.001.02" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <BkToCstmrAcctRpt>
      <GrpHdr>
         <MsgId>AAAASESS-FP-ACCR001</MsgId>
         <CreDtTm>2010-10-18T12:30:00+01:00</CreDtTm>
         <MsgPgntn>
            <PgNb>1</PgNb>
            <LastPgInd>true</LastPgInd>
         </MsgPgntn>
      </GrpHdr>
      <Rpt>
         <Id>AAAASESS-FP-ACCR001</Id>
         <CreDtTm>2010-10-18T12:30:00+01:00</CreDtTm>
         <FrToDt>
            <FrDtTm>2010-10-18T08:00:00+01:00</FrDtTm>
            <ToDtTm>2010-10-18T12:30:00+01:00</ToDtTm>
         </FrToDt>
         <Acct>
            <Id>
               <Othr>
                  <Id>50000000054910000003</Id>
               </Othr>
            </Id>
            <Ownr>
               <Nm>FINPETROL</Nm>
            </Ownr>
            <Svcr>
               <FinInstnId>
                  <Nm>AAAA BANKEN</Nm>
                  <PstlAdr>
                     <Ctry>SE</Ctry>
                  </PstlAdr>
               </FinInstnId>
            </Svcr>
         </Acct>
         <Ntry>
            <Amt Ccy="SEK">200000</Amt>
            <CdtDbtInd>DBIT</CdtDbtInd>
            <Sts>BOOK</Sts>
            <BookgDt>
               <DtTm>2010-10-18T10:15:00+01:00</DtTm>
            </BookgDt>
            <ValDt>
               <Dt>2010-10-18</Dt>
            </ValDt>
            <AcctSvcrRef>AAAASESS-FP-ACCR-01</AcctSvcrRef>
            <BkTxCd>
               <Domn>
                  <Cd>PAYM</Cd>
                  <Fmly>
                     <Cd>0001</Cd>
                     <SubFmlyCd>0003</SubFmlyCd>
                  </Fmly>
               </Domn>
            </BkTxCd>
            <NtryDtls>
               <Btch>
                  <MsgId>FINP-0055</MsgId>
                  <PmtInfId>FINP-0055-001</PmtInfId>
                  <NbOfTxs>20</NbOfTxs>
               </Btch>
            </NtryDtls>
         </Ntry>
         <Ntry>
            <Amt Ccy="SEK">30000</Amt>
            <CdtDbtInd>CRDT</CdtDbtInd>
            <Sts>PDNG</Sts>
            <ValDt>
               <Dt>2010-10-18</Dt>
            </ValDt>
            <AcctSvcrRef>AAAASESS-FP-CONF-FX</AcctSvcrRef>
            <BkTxCd>
               <Domn>
                  <Cd>TREA</Cd>
                  <Fmly>
                     <Cd>0002</Cd>
                     <SubFmlyCd>0000</SubFmlyCd>
                  </Fmly>
               </Domn>
            </BkTxCd>
            <NtryDtls>
               <TxDtls>
                  <Refs>
                     <InstrId>FP-004567-FX</InstrId>
                     <EndToEndId>AAAASS1085FINPSS</EndToEndId>
                  </Refs>
                  <AmtDtls>
                     <CntrValAmt>
                        <Amt Ccy="EUR">3255</Amt>
                        <CcyXchg>
                           <SrcCcy>EUR</SrcCcy>
                           <XchgRate>0.185</XchgRate>
                        </CcyXchg>
                     </CntrValAmt>
                  </AmtDtls>
               </TxDtls>
            </NtryDtls>
         </Ntry>
      </Rpt>
   </BkToCstmrAcctRpt>
</Document>

Output

Output of the component is the same as the input if the incoming message passes all of the validation criteria.

An exception message with a reason for the failure of validation is sent on the ON_EXCEPTION port if the validation fails.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.