https://github.com/prowide/prowide-iso20022
Comprehensive business model and parser for all ISO 20022 messages
https://github.com/prowide/prowide-iso20022
camt iso20022 jar java mx pacs swift
Last synced: 5 days ago
JSON representation
Comprehensive business model and parser for all ISO 20022 messages
- Host: GitHub
- URL: https://github.com/prowide/prowide-iso20022
- Owner: prowide
- License: apache-2.0
- Created: 2020-04-20T22:26:39.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2025-11-26T16:10:44.000Z (about 2 months ago)
- Last Synced: 2025-11-29T10:30:03.458Z (about 2 months ago)
- Topics: camt, iso20022, jar, java, mx, pacs, swift
- Language: Java
- Homepage: https://www.prowidesoftware.com
- Size: 55.7 MB
- Stars: 193
- Watchers: 8
- Forks: 81
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
**Prowide ISO 20022** is an open source Java framework for managing **ISO 20022** messages.
This project is a complement for the **Prowide Core** library: https://github.com/prowide/prowide-core
### What's included?
* **Java model** for ISO 20022 MX (for example: pacs.008.001.02, for all ISO 20022 message categories and types)
* **Parser** from ISO 20022 XML into Java
* **Builder** API from Java to ISO 20022 XML
* Conversion to/from **JSON**
For SWIFT messages validation, restricted ISO versions (such as SEPA, CBPR+, TARGET), GUI application and more, please check our complementary commercial offerings at https://www.prowidesoftware.com/
### Documentation
* Documentation site https://dev.prowidesoftware.com/
* Javadoc https://www.javadoc.io/doc/com.prowidesoftware/pw-iso20022/
* Code examples https://github.com/prowide/prowide-iso20022-examples
### Distribution
Latest public **binary DOWNLOAD** is available at https://dev.prowidesoftware.com/SRU2022/getting-started/download-iso20022/
SRU updates are made available in October (one month before SWIFT production date) for the public, and 6 months in advance for subscribed customers.
### License
Apache License 2.0
SWIFT is a trademark of S.W.I.F.T. SCRL. (www.swift.com)
### Dependencies
This project depends on https://github.com/prowide/prowide-core
The project also needs the **javax.xml.bind** in runtime. Until Java 8 this package is part of the JDK.
If you use **Java above 8** you might need to activate the required modules in the JDK; or add these dependencies (or an equivalent implementation) to your application:
```
implementation 'javax.xml.bind:jaxb-api:2.3.1'
implementation 'com.sun.xml.bind:jaxb-impl:2.3.3'
```
### Build
For better build performance, local configurations can be setup in a gradle.properties file such as:
```
org.gradle.jvmargs=-Xms512m -Xmx7g
org.gradle.parallel=true
```
To compile and test all modules:
`./gradlew build`
### Modules
The project is huge because it contains the complete set of jaxb generated the project is divided into multiple subprojects though as follows:
* iso20022-core: main common code and base classes for all modules, including API for headers
* model-common-types: common business types dictionary for many message categories
* model-[category]-mx: the Document classes for each specific category (entry point for each message type)
* model-[category]-types: business types dictionary for each specific category
The dependencies being:
```
iso20022-core
\-- model-common-types
model-[category]-types
\-- model-common-types
model-[category]-mx
+-- iso20022-core
+-- model-[category]-types
\-- model-common-types
```
### Artifacts
The root project creates an uber jar named **pw-iso20022-SRUYYYY-version.jar** with the library API for all ISO20022
message categories: pacs, camt, xsys, sese, etc... So if you need to process many message types, or you
want to keep your dependencies simple, you can just take the single jar output. This is also the jar published in
**Maven Central**.
If instead of depending on the uber jar you want to have a subset of the library for some message types you can just
take the base and common jars and the specific category modules. For instance to use ony the pacs and camt messages, you need:
* iso20022-core -> `pw-iso20022-core-SRUYYYY-version.jar`
* model-common-types -> `pw-iso20022-common-types-SRUYYYY-version.jar`
* model-pacs-mx -> `pw-iso20022-pacs-mx-SRUYYYY-version.jar`
* model-pacs-types -> `pw-iso20022-pacs-types-SRUYYYY-version.jar`
* model-camt-mx -> `pw-iso20022-camt-mx-SRUYYYY-version.jar`
* model-camt-types -> `pw-iso20022-camt-types-SRUYYYY-version.jar`
In this case, you can run the following commands:
`./gradlew :iso20022-core:jar`
`./gradlew :model-common-types:jar`
`./gradlew :model-pacs-mx:jar`
`./gradlew :model-pacs-types:jar`
`./gradlew :model-camt-mx:jar`
`./gradlew :model-camt-types:jar`
This will create individual jars in each module folder, so you can use each lib as needed.