Skip to main content

REST API - Bank Account and Company

How to connect a bank account to a company via REST API

Written by Petr Pech

Business partners' bank accounts are not directly in the address book — they are kept in their own record, adresar-bankovni-ucet, which links the account to the company.


Creating an account for a company

<winstrom version="1.0">
<adresar-bankovni-ucet>
<firma>code:FIRMA</firma>
<buc>123456789</buc>
<smerKod>code:0100</smerKod>
</adresar-bankovni-ucet>
</winstrom>

In addition to the account number and bank code, you can also specify other fields:

Field

Meaning

firma

Link to the record in the address book.

buc, smerKod

Account number and bank code (penezni-ustav record).

iban, bic

International account format.

primarni

Marks the company's main account.

varSym, specSym, konSym

Predefined payment symbols.

⚠️ The bank code must exist in the penezni-ustav record and be valid. For banks that have been discontinued, the validity is limited, and an account with such a code cannot be created — this is addressed in the article Cannot add a financial institution with code 8050.


Listing a company's accounts

GET /c/{firma}/adresar-bankovni-ucet/(firma='code:FIRMA').xml?detail=full

ℹ️ Don't confuse this with the bankovni-ucet record — that one contains the company's own accounts, on which bank documents are kept. adresar-bankovni-ucet are accounts belonging to business partners.


Related

Did this answer your question?