summaryrefslogtreecommitdiff
path: root/libeufin
diff options
context:
space:
mode:
authorFlorian Dold <florian.dold@gmail.com>2020-07-06 18:45:35 +0530
committerFlorian Dold <florian.dold@gmail.com>2020-07-06 18:45:35 +0530
commit0fc949ee171bb7cb320de5593c59474684f440ea (patch)
tree0d26299080178084e6182158c727f3487f330e2b /libeufin
parentce15fc3472f93b3d213d220f6a144cf58a0b5706 (diff)
downloaddocs-0fc949ee171bb7cb320de5593c59474684f440ea.tar.gz
docs-0fc949ee171bb7cb320de5593c59474684f440ea.tar.bz2
docs-0fc949ee171bb7cb320de5593c59474684f440ea.zip
iso20022 notes
Diffstat (limited to 'libeufin')
-rw-r--r--libeufin/iso20022.rst36
1 files changed, 29 insertions, 7 deletions
diff --git a/libeufin/iso20022.rst b/libeufin/iso20022.rst
index d87098a3..06d929c2 100644
--- a/libeufin/iso20022.rst
+++ b/libeufin/iso20022.rst
@@ -22,15 +22,37 @@ The specifics of this mapping are:
of message elements in the same schema.
-Cash Management (camt)
-======================
+Why does LibEuFin not use ISO 20022?
+====================================
-LibEuFin combines camt.052, camt.053 and camt.054, as they essentially
-have the same structure and serve the same purpose: Reporting transactions
-on a customer's bank account.
+While LibEuFin can ingest ISO 20022 messages (camt.05x, pain.002) and generate
+them (pain.001), it does not use ISO 20022 in its API and internal data model.
-We also flatten the hierarchy a bit and only have entries ("money movement in one go")
-and transactions.
+Reasons for not using ISO 20022 directly are:
+
+1. Impedence mismatch. ISO 20022 messages do not map well to query/response
+ APIs.
+2. Cumbersome to use. Even when ISO 20022 messages are directly mapped
+ to JSON, they are difficult to use due to their verbosity.
+3. Underspecification. Messages like camt.05x leave many "degrees of freedom"
+ when translating the underlying data into a message.
+4. No interoperability. As a result of underspecification, different countries/organisations
+ define their own subset and interpretation rules for ISO 20022 messages. This can
+ lead to even contradictory usage rules. An example for this is how the Swiss and EPC
+ interpretations handle transaction amounts in the presence of multiple currencies.
+5. Redundancy. ISO 20022 are redundant, and often mix aspects of the "presentation logic"
+ with the underlying data model. An example of this is the optional "summary" information
+ in camt.05x messages.
+
+Instead of using ISO 20022 messages directly, LibEuFin leverages the standard in other ways:
+
+* As the data exchange format with banks
+* As a guideline for naming in data formats
+* As a guideline for which concepts need to be understood by LibEuFin
+
+
+Implementation notes for camt.05x
+=================================
Types of amounts in camt messages
---------------------------------