-
Notifications
You must be signed in to change notification settings - Fork 12
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Separation of Sender information - Breaking Change
- Separeted Sender information from Initialzation - Changed Sender information to public property - Added README.md for nuget package and moved help documentation to this file
- Loading branch information
1 parent
a202cee
commit 5f35745
Showing
8 changed files
with
202 additions
and
107 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,14 @@ | ||
Iso20022 Generator ist licensed under the Apache License | ||
|
||
Copyright (c) .NET Foundation. All rights reserved. | ||
|
||
Licensed under the Apache License, Version 2.0 (the "License"); you may not use | ||
these files except in compliance with the License. You may obtain a copy of the | ||
License at | ||
|
||
http://www.apache.org/licenses/LICENSE-2.0 | ||
|
||
Unless required by applicable law or agreed to in writing, software distributed | ||
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR | ||
CONDITIONS OF ANY KIND, either express or implied. See the License for the | ||
specific language governing permissions and limitations under the License. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,120 @@ | ||
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](Assets/zahlungsarten.png) | ||
|
||
# Zahlungsarten | ||
|
||
![Paymenttypes](Assets/paymenttypes.png) | ||
|
||
## 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.0.0 (2023-03-30) - Breaking Changes | ||
- Separeted 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 | ||
|
||
# Links | ||
|
||
- [License](LICENSE.md) | ||
- [Homepage enio AG](https://www.enio.ch) | ||
- [Releases](https://github.com/enioag/iso20022-generator/releases) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
using System; | ||
|
||
namespace iso20022_generator.entity | ||
{ | ||
public class Sender | ||
{ | ||
private string _senderIban; | ||
private string _senderBic = ""; | ||
public string SenderPartyName { get; set; } | ||
|
||
public string SenderIban | ||
{ | ||
get => _senderIban; | ||
set | ||
{ | ||
if (string.IsNullOrWhiteSpace(value)) | ||
throw new ArgumentException("Sender IBAN cannot be null or whitespace.", nameof(value)); | ||
if (value.Length < 20) | ||
throw new ArgumentException("Sender IBAN is to short", nameof(value)); | ||
_senderIban = value.Replace(" ", ""); | ||
} | ||
} | ||
|
||
public string SenderBic | ||
{ | ||
get => _senderBic; | ||
set | ||
{ | ||
if (value.Length > 11) | ||
throw new ArgumentException("Sender BIC is to long", nameof(value)); | ||
_senderBic = value; | ||
} | ||
} | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters