FMS user guide


A SPFS Service Bureau allows participants connected to the SPFS to interact in the Bank of Russia SPFS format.

The SPFS Service Bureau provides the user with an interface to work with various types of SPFS messages as well as an administrative panel where the organisation, SPFS account, user, signing model, authorisation, etc. are initially created and configured.

Acronyms used

SPFS - the Financial Messaging System;

MPC (SPFS)- Message Processing Center (SPFS);

Types of SPFS documents

In the SPFS, different types of documents are exchanged between participants; these documents are also commonly referred to as envelopes. The ED503 and ED501 envelopes are the most commonly used for messaging. The Service Bureau supports the sending of these messages.

The Service Bureau also allows ED512 and ED573 messages to be sent to the MPC (SPFS).

Below we will take a closer look at the types of messages supported by the Service Bureau:

  • ED512 - instruction for managing SPFS user details. This is a service message that needs to be generated and sent to the SPFS MPC in advance in order to be able to accept certain types of messages from a particular counterparty.

  • ED573 - request for a directory of users of the Bank of Russia financial messaging system.

  • ED501 - message of participants' own formats, sometimes referred to as a free format. All types of files can be transferred with this type of message. SPFS participants transmit messages with file types that are agreed upon in advance, e.g. text messages.

  • ED503 is a financial messaging envelope (SWIFT). Messages transmitted by such an envelope are subject to additional formatting and logical control in the SPFS, following the same rules that apply to SWIFT messages.

Administrator settings panel

Before you can start working in the SPFS section, you need to enter a number of settings in the administrator settings panel.

To go to the administrator settings panel, click on the user name in the top right corner and select Settings:

Go to Settings

Setting up an organisation

The first thing to do is to add an organisation in the Organisations section using the Add button. The following fields must be filled out in the form for adding an organisation:

  • Full name - text field;

  • Short name - text field;

  • English name - text field;

    Note: To avoid confusion in the test segment, the name of the organisation should be marked to indicate that it is the organisation under test;

  • Group - optional field, can be left blank for SPFS;

  • INN/KIO - in the case of residents of the Russian Federation, you must fill in the field with your TIN data; for non-residents, you must enter an arbitrary value, e.g. “1234567890”;

  • KPP - optional field, can be left blank for SPSS;

  • OGRN - residents of the Russian Federation must indicate their Primary State Registration Number (OGRN); non-residents must indicate an arbitrary value, e.g. “1234567890123”;

  • OKPO - residents of the Russian Federation must indicate their Russian National Classifier of Businesses and Organisations (OKPO); non-residents must indicate an arbitrary value, e.g. “1234567890123”;

    Note: TIN, OGRN, OKPO are used for Russian organisations. These codes do not play a business role in the SPFS, so, as indicated above, arbitrary values may be set in these fields for non-residents;

  • File Gateway channel code and NSD person code – identifiers in NSD’s EDI system. These codes are issued together with the agreement or issued by technical support at the testing phase. File Gateway channel code is the same as NSD person code.

    Please note: the codes in the test and production segments are different.

  • SPFS user code – the 11-digit user code assigned by the SPFS (same as SWIFT BIC). If the client does not have a SWIFT BIC, the SPFS assigns its own value;

  • Sberbank ID (KPP) - not to be completed for the SPFS;

  • Raiffeisenbank ID (Hash) - not to be completed for the SPFS;

  • The Branch option is not used for SPFS, leave it off;

Once the form has been completed, click on the Save button.

Adding an SPFS organisation

Adding a SPFS account

Before creating an SPFS account, make sure that the directory of SPFS participants (ED574) has been received.

You can check if this directory has been downloaded in the folder: C:\Program Files (x86)\NSD Tranzit\config\Dict or ...\config\dict

In production, the user directory is sent automatically at the beginning of every 24 hours, Moscow time. In a testing environment, you can request the directory by sending a request to technical support at transit-help@nsd.ru.

Please note The directories differ in the test and production segments. This is one reason why a test segment should not be subsequently converted into a production segment. It would be more correct to deploy the production run on a separate server.

To add an SPFS account, go to Accounts and click on the Add account button, a form will open which should be completed as follows:

  • tick Without number;
  • select the SPFS value in the Module field, then the Use SPFS option will be automatically enabled; this option is locked for changing;
  • in the Organisation field, select the organisation previously configured;
  • select one of the two values (Sequential or Hierarchical) in the Sign model type field. For details on the differences between the two types of models, refer to the Signature model types section;
Adding an SPFS account

There are also two options on the form:

  • Autosave ED501 - if the option is enabled, ED501 incoming documents will be saved automatically to a specified directory. See section Automatic saving of incoming messages for more details;
  • Autosave ED503 - if the option is enabled, ED503 incoming documents will be saved automatically to a specified directory. See section Automatic saving of incoming messages for more details;

Once the form for adding the account has been completed, click on the Save button.

Setting up the signature model

After setting up the account, proceed to setting up the signature model for this account and the corresponding document types.

A signature model describes the flow of a particular document type on an account until it is sent to the SPFS MPC. Signature models are configured in terms of document types and accounts, and describe the envisaged approval/signing phases for the specified account and document type.

To proceed to setting up the signature models, left click on the account under Accounts and an additional line with the Sign models button will be displayed:

Going to Sign Models section

By clicking on the Sign models button, the modal window Sign models of opens.

Sign Models section

To add a signature model, you need to:

  1. press the Add model button;

    Adding a signature model
  2. in the modal window, select the document type from the drop-down list for which the current signature model is being set up. The following types of documents are available:

    • SPFS SWIFT (ED503);
    • SPFS free format (ED501);
    • ED512;
    • ED573;

    These document types are described in detail in the Types of SPFS documents section;

  3. if the document does not require approval/signing and immediately after creation should be sent to SPFS MPC without verification, the Signing phases are not required option is activated, otherwise point 4 is executed;

  4. The approval/signature phases for the document are set, click on the Add button and the Add sign phase modal window will open. The type Agreement can be specified as the signature phase for SPFS documents. By ticking the stage Agreement, you require approval of the document by the user, for whom the appropriate authority will subsequently be made available, as detailed in the section Configuring User Authority.

    Please note: In addition approval, the Sign type can also be used, using the NSD Cryptographic Service crypto provider (see Signing configuration with NSD Cryptographic Service (GOST/RSA) for details.

    Adding a phase to the sign model
  5. Restrictions in the SPFS are not used, the block should be left blank.

  6. Click on the Save button at the bottom of the modal window;

Below is an example of how to set up a signature model for ED512 with one phase “Agreement”:

Adding a signature model

Note:

  • We recommend using no more than two Approval/Signature phases.
  • Only one signature model is created for a document within one account (SPFS). If a signature model for a document type has already been created, this document type will not appear in the drop-down list when a new model is created.
  • One user cannot approve the same document more than once, regardless of the settings. Thus, if two approval phases are configured in the signature model, it is assumed that one user will approve the document in the first phase and another user in the second phase.

To edit the signature model, you should:

  1. left-click on the line with the type of document whose signing model is to be changed;
  2. set or delete the signature phase in the modal window (the field with the document type is not available for editing);
  3. click on the Save button at the bottom of the modal window.

After editing the account signature model, the assigned signature phases on a given account with a user can be reset.

To delete the signature model, you need to:

  1. tick the checkbox of the signature model to be deleted;
  2. press the Delete button;
  3. confirm deletion.
Deleting a signature model

Setting up users

Once Terminal Transit is installed, a user with username admin and password 1234 is registered in the system.

The user password can be changed, see section Changing user password for details.

The Users section of the admin settings panel configures the users of the Transit Terminal.

The section is for adding, deleting and editing users as well as configuring authority.

Section Users

To add a user, click on the Add button and a modal window will open. The following fields are available on the form (mandatory fields are marked with *):

  • User's display name* - the user name that will appear in the interface;
  • Login to log in* - the username to be entered at authorisation;
  • Password* - the password to be entered at authorisation;
  • Repeat the password* - duplicate password;
  • The number of the login certificate - leave empty for SPFS;
  • Option Administrator is only enabled if the user to be added should have administrator authority. A user with this authority will have full access to the admin panel where basic settings are made;
  • Option Domain user enables login authorisation with domain account. Note: The option is only displayed on the form if the relevant setting is enabled in the Transit Terminal configuration file (the Web.UseDomainAuth key is set to true);
  • Option Allow viewing summary information is not relevant for SPFS;

Once the form has been completed, click on the Add user button. The new user will appear in the table section.

Creating a user

To edit user data, you need to:

  1. left-click on the user and an additional line with a Change user data button will be displayed, which will open an edit form when clicked. You can also open the edit form by double-clicking on the user you are looking for;
  2. change the required fields on the form (except for the login as this field is locked for editing);
  3. Press the Save button.

To remove a user, you need to:

  1. tick the box of the user or users to be deleted;
  2. press the button Delete;
  3. confirm deletion.
Deleting a user

Only one user can also be assigned the role of confirming changes. This role only regulates the approval of changes to Transit Terminal settings, and has nothing to do with the approval of business documents. If a user has been assigned this role, a Change Request section will be available in the Settings Panel where the user can approve or reject change requests. For more information, see the sections Setting confirming role to user and Change requests.

Left-clicking on a user opens a row with the buttons Change user data, Certificates, Accounts and Permissions and Copy user permissions:

  • The Change user data button opens an edit form to make changes to the user’s details;
  • The Certificates button takes you to a modal window where certificates can be added to the user if required. The NSD Cryptographic Service is used as the cryptoprovider (see Signing configuration with NSD Cryptographic Service (GOST/RSA). Note: If signature model uses only phases with type “Agreement”, no certificates need to be configured.
  • The Accounts and permissions button opens a modal window Manage user permissions where the user’s authority is configured. For details, see Configuring User Authority section.
  • For details on button Copy user permissions functionality, see section Copy user permissions.
User - a row with the buttons

Configuring User Authority

User permissions are set in terms of accounts and document types. The permissions define what actions a user can perform with a specific document type within a specific account (import, view, delete, etc.), as well as establish the user’s right to approve/sign a document at a specific phase.

Once users have been added to the system, it is necessary to determine which permissions will be available to each of them. It is possible for one user to import, review and delete documents and for another user to review, approve and reject documents, but not to be able to import documents. This was just one possible example. In reality, authority settings are very flexible, making it possible to implement almost any document handling scenario at the user authority level.

To go to user authorisation settings, you need to left-click on the relevant user and then click on the button Accounts and permissions:

Accounts and permissions

In order to add authority to the user, press the button Add permissions, and a modal window will open, in which you need to

  1. choose an account;

  2. select the necessary type of document. The following document types are available for the SPFS account:

    • Statement - MT950 format;
    • SPFS SWIFT(ED503) is a financial messaging envelope (SWIFT);
    • SPFS free format (ED501) - the envelope for electronic message in the participants' own formats of electronic data exchange;
    • ED512 - an order to manage SPFS user details;
    • ED573 - request for a directory of users of the Bank of Russia financial messaging system;
    • ED201 - this item is not relevant (not used);
    Selecting a document type
  3. set permissions - tick the appropriate options.

    • The following permissions are available for the following document types SWIFT (ED503), SPFS free format (ED501), ED512 and ED573:
      • View establishes the user rights to view the specified document type for the SPFS account;
      • Import establishes the user rights to import the specified document type for the SPFS account;
      • Delete establishes the user rights to delete the specified document type for the SPFS account. See section Deleting SPFS Documents;
      • Cancel establishes the user rights to reject the specified document type for the SPFS account. See section Rejecting SPFS Documents;
    • only one authority is available for Statement and ED201 document types:
      • View establishes the user rights to view the specified document type for the SPFS account;
  4. If Approval/Signature Model is configured for the document being searched, the Document Signing Phases block will appear. To set the user’s signing or approval rights, click on the Add signing phase button, which will open a modal window Add signing phase, where the following fields may be present:

    • Phase which is always displayed on the form. This field selects the phase for which the user approves/signs the document. Values in the drop-down list are displayed in accordance with the signature model settings entered for the account in question (for details, see section Setting up the signature model);
    Adding an approval phase

  5. Click Add in the Add signing phase window;

  6. click the Save button in the Add permissions window.

The illustration below shows an example of how to configure user permissions for one of the SPFS document types. With this setting, the user will be able to view ED512 documents in the tabular part, approve them before sending them to the SPFS MPC, reject them if necessary, but will not be able to create ED512 documents.

Adding authority to a user

To edit a user’s permission, you need to:

  1. click on the row with the account and document type in the table, a modal window will open;
  2. in the modal window edit necessary data;
  3. click on the Save button.

To delete a user’s permission, you need to:

  1. tick the position to be deleted;
  2. press the button Delete;
  3. confirm deletion.
Deleting a user’s authority

If you need to assign the same authority to a large number of users, the Transit Terminal provides a user authorisation copying function, which is explained in detail in the section Copy user permissions.

Important note: The administrator’s (user with option Administrator ) work with documents is governed by the permissions configured just like for normal users. If the administrator has not configured permissions for the SPFS account and document type, he/she will not be able to perform any actions with this document type (import, create, view, sign, etc.) in the SPFS user interface.

Other

When working with SPFS in the Other section of the administration panel, you must set the operational day.

The operational day in the production segment is the same as the current date.

Please note: In the test segment, as a rule, the operational day does not coincide with the current date.

The operational day for the test segment is set according to the information available on the Bank of Russia website at https://cbr.ru/development/mcirabis/regl/

The website specifies the testing date, which is to be indicated in the settings as the operational day for the test segment.

Setting the operational day

Subsequently, the date specified in the operational day will be in the EDDate field of the generated ED envelope of the SPFS documents (ED512, ED501, ED503 and ED573). The picture below shows a generated ED envelope of document ED512 where the EDDate field is populated according to the business date specified in the settings of the Other section:

Filling in the EDDate field in the ED envelope

It is also possible to set up automatic changeover of the operational day by enabling the corresponding option and specifying the time of the operational day changeover in HH:MM format (hours, minutes).

This section also includes useful settings such as auto-import of documents and document archiving that can be applied when working with SPFS.

You can set up automatic import of SFPS documents into the Transit Terminal from a specific directory at a specific interval.

To set up automatic import for SPFS documents, you need to enable the Automatic import option, then the SPFS option and specify the mask (the characters in the name of the imported files by which the SPFS document will be identified). Next you need to select the method of marking the imported documents, the period of checking folders and the path to the automatic import folder. Detailed description of automatic import settings for documents and possible scenarios are given in section Automatic import of documents.

Setting up automatic import for SPFS documents

Please note that automatic import for SPFS documents is only possible for SWIFT messages (ED503).

The process of deleting documents from the Transit Terminal with pre-archiving is described in detail in section Deleting documents (pre-archiving).

SPFS - user menu

Once all necessary settings have been made in the admin settings panel, you can proceed directly to working with SPFS documents. SPFS documents are handled in the user menu, in the SPFS section.

An English version of the SPFS section is also available. To switch to English, you need to select English in the top bar:

Switching to English

Tabular part

The tabular part provides information about the SPFS documents. Outgoing messages ED512 and ED573 as well as messages ED501 and ED503 both outgoing and incoming are accumulated here.

The current user can view the documents provided that the user settings for the SPFS account and the document type being searched enables authority View.

Authority to view document

When the viewing rights for documents ED501 and ED503 are enabled, both incoming and outgoing messages will be displayed in the tabular section.

The following columns are provided in the tabular part:

  • SPFS number - the SPFS document number is displayed. The value can be entered manually in the filter field;
  • Direction - the direction of document is displayed, either incoming or outgoing. The value in the filter field is selected from a drop-down list;
  • Date - the date and time of creation is displayed for outgoing documents; and only the date of message without time indication for incoming documents. The value in the filter field is selected from the calendar;
  • Sender - the sender of the message is displayed;
  • Receiver - the recipient of the message is displayed;
  • SWIFT number - SWIFT number in the SPFS system, to be filled in for ED503 only. The value can be entered manually in the filter field;
  • SWIFT sender - sender’s SWIFT BIC for message ED503, not to be completed for other message types. The value can be entered manually in the filter field;
  • SWIFT receiver - receiver’s SWIFT BIC for message ED503, not to be completed for other message types. The value can be entered manually in the filter field;
  • SWIFT message type - type of SWIFT MT message (ED503). The field is only relevant for ED503. The value can be entered manually in the filter field;
  • Document type - the type of the message is displayed: SPFS SWIFT (ED503), SPFS free format (ED501), ED512, ED573. The value in the filter field is selected from a drop-down list;
  • Status - the current status of the document is displayed. The value in the filter field is set by ticks, a text search option is provided;
  • Sum - the field is relevant for ED503 with types MT 103, 195 and 202 (the amount is filled based on the 32A field in SWIFT message);
  • Currency - the field is relevant for ED503 with types MT 103, 195 and 202 (the currency is filled based on 32A in SWIFT message);
  • Phases - all message phases (approval/signing phases) are displayed, the stages that have been completed are marked with a tick;

The illustration below shows the tabular part in the “SPFS” section:

SPFS - the tabular part

The Transit Terminal provides the ability to set filters in any of the columns, and to sort the data in the table by any of the columns. For example, in the picture below, the tabular part is filtered by outgoing messages with document type ED503. In this table, the data is sorted by SWIFT message type (left-click on the arrows to the right of the column header to sort). The column by which the data is sorted in the table is highlighted in blue.

Sorting and filtering

It is also possible to customise the display of columns in the tabular part. If you uncheck certain columns, they will not be displayed in the tabular part:

Setting the columns to be displayed

The section Saving table display settings explains in detail how you can save the table settings you have entered (filters, sorting, column display).

On the right side above the table, the total amount of the ticked documents is displayed (you can pre-filter the table part by document type ED503 and other required parameters):

Total amount of selected documents

If documents with different currencies are highlighted, the total amount is not displayed:

Total amount of selected documents (different currencies)

ED512

ED512 is an instruction to manage the details of the users of the Bank of Russia financial messaging system.

Before exchanging ED501 and/or ED503 messages with a specific counterparty, the SPFS user must send a message to MPC by which it authorises the counterparty to send it messages with one or the other envelope. This message (sent to the MPC) is referred to as ED512. The result of processing such a message in the MPC is to make appropriate changes to the SPFS User Directory, which is stored centrally. In response to the request, message ED574 is received, which contains only the changed information in the directory for the SPFS user from whom message ED512 was received and processed.

For one counterparty and one type of document (ED501 or ED503), it is sufficient to generate and send an ED512 envelope only once.

The following sections will detail how to handle ED512 messages in the Transit Terminal.

Creating ED512

Creating ED512 is available to users who have the right to import a document as set in the authority settings. For the user who has the right to import a document, it is advisable to set the right to view it.

The ED501 must also be preconfigured with a signature model.

In order to generate and send an ED512 message through the Transit Terminal interface, press the Create ED512 button.

A form will open where you need to:

  • select an organisation from the drop-down list in the Sender field;

  • in the Document type field, select a type of envelope, which you intend to exchange with the specified counterparty (counterparty is indicated in the Contractor field). You authorise the counterparty to send you the specified envelope type. One of the two envelope types is available for selection in the drop-down list:

    • SPFS SWIFT (ED503);
    • SPFS Free format (ED501);
    ED512- selecting a document type
  • The field MT messages allowed for exchange is only displayed on the form if SWIFT document type (ED503) has been selected. Here, according to the mask, the types of MT messages that are allowed to be sent to the counterparty are listed. If the counterparty is given permission to send any type of MT message, the field is not completed.

    List of MT message types that are allowed to be exchanged
  • in the field Contractor, select the SPFS participant from the drop-down list with whom you plan to exchange with the specified envelope type (it is the counterparty you give permission to send you documents with the specified envelope, in the case of ED503, the MT message types for exchange can be also set, as described above). The list of counterparties is formed according to the directory of SPFS participants, which is updated daily (in the production segment). A text search by name, UIS and SWIFT BIC has been implemented for a convenient counterparty search.

  • click on the Create button.

The illustration below shows an example of creating an ED512:

Creating ED512

Please note You need to send an ED512 message to the MPC for each of the counterparties with which you intend to exchange documents of a certain type (ED503 and ED501). If both ED503 and ED501 are to be exchanged with a counterparty, two ED512 messages need to be created and sent to that counterparty, one to authorise the counterparty to send you messages with an ED503 envelope (list the types of MT messages if applicable) and one to authorise the counterparty to send you messages with an ED501 envelope.

To receive any messages from you the counterparty should also send an ED512 to the MPC, thereby giving you permission to send them messages with a specific envelope.

Sending ED512

Depending on the signature model configured, the ED512 can be sent to the MPC:

  • immediately after the document has been created and saved (via the Create button) in case the Signing phases are not required option is activated in the signature model settings for the ED512 document;
  • after the document has been approved/signed at all stages specified in the signature model. This is usually one or two approval stages.

If the Signing phases are not required option is activated in the Signature Model settings for an ED512 document (see section Setting up the signature model), the document is sent to the MPC immediately after it has been created.

If the approval/signing phase/phases has/have been configured in the Signature Model settings, the document must be approved/signed by an authorised user before the document can be sent to the MPC.

To approve/sign the document, you need to tick it in either the first column or tick the checkbox in the Phases column and click on the Agreement / Sign button (or Agreement and send / Sign and send). The name of the button is dynamic depending on whether the current phase has a signature or approval type. If the type is Sign, the button will be named Sign and send or Sign (in case several signatures are set up and the signature to be given is not the final signature). Similarly, if approval has set up, the button is called Agreement and send or Agreement (in case more than one approval phases are set up and the current approval is not final).

The illustration below shows approval of a ED512 document with one phase. In this example, for convenience, the tabular part has been pre-filtered by document type and Draft status, then in the phases column the first phase has been ticked and the Agreement and send button pressed. As a result, all marked ED512 documents will be agreed and sent to the MPC.

Approval of ED512

Note that for a user who has approval authority over a document in the current phase, these documents will be highlighted in green in the tabular part. Thus, the green colour for the user is an indicator that these documents need to be approved/signed.

The signature/approval process is the same for all types of documents. A detailed example on signing documents can be found in the section Signing SPFS documents.

Once the ED512 message has been created and approved/signed, it is sent to the MPC. The ED512 message can be considered to have been processed by the MPC as soon as the ED512 document has been assigned the status Done. You will in turn receive an envelope ED574, the printed form of which can be viewed by opening the ED512 document detail. You will then be able to receive documents from the counterparty with the envelope type specified in ED512 (ED501 or ED503).

ED512 statuses

If the ED512 document is sent successfully, it passes the following statuses:

  • Draft - the document is in this status as soon as it is created;
  • In the signing queue - the document moves to this status when it is being approved/signed. This status is not relevant for documents with the signature model not providing approval/signing phases. In this case, after the document is created, from the Draft status it is immediately moved to the In the queue for sending status;
  • In the queue for sending - the document is in the queue to be sent to NSD;
  • Sending to NSD - this status is assigned after the document has been posted in the File Gateway folder, but before a reply receipt is received;
  • Sent to NSD - this status is assigned after uploading the message to the File Gateway folder with confirmation of sending;
  • Sent to service-bureau - this status is assigned after the document has been sent to the SPFS Service Bureau;
  • Delivered to service-bureau - this status is assigned after the document has been delivered to the SPFS Service Bureau;
  • Done - it is assigned after the document has been processed in the SPFS Service Bureau and ED574 has been received in response. This is the final status;

The statuses assigned in case of any errors are described in a section Error statuses.

ED512 - detail

Double left-clicking on ED512 opens a form detailing the document. The name of the modal window contains SPFS message number.

The following buttons are available on the form:

  1. Download Document - the button allows you to download a document converted to SPFS format after the document has been agreed/signed or sent. If the document is in Draft status (i.e. no ED envelope has been generated), it is not possible to download such a document, an error occurs when trying to download the document;
  2. Download ED574(PDF) - is only displayed for documents in Done status, otherwise the button is not available on the form. By clicking on the button you can download the Information on SPFS participants received in response to ED512 in PDF format (contains only the amended Directory information for the SPFS user from whom the ED512 message was received and processed).
  3. Refresh - the form is updated according to the latest data on the document;

The following tabs are available on the form:

  1. Details - the document parameters and their values are displayed;

  2. Status history - changes in the document statuses can be traced;

  3. Linked documents is only displayed for documents with the status Done. This tab in the tabular section displays the documents associated with the current ED512 .

    ED512 - linked documents
  4. Document - in case the document is in Draft status, the original information of the document (Sender, Countragent and Document Type) will be displayed as shown in the figure below:

    Displaying Document ED512 in Draft status

    In case of document type ED503, information on allowed MT message types will also be displayed if they were listed in the corresponding field in the ED512 creation step.

    Display ED512 document with type ED503 in Draft status

    Otherwise, if the document has been approved/signed or sent immediately, the Document tab will display the generated ED envelope as shown in the figure below.

    Displaying the ED envelope for ED512
  5. ED574 is only displayed for documents with Done status. The tab contains the ED574 (Information on SPFS Participants) report received in response to ED512 (contains only the amended Directory information for the SPFS user from whom the ED512 message was received and processed). The same form can be downloaded by clicking on Download ED574 (PDF).

    Print form ED574 for executed ED512

ED573

Message ED573 is used to request a directory of users of the Bank of Russia Financial Messaging System. The user of the SPFS who initiated the request receives in response ED574, which contains information about all users of the Bank of Russia Financial Messaging System.

Creating ED573 is available to users who have the right to import a document as set in the authority settings. Document ED573 must also be preconfigured with a signature model.

In order to create an ED573 document, click on the Create ED573 button, a modal window will open, where the following actions are required:

  • in the field Sender, select the sender organisation from the list;
  • in the field Dictionary request time, select one of three values from the drop-down list:
    • 1 - Request dictionary of SPFS members;
    • 2 - Request dictionary with information about members which can send messages;
    • 3 - Request dictionary with information about members which can receive messages;
  • click on the Create button.
Creating ED573

Once the document has been created, it should be sent to the MPC. If the No signing phases are needed option is activated in the signature model settings for the ED573 document, the document is sent immediately after it has been created.

If the approval/signing phase/phases are configured in the signature model settings, the document must be approved/signed by an authorised user before it can be sent.

The illustration below shows approval of a ED573 document with one phase. As a result, the agreed document will be sent to the MPC.

Approval of ED573

The signature/approval process is the same for all types of documents. A detailed example on signing documents can be found in the section Signing SPFS documents.

The message ED573 can be considered to have been successfully processed in the MPC as soon as the ED573 document sought is assigned the status Done and an ED574 envelope will be received in response, the printed form of which can be observed by opening the ED573 document detail form.

Double left-clicking on ED573 opens a form detailing the document. The name of the modal window contains SPFS message number.

The composition of the tabs and buttons on the form for document ED573 is the same as for document ED512. Therefore, the description of the tabs and buttons can be found in the example ED512 in section ED512 - detail. Please note that for executed ED573 (status Done) as well as for ED512, the Download ED574(PDF) button and the ED574 tab will appear on the form where it is possible to view information on all users of the Bank of Russia financial messaging system received in response to the request.

The statuses of an ED573 document when sent successfully are similar to those for an ED512 document, see section ED512 statuses.

ED501

ED501 - message of participants' own formats, sometimes referred to as a free format. All types of files can be transferred with this type of message. SPFS participants transmit messages with file types that are agreed upon in advance, e.g. text messages.

The user of the SPFS sends an ED501 to the MPC. ED501 contains a message with the information established by the bilateral protocol of information interaction between the sending and receiving participants. The SPFS user receives ED508 in response with information on the status of the message. If the control is successful the MPC sends ED501 to the recipient.

Creating ED501 is available to users who have the right to import a document as set in the authority settings. For the user who has the right to import a document, it is advisable to set the right to view it.

Authority to create ED501 by the user

Document ED501 must also be preconfigured with a signature model.

In order to create a free format message ED501, click on the button Create ED501, a modal window will open, where the following actions are required:

  • in the Sender field, select the sender organisation from the list;
  • in the Receiver field, select the SPFS participant from the list of participants, to which the current envelope is to be sent. A text search by name, UIS and SWIFT BIC has been implemented;
  • Press the button Choose a file to open an explorer window where you must select the message file.
Creating ED501

Once the file is selected from Explorer, the created message ED501 will be displayed in the tabular part:

ED501 in the tabular part

If the option Signing phases are not required is activated in the Signature Model settings for an ED501 document (see section Setting up the signature model), the document is sent to the SPFS Service Bureau immediately after it has been created.

If the approval/signing phase/phases has/have been configured in the Signature Model settings, the document must be approved/signed by an authorised user before the document can be sent.

To approve/sign the document, you need to tick it in either the first column or tick the checkbox in the Phases column and click on the Agreement / Sign button (or Agreement and send / Sign and send). The name of the button is dynamic, depending on what type the current phase is (signing or agreeing) and whether the current phase is the final phase. You can pre-filter by any of the parameters, and select the filtered entries in the table at once by checking the box in the table header in the first column or by ticking the appropriate stage in the top row of the column Phases.

The illustration below shows approval of a ED501 document with one phase. As a result, all ED501 documents will be agreed and sent to the end user.

Approval of ED501

Note that for a user who has approval/signing authority over a document in the current phase, these documents will be highlighted in green in the tabular part. Thus, the green colour for the user is an indicator that these documents need to be approved/signed.

The signature/approval process is the same for all types of documents. A detailed example on signing documents can be found in the section Signing SPFS documents.

Once ED501 has been created and approved/signed, it is sent to the final recipient.

The ED501 message can be considered to have been successfully processed by the SPFS MPC and sent on to the recipient once the ED501 is assigned the Sent to the recipient of the SPFS status.

It is also possible to automatically save ED501 incoming documents (see section Automatic saving of incoming messages).

ED501 statuses

If the ED501 document is sent successfully it passes the following statuses:

  • Draft - the document is in this status as soon as it is created;
  • In the signing queue - the document moves to this status when it is being approved/signed. This status is not relevant for documents with the signature model not providing approval/signing phases. In this case, after the document is created, from the Draft status it is immediately moved to the Queued for sending status;
  • In the queue for sending - the document is in the queue to be sent to NSD;
  • Sending to NSD - this status is assigned after the document has been posted in the File Gateway folder, but before a reply receipt is received;
  • Sent to NSD - this status is assigned after uploading the message to the File Gateway folder with confirmation of sending;
  • Sent to service-bureau - this status is assigned after the document has been sent to the SPFS Service Bureau;
  • Delivered to service-bureau - this status is assigned after the document has been delivered to the SPFS Service Bureau;
  • Sent to the recipient of the SPFS - assigned when ED508 (with status information of the electronic message) is received from the SPFS MPC (successful processing of the message in the MPC). This is the final status;

Important note: The ED508 received from the SPFS MPC will not be shown in the interface; in this case the document will be assigned the status Sent to the recipient of the SPFS, which will indicate that ED508 has been received.

The statuses assigned in case of any errors are described in a section Error statuses.

ED501 - detail

Double left-clicking on ED501 opens a form detailing the document. The name of the modal window contains SPFS message number.

The following buttons are available on the form:

  1. Download document - allows you to download a document converted to SPFS format after the document has been approved/signed or sent to the MPC. If the document is in Draft status, the attachment (the file selected when the document was created) is downloaded;
  2. Download attachment - the button downloads the attachment (decoded file of message ED501);
  3. Refresh - the form is updated according to the latest data on the document;

The following tabs are available on the form:

  1. Details - the document parameters and their values are displayed;

  2. Status history - changes in the document statuses can be traced;

  3. Document - the generated ED envelope for the approved/signed or sent documents to the SPFS is displayed. In case of documents in Draft status, the tab is not filled in;

    The figure below shows what the Document tab may look like for an approved ED501 (the document has been converted to SPFS format when approved).

    ED501 message form - document tab

ED503

ED503 is used for the transmission of financial messages (SWIFT). Messages transmitted by such an envelope are subject to additional formatting and logical control in the SPFS, following the same rules that apply to SWIFT messages.

The SPFS user sends an ED503 to the MPC, which contains the financial messages for the transfer of funds. The SPFS user receives ED508 with information on the status of the message. If the control is successful, the MPC sends ED503 to the recipient.

Creating or importing an ED503 document is available to users who have the right to import a document as set in the authority settings. For the user who has the right to create a document, it is advisable to set the right to view it.

Authority to create ED503 by the user

Document ED503 must also be preconfigured with a signature model.

There are two ways to create an ED503 envelope:

  • Import a ready-made (correctly composed) SWIFT message by clicking on the button Import SWIFT. See section Importing ED503 for details;
  • Create message from screen form using the button Create ED503. See section Creating ED503 via screen form for details;

It is also possible to automatically save ED503 incoming documents (see section Automatic saving of incoming messages) and to automatically print ED503 with message type SWIFT MT950 (see section Automatic printing of incoming and outgoing documents).

Importing ED503

The Transit Terminal provides allows the user to import files with SWIFT messages, which, for example, can in turn be uploaded from third-party software.

To import SWIFT message files, click on the button Import SWIFT and an Explorer window will open, in which the relevant files are selected for import. Imported SWIFT messages will be displayed in the tabular part with Draft status. If the configured signature model provides for sending a document without approval/signing phases, it will be immediately transferred to further statuses.

Example of imported ED503 documents

Further, if the configured model provides for approval/signing phases, the documents must be approved/signed by selecting them and clicking on the button Agreement and send (Sign and send), and the documents will be sent to the MPC.

Approval of ED503

Note that for a user who has approval authority over a document in the current phase, these documents will be highlighted in green in the tabular part. Thus, the green colour for the user is an indicator that these documents need to be approved/signed.

The ED503 message can be considered to have been successfully processed by the SPFS MPC and sent on to the recipient once the ED501 is assigned the Sent to the Recipient of the SPFS status.

The fifth block is available when importing a document. If the fifth block is filled in in a SWIFT message, the block will also be filled in in the imported ED503. Below is an example of an imported SWIFT message with block 5:

Imported ED503 with block 5

Important note: importing multiple SWIFT messages from a file is available. Thus, if you have two or more SWIFT messages in one text file, the import will create multiple ED503 documents according to the number of SWIFT messages in the file.

It is also possible to set up the automatic import of SWIFT messages from a specified directory at the desired frequency. Detailed description of automatic import settings for documents is given in section Automatic import of documents.

Creating ED503 via screen form

To create ED503 via screen form, you need to click on the button Create ED503, and a screen form will open where the following fields are provided:

  • Sender - select an organisation from the drop-down list. A list of organisations is formed according to the authority given to the current user;

  • Receiver - is selected from the drop-down list in which SPFS participants are included according to the available directory. A text search by name, UIS and SWIFT BIC has been implemented;

  • MT type of SWIFT message - a three character numeric code corresponding to the type of MT message should be entered;

  • Priority - selected from a drop down list; values available: Normal, System or Urgent. The value is involved in the automatic generation of SWIFT MT message technical blocks and does not affect the SPFS service. It is recommended to select Normal by default.

  • Control over message delivery - selected from a drop down list; values available: Delivery notification, Non-delivery warning, Non-delivery warning and delivery notification. The value is involved in the automatic generation of SWIFT MT message technical blocks and does not affect the SPFS service. By default, it is populated with a Delivery Notification.

  • Possible delivery period - filled in with a three-character number. Valid values:

    • 001 - this value is indicated if the possible delivery period is 5 minutes;
    • 003 - this value is for urgent priority;
    • 020 - this value is for normal priority; this is the default value, it is recommended to leave the default value;
  • Add data of 4 SWIFT message blocks - the fourth block of a SWIFT message (message body). You can either fill in the block manually or copy the data from the clipboard;

Creating ED503 via screen form

Once all fields on the form have been filled in, click the Save button.

When creating via screen form, technological fields (1, 2, 3) will be filled in automatically based on data already entered. Field 4 will be filled in according to the data entered on the form in the field Add data of 4 SWIFT message blocks. Block 5 will be automatically made empty.

The SWIFT message number is one of the components of block 1.

Block 2 of a SWIFT message is formed of the parameters Priority, Delivery control and Delivery period, i.e. (highlighted in bold): {2:I195NICBAZ22AXXXU2003} where U is Priority, possible values:

  • N - normal;
  • S - system;
  • U - urgent;

where 2 is Delivery control, possible values:

  • 2 - delivery notification;
  • 1 - delivery failure alert;
  • 3 - delivery failure alert and delivery notification;

where 020 is Delivery period, with possible values:

  • 020 - normal;
  • 001 - system;
  • 003 - urgent;

Please note: When completing a SWIFT message, it is assumed that:

  1. You have specialised software (ABS, ERP, SWIFT Alliance terminal, etc.) that generates messages in the required format;
  2. Your company has people with experience in creating SWIFT MT messages in the required categories (1nn to 9nn).

If the option Signing phases are not required is activated in the Signature Model settings for an ED503 document (see section Setting up the signature model), the document is sent to the MPC immediately after it has been created.

If the approval/signing phase/phases are configured in the signature model settings, the document must be approved/signed by an authorised user before it can be sent.

To approve/sign the document, you need to tick it in either the first column or tick the checkbox in the Phases column and click on the Agreement / Sign button (or Agreement and send / Sign and send). The name of the button is dynamic, depending on what type the current phase is (signing or agreeing) and whether the current phase is the final phase.

The ED503 message can be considered to have been successfully processed by the SPFS MPC and sent on to the recipient once the ED501 is assigned the Sent to the Recipient of the SPFS status.

ED503 statuses

When ED503 is sent successfully, it passes the same statuses as ED501, namely:

  • Draft - the document is in this status as soon as it is created;
  • In the signing queue - the document moves to this status when it is being approved/signed. This status is not relevant for documents with the signature model not providing approval/signing phases. In this case, after the document is created, from the Draft status it is immediately moved to the Queued for sending status;
  • In the queue for sending - the document is in the queue to be sent to NSD;
  • Sending to NSD - this status is assigned after the document has been posted in the File Gateway folder, but before a reply receipt is received;
  • Sent to NSD - this status is assigned after uploading the message to the File Gateway folder with confirmation of sending;
  • Sent to service-bureau - this status is assigned after the document has been sent to the SPFS Service Bureau;
  • Delivered to service-bureau - this status is assigned after the document has been delivered to the SPFS Service Bureau;
  • Sent to the recipient of the SPFS - assigned when a positive ED508 (with status information of the electronic message) is received from the SPFS MPC (successful processing of the message in the MPC). This is the final status;

Important note: the positive ED508 received from the SPFS MPC will not be shown in the interface; in this case the document will be assigned the status Sent to the recipient of the SPFS, which will indicate that the positive ED508 has been received.

The statuses assigned in case of any errors are described in a section Error statuses.

ED503 - detail

Double left-clicking on ED503 opens a form detailing the document. The name of the modal window contains SPFS message number.

The following buttons are available on the form:

  1. Download Document - the button allows you to download a document converted to SPFS format after the document has been agreed or sent. If the document is in Draft status, the SWIFT message is downloaded in txt format;
  2. Download SWIFT - the button downloads the SWIFT message in txt format (decoded message). The same message appears on the tab SWIFT;
  3. Refresh - the form is updated according to the latest data on the document;

The following tabs are available on the form:

  1. Details - the document parameters and their values are displayed;

  2. Status history - changes in the document statuses can be traced;

  3. Document - the generated ED envelope for the approved/signed or sent documents to the SPFS is displayed. In case of documents in Draft status, the tab is not filled in;

    The figure below shows what the Document tab may look like for an approved ED503 (the document has been converted to SPFS format when approved).

    ED503 message form - document tab
  4. SWIFT - the SWIFT message (decoded message) is displayed. The same message in txt format can be downloaded to the user’s computer using the button Download SWIFT.

    ED503 message form - SWIFT tab

Editing ED503

It is possible to edit an ED503 document in Draft status.

To edit a ED503 document, select it in the tabular part and click on the button Edit. The form Edit the SWIFT message will open where you need to edit the data in the fields you need and click on the Save buttonafterwards.

Editing ED503

Important note: only ED503 documents can be edited. This is not possible for other SPFS documents

Statement

When an incoming ED503 with message type MT950 is received, an incoming document appears in the SPFS section (see section Incoming SPFS Documents). At the same time, a Swift type document is generated in the section Statements.

The current user can view these statements if the user settings for the SPFS Account and Statement document type have the View permission enabled.

Rights to view SPFS account statements

The illustration below shows incoming document ED503 with message type MT950 displayed in the SPFS section:

Incoming document ED503 with Message Type MT950

The illustration below shows the statement in the Statements section generated from the document ED503. The statement you need can be downloaded in several formats. To do so, left-click on the line with the statement. An additional line with buttons with format names will open.To save the statement in the format you need, click on the button with the required format name. The statement will be saved to the user’s computer.

Statement based on ED503 with MT950

To view detailed information on a statement, double left click on the line with the statement. A modal window will display detailed information on the debit and credit turnover. Here the user can also filter and sort data, download 1C or open a printable document form (PDF).

Details of the statement

Incoming SPFS documents

Incoming documents ED501 and ED503 are displayed in the tabular section with Input direction and Received status.

The figure below shows an example of how incoming documents ED501 and ED503 are displayed in the tabular part in the tabular part SPFS:

Incoming Documents in the tabular part

In the tabular part in the Date column the date for incoming messages is displayed in MM/DD/YY format without time indicated.

It is possible to view detailed information for incoming documents, as well as for outgoing ones, by double clicking on the document in the table. A form will open where you can view detailed information, download an attachment (SWIFT message) and the document itself. A detailed description of this form can be found in sections ED501 - detail and ED503 - detail.

Detailed information on the incoming document

Error statuses

Various errors can occur during the processing of SPFS documents. If an error occurs, the document will be given a relevant status, such as Sending error, Delivery error, Rejected by SPFS control, Terminal error, or Convertation error may occur.

Rejected by SPFS control for ED512, ED573 and ED501 is given when an ED201 response message is received from the SPFS MPC. Rejected by SPFS control for ED503 is given when ED201 or a negative ED508 is received in response from the SPFS MPC. In turn, ED201 is a notification of control results and ED508 contains information on the status of the electronic message.

Important note: ED201 or negative ED508 received from MPC are not shown in the tabular part of the interface in any way. When these messages are received, the user will see the relevant status, Rejected by SPFS control and will also see the error text. See below for examples.

The document with the error will be highlighted in red in the tabular part and will be given the relevant error status. The illustration below shows an example of ED512 documents with errors:

ED512 documents with an error in the tabular part

You can see the details of the error by left-clicking on the document, as shown in the figure below. In this case, the document was rejected by the SPFS control due to an incorrect message date:

ED512 - detailed information about the error in the tabular part

You can also see the error message when viewing the detailed information of the document by double-clicking on it (a form will open in another window).

The figure below shows an example of an error occurring for document ED503 during the SPFS control phase. The document is highlighted in red and has been assigned the relevant status Rejected by SPFS control, the document has been rejected due to an incorrectly drafted SWIFT message. Open the detailed information or click once with the left mouse button and you will see the detailed information on the error:

ED503 - rejected at the phase of the SPFS control

The following figure also shows an example of an error occurring for document ED503 during the SPFS control phase (Rejected by SPSS Control status is assigned). In this case, the document was rejected because the recipient did not give permission to send this type of MT message. Open detailed information or left click once and you will see detailed information about the error:

ED503 - rejected at the stage of the SPFS control

The status for other SPFS documents (ED501 and ED573) is similarly assigned when an error occurs, the document is highlighted in red and the error information can be viewed in the ways described above.

Automatic saving of incoming messages

It is possible to automatically save incoming messages ED501 and ED503 in the Transit Terminal.

To enable this feature, you need to go to the administrator’s settings panel in the section Accounts and open the SPFS account card. In the SPFS account card:

  • set the option Autosave ED501/Autosave ED503 in the settings;
  • select the format for saving the document: Package and/or Attachment, documents can be saved in both formats if needed;
  • in the Format of package file ED501(/ED503) and Format of attachment file ED501(/ED503) fields you can specify the naming pattern for the package file and the attachment file respectively. The following variables can be used in the naming pattern: DD, MM, YYYY, YYYY - date, month, year of document creation; HH, mm - hours and minutes of document creation; GUID - unique identifier; ORG - organisation name; N - number of SPFS document; UC - SPFS user code;
  • specify the path to the message saving directory on the Transit Terminal server;
  • save the entered settings by pressing the Save button.

The illustration below shows an example of the settings for automatic saving of ED501 and ED503 incoming documents.

Enable automatic saving of incoming documents

If an invalid (non-existent) directory path is specified, an error will occur when trying to save the account:

Error when saving the account - invalid path

If the automatic save setting is on, you will see the following when you receive an incoming message ED501:

Received incoming message ED501

the document will be saved in the specified directory on the Transit Terminal server in the specified formats, in this example, as a package and as an attachment:

Saving an incoming document to the Transit Terminal Server

A file with the word attachment in its name is an attachment and a file with the word package in its name is a package. An attachment is the attachment itself received in a message sent with an ED501 envelope. Package is an XML file with the ED envelope.

Similarly, when ED503 is received, a package or/and attachment will be saved in the directory you need on the Transit Terminal server. The attachment for ED503 will be the SWIFT message itself in txt format and the package will be saved as an XML document with the ED envelope.

Important note: this setting can be used for integration with ABS (Automated Banking Systems). It is assumed that in this case, documents will be exchanged through shared file folders.

Automatic printing of incoming and outgoing documents

The SPFS module implements automatic printing of incoming and outgoing documents. This option only applies to ED503 documents.

To enable automatic printing of incoming/outgoing documents, go to Banking modules in the admin settings panel, select the SPFS module on the left side of the list of banking modules and enable the Automatically print documents option. Additionally, the boxes MT type groups for incoming documents and MT type groups for outgoing documents will be displayed where only those MT message categories (incoming and outgoing) that need to be automatically printed when receiving/sending ED503 should be checked. An additional field Printer for printing will also appear, where you must select one of the connected printers on the Transit Terminal server from the drop-down list. Once the settings have been entered, the Save the configuration of the selected module button must be pressed.

Enabling automatic printing of documents

When incoming ED503 documents are received with the MT message categories checked in the bank module settings, these documents will be printed on the selected printer.

Similarly, when ED503 documents are sent to the SPFS Service Bureau (outgoing) with the message categories ticked in the banking module settings, these documents will be printed on the selected printer.

Please note: If the Automatically print documents option is enabled, it will print incoming ED503 documents with message type MT950 (statements) by default regardless of whether the 9xx category is checked in the bank module settings. If you wish to print other types of MT messages from category 9xx other than MT950, you will need to enable the required check box in the settings.

The MT950 incoming message is printed as a statement, such as the one shown below:

Print MT950 Inbox

In case of all other incoming message types and all outgoing message types (including outgoing MT950 message type), a SWIFT message will be printed:

Print SWIFT message

Rejecting SPFS documents

There is the button Reject in the СПФС section which allows you to move the document from Draft status to Rejected by User status, as well as from Pending to Rejected at the control phase.

The button is active only for documents in Draft or Pending statuses, provided that the user has enabled the authority Rejection in the settings for the account.

To reject a document, it must be ticked and then the button Reject must be clicked.

Rejecting SPFS documents

Documents after rejection (in statuses Rejected by user and Rejected at control phase) continue to be displayed in the tabular part and highlighted in red.

It is possible to reject several documents at once by ticking them all and clicking the button Reject.

Deleting SPFS documents

There is the button Deletein the SPFS section which allows you to delete documents in Draft, Terminal Error, Rejected at control phase, Send Error and Conversion Error statuses.

The button is activated only for documents in the above statuses, provided that the user has enabled authority Delete in the settings for the account.

To delete a document, it must be ticked and then the button Delete must be clicked.

Deleting SPFS documents

The document will be deleted and disappear from the tabular part.

It is possible to delete several documents at once by ticking them all and clicking the button Delete.

Saving table display settings

In the Transit Terminal, it is possible to save tabular display settings (various filters, sorting, column display). You can save as many settings as you like, and then switch between these settings.

Let’s say we want to configure the tabular part to display ED501 documents. In this example, we want to display only the columns relevant to ED501, we want the tabular part to show only ED501 documents, and we want to sort by direction of messages: first, we want to see all outgoing messages and then all incoming messages. You can make any other setting requirements.

To save the filter with the settings described above, proceed as follows:

  1. Click on the icon on the right side above the table . This will open a pop-up window with the settings. Enter a name for the filter in the input field below, preferably a name that is intuitive (i.e. expresses the essence of the filter being configured). In our case, we will call the filter “ED501”. Then you should click the icon .

    Adding a new filter
  2. select the filter saved in step 1 (click on the circle icon next to the filter name) and then left-click on any area outside the pop-up window.

    Switching to the filter

    Then we will see the name of the selected filter above the tabular part, in this example “ED501”:

    Selected filter
  3. In this step, we will make the tabular part of the table display the way we need:

    • select only columns relevant to ED501 (uncheck the columns used exclusively to SWIFT messages):

      Selection of columns to be displayed
    • set filter by Document type field, select ED501:

      Set filter by document type ED501
    • sort the tabular part by the Direction field (to sort, left-click on the arrows to the right of the column header, one click to sort in ascending order, two click to sort in descending order).

      Sorting the tabular part
  4. In the last step, save the settings entered in step 3. Just click on the floppy disk icon on the right side above the tabular part:

    Saving filter settings

The other filters are set up similarly; in step 3, you decide in which view you want to see the tabular part.

Next, click on the icon to switch between the filters. You select the filter in the pop-up window (click the circle icon next to the filter name) and then click the left mouse button anywhere outside the pop-up window.

Switching the filter

If necessary, you can remove a previously configured filter by clicking on the bin icon next to the filter and then confirming the removal in another window.

Removing a filter from the list

The default filter, Show All, cannot be deleted or overwritten. If you try to overwrite the filter, an error will occur:

Error when saving the filter Show all

Additional information

The sections below describe functionality that may be useful when working with SPFS.

Signing configuration with NSD Cryptographic Service (GOST/RSA)

This type of signing implies the use of keys in Validata format, hence the NSD Cryptographic Service. The MOEX Client Hardware and Software Suite, Validata CSP and NSD Crypto Service must be pre-installed and configured.

Further, after all necessary software has been installed and configured, the following steps need to be completed to enter a signature using NSD Cryptographic Service:

  1. Log in to the web account using the IP address or domain name as a user with Administrator rights;
  2. go to Settings, section Users;
  3. left-click on the appropriate user and click on Certificates;
  4. click on the button Add certificate, fill in the fields:
    • Certificate type - with “Client”;
    • Crypto provider - with “Crypto service NSD (GOST)” / “Crypto service NSD (RSA)";
    • The name of the profile to sign on the client - with a profile name;
  5. press Add certificate;
Adding NSD Cryptographic Service (GOST/RSA) certificate

The profiles used can be viewed in the certificate directory:

Certificate Directory

To set up profiles in the Certificate Directory, select “Profiles -> Profile Setup”:

Setting up profiles in the Certificate Directory

When signing via NSD Cryptographic Service, window Select a profile to sign appears, in which you must specify Type of Cryptography and Profile, and press the button Sign:

Signing via NSD Cryptographic Service

Signing of SPFS documents

The SPFS subsection provides a Sign/ Agreement button for those accounts for which the configured model includes signature/approval phases.

The name of the button is dynamic depending on whether the current phase is of signature or approval type. If the type is Sign, the button will be named “Sign and Send” or “Sign” (in case several signatures are set up and the signature to be given is not the final signature). Similarly, if approval has set up, the button is called “Agreement and Send” or “Agreement” (in case more than one approval phases are set up and the current approval is not final).

Example:

Below we will look at one possible example of signing documents depending on the settings you have made. We will take ED503 as an example. The signing process is the same for all other documents.

Let’s assume that the signature model set up includes two phases, the first with type Sign and the second with type Agreement:

Setting up a signature model

User A has been set up in the Transit Terminal, for which permissions have been set up and phase 1-Sign has been specified:

Setting up User A’s permissions

User B has been set up in the Transit Terminal, for which permissions have been set up and phase 2-Agreement has been specified:

Setting up User B’s permissions

In the account settings, Hierarchical is selected as the type of signature model. This means that the order of the signing/approval phases can be any order. Thus, User B can be the first to approve the document (second phase) and then User A can sign the document (first phase). For more information on the existing signature model types in the Transit Terminal, see Signature model types.

Account settings

In order for User B to approve ED503 documents, the user need to tick the required phase in the column Phases(the user can pre-filter the table part for convenience), and click on the button Agreement.

Approval of documents by User B

The documents will go to status Under control.

In order for User A to sign ED503 documents, it is necessary to tick the required phase in the column Phases (for convenience, the table part can be filtered), and click on the button Sign and send.

Signing documents by User A

Once all signature/approval phases have been completed, ED503 documents will be sent to the SPFS MPC for onward shipment to the final recipient.

Signature model types

The Transit Terminal provides the ability to configure the order in which electronic signatures are applied to documents before they are sent to the SPFS MPC. The type of signature model is specified in the account settings.

Two types of signature models are available:

Sequential signature model

Let’s look at an example where Sequential have been set as a signature model type in the account settings.

Account settings - sequential signing

Suppose the account signature model setting specifies two approval phases:

Setting up a account model

The permission settings for the user being searched are set to Agreement in Phase 2 (the last phase), i.e. this user is performing Phase 2 approval. Note that the user must have View permissions in order for the documents for the account being searched to be displayed in the tabular portion for that user.

Setting up user permissions

The checkboxes for none of the phases are active in the SPFS section of the tabular part in the Phases column. The first phase is inactive because the current user has no authority to negotiate this phase. The second phase is inactive because the first phase has not yet been approved, and consecutive approval (signing) implies that the user can only approve (sign) the document when the document has been approved (signed) in all previous phases.

Signing phases - consecutive signing

Once the first phase has been approved by other user, the checkbox for the second phase will become active for the user. In this way, the user can approve on the second phase for all documents by activating the checkboxes for the desired phase and clicking on the button Agreement and send.

The Transit Terminal provides the option to enable all phase checkboxes for filtered table entries at once. To do this, the checkbox for the phase to be signed must be enabled on the top row of the table.

Setting up an account model - consecutive signing

Hierarchical signature model

Now let’s look at an example where the signature model type is selected as Hierarchical.

In the account settings, the hierarchical signature model type is specified accordingly:

Account settings - sequential signing

Let the account model settings and authority settings for this account be the same as for the sequential model example, i.e. two phases of approval in total and the current user has authority to approve the second phase.

In this case, in contrast to the sequential signature model, even though the first phase has not yet been approved, the user can agree on the second phase, because in the hierarchical signature model, the order of approval (signature) phases is not important:

Setting up the account model - hierarchical signing

Changing user password

Administrator can change the password of any user in the Users section, as well as change its own password if needed.

In order to change own or any user’s password, double-click the left mouse button on the line with the user you are looking for. In the modal window that will open, press the button Change password, enter a new password in the fields that will appear and press the button Save:

Changing user password

Copy user permissions

If you need to assign the same authority to a large number of users, the Transit Terminal provides a user authorisation copying function.

In order to copy a user’s permissions to other users, it is necessary to:

  1. click on the line with the user whose permissions are to be copied, the button Copy user permissions will appear;
Copy user permissions - the button in the tabular part
  1. press Copy user permissions;
  2. in the field User to copy, one should select the user from the drop-down list to whom the permissions are to be copied, and the tabular part with teh permissions of the original user will appear;
  3. if the tabular part contains permissions with Sign phase, select the certificate from the drop-down list in the Replacement column (it is possible to select the certificate of the original user);
  4. check the box for the permissions to be copied. When copying all permissions, a check mark must be placed on the table header to select all positions in the table at once. If necessary, one can pre-filter the table part, e.g. by document type, status or any other parameter;
  5. click on the button Copy.

The permissions checked will be copied to the specified user.

Copying user permissions

In the Copy user permissions window, it is possible to install one certificate at once to all positions for which the Sign phase type is set. To do this it is necessary to:

  1. in the tabular part check all records where replacement of the certificate is required (for convenience you can pre-filter records in the table by certificate and check all filtered records at once);
  2. click the button Select a certificate in the bottom right corner of the form;
  3. select the required value from the drop-down list in the Select Certificate window;
  4. click on the button Select.

The selected certificate will be installed for all checked entries.

Replacing certificates when copying permissions

Setting confirming role to user

Terminal Transit allows you to enter the role of Confirming Change. In this case, actions performed by the administrator to configure the Transit Terminal (create/delete/edit organizations, accounts, signature models, permissions, etc.) will require confirmation from the user assigned to this role. This role only regulates the confirmation of changes to Transit Terminal settings, and has nothing to do with the approval of business documents.

Only one non-administrator user can be assigned to the role of Confirming Change.

In order to assign the Confirming Role to a user, double click on the user you want to assign the role to in Settings in the Users section. A modal window will open where you should press the button Assign as approver of changes:

Assigning the user to confirm changes

The user will then have a Change Requests section in Settings where the user with the Confirming Rol can confirm or reject the action. To approve the action, tick the appropriate requests in the table and click on the button Approve, or click on the button Decline to reject the action.

Change requests

If you left-click on a request line in the tabular area, you can see detailed information about that request:

Decryption of change requests

To remove the authority of the Confirming Change, double left click on the user, and a modal window will open where the button Remove authority approver must be clicked:

Remove authority approver

A warning will then be displayed:

Warning on removal of confirmation authority

This warning informs you that in order to complete the operation (removal of the Confirming authority), the user who is being removed as Confirmer must approve this action in the Change Requests section.

If one want to reassign the Confirming role to another user, you must open the settings of the user as the new Confirmer in the Users section (by double-clicking on the user) in Settings. Press the button Appoint to confirm changes in the modal window. In this case a warning will be displayed (see Figure “Warning when confirmatory authority is withdrawn”). The current Confirming user must therefore approve this action in Change Requests, namely the appointment of a new Confirming user.

Please note Losing the password of a user with the Confirming Role will result in a complete reinstallation of the Transit Terminal and re-configuration. Resetting the password and transferring this role to another user without knowing the password of the current Confirming user is not possible.

Change requests

This section is available to users with administrative rights and to a user assigned the confirming role (see Setting confirming role to user for details).

Administrators (not given the confirming role) can only reject requests; confirmation of requests is not available to them. Confirmation of requests is only available to the user with the confirming role.

Section Change requests

Automatic import of documents

Terminal Transit provides the option to set up auto-import of documents from a specified directory at a specified interval.

In order to set up auto-import, it is necessary to enable the option Automatic import in the Other section:

  • tick the checkboxes to indicate the document types which should be automatically imported into the Transit Terminal;
  • for each document type you may indicate a mask (symbols in the name of imported files which will identify the document type); the mask is not obligatory for SPFS documents.
    Specifying a mask for documents during auto-import

Note: in the first stage, the files to be imported are searched by mask. In the second stage, all other files that were not defined by a mask will be processed; the document type is recognized according to the file contents.

  • select one of the two values in the field Method of marking imported documents:

    • Symbol - this method will add an underscore character _ to the beginning of the file name that was imported.
    • Move - this method also specifies the path to the folder to move in the field Directory for imported documents. In this way, the files that have been imported to the Transit Terminal will be moved to the specified folder. The folder must be located on the Transit Terminal server.
  • The field Folder scanning period sets the frequency of the folder check and if there are new (unimported) files in the folders, these files will be imported into the Transit Terminal. Frequency is set as HH:MM:SS (hours, minutes, seconds). For example, if it is necessary to check the folder with imported files every 10 minutes, you should specify in the field 00:10:00.

  • click on Add folder, and specify path to auto-import folder on the Transit Terminal server; this is the folder where the files to be imported to the Transit Terminal are located. Please note: you can add more than one folder, if necessary (to add a new folder, each time press Add folder). Use the button Delete to delete the unnecessary folder path.

    Auto import settings

    If no auto-import folder has been added, the user will see an error message when trying to save the settings:

    Error when saving auto-import settings

PLEASE NOTE:

  1. do not specify the root directory of the drive as directories (directories for imported documents or directories with files to be imported).
  2. The relocation folder must not be the same as the auto-import folder, nor must it be a subfolder of the auto-import folder. For example, if you specified C:\autoimport as the automatic import folder, you must not specify the same folder as the relocation folder, or, for example, C:\autoimport\done. Specify a separate folder to relocate, e.g. C:\importDone, which will not be a sub-folder of the automatic import folder.

Please note: in case of SPFS documents, automatic import is only possible for SWIFT messages (ED503).

Deleting documents (pre-archiving)

It is possible to delete old documents from the Transit Terminal and archive them beforehand.

This option is semi-automatic.

If you need to delete old documents from Transit terminal, you should go to Other section (admin panel). In the Deleting documents (with pre-archiving) block, please specify directory on Transit Terminal server where archive with documents to be deleted will be saved (field Archive saving path), and also specify date until which documents will be deleted and archived (inclusive).

Deleting documents in Transit Terminal with pre-archiving

Thus, each time you need to delete (archive) old documents you should perform the above described operation in section Other in the administrative panel.