NBS web service integration

Service setup

Before this extension can be activated, the following preconditions must be met:

• The company must be registered in the National Bank of Serbia web system.

• A digital certificate must be installed.

You can access the NBS web services connection through Service Connections in Business Central.

In the search bar, type Service Connections, open the page, and then select NBS Setup to configure the service.

On the General tab on the NBS Setup page, it is mandatory to enter the following information:

NBS Username – provided by NBS

NBS Password – provided by NBS

NBS License ID – provided by NBS

After entering the NBS Username, NBS Password, and NBS License ID, run the Set URLs to Default action on the NBS Setup page.

This action enables the system to automatically retrieve all necessary URLs required for further work with the NBS web service

On the NBS Setup page, the options Block Customer if Bank is Blocked and/or Block Vendor if Bank is Blocked allow a customer or vendor who has been blocked by the National Bank of Serbia to be automatically blocked in Business Central as well. This way, you have timely information about any initiated forced collection (account blockage) and additional control over further business operations.

Note: Blocking functions can be customized if you want to continue working with a blocked customer or vendor. This is configured directly on the customer/vendor card, under the General section. The Blocked option on the customer and vendor card contains a dropdown menu where you can select what to block (shipment, invoice, all).

Enable the NBS service

To enable the service with the National Bank of Serbia, after retrieving the URLs and entering the username, password, and license ID, you need to check the Enabled option – on the NBS Setup page. After that, you can proceed with the next steps to retrieve data from the National Bank of Serbia.

How to apply the NBS functionality

The next step is to execute the actions covered by the NBS functionalities.

On the NBS Setup page, under the Actions section, by selecting the Import data from NBS action, you will get a list of available data retrieval actions, which includes:

• Local banks

• Currencies

• Activitis

• Territory regions

• Countries

• Partner data

• Customer/Vendro bank account.

• Customer/vendor data migration

Action Local banks

The Local Banks action imports all information about state-registered banks – name, address, contact details, and website – providing a complete database of all local banks.

The local banks directory is necessary for creating local bank currencies, as well as when setting up exchange rates from a local bank.

Regular updating of the local banks directory and the current accounts of customers and vendors is a prerequisite for the proper functioning of features such as payment transactions, vendor payment proposals, and statement imports.

After retrieving the Local Banks data, if you enter Local Banks in the Business Central search, you will get a list of the imported local banks. The local banks list can also be updated and re-imported from the Local Banks page by running the NBS – Get Bank list action and the Update Current bank action.

Action Currencies

The Currencies action enables the import of all currencies into Business Central. When you retrieve currencies from the NBS Setup page and obtain the complete list, you can also access the same list through the Business Central search by entering Currencies.

Currencies can also be retrieved directly from the Currencies page by selecting Home → Import All Currencies. Use this option if you have not previously imported the list from the NBS Setup page.

Importing currencies significantly reduces the risk of system errors. One of the key requirements for proper functionality is that currency codes must be entered in the exact same format as on the website of the National Bank of Serbia.

For example, the correct code for the euro is EUR. If EURO is entered manually in the code field, the system will not be able to retrieve the corresponding exchange rate, as such a designation does not exist on the NBS website.

Action NBS – Import Exchange Rate from NBS

The NBS – Import Exchange Rate from NBS action, located on the Currencies page, enables the system to pull all exchange rates from the NBS website for the currencies available in your list.

After running the NBS – Import Exchange Rate from NBS action, a new window appears where the user selects whether to import exchange rate lists:

• For today

• For a specific date or period

In the Date Filter field, enter the desired dates for processing. After confirming by clicking OK, the currency exchange rates will be imported and updated in Business Central.

Creating a Currency for Importing NBS Effective or Currency

If you have a vendor who requires transactions to be calculated based on the effective rate of a specific local bank, i.e., the bank where they hold a current account, it is necessary to create the exchange rate for that local bank.

To run the function and set the parameters, open the Currencies page in Business Central (accessible via the Business Central search). Then, on the Currencies page, click the New action to create a new currency card.

The data to be filled in on the Currency card, under the General tab, are:

• Code: depends on the currency (e.g., EUR, USD); it is recommended that the name includes the currency and the bank initials.

• Description: a short description of the currency.

• ISO Code: the code defined according to international standards (EUR, USD, etc.).

• ISO Numeric Code: defined in the country and territory directory according to international standards.

• Original Currency Code: e.g., EUR, USD.

• Account: enter the account for positive and negative exchange rate differences.

• Rate Type: from the dropdown menu, select whether you want values based on the selling or buying rate.

• Bank Code for Currency Rate: the first three digits represent the fixed bank identification number, which the system uses to determine which bank the processing is performed with.

• Exchange Rate List Type: select Effective only.

Note: Exchange Rate List Type – the selling and buying rates of commercial banks apply only to effective rates and cannot be used for currency. For NBS rates, it is possible to configure the system to retrieve both buying and selling rates for foreign exchange and effective rates, according to your needs.

Job queue entry

It also provides NBS exchange rates import - through daily job, or action when needed. Daily jobs settings are placed within Job queue entry, where parameters can be edited if necessary.

Activities

Provides info of designated industry groups.

Territory regions

Updates information about state regions:

Countries

It downloads countries database.

Partner data

This action can be called through customers/vendors cards:

It updates partner's data information - name, address, region, registration date, activity ...It is necessary to have Registration no. recorded on Customer/Vendor card in order for this action to work. It can also help to create new contact - by adding only registration no., the rest of data will be inserted.

It also serves to link industry activity to contacts and can be used further for marketing segmentation for different industry activities. New contact can be also created from the Contact list:

New window will open, to type either Registration no, or VAT registration no.

With confirmation, company data will show, and with confirmation, new contact is created.

Customer/Vendor bank accounts

It is enabled to insert and update partner's bank accounts. This action can be initiated for all customers and vendors, or for particular ones, through customer/vendor cards. It works only if VAT registration number is familiar.

Daily jobs for currencies and bank list update

It is possible to set up daily jobs, actions that will occur on daily basis, on the exact time, to update the last published exchange currency list and bank list.

Import data from NBS

Importing a list of contacts could be done by invoking these two actions:

1. Download Excel template
2. Customer/Vendor from Excel

1.Download Excel template - Excel contains all important data for creating a contact card (customer and vendor)

The following fields should be filled in:

• VAT Registration No.
• Registration No.
• Customer Templates
• Vendor Templates
• Old customer No - if you transfer data from the previous software
• Old customer name if you transfer data from the previous software
• Old vendor No - if you transfer data from previous software
• Old vendor name - if you transfer data from the previous software

Mandatory fields that need to be filled in are VAT Registration No. or Registration No., Customer Templates and Vendor Templates. If there isn't such data, contact, customer and vendor won't be created . Other fields from the table should be filled in if you need that data.

2.Customer/Vendor from Excel - Invoking this action the data will be imported from Excel

On the request page button choose will allow us to select the excel document that we want to import. If any vat registration number is not correct, you will receive error message.