ISO20022 Message Validator Demo

This project is part of the FINaplo product and is here to demonstrate how our SDK for SWIFT MX (ISO20022) Messages Validation works. For our demonstration we are going to use the demo SDK which can parse/validate/generate a pacs.002.001.XX message.

It's a simple maven project, you can download it and run it, with Java 1.8 or above.

Table of Contents

1. SDK Setup
2. HOW-TO Use the SDK
3. CBPR+ Messages
4. SCRIPS (MEPS+) messages
5. TARGET2 (RTGS) messages
6. FedNow messages
7. SIC/euroSIC messages
8. BAHTNET messages
9. [CGI-MP messages](#CGI-MP messages)
10. SEPA Messages
    • SEPA-EPC Credit Transfer
    • SEPA-EPC Direct Debit
    • SEPA-EPC Instant Payment
    • SEPA-EBA Credit Transfer
    • SEPA-DIAS Credit Transfer
    • SEPA-SIBS Credit Transfer
    • SEPA-SIBS Direct Debit

SDK setup

Incorporate the SDK jar into your project by the regular IDE means. This process will vary depending upon your specific IDE and you should consult your documentation on how to deploy a bean. For example in Eclipse all that needs to be done is to import the jar files into a project. Alternatively, you can import it as a Maven or Gradle dependency.

Maven

Define repository in the repositories section

<repository>
    <id>paymentcomponents</id>
    <url>https://nexus.paymentcomponents.com/repository/public</url>
</repository>

Import the SDK

<dependency>
    <groupId>gr.datamation.mx</groupId>
    <artifactId>mx</artifactId>
    <version>23.17.0</version>
    <classifier>demo</classifier>
</dependency>

Gradle

Define repository in the repositories section

repositories {
    maven {
        url "https://nexus.paymentcomponents.com/repository/public"
    }
}

Import the SDK git push https://gantoniadispc14:[email protected]/Payment-Components/demo-iso20022.git main

implementation 'gr.datamation.mx:mx:23.17.0:demo@jar'

In case you purchase the SDK you will be given a protected Maven repository with a user name and a password. You can configure your project to download the SDK from there.

Other dependencies

There is a dependency in groovy-all library which is required for some of the included features (version 2.4.8 or later). There is also a dependency in classgraph library which is required for some of the included features (version 4.8.153 or later). You can use maven or gradle to add the dependencies below or manually include the jar to your project.

Maven

<dependency>
    <groupId>org.codehaus.groovy</groupId>
    <artifactId>groovy-all</artifactId>
    <version>2.4.8</version>
</dependency>
<dependency>
   <groupId>io.github.classgraph</groupId>
   <artifactId>classgraph</artifactId>
   <version>4.8.153</version>
</dependency>

Gradle

compile group: 'org.codehaus.groovy', name: 'groovy-all', version: '2.4.8'
compile group: 'io.github.classgraph', name: 'classgraph', version: '4.8.153'

HOW-TO Use the SDK

All ISO20022 messages are identified by a code id and a name. The code id (FIToFIPmtStsRpt) and the name (FIToFIPaymentStatusReportV11) are located in the .xsd file that describes the XML schema of each message. Both the name and the code id of the message are available in the ISO20022 messages catalogue.

Inside pacs.002.001.11.xsd

<xs:complexType name="Document">
    <xs:sequence>
        <xs:element name="FIToFIPmtStsRpt" type="FIToFIPaymentStatusReportV11"/>
    </xs:sequence>
</xs:complexType>

Message objects

For every ISO20022 message there is an equivalent class in our SDK. The name of the class is equivalent to the name of the message. For example the name of the class for the message named FIToFIPaymentStatusReportV11 is FIToFIPaymentStatusReport11 (using version 11 of FIToFIPmtStsRpt). Each message has its own versions which are all maintained according to the yearly ISO20022 guidelines.

Building and validating messages

There are three steps the user must follow in order to build a new Swift MX message:

1. Initialize the class corresponding to the message.

   The initialization of the class is as simple as initializing any class in Java. For the example message we are using here (FIToFIPaymentStatusReport11) the initialization would be

   FIToFIPaymentStatusReport11 message = new FIToFIPaymentStatusReport11();
   

   The above command will initialize a class for this message named FIToFIPaymentStatusReport11 which is initially empty.

   Validating a text

   ValidationErrorList errorList = message.validateXML(new ByteArrayInputStream("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +
                                                                                "<Document xmlns=\"urn:iso:std:iso:20022:tech:xsd:pacs.002.001.11\">\n" +
                                                                                "  <FIToFIPmtStsRpt>\n" +
                                                                                "     ............\n" +
                                                                                "  </FIToFIPmtStsRpt>\n" +
                                                                                "</Document>".getBytes()));
   

   Parsing a text

   message.parseXML("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +
                    "<Document xmlns=\"urn:iso:std:iso:20022:tech:xsd:pacs.002.001.11\">\n" +
                    "  <FIToFIPmtStsRpt>\n" +
                    "     ............\n" +
                    "  </FIToFIPmtStsRpt>\n" +
                    "</Document>");
   

   Auto parse and validate

   In case we do not know the class of the message, we can use the auto parse and validate from the xml. Auto validating a text

   ValidationErrorList errorList = MXUtils.autoValidateXML(new ByteArrayInputStream("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +
                                                                                    "<Document xmlns=\"urn:iso:std:iso:20022:tech:xsd:pacs.002.001.11\">\n" +
                                                                                    "  <FIToFIPmtStsRpt>\n" +
                                                                                    "     ............\n" +
                                                                                    "  </FIToFIPmtStsRpt>\n" +
                                                                                    "</Document>".getBytes()));
   

   Auto parsing a text

   Message message = MXUtils.autoParseXML("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +
                                           "<Document xmlns=\"urn:iso:std:iso:20022:tech:xsd:pacs.002.001.11\">\n" +
                                           "  <FIToFIPmtStsRpt>\n" +
                                           "     ............\n" +
                                           "  </FIToFIPmtStsRpt>\n" +
                                           "</Document>");
   

2. Add data to the class.

   The next step is to add data to the new message. In order to add some data to the message, user must know which element in the message tree he wants to add. The element he wants to add is identified by an XML path. The value of the element user wants to add may be a String, a Boolean or a complex type that is described in the SWIFT MX type catalog.

   So to enter some data into the message, user must call the following method of the previously instantiated object where the path argument is a String identifying the element to add and the value argument is an Object.

   message.setElement("path/to/field", "value");
   

   User can also work with the XSD defined classes that represent a tag. e.g. GroupHeader91 for GrpHdr tag.

   message.getMessage().setGrpHdr(new GroupHeader91()); // setGrpHdr() method accepts iso.pacs_002_001_11.GroupHeader91 objects
   

3. Validate the message.

   After building a Swift MX message using the appropriate class, user may want to validate this message. Of course validation is not mandatory but is the only way to prove that the message is correct. Validation is performed by calling the validate() method and internally is a two step process:

   • Validation against the schema of the message in order to ensure that the message is a well-formed instance of it.
   • Validation against any Validation Rule as described for that message by the ISO20022 rules.

   The validate() method returns an ArrayList containing the validation errors that may occur. Each error is contained in the ArrayList as a ValidationError object describing the error.

   ValidationErrorList errorList = message.validate();
   

Resolve Paths

For each message object we can call the resolvePaths() method on the object.
This method returns the xml as paths, from root element to the leaf.
It returns a List and each element of the List is a String array consisted of 3 elements:

1. Field Path excluding the leaf code
2. Leaf code
3. Leaf value
4. Leaf attributes (e.g. Ccy=EUR;)

For example if we call the resolvePaths() on a pacs.002.001.12

FIToFIPaymentStatusReport12 pacs002 = new FIToFIPaymentStatusReport12();
//fill the message object or parse from an xml
List<String[]> paths = pacs002.resolvePaths();
for (String[] path: paths)
        System.out.println("Field path: " + path[0] + " | " + "Field code: " + path[1] +  " | " + "Field value: " + path[2] + " | " + "Field attributes: " + path[3]);

part of the output we will receive is

Field path: /Document/FIToFIPmtStsRpt/GrpHdr | Field code: MsgId | Field value: ABABUS23-STATUS-456/04 | Field attributes: null
Field path: /Document/FIToFIPmtStsRpt/GrpHdr | Field code: CreDtTm | Field value: 2015-06-29T09:56:00 | Field attributes: null
Field path: /Document/FIToFIPmtStsRpt/OrgnlGrpInfAndSts | Field code: OrgnlMsgId | Field value: AAAA100628-123v | Field attributes: null
Field path: /Document/FIToFIPmtStsRpt/OrgnlGrpInfAndSts | Field code: OrgnlMsgNmId | Field value: pacs.003.001.09 | Field attributes: null
Field path: /Document/FIToFIPmtStsRpt/TxInfAndSts | Field code: OrgnlEndToEndId | Field value: VA060327/0123 | Field attributes: null
Field path: /Document/FIToFIPmtStsRpt/TxInfAndSts | Field code: OrgnlTxId | Field value: AAAAUS29/100628/ad458 | Field attributes: null
Field path: /Document/FIToFIPmtStsRpt/TxInfAndSts | Field code: TxSts | Field value: RJCT | Field attributes: null

In case the child of an xml element is an array, we will receive an index of the element.
In our case, if pacs.002 had more than one FIToFIPmtStsRpt, the path would have an index. E.g.

/Document/FIToFIPmtStsRpt[0]/TxInfAndSts
/Document/FIToFIPmtStsRpt[1]/TxInfAndSts

Get Element

For each message object we can call the getElement() method on the object.
This method receives a field path until leaf and returns the field value. The value could be a simple String or a complex Object.
For example we can call the below in a pacs.002 message

pacs002.getElement("TxInfAndSts[0]/TxSts");

the output will be a "RJCT" String. If we call

pacs002.getElement("TxInfAndSts[0]");

the output will be a PaymentTransaction130 Object.
The use of index is necessary in case the element is an array.

Code Samples

In this project you can see code for all the basic manipulation of an MX message, like:

• Parse and validate valid pacs.002
• Parse and validate an invalid pacs.002 (get syntax, network validation errors)
• Build a valid pacs.002
• Convert an MX message to XML

CBPR+ messages

SDK Setup

Maven

<!-- Import the CBPR+ demo SDK-->
<dependency>
    <groupId>gr.datamation.mx</groupId>
    <artifactId>mx</artifactId>
    <version>23.17.0</version>
    <classifier>demo-cbpr</classifier>
</dependency>

Gradle

implementation 'gr.datamation.mx:mx:23.17.0:demo-cbpr@jar'

Please refer to General SDK Setup for more details.

Parse & Validate CBPR+ Message

In case you need to handle CBPR+ messages, then you need to handle objects of CbprMessage class.

//Initialize the cbprMessage
CbprMessage<BusinessApplicationHeader02, FIToFICustomerCreditTransfer08> cbprMessage = new CbprMessage<>(new BusinessApplicationHeader02(), new FIToFICustomerCreditTransfer08());
//Fill the cbprMessage with data from xml validate CBPR+ against the xml schema. We can also exit in case of errors in this step.
ValidationErrorList validationErrorList = cbprMessage.autoParseAndValidateXml(new ByteArrayInputStream(validCbprPacs008String.getBytes()));
//Perform validation in both header and message object using cbprMessage
//Use CbprMessage.CbprMsgType enumeration object to select the matching schema (check the table of supported CBPR messages below
//CbprMessage.extractCbprMsgType() can also be used
validationErrorList.addAll(cbprMessage.validate(CbprMessage.CbprMsgType.PACS_008));

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}
 
//Extract the header and the core message from cbprMessage object
BusinessApplicationHeader02 businessApplicationHeader = (BusinessApplicationHeader02)cbprMessage.getAppHdr();
FIToFICustomerCreditTransfer08 fiToFICustomerCreditTransfer = (FIToFICustomerCreditTransfer08) cbprMessage.getDocument();

AutoParse & Validate CBPR+ Message

//Initialize the cbprMessage
CbprMessage<?, ?> cbprMessage = new CbprMessage<>();
//Fill the cbprMessage with data from xml and validate CBPR+ against the xml schema. We can also exit in case of errors in this step.
ValidationErrorList validationErrorList = cbprMessage.autoParseAndValidateXml(new ByteArrayInputStream(validCbprPacs008String.getBytes()));

//Perform validation in both header and message object using cbprMessage
validationErrorList.addAll(cbprMessage.autoValidate());

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Construct CBPR+ Message

//Initialize the header object
BusinessApplicationHeader02 businessApplicationHeader = new BusinessApplicationHeader02();
businessApplicationHeader.parseXML(validCbprPacs008HeaderString);

//Initialize the document object
FIToFICustomerCreditTransfer08 fiToFICustomerCreditTransfer = new FIToFICustomerCreditTransfer08();
fiToFICustomerCreditTransfer.parseXML(validCbprPacs008DocumentString);

//We fill the elements of the message object using setters
fiToFICustomerCreditTransfer.getMessage().setGrpHdr(new GroupHeader93());
fiToFICustomerCreditTransfer.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
fiToFICustomerCreditTransfer.setElement("GrpHdr/MsgId", "1234");

//Construct the CBPR message object      
CbprMessage<BusinessApplicationHeader02, FIToFICustomerCreditTransfer08> cbprMessage = new CbprMessage<>(businessApplicationHeader, fiToFICustomerCreditTransfer);

//Perform validation in both header and message object using cbprMessage
//Use CbprMessage.CbprMsgType enumeration object to select the matching schema (check the table of supported CBPR messages below)
//CbprMessage.extractCbprMsgType() can also be used
ValidationErrorList validationErrorList = cbprMessage.validate(CbprMessage.CbprMsgType.PACS_008); 

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

In case you want to enclose the CBPR+ message under another Root Element, use the code below

cbprMessage.encloseCbprMessage("RequestPayload") //In case you want RequestPayload

Code samples

Parse and validate CBPR+ message

Supported CBPR+ Message Types (v2.1)

Auto replies

Sample code for FIToFICustomerCreditTransferCbprAutoReplies can be found here.
Sample code for FinancialInstitutionCreditTransferCbprAutoReplies can be found here.
Sample code for FIToFIPaymentCancellationRequestCbprAutoReplies can be found here.

Please refer to general auto replies for more details.

SCRIPS (MEPS+) messages

Parse & Validate SCRIPS Message

In case you need to handle SCRIPS messages, then you need to handle objects of ScripsMessage class.

//Initialize the scripsMessage
ScripsMessage<BusinessApplicationHeader02, FinancialInstitutionCreditTransfer08> scripsMessage = new ScripsMessage<>(new BusinessApplicationHeader02(), new FinancialInstitutionCreditTransfer08());
//Fill the scripsMessage with data from xml and validate SCRIPS against the xml schema
ValidationErrorList validationErrorList = scripsMessage.autoParseAndValidateXml(new ByteArrayInputStream(validScripsPacs009CoreString.getBytes()));
//Perform validation in both header and message object using scripsMessage
//Use ScripsMessage.ScripsMsgType enumeration object to select the matching schema (check the table of supported SCRIPS messages below
//ScripsMessage.extractScripsMsgType() can also be used
validationErrorList.addAll(scripsMessage.validate(ScripsMessage.ScripsMsgType.PACS_009_CORE));

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}
 
//Extract the header and the core message from scripsMessage object
BusinessApplicationHeader02 businessApplicationHeader = (BusinessApplicationHeader02)scripsMessage.getAppHdr();
FIToFICustomerCreditTransfer08 fiToFICustomerCreditTransfer = (FIToFICustomerCreditTransfer08) scripsMessage.getDocument();

AutoParse SCRIPS Message

//Initialize the scripsMessage
ScripsMessage<?, ?> scripsMessage = new ScripsMessage<>();
//Fill the scripsMessage with data from xml and validate SCRIPS against the xml schema
ValidationErrorList validationErrorList = scripsMessage.autoParseAndValidateXml(new ByteArrayInputStream(validScripsPacs009CoreString.getBytes()));

//Perform validation in both header and message object using scripsMessage
validationErrorList.addAll(scripsMessage.autoValidate());

if (validationErrorList.isEmpty()) {
    System.out.println("Message is valid");
    System.out.println(scripsMessage.convertToXML()); //Get the generated xmls for head and document
} else {
    handleValidationError(validationErrorList);
}

Construct SCRIPS Message

//Initialize the document object
FinancialInstitutionCreditTransfer08 financialInstitutionCreditTransfer08 = new FinancialInstitutionCreditTransfer08();
financialInstitutionCreditTransfer08.parseXML(validScripsPacs009CoreDocumentString);

//We fill the elements of the message object using setters
//financialInstitutionCreditTransfer08.getMessage().setGrpHdr(new GroupHeader93())
//financialInstitutionCreditTransfer08.getMessage().getGrpHdr().setMsgId("1234")

//or setElement()
//financialInstitutionCreditTransfer08.setElement("GrpHdr/MsgId", "1234")

//Construct the SCRIPS message object using two separate objects, header, document
ScripsMessage<BusinessApplicationHeader02, FinancialInstitutionCreditTransfer08> scripsMessage = new ScripsMessage<>(businessApplicationHeader, financialInstitutionCreditTransfer08);

//Perform validation in both header and message object using scripsMessage
//Use ScripsMessage.ScripsMsgType enumeration object to select the matching schema (check the table of supported SCRIPS messages below
//ScripsMessage.extractScripsMsgType() can also be used
ValidationErrorList validationErrorList = scripsMessage.validate(ScripsMessage.ScripsMsgType.PACS_009_CORE);

if (validationErrorList.isEmpty()) {
    System.out.println("Message is valid");
    System.out.println(scripsMessage.convertToXML()); //Get the generated xmls for head and document
} else {
    handleValidationError(validationErrorList);
}

Code samples

Parse and validate SCRIPS message

Supported SCRIPS Message Types (v2.4)

TARGET2 (RTGS) messages

SDK Setup

Maven

<!-- Import the TARGET2 (RTGS) demo SDK-->
<dependency>
    <groupId>gr.datamation.mx</groupId>
    <artifactId>mx</artifactId>
    <version>23.17.0</version>
    <classifier>demo-rtgs</classifier>
</dependency>

Gradle

implementation 'gr.datamation.mx:mx:23.17.0:demo-rtgs@jar'

Please refer to General SDK Setup for more details.

Parse & Validate TARGET2 Message

In case you need to handle TARGET2 (RTGS) messages, then you need to handle objects that extend the ISO20022 classes.

//Initialize the message object
FIToFICustomerCreditTransfer08Rtgs fiToFICustomerCreditTransfer = new FIToFICustomerCreditTransfer08Rtgs();
//Validate against the xml schema. We can also exit in case of errors in this step.
ValidationErrorList validationErrorList = fiToFICustomerCreditTransfer.validateXML(new ByteArrayInputStream(validRtgsPacs008String.getBytes()));
//Fill the message with data from xml
fiToFICustomerCreditTransfer.parseXML(validRtgsPacs008String);
//Validate both the xml schema and rules
validationErrorList.addAll(fiToFICustomerCreditTransfer.validate());  

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

AutoParse TARGET2 Message

//Validate against the xml schema without knowing the message type. We can also exit in case of errors in this step.
ValidationErrorList validationErrorList = RtgsUtils.autoValidateXML(new ByteArrayInputStream(validRtgsPacs008String.getBytes()));
//Fill the message with data from xml without knowing the message type
Message message = RtgsUtils.autoParseXML(validRtgsPacs008String);
//Validate both the xml schema and rules
validationErrorList.addAll(message.validate());

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Construct TARGET2 Message

//Initialize the message object
FIToFICustomerCreditTransfer08 fiToFICustomerCreditTransfer = new FIToFICustomerCreditTransfer08();

//We fill the elements of the message object using setters
fiToFICustomerCreditTransfer.getMessage().setGrpHdr(new GroupHeader93());
fiToFICustomerCreditTransfer.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
fiToFICustomerCreditTransfer.setElement("GrpHdr/MsgId", "1234");

//Perform validation
ValidationErrorList validationErrorList = fiToFICustomerCreditTransfer.validate(); 

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Code samples

Parse and validate TARGET2 message

Supported TARGET2 Message Types (v2.2)

Auto replies

Sample code for FIToFICustomerCreditTransferRtgsAutoReplies can be found here.
Sample code for FinancialInstitutionCreditTransferRtgsAutoReplies can be found here.
Sample code for FIToFIPaymentCancellationRequestRtgsAutoReplies can be found here.

Please refer to general auto replies for more details.

FedNow messages

Parse & Validate FedNow Message

In case you need to handle FedNow messages, then you need to handle objects that extend the ISO20022 classes.

//Initialize the message object
FIToFICustomerCreditTransfer08Fednow fiToFICustomerCreditTransfer = new FIToFICustomerCreditTransfer08Fednow();
//Validate against the xml schema. We can also exit in case of errors in this step.
ValidationErrorList validationErrorList = fiToFICustomerCreditTransfer.validateXML(new ByteArrayInputStream(validFednowPacs008String.getBytes()));
//Fill the message with data from xml
fiToFICustomerCreditTransfer.parseXML(validFednowPacs008String);
//Validate both the xml schema and rules
validationErrorList.addAll(fiToFICustomerCreditTransfer.validate());  

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Auto Parse and Validate FedNow Message

//Validate against the xml schema without knowing the message type. We can also exit in case of errors in this step.
//We can use FednowUtils.FedNowMessageType enumeration in order to specify the fednow type we are interested in messages with multiple types (pacs.002, camt.052, camt.029)
ValidationErrorList validationErrorList = FednowUtils.autoValidateXML(new ByteArrayInputStream(validFednowPacs008String.getBytes()));
//Fill the message with data from xml without knowing the message type
Message message = FednowUtils.autoParseXML(validFednowPacs008String);
//Validate both the xml schema and rules
validationErrorList.addAll(message.validate());

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Construct FedNow Message

//Initialize the message object
FIToFICustomerCreditTransfer08Fednow fiToFICustomerCreditTransfer = new FIToFICustomerCreditTransfer08Fednow();

//We fill the elements of the message object using setters
fiToFICustomerCreditTransfer.getMessage().setGrpHdr(new GroupHeader93());
fiToFICustomerCreditTransfer.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
fiToFICustomerCreditTransfer.setElement("GrpHdr/MsgId", "1234");

//Perform validation
ValidationErrorList validationErrorList = fiToFICustomerCreditTransfer.validate(); 

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Code samples

Parse and validate FedNow message

Supported FedNow Message Types (29 June 2022)

Auto replies

Sample code for FIToFICustomerCreditTransferFednowAutoReplies can be found here.
Sample code for FIToFIPaymentCancellationRequestFednowAutoReplies can be found here.

SIC/euroSIC messages

Parse & Validate SIC/euroSIC Message

 //Initialize the message object
 FIToFICustomerCreditTransfer08SicEurosic fiToFICustomerCreditTransfer = new FIToFICustomerCreditTransfer08SicEurosic();
 //Validate against the xml schema. We can also exit in case of errors in this step.
 ValidationErrorList validationErrorList = fiToFICustomerCreditTransfer.validateXML(new ByteArrayInputStream(validSicEuroSicPacs008String.getBytes()));
 //Fill the message with data from xml
 fiToFICustomerCreditTransfer.parseXML(validSicEuroSicPacs008String);
 
 //Validate both the xml schema and rules
 validationErrorList.addAll(fiToFICustomerCreditTransfer.validate());
 
 if (validationErrorList.isEmpty()) {
 System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
 } else {
 System.out.println(validationErrorList);
 }

Auto Parse and Validate SIC/euroSIC Message

 //Initialize the message object
 FIToFICustomerCreditTransfer08SicEurosic fiToFICustomerCreditTransfer = new FIToFICustomerCreditTransfer08SicEurosic();

 //Validate against the xml schema without knowing the message type. We can also exit in case of errors in this step.
 ValidationErrorList validationErrorList = SicEurosicUtils.autoValidateXML(new ByteArrayInputStream(validSicEuroSicPacs008String.getBytes()));
 //Fill the message with data from xml without knowing the message type
 Message message = SicEurosicUtils.autoParseXML(validSicEuroSicPacs008String);
 
 //Validate both the xml schema and rules
 validationErrorList.addAll(message.validate());
 
 if (validationErrorList.isEmpty()) {
 System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
 } else {
 System.out.println(validationErrorList);
 }

Construct SIC/euroSIC Message

 //Initialize the message object
 FIToFICustomerCreditTransfer08SicEurosic fiToFICustomerCreditTransfer = new FIToFICustomerCreditTransfer08SicEurosic();

 //We fill the elements of the message object using setters
 fiToFICustomerCreditTransfer.getMessage().setGrpHdr(new GroupHeader93());
 fiToFICustomerCreditTransfer.getMessage().getGrpHdr().setMsgId("1234");
 fiToFICustomerCreditTransfer.getMessage().getGrpHdr().setNbOfTxs("0");
 //or setElement()
 fiToFICustomerCreditTransfer.setElement("GrpHdr/MsgId", "1234");
 fiToFICustomerCreditTransfer.setElement("GrpHdr/NbOfTxs", "0");

 //Perform validation
 ValidationErrorList validationErrorList = fiToFICustomerCreditTransfer.validate();

 if (validationErrorList.isEmpty()) {
 System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
 } else {
 System.out.println(validationErrorList);

Code samples

Parse and validate SIC/euroSIC message

Supported SIC/euroSIC Message Types (version 4.9)

BAHTNET messages

Parse & Validate Bahtnet Message

In case you need to handle Bahtnet messages, then you need to handle objects of BahtnetMessage class.

//Initialize the bahtnetMessage
BahtnetMessage<BusinessApplicationHeader02, FIToFICustomerCreditTransfer08> bahtnetMessage = new BahtnetMessage<>(new BusinessApplicationHeader02(), new FIToFICustomerCreditTransfer08());
//Fill the bahtnetMessage with data from xml validate Bahtnet against the xml schema. We can also exit in case of errors in this step.
ValidationErrorList validationErrorList = bahtnetMessage.autoParseAndValidateXml(new ByteArrayInputStream(validBahtnetPacs008String.getBytes()));
//Perform validation in both header and message object using bahtnetMessage
//Use BahtnetMessage.BahtnetMsgType enumeration object to select the matching schema (check the table of supported Bahtnet messages below
//BahtnetMessage.extractBahtnetMsgType() can also be used
validationErrorList.addAll(bahtnetMessage.validate(BahtnetMessage.BahtnetMsgType.PACS_008));

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}
 
//Extract the header and the core message from bahtnetMessage object
BusinessApplicationHeader02 businessApplicationHeader = (BusinessApplicationHeader02)bahtnetMessage.getAppHdr();
FIToFICustomerCreditTransfer08 fiToFICustomerCreditTransfer = (FIToFICustomerCreditTransfer08) bahtnetMessage.getDocument();

AutoParse & Validate Bahtnet Message

//Initialize the bahtnetMessage
BahtnetMessage<?, ?> bahtnetMessage = new BahtnetMessage<>();
//Fill the bahtnetMessage with data from xml and validate Bahtnet against the xml schema. We can also exit in case of errors in this step.
ValidationErrorList validationErrorList = bahtnetMessage.autoParseAndValidateXml(new ByteArrayInputStream(validBahtnetPacs008String.getBytes()));

//Perform validation in both header and message object using bahtnetMessage
validationErrorList.addAll(bahtnetMessage.autoValidate());

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Construct Bahtnet Message

//Initialize the header object
BusinessApplicationHeader02 businessApplicationHeader = new BusinessApplicationHeader02();
businessApplicationHeader.parseXML(validBahtnetPacs008HeaderString);

//Initialize the document object
FIToFICustomerCreditTransfer08 fiToFICustomerCreditTransfer = new FIToFICustomerCreditTransfer08();
fiToFICustomerCreditTransfer.parseXML(validBahtnetPacs008DocumentString);

//We fill the elements of the message object using setters
fiToFICustomerCreditTransfer.getMessage().setGrpHdr(new GroupHeader93());
fiToFICustomerCreditTransfer.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
fiToFICustomerCreditTransfer.setElement("GrpHdr/MsgId", "1234");

//Construct the Bahtnet message object      
BahtnetMessage<BusinessApplicationHeader02, FIToFICustomerCreditTransfer08> bahtnetMessage = new BahtnetMessage<>(businessApplicationHeader, fiToFICustomerCreditTransfer);

//Perform validation in both header and message object using bahtnetMessage
//Use BahtnetMessage.BahtnetMsgType enumeration object to select the matching schema (check the table of supported Bahtnet messages below)
//BahtnetMessage.extractBahtnetMsgType() can also be used
ValidationErrorList validationErrorList = bahtnetMessage.validate(BahtnetMessage.BahtnetMsgType.PACS_008); 

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFICustomerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

In case you want to enclose the Bahtnet message under another Root Element, use the code below

bahtnetMessage.encloseBahtnetMessage("RequestPayload") //In case you want RequestPayload

Code samples

Parse and validate BAHTNET message

Supported BAHTNET Message Types (03 March 2022)

CGI-MP messages

SDK Setup

Maven

<!-- Import the TARGET2 (RTGS) demo SDK-->
<dependency>
    <groupId>gr.datamation.mx</groupId>
    <artifactId>mx</artifactId>
    <version>23.17.0</version>
    <classifier>{CLIENT_CLASSIFIER}</classifier>
</dependency>

Gradle

implementation 'gr.datamation.mx:mx:23.17.0:{CLIENT_CLASSIFIER}@jar'

Please refer to General SDK Setup for more details.

Parse & Validate CGI-MP Message

In case you need to handle CGI-MP messages, then you need to handle objects that extend the ISO20022 classes.

//Initialize the message object
CustomerCreditTransferInitiation09RelayServiceCgiMp customerCreditTransfer = new CustomerCreditTransferInitiation09RelayServiceCgiMp();
//Validate against the xml schema. We can also exit in case of errors in this step.
ValidationErrorList validationErrorList = customerCreditTransfer.validateXML(new ByteArrayInputStream(validPain001String.getBytes()));
//Fill the message with data from xml
customerCreditTransfer.parseXML(validPain001String);
//Validate both the xml schema and rules
validationErrorList.addAll(customerCreditTransfer.validate());  

if (validationErrorList.isEmpty()) {
    System.out.println(customerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Construct CGI-MP Message

//Initialize the message object
CustomerCreditTransferInitiation09RelayServiceCgiMp customerCreditTransfer = new CustomerCreditTransferInitiation09RelayServiceCgiMp();

//We fill the elements of the message object using setters
customerCreditTransfer.getMessage().setGrpHdr(new GroupHeader85());
customerCreditTransfer.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
customerCreditTransfer.setElement("GrpHdr/MsgId", "1234");

//Perform validation
ValidationErrorList validationErrorList = customerCreditTransfer.validate(); 

if (validationErrorList.isEmpty()) {
    System.out.println(customerCreditTransfer.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Code samples

Parse and validate CGI-MP message

Supported CGI-MP Message Types

SEPA-EPC Credit Transfer

SDK Setup

Maven

<!-- Import the SEPA-EPC-CT demo SDK-->
<dependency>
    <groupId>gr.datamation.mx</groupId>
    <artifactId>mx</artifactId>
    <version>23.17.0</version>
    <classifier>demo-sepa</classifier>
</dependency>

Gradle

implementation 'gr.datamation.mx:mx:23.17.0:demo-sepa@jar'

Please refer to General SDK Setup for more details.

Parse & Validate SEPA Message

In case you need to handle SEPA-EPC-CT messages, then you need to handle objects that extend the ISO20022 classes.

//Initialize the message object
FIToFIPaymentStatusReport10SepaEpcCt fiToFIPaymentStatusReport = new FIToFIPaymentStatusReport10SepaEpcCt();
//Validate against the xml schema. We can also exit in case of errors in this step.
ValidationErrorList validationErrorList = fiToFIPaymentStatusReport.validateXML(new ByteArrayInputStream(validSepaPacs002String.getBytes()));
//Fill the message with data from xml
fiToFIPaymentStatusReport.parseXML(validSepaPacs002String);
//Validate both the xml schema and rules
validationErrorList.addAll(fiToFIPaymentStatusReport.validate());  

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFIPaymentStatusReport.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Construct SEPA-EPC-CT Message

//Initialize the message object
FIToFIPaymentStatusReport10 fiToFIPaymentStatusReport = new FIToFIPaymentStatusReport10();

//We fill the elements of the message object using setters
fiToFIPaymentStatusReport.getMessage().setGrpHdr(new GroupHeader93());
fiToFIPaymentStatusReport.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
fiToFIPaymentStatusReport.setElement("GrpHdr/MsgId", "1234");

//Perform validation
ValidationErrorList validationErrorList = fiToFIPaymentStatusReport.validate(); 

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFIPaymentStatusReport.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Code samples

Parse and validate SEPA-EPC-CT message

Supported SEPA-EPC-CT Message Types (2023 Version 1.0)

Auto replies

Sample code for FIToFICustomerCreditTransferSepaEpcCtAutoReplies can be found here.
Sample code for FIToFIPaymentCancellationRequestSepaEpcCtAutoReplies can be found here.
Sample code for ClaimNonReceiptSepaEpcCtAutoReplies can be found here.
Sample code for RequestToModifyPaymentSepaEpcCtAutoReplies can be found here.

Please refer to general auto replies for more details.

SEPA-EPC Direct Debit

SDK Setup

Maven

<!-- Import the SEPA-EPC-DD demo SDK-->
<dependency>
    <groupId>gr.datamation.mx</groupId>
    <artifactId>mx</artifactId>
    <version>23.17.0</version>
    <classifier>demo-sepa</classifier>
</dependency>

Gradle

implementation 'gr.datamation.mx:mx:23.17.0:demo-sepa@jar'

Please refer to General SDK Setup for more details.

Parse & Validate SEPA Message

In case you need to handle SEPA-EPC-DD messages, then you need to handle objects that extend the ISO20022 classes.

//Initialize the message object
FIToFIPaymentStatusReport10SepaEpcDd fiToFIPaymentStatusReport = new FIToFIPaymentStatusReport10SepaEpcDd();
//Validate against the xml schema. We can also exit in case of errors in this step.
ValidationErrorList validationErrorList = fiToFIPaymentStatusReport.validateXML(new ByteArrayInputStream(validSepaPacs002String.getBytes()));
//Fill the message with data from xml
fiToFIPaymentStatusReport.parseXML(validSepaPacs002String);
//Validate both the xml schema and rules
validationErrorList.addAll(fiToFIPaymentStatusReport.validate());  

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFIPaymentStatusReport.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Construct SEPA-EPC-DD Message

//Initialize the message object
FIToFIPaymentStatusReport10 fiToFIPaymentStatusReport = new FIToFIPaymentStatusReport10();

//We fill the elements of the message object using setters
fiToFIPaymentStatusReport.getMessage().setGrpHdr(new GroupHeader93());
fiToFIPaymentStatusReport.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
fiToFIPaymentStatusReport.setElement("GrpHdr/MsgId", "1234");

//Perform validation
ValidationErrorList validationErrorList = fiToFIPaymentStatusReport.validate(); 

if (validationErrorList.isEmpty()) {
    System.out.println(fiToFIPaymentStatusReport.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Code samples

Parse and validate SEPA-EPC-DD message

Supported SEPA-EPC-DD Message Types (2023 Version 1.0)

Auto replies

Sample code for FIToFICustomerDirectDebit08SepaEpcDdAutoReplies can be found here.

Sample code for FIToFIPaymentReversalSepaEpcDdAutoReplies can be found here.

SEPA-EPC Instant Payment

SDK Setup

Maven

<!-- Import the SEPA-EPC-INST demo SDK-->
<dependency>
    <groupId>gr.datamation.mx</groupId>
    <artifactId>mx</artifactId>
    <version>23.17.0</version>
    <classifier>demo-sepa</classifier>
</dependency>

Gradle

implementation 'gr.datamation.mx:mx:23.00.0:demo-sepa@jar'

Please refer to General SDK Setup for more details.

Parse & Validate SEPA Message

In case you need to handle SEPA-EPC-INST messages, then you need to handle objects that extend the ISO20022 classes.

//Initialize the message object
FIToFICustomerCreditTransfer08SepaEpcInst fiCustomerCreditTransfer08SepaEpcInst = new FIToFICustomerCreditTransfer08SepaEpcInst();
//Validate against the xml schema
ValidationErrorList validationErrorList = fiCustomerCreditTransfer08SepaEpcInst.validateXML(new ByteArrayInputStream(validSepaEpcInstPacs008string.getBytes()));
//Fill the message with data from xml
fiCustomerCreditTransfer08SepaEpcInst.parseXML(validSepaEpcInstPacs008string);
//Validate both the xml schema and rules
validationErrorList.addAll(fiCustomerCreditTransfer08SepaEpcInst.validate());

if (validationErrorList.isEmpty()) {
    System.out.println("Message is valid");
    System.out.println(fiCustomerCreditTransfer08SepaEpcInst.convertToXML()); //Get the generated xml
} else {
     System.out.println(validationErrorList);
}

Construct SEPA-EPC-INST Message

//Initialize the message object
FIToFICustomerCreditTransfer08SepaEpcInst fIToFIPaymentStatusReport10 = new FIToFICustomerCreditTransfer08SepaEpcInst();

//We fill the elements with the message object using setters
fIToFIPaymentStatusReport10.getMessage().setGrpHdr(new GroupHeader93());
fIToFIPaymentStatusReport10.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
fIToFIPaymentStatusReport10.setElement("GrpHdr/MsgId", "1234");

//Perform validation
ValidationErrorList validationErrorList = fIToFIPaymentStatusReport10.validate();

if (validationErrorList.isEmpty()) {
    System.out.println(fIToFIPaymentStatusReport10.convertToXML()); //Get the generated xml
} else {
     System.out.println(validationErrorList);
}

Code samples

Parse and validate SEPA-EPC-INST message

Supported SEPA-EPC-INST Message Types (2023 Version 1.0)

Auto replies

Sample code for FIToFICustomerCreditTransferSepaEpcInstAutoReplies can be found here.
Sample code for FIToFIPaymentCancellationRequestEpcInstAutoReplies can be found here.

SEPA-EBA Credit Transfer

SDK Setup

Maven

<!-- Import the SEPA-EΒΑ-CT demo SDK-->
<dependency>
    <groupId>gr.datamation.mx</groupId>
    <artifactId>mx</artifactId>
    <version>23.17.0</version>
    <classifier>demo-sepa</classifier>
</dependency>

Gradle

implementation 'gr.datamation.mx:mx:23.17.0:demo-sepa@jar'

Please refer to General SDK Setup for more details.

Parse & Validate SEPA Message

In case you need to handle SEPA-ΕΒΑ-CT messages, there is a dedicated class for each message type.

//Initialize the message object
FIToFIPaymentStatusReport10SepaEbaCt fIToFIPaymentStatusReport10 = new FIToFIPaymentStatusReport10SepaEbaCt();
//Validate against the xml schema
ValidationErrorList validationErrorList = fIToFIPaymentStatusReport10.validateXML(new ByteArrayInputStream(validSepaEbaCtPacs002String.getBytes()));

//Fill the message with data from xml
fIToFIPaymentStatusReport10.parseXML(validSepaEbaCtPacs002String);
//Validate both the xml schema and rules
validationErrorList.addAll(fIToFIPaymentStatusReport10.validate());

if (validationErrorList.isEmpty()) {
    System.out.println(fIToFIPaymentStatusReport10.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Construct SEPA-EBA-CT Message

//Initialize the message object
FIToFIPaymentStatusReport10SepaEbaCt fIToFIPaymentStatusReport10 = new FIToFIPaymentStatusReport10SepaEbaCt();

//We fill the elements of the message object using setters
fIToFIPaymentStatusReport10.getMessage().setGrpHdr(new SCTGroupHeader91());
fIToFIPaymentStatusReport10.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
fIToFIPaymentStatusReport10.setElement("GrpHdr/MsgId", "1234");

//Perform validation
ValidationErrorList validationErrorList = fIToFIPaymentStatusReport10.validate();

if (validationErrorList.isEmpty()) {
    System.out.println(fIToFIPaymentStatusReport10.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Code samples

Parse and validate SEPA-EPC-CT message

Supported SEPA-EBA-CT Message Types

Auto replies

Sample code for FIToFICustomerCreditTransferSepaEbaCtAutoReplies can be found here.
Sample code for FIToFIPaymentCancellationRequestSepaEbaCtAutoReplies can be found here.
Sample code for ClaimNonReceiptSepaEbaCtAutoReplies can be found here.
Sample code for RequestToModifyPaymentSepaEbaCtAutoReplies can be found here.

Please refer to general auto replies for more details.

SEPA-DIAS Credit Transfer

SDK Setup

Maven

<!-- Import the SEPA-DIAS-CT demo SDK-->
<dependency>
    <groupId>gr.datamation.mx</groupId>
    <artifactId>mx</artifactId>
    <version>23.17.0</version>
    <classifier>demo-sepa</classifier>
</dependency>

Gradle

implementation 'gr.datamation.mx:mx:23.17.0:demo-sepa@jar'

Please refer to General SDK Setup for more details.

Parse & Validate SEPA Message

In case you need to handle SEPA-DIAS-CT messages, there is a dedicated class for each message type.

//Initialize the message object
FIToFIPaymentStatusReport10BatchSepaDiasCt fIToFIPaymentStatusReport10 = new FIToFIPaymentStatusReport10BatchSepaDiasCt();
//Validate against the xml schema
ValidationErrorList validationErrorList = fIToFIPaymentStatusReport10.validateXML(new ByteArrayInputStream(validSepaDiasCtPacs002String.getBytes()));

//Fill the message with data from xml
fIToFIPaymentStatusReport10.parseXML(validSepaDiasCtPacs002String);
//Validate both the xml schema and rules
validationErrorList.addAll(fIToFIPaymentStatusReport10.validate());

if (validationErrorList.isEmpty()) {
    System.out.println(fIToFIPaymentStatusReport10.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Construct SEPA-DIAS-CT Message

//Initialize the message object
FIToFIPaymentStatusReport10BatchSepaDiasCt fIToFIPaymentStatusReport10 = new FIToFIPaymentStatusReport10BatchSepaDiasCt();

//We fill the elements of the message object using setters
fIToFIPaymentStatusReport10.getMessage().setGrpHdr(new GroupHeader91());
fIToFIPaymentStatusReport10.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
fIToFIPaymentStatusReport10.setElement("GrpHdr/MsgId", "1234");

//Perform validation
ValidationErrorList validationErrorList = fIToFIPaymentStatusReport10.validate();

if (validationErrorList.isEmpty()) {
    System.out.println(fIToFIPaymentStatusReport10.convertToXML()); //Get the generated xml
} else {
    System.out.println(validationErrorList);
}

Code samples

Parse and validate SEPA-DIAS-CT message

Supported SEPA-DIAS-CT Message Types

Auto replies

Sample code for FIToFICustomerCreditTransferSepaDiasCtAutoReplies can be found here.
Sample code for FIToFIPaymentCancellationRequestSepaDiasCtAutoReplies can be found here.
Sample code for ClaimNonReceiptSepaDiasCtAutoReplies can be found here. Sample code for RequestToModifyPaymentSepaDiasCtAutoReplies can be found here.

Please refer to general auto replies for more details.

SEPA-SIBS Credit Transfer

SDK Setup

Maven

<!-- Import the SEPA-SIBS-CT demo SDK-->
<dependency>
    <groupId>gr.datamation.mx</groupId>
    <artifactId>mx</artifactId>
    <version>23.17.0</version>
    <classifier>demo-sepa</classifier>
</dependency>

Gradle

implementation 'gr.datamation.mx:mx:23.17.0:demo-sepa@jar'

Please refer to General SDK Setup for more details.

Parse & Validate SEPA Message

In case you need to handle SEPA-SIBS-CT messages, there is a dedicated class for each message type.

//Initialize the message object
FIToFIPaymentStatusReport10SepaSibsCt fIToFIPaymentStatusReport10 = new FIToFIPaymentStatusReport10SepaSibsCt();
//Validate against the xml schema
ValidationErrorList validationErrorList = fIToFIPaymentStatusReport10.validateXML(new ByteArrayInputStream(validSepaSibsCtPacs002String.getBytes()));

//Fill the message with data from xml
fIToFIPaymentStatusReport10.parseXML(validSepaSibsCtPacs002String);
//Validate both the xml schema and rules
validationErrorList.addAll(fIToFIPaymentStatusReport10.validate());

if (validationErrorList.isEmpty()) {
System.out.println(fIToFIPaymentStatusReport10.convertToXML()); //Get the generated xml
} else {
System.out.println(validationErrorList);
}

Construct SEPA-SIBS-CT Message

//Initialize the message object
FIToFIPaymentStatusReport10SepaSibsCt fIToFIPaymentStatusReport10 = new FIToFIPaymentStatusReport10SepaSibsCt();
//We fill the elements with the message object using setters
fIToFIPaymentStatusReport10.getMessage().setGrpHdr(new SCTGroupHeader91());
fIToFIPaymentStatusReport10.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
fIToFIPaymentStatusReport10.setElement("GrpHdr/MsgId", "1234");

//Perform validation
ValidationErrorList validationErrorList = fIToFIPaymentStatusReport10.validate();

if (validationErrorList.isEmpty()) {
System.out.println(fIToFIPaymentStatusReport10.convertToXML()); //Get the generated xml
} else {
System.out.println(validationErrorList);
}

Code samples

Parse and validate SEPA-SIBS-CT message

Supported SEPA-SIBS-CT Message Types

Auto replies

Sample code for FIToFICustomerCreditTransferSepaSibsCtAutoReplies can be found here.
Sample code for FIToFIPaymentCancellationRequestSepaSibsCtAutoReplies can be found here.
Sample code for ClaimNonReceiptSepaSibsCtAutoReplies can be found here.
Sample code for RequestToModifyPaymentSepaEbaCtAutoReplies can be found here.

Please refer to general auto replies for more details.

SEPA-SIBS Direct Debit

SDK Setup

Maven

<!-- Import the SEPA-SIBS-CT demo SDK-->
<dependency>
    <groupId>gr.datamation.mx</groupId>
    <artifactId>mx</artifactId>
    <version>23.17.0</version>
    <classifier>demo-sepa</classifier>
</dependency>

Gradle

implementation 'gr.datamation.mx:mx:23.17.0:demo-sepa@jar'

Please refer to General SDK Setup for more details.

Parse & Validate SEPA Message

In case you need to handle SEPA-SIBS-DD messages, there is a dedicated class for each message type.

 //Initialize the message object
FIToFIPaymentStatusReport10S2SepaSibsDd fIToFIPaymentStatusReport10 = new FIToFIPaymentStatusReport10S2SepaSibsDd();
//Validate against the xml schema
ValidationErrorList validationErrorList = fIToFIPaymentStatusReport10.validateXML(new ByteArrayInputStream(validSepaSibsDdPacs002String.getBytes()));

//Fill the message with data from xml
fIToFIPaymentStatusReport10.parseXML(validSepaSibsDdPacs002String);
//Validate both the xml schema and rules
validationErrorList.addAll(fIToFIPaymentStatusReport10.validate());

if (validationErrorList.isEmpty()) {
System.out.println(fIToFIPaymentStatusReport10.convertToXML()); //Get the generated xml
} else {
System.out.println(validationErrorList);
}

Construct SEPA-SIBS-DD Message

//Initialize the message object
FIToFIPaymentStatusReport10S2SepaSibsDd fIToFIPaymentStatusReport10 = new FIToFIPaymentStatusReport10S2SepaSibsDd();
//We fill the elements with the message object using setters
fIToFIPaymentStatusReport10.getMessage().setGrpHdr(new SDDGroupHeader91());
fIToFIPaymentStatusReport10.getMessage().getGrpHdr().setMsgId("1234");
//or setElement()
fIToFIPaymentStatusReport10.setElement("GrpHdr/MsgId", "1234");

//Perform validation
ValidationErrorList validationErrorList = fIToFIPaymentStatusReport10.validate();

if (validationErrorList.isEmpty()) {
System.out.println(fIToFIPaymentStatusReport10.convertToXML()); //Get the generated xml
} else {
System.out.println(validationErrorList);
}

Code samples

Parse and validate SEPA-SIBS-DD message

Supported SEPA-SIBS-DD Message Types

Auto replies

Sample code for FIToFICustomerDirectDebitSepaSibsDdAutoReplies can be found here.

Sample code for FIToFIPaymentReversalSepaSibsDdAutoReplies can be found here.

Please refer to general auto replies for more details.

More features are included in the paid version

Auto Replies

Additional Dependencies

In order to use auto-replies, the use of gson is required Maven

<dependency>
   <groupId>com.google.code.gson</groupId>
   <artifactId>gson</artifactId>
   <version>2.8.9</version>
</dependency>

The library supports the creation of reply message. For example, for a pacs.008 message, you can create a pacs.004 message.
The correspondent classes belong to gr.datamation.replies package and extends the CoreMessageAutoReplies abstract Class.
This class contains the abstract <R extends CoreMessage> R autoReply(R replyMessage, List<MsgReplyInfo> msgReplyInfo) method.
MsgReplyInfo contains information for the reply and is a list because some reply messages may contain many transactions.
For example, for a pacs.008.001.10, the class for replies should be FIToFICustomerCreditTransferAutoReplies that extends CoreMessageAutoReplies.
We initiate this class with the source message.
For a pacs.008.001.10, the initialization should be:

FIToFICustomerCreditTransfer10 pacs008 = new FIToFICustomerCreditTransfer10();
//fill the message object or parse from an xml
FIToFICustomerCreditTransferAutoReplies<FIToFICustomerCreditTransfer10, PaymentReturn11> pacs008Replies = 
    new FIToFICustomerCreditTransferAutoReplies<>(pacs008);

If we want to create a pacs.004.001.11 reply for this pacs.008, we should call the autoReply() like this:

MsgReplyInfo msgReplyInfo = new MsgReplyInfo();
ReasonInformation reasonInformation = new ReasonInformation();
msgReplyInfo.setRsnInf(reasonInformation);

reasonInformation.setType(ReasonInformation.Type.CD);
reasonInformation.setValue("AC01");
reasonInformation.setAddtlInf(Collections.singletonList("Additional info"));

msgReplyInfo.setOrgnlInstrId("instrId");
msgReplyInfo.setReplyId("pacs008Reply");
msgReplyInfo.setIntrBkSttlmDt(new Date());

ChargesInformation chargesInformation = new ChargesInformation();
chargesInformation.setAmount(new BigDecimal("2.00"));
chargesInformation.setAgentBic("AAAAGB2L");
msgReplyInfo.setChargesInformation(Collections.singletonList(chargesInformation));

msgReplyInfo.setChargeBearer("SLEV");

PaymentReturn11 pacs004 = pacs008Replies.autoReply(new PaymentReturn11(), Collections.singletonList(msgReplyInfo));

The following replies for generic iso20022 messages are supported:

* Where XX represents the version of the message.
Sample code for FIToFICustomerCreditTransferAutoReplies can be found here.
Sample code for FinancialInstitutionCreditTransferAutoReplies can be found here.
Sample code for FIToFIPaymentCancellationRequestAutoReplies can be found here.

Universal Confirmations

You can create Universal Confirmations trck.001.001.02 for a pacs.008 messages. It is the equivalent of creating MT199 Universal Confirmation for an MT103.
First, you need to initiate FIToFICustomerCreditTransferAutoReplies class since the method for Universal Confirmation exists there.
A Universal Confirmations message is represented by UniversalConfirmationsMessage and consists of the ApplicationHeader(head.001.001.02) and the Document(trck.001.001.02).
Available statuses are: ACCC, ACSP and RJCT.
Below you can see how to use it.

//initiate a UniversalConfirmationsMessage instance
String status = "ACSP";
ReasonInformation rsnInf1 = new ReasonInformation();
rsnInf1.setValue("G001");
MsgReplyInfo msgReplyInfo1 = new MsgReplyInfo();
msgReplyInfo1.setRsnInf(rsnInf1);
msgReplyInfo1.setOrgnlInstrId("BBBB/150928-CCT/JPY/123/0");
msgReplyInfo1.setChargeBearer("CRED"); //optional
msgReplyInfo1.setChargesInformation(new ArrayList<>()); //optional
msgReplyInfo1.getChargesInformation().add(new ChargesInformation()); //optional
msgReplyInfo1.getChargesInformation().get(0).setAmount(new BigDecimal("1")); //optional

//OR
String status = "ACCC";
MsgReplyInfo msgReplyInfo1 = new MsgReplyInfo();
msgReplyInfo1.setOrgnlInstrId("BBBB/150928-CCT/JPY/123/0");

//OR
String status = "RJCT";
ReasonInformation rsnInf1 = new ReasonInformation();
rsnInf1.setValue("AM06");
MsgReplyInfo msgReplyInfo1 = new MsgReplyInfo();
msgReplyInfo1.setRsnInf(rsnInf1);
msgReplyInfo1.setOrgnlInstrId("BBBB/150928-CCT/JPY/123/0");
        
UniversalConfirmationsMessage universalConfirmationsMessage =
   new UniversalConfirmationsMessage<>(new BusinessApplicationHeader02(), new PaymentStatusTrackerUpdate02UniversalConfirmations());

//initiate the Reply Class instance
UniversalConfirmationsAutoReplies<FIToFICustomerCreditTransfer08> universalConfirmationsAutoReplies =
   new UniversalConfirmationsAutoReplies<>(pacs008);

//call method that generates the universal confirmation
universalConfirmationsAutoReplies.autoReply(universalConfirmationsMessage, Arrays.asList(msgReplyInfo1), status);

See more provided SDKs on ISO20022 and SWIFT MT here