iso20022Generator 3.1.0

dotnet add package iso20022Generator --version 3.1.0
                    
NuGet\Install-Package iso20022Generator -Version 3.1.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="iso20022Generator" Version="3.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="iso20022Generator" Version="3.1.0" />
                    
Directory.Packages.props
<PackageReference Include="iso20022Generator" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add iso20022Generator --version 3.1.0
                    
#r "nuget: iso20022Generator, 3.1.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package iso20022Generator@3.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=iso20022Generator&version=3.1.0
                    
Install as a Cake Addin
#tool nuget:?package=iso20022Generator&version=3.1.0
                    
Install as a Cake Tool

The iso20022-generator is a c# library which helps you generating iso 20022 artifacts with the minimum amount of information you need to set up valid documents.

What you can do at the moment:

  • Currently the creation of pain.001 files is the only thing the library can do.
  • The file can contain multiple transactions to different receivers.
  • You can add multiple payment information records with multiple transactions each. Each with its different execution date.
  • Swiss QR with reference number (QRR). Use IBANandQRR transaction type and set QRReferenceNumber property.

Limitations:

  • Although the iso20022 is a standard definition it looks as there are a lot of excess to this standard in the world. The library was mainly built for communication with swiss banks. To be precise the library was successfully tested against the test environments from the following banks: Raiffeisen Bank Schweiz, Credit Suisse, UBS and Zürcher Kantonalbank

Usage: have a look into the happy test file

Schemas and Examples

Kunde-Bank-Meldungen

https://www.six-group.com/de/products-services/banking-services/standardization/iso-payments.html

Swiss Payment Standards 2021

Schweizer Business Rules für Zahlungen und Cash Management für Kunde-Bank-Meldungen

Version 2.10, gültig per 19. November 2021

https://www.six-group.com/dam/download/banking-services/interbank-clearing/de/standardization/iso/swiss-recommendations/archives/business-rules/business-rules.pdf

Swiss Payment Standards 2021

Schweizer Implementation Guidelines für Kunde-Bank-Meldungen für Überweisungen im Zahlungsverkehr

Customer Credit Transfer Initiation (pain.001)

Version 1.11, gültig per 19. November 2021

https://www.six-group.com/dam/download/banking-services/interbank-clearing/de/standardization/iso/swiss-recommendations/archives/implementation-guidelines-ct/implementation-guidelines-ct.pdf

Swiss Payment Standards 2021

Swiss Implementation Guidelines for Customer-Bank Messages Credit Transfer (Payment Transactions)

Customer Credit Transfer Initiation (pain.001)

Version 1.11, with effect from 19 November 2021 https://www.six-group.com/dam/download/banking-services/interbank-clearing/en/standardization/iso/swiss-recommendations/implementation-guidelines-ct.pdf

ISO 20022 Payments

Schweizer Implementation Guidelines für Kunde-Bank-Meldungen für SEPA-Lastschriften

Customer Direct Debit Initiation (pain.008)

https://www.six-group.com/dam/download/banking-services/interbank-clearing/de/standardization/iso/swiss-recommendations/archives/implementation-guidelines-sdd/implementation-guidelines-sdd_v2_5_1.pdf

Payment Types

Paymenttypes

Zahlungsarten

Paymenttypes

Implemented and tested

Description Type Implementation Local Instrument
ESR - orange with reference number → !!!!obsolete!!!! 1 TransactionESR CH01
ES - red no reference number → !!!!obsolete!!!! 2.1 TransactionES CH02
IBAN/QRR 3 TransactionIBANandQRR
IBAN/SCOR 3 TransactionIBANandSCOR

Version Information

3.1.0 (2024-04-16)

  • added XML tag InstrForCdtrAgt (Index 2.81). The element may only be used in consultation with the commissioned financial institution. This element may have different characteristics and instructions depending on the financial institution.

Version Information

3.0.5 (2024-03-14)

  • changed minimum length of IBAN to 15 (Norway)
  • updated several NuGet packages

3.0.4 (2023-07-18)

  • added UnstructuredRemittanceInformation and AdditionalRemittanceInformation to TransactionIBANandSCOR

Version Information

3.0.3 (2023-05-08)

  • added boolean value batchBookingSpezified to enable export of pmtInf.BtchBookg flag properly

Version Information

3.0.2 (2023-04-13)

  • Split Street and StreetNumber into two properties
  • Don't export postal adress properties if empty
  • Don't export InstructionForDebtorAgent if empty

3.0.1 (2023-04-03)

  • Corrected issue with unintentionally overriding of sender information

3.0.0 (2023-03-30) - Breaking Changes

  • Separated Sender information from Initialzation
  • Changed Sender information to public property
  • Added README.md for nuget package and moved help documentation to this file

2.1.1 (2023-03-24)

Corrected null pointer exception on missing additional remittance information

2.1.0 (2022-11-22)

Added possibility to change contact detail and contact detail other values (Index 1.8)

  • Added configuration for payment method (TFA, TRA, CHK, ....) (Index 2.2)
  • Removed field PaymentType → obsolete
  • Added additional remittance information field for QRR transaction
  • Added unstructured remittance information for IBAN
  • Removed ESR and ES transactions → obsolete
  • Added configuration for control sum field (Index 1.7)
  • Added AutoCalculateControlSum field

2.0.0 (2022-10-12)

  • Added InstructionForDebtorAgent Index 2.85
  • Updated help

1.6.1 (2022-10-15)

  • Added IBAN and SCOR transaction. Allow empty address and receiver name
  • Bump NuGet.CommandLine from 4.9.5 to 4.9.6

1.6.0 (2022-10-15)

  • Added QR with Reference

1.4.0 (2022-10-14)

  • Extended generator to add more than one payment info record including the feature to use a different required execution date per payment info

1.4.0 (2022-10-12)

  • Implementation of ESR and ES 1, introduced transactions for each implementation
  • FIX: Implemenetation of required BIC Code for PostFinance support

1.3.0 (2021-12-02)

  • Fixed issue with amount in payment file

1.1.0 (2021-11-02)

  • Fixed issue with setting property Street-Number (StrtNm, 2.79)

1.0.0 (2021-10-15)

  • Initial release
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.1.0 5,569 4/16/2024
3.0.5 3,071 3/14/2024
3.0.4 4,806 7/18/2023
3.0.3 675 5/8/2023
3.0.2 695 4/13/2023
3.0.1 666 4/3/2023
3.0.0 618 3/30/2023
2.1.1 709 3/24/2023
2.1.0 2,244 11/22/2022
2.0.0 1,228 10/12/2022
1.6.1 2,714 10/15/2020
1.5.0 939 10/14/2020
1.4.0 953 10/12/2020
1.3.0 3,065 2/12/2019