API connector settings
Update 30.05.2025
CSOB API connector
Launch of the ČSOB Business Connector service
The steps to get the service up and running are as follows:
- Enabling the CSOB Business Connector service for the CEB service contract,
- obtaining a certificate from a certification authority or directly from the bank,
- registering the certificate for use in the CSOB Business Connector service in the portal,
- configuring the CSOB Business Connector service in the portal,
- setting up the client application in Business Central
Enabling the CSOB Business Connector service for the CEB service contract
Disabling or enabling the CSOB Business Connector service can be done in the portal or at a bank branch
Obtaining a certificate
The ČSOB Business Connector service enables the use of certificates issued by certification authorities I. Certification Authority and PostSignum. Only so-called Server Commercial Certificates are suitable for use in the CSOB Business Connector service and must enable so-called Client Authentication.
The certificate can also be obtained directly from the bank, which can be done in basically 2 ways, either
- by Windows means (e.g. with the help of an IT person)
- Manually creating a certificate request on the client computer (e.g. using the Windows tool certmgr.msc),
- Submitting a certificate request and issuing the certificate (CEB -> Business Connector -> Request Certificate and then downloading the certificate by selecting Download)
- Installing the issued certificate on the client computer (e.g. using the Windows certmgr.msc tool)
- or using the CSOB Business Connector application (obtaining a communication certificate is described in the csob-business-connector-implementacni-prirurucka.pdf manual). This is
- installation of the CSOB Business Connector application on a computer (chapter 2)
- obtaining a communication certificate (chapter 3).
Tip
The CSOB Business Connector application will not be used for normal work. However, it is recommended to set up a certificate expiry notification (see the guide in the chapter Renewing the communication certificate).
Certificate registration
In the case of a certificate from a bank (see above), it is automatically registered.
Configuring the CSOB Business Connector service in the portal
In the portal, it is necessary to enable the required operations that the client will use using the CSOB Business Connector. In our case, these are Download statements for specific accounts and Send signed payment order files for specific accounts.
Setting up a client application in Business Central
To set up Business Central, you need to download a communication certificate in pfx format:
- Press Windows key + R and type certmgr.msc in the window that opens and press OK.
- In the certmgr tool, expand Personal on the left side and find the certificate line in the list. It will have the CEB Business Connector CA issuer and the subject name you selected.
- Press the right mouse button on the certificate and select All Tasks and Export... from the context menu.
- In the certificate export wizard, select Yes, export private key and then export to a PKCS #12 file with a .pfx extension. You will need the password you entered in the next step.
The next step is to set up access in Business Central:
- Choose the
icon, enter Clients of CSOB CEB and then choose the related link.
- Enter "CSOB" in the Code field on the new line.
- Enter e.g. "CSOB API" in the Description field.
- Leave the value "Production Environment" in the API field.
- In the Available for field, leave the value "Company" to set up common access for all authorized users of the module.
- In the Contract Number field, enter the value from the API access contract you signed with the bank.
- Run the Upload Certificate action and select the certificate file in pfx format.
- Enter a password for the certificate in the Certificate Password field.
Tip
If you want to determine access according to the user's login, each user must make the above-mentioned settings of the ČSOB CEB Client. In the Available for field, select the value "User".
Specific parameters for ČSOB API connector
The following parameters must be added to the Advanced Settings if you want to use the CSOB API connector to import bank statements:
- Choose the
icon, enter Bank Export/Import Settings and then choose the related link.
- Navigate to the selected Import type row.
- Run the Advanced Settings action.
- In the Bank Statement Provider field, select "CSOB CEN Connector".
- In the CSOB CEB Client Code field, select the client code defined in the previous section.
- In the CSOB CEB File Format field, select the GPC option representing the ABO format.
- In the Content Encoding field, add a value - see Setting the encoding for import
- In the Processing Procedure ID field, check that the value 52057431 (Bank Stmt.Imp.-ABO Acb) has been added.
The following parameters must be added to the Advanced Settings if you want to use the CSOB API connector to export payment orders:
- Choose the
icon, enter Bank Export/Import Settings and then choose the related link.
- Navigate to the selected Export type row.
- Run the Advanced Settings action.
- In the Bank Statement Provider field, select "CSOB CEN Connector".
- In the CSOB CEB Client Code field, select the client code defined in the previous section.
- In the CSOB CEB File Format field, select the KPC option representing the ABO format.
- In the Processing Procedure ID field, check that the value 52057438 (Paym.Order Export-ABO acb) has been added.
KB API connector
Launch of the API Business suite service
In order to use the API Business suite service from Komerční banka, you must have activated the selected internet banking application (Moje Banka Business, or Profibanka, or Mobilní banka Business). The basic steps to make the API interface operational are:
- The company activates the API Business Suite service in KB
- The company applies to Aricoma for an Authorization Key, which will be generated specifically for the company and thanks to which Aricoma will register the KB API connector with KB.
- The company sets up the module in Business Central
- The company gives consent to the BC application to download data from KB and selects the bank accounts to which BC will have access
Obtaining the Authorization Key Contact us by email at bc_sales@aricoma.com. All we need is your company name, and we will send you an Authorization Key in reply. This is for your company's use only and must not be used by anyone else. Setting up the module in BC The next step is to set up access in Business Central:
- Choose the
icon, enter KB API Clients and then choose the related link.
- On the KB API Clients page, enter "KB" in the Code field on the new line.
- For example, type "KB API" in the **Description **field.
- Leave the value "Production environment" in the API field.
- In the Authorization Key field, enter the value you received from Aricoma (see previous paragraph).
- In the Number of days of transaction history field, enter 10
Granting consent
- On the KB API Clients page, run the Authorize Client action.
- In the new window that automatically opens, the bank's dialogue will appear, where after logging in you will be asked to give consent to use the "Aricoma KB Connector" application.
- Immediately afterwards, another login prompt will appear, after which you will select the bank accounts to which "Aricoma KB connector" should have access.
See also
CZ Banking Extension Setup
CZ Banking Extension
Financial Pack