Banking (ISO 20022) Nuclet – nuclet: banking interface (iso 20022) (not yet available).

globe with meridians Language: Deutsch · English

light bulb Nuclet: Banking interface (ISO 20022) (not yet available)

Data sheet and documentation entry point for the Banking (ISO 20022) Nuclet (banking interface based on the ISO 20022 standard).

On this page

This page was machine-translated from German as a first draft and is currently under review. The authoritative source remains the German original (see the language switch above).

Table of contents

Releases

VersionDateNotesCompatibility
1.011.9.2018First published version

from Nuclos 4.26.1, 4.27.5, 4.28.3, 4.29.0

Database: Postgres

Overview

Das Nuclet "ISO2002" ermöglicht den Umgang mit durch den ISO-Standard 20022 .

Feature scope (1.0)
  • Import of account statements
    • Account statements and individual transactions are then available as business objects
    • supported formats: camt.053, camt.054 and camt.053-Stuzza (for Austrian banks)
    • automation via jobs (currently only camt.053 and camt.054 )

  • Payment reconciliation
    • enables the rule-based reconciliation of transactions with your own business objects (e.g. invoices) and thus the automatic capture and assignment of incoming or outgoing payments
    • update of open/paid amounts
    • configurable status change
Feature scope (planned for version 2.0)
  • import of transactions in CAMT.045-Stuzza format (Austria)
  • import jobs for Austrian formats
  • automation of the payment reconciliation via jobs
  • generation of credit transfer and direct debit orders in PAIN format from your own business objects

Integration of account statement import (CAMT)

StepDescription
1

Nuclet import

(see Nuclet import)

After importing the Nuclet, a restart of the server is required first.

2

Configure integration point currency

If not present, a new business object for currencies must be created. A required field is a text field in which the respective currency code according to ISO 4217 must be entered.

Then Integrationspunkt configure currency by selecting the target Nuclet, the currency BO it contains and the field for the currency code (under the menu item Konfiguration).

3

Set default value for import format (optional)

If the same file format is used regularly for the import (see next point), it is advisable to set your own default value for new imports.

For this, in the Konfiguration für Businessobjekte for the field Nachrichtentyp  in the business object CAMT-Import  select a default value.

Using the account statement import

Perform import:
  1. Select mode or file format and the file to be imported, and save
  2. Select the import button. Depending on the size of the file, this can take a few minutes.

The import creates business objects for all contained account statements, closing balances and transactions, which are then also available under the menu item CAMT/Archiv .

Account statements: Individual statements described in the import file.

Account balances: Closing balances of the selected account statement. The individual balance types are described under CAMT/ Stammdaten .

Account balances: Individual transactions of the selected account statement.

Import jobs

The import of transactions in CAMT.053 and CAMT.054 formats can also be automated as a Job

For this, the following parameters must be set in the Nucletmanagement :

CAMT File Encodingencoding of the import file (usually UTF-8)

CAMT File Directory : directory in which the files to be imported are stored

CAMT File Extensions : restriction of the files to be processed by extension, comma-separated list (e.g. .xml, .txt)

Integration (payment reconciliation)

StepDescription
1

Create status model for reconciliation object create

Due to current restrictions when using integration points, the reference object for the payment reconciliation must have a status model even if the automatic status change is not used.

Dazu genügt es das Flag "Statusmodell" im BO-Editor zu setzen und einfaches Statusmodell (ein Status und Übergang vom Startpunkt) anzulegen to the reference object.

2

Configure integration point for reconciliation object

In this step, the business object for the payment reconciliation is configured. The following fields must be assigned:

Currency (reference field): the reconciliation object must have a reference to the existing or newly created BO currency (see above).
If the currencies of a transaction and a reconciliation object do not match, an assignment is prevented.

Betrag (decimal number): the amount to be settled.

Betrag offen or Betrag paid (decimal numbers): on successful assignment, the amount from a transaction is recorded here.

  • When using the field Betrag offen the transaction amount is subtracted from it; if the value thereby changes to zero or less,
    the field bezahlt is set to yes.
  • When using the field Betrag gezahlt the transaction amount is added to it; if the value thereby becomes greater than or equal to that of the field Betrag, the field bezahlt is set to yes.

Zahlungsdatum Ist (date): is set when the amount is settled.

Vergleichsfelder (text): up to five text fields from the reconciliation object can be selected for defining the reconciliation rules (see step 3).

Optional fields

Bezahlt (yes/no field): indicates whether the amount of the reconciliation object has been settled by the last transaction. If yes, the object is no longer
used for the payment reconciliation. If the field has to be newly created, it is advisable to first set Ja as the default value so that
existing data that is no longer relevant for the reconciliation is excluded. After creating the field, the default value can then be set
to Nein so that newly created objects are included. Which objects are used for the reconciliation and which are not
can, if the object has a status model, alternatively or additionally also be defined via the status (see step 4).

Caution: If reconciliation objects are not marked as paid/open by a status model, this field is necessary!

Referenz Zusätzliches Abgleichobjekt (reference field): additional BO referenced by the reconciliation object for use in reconciliation rules (e.g. invoice → customer), selection takes place in step 3.

Betrag invertiert (yes/no field): if this field is set in the target object, the sign of the amount from the transaction is reversed during reconciliation. Useful for objects such as credit notes whose amount is positive but which are reconciled with debit transactions.

3

Configure integration point for additional reconciliation object (optional)

Vergleichsfelder (text): analogous to step 2, up to five text fields can be selected for defining the reconciliation rules (see step 3).

4

Define rules for payment reconciliation

Under the menu item CAMT/Definition Zahlungsabgleich you can define rules for the assignment of transactions. Such a definition is used for carrying out a payment reconciliation, but you can also create multiple definitions and use them as needed.

Name: A name for the definition.

Credit/debit: Selection of whether credit, debit or all transactions of an account statement are to be compared.

Assignment rulen : Rules that are used for the reconciliation. Each rule can have multiple entries in which a field from the account statement (statement field) is assigned to a comparison field  configured in step 2 or 3.

These entries can be linked with UND- or ODER-operators. Each linking of two or more assignments forms a group, whereby only one of the operators can be used within each group. To use both operators in one rule, groups of AND and OR links must be enclosed with the entries BEGINN GRUPPE and END GRUPPE, which act as brackets.

Example: assignment of an invoice by customer number or first and last name

If the selection Exakt is set, only an exact match is counted as a hit; otherwise, upper and lower case as well as spaces at the end and beginning are ignored and it is additionally checked whether one of the fields is contained in the other. Strings consisting of 3 or fewer characters are skipped in this last step.

For each rule, it can be selected whether a hit leads to the immediate assignment of the transaction. This only happens if the hit for this rule is unique (and other rules with immediate assignment also find no other hits).

The following fields from the account statement are currently available for the reconciliation:

  • Ordering party (account holder of the other party)
  • IBAN
  • Purpose
  • End-to-end ID (customer reference)
  • Direct debit mandate (SEPA mandate reference)

Perform status change: Indicates whether a status change should be performed on successful assignment. If yes, the Zielstatus must not be empty.

Valid source status: Only reconciliation objects with a status specified here are included in the payment reconciliation.

Target status: Target status for the automatic status change. Attention: in the Status model of the reconciliation object, an (automatic) status change to the target status must be enabled for each valid source status.

Perform status change: Return status for using the function Zuordnung zurücksetzen in the payment reconciliation (see further below). The corresponding status change must be enabled by the status model.

Filter bank transactions: Here, bank transactions (transaction types) can be selected in order to exclude all transactions of the type from the payment reconciliation. Each transaction from an account statement is assigned such a type; the list of all types can be found under CAMT/Stammdaten/Transaktionstyp.

Using the payment reconciliation

Create
  1. Selection in the menu item CAMT/Zahlungsabgleich.
  2. Bank statement or Select import process
  3. Select definition for the payment reconciliation
  4. Speichern

In the upper form, all transactions from the account statement (possibly filtered by transaction type and debit/credit) are now listed. Further details can be displayed via a right-click in the transaction column.

Start payment reconciliation

After clicking the button Abgleich starten Nuclos begins to assign the transactions according to the defined rules. Depending on the number of transactions and reconciliation objects, this can take a few minutes.

The result of the reconciliation is shown by a colouring of the transactions and the changes in the column Status . (Potential) hits for each transaction are displayed when selecting a transaction in the lower form (Zugeordnete Objekte). The following possibilities exist:

For transactions in status 30, it is now possible to make the correct selection among the potential assignments (details can be displayed via right-click on the reconciliation object) and to select the assignment manually. The following steps are necessary for this:

  1. Selection of the column Zuordnung wählen for the desired reconciliation object (for one or more transactions)
  2. Speichern
  3. Button Zuordnung auswählen  use

For transactions in status 90, a manual assignment can also be made after searching for errors in the reconciliation object. If corresponding error handling exists, the error message from the reconciliation object is also displayed if the manual assignment fails.

Other functions

Mark as irrelevant: In addition to the available filter options, it is possible to mark individual transactions as irrelevant in order to exclude them from the payment reconciliation. This can help to make the process clearer. Usage analogous to the manual assignment:

  1. Activation of the selection in the column irrelevant for the desired transactions
  2. Speichern
  3. Button Als irrelevant markieren use

Reset assignment: In the case of incorrect hits or accidental incorrect assignment, you may want to undo an assignment.

  1. Activation of the selection in the column Zurücksetzen for the desired transactions
  2. Speichern
  3. Button Zurücksetzen use

ATTENTION: When using the reset function, all changes made by the payment reconciliation are undone. Changes to the reconciliation object made by user rules or other components during the update or the status change of the reconciliation object can NOT be undone. An assignment with a status change can only be undone if the corresponding status change is enabled by the status model.

Related pages

open book Supporting Nuclets


Back to Supporting Nuclets

Open →

open book Nuclet Wiki


Nuclet Wiki home

Open →