# Vytvoriť bankový účet

Vytvorí nový bankový účet aktuálnej firmy. V requeste posielate len business dáta účtu. Response vráti výsledný uložený objekt vrátane informácie, či je účet aktuálne vedený ako primárny a či je napojený na open banking.

Endpoint: POST /bank-accounts
Version: 1.0.0
Security: bearerAuth

## Request fields (application/json):

  - `bankId` (integer,null)
    Voliteľné ID banky z [lookup endpointu bánk](#operation/listBanks). Použite ho, ak chcete účet naviazať na konkrétnu banku z verejného lookupu.
    Example: 1

  - `name` (string)
    Názov bankového účtu, pod ktorým ho budete identifikovať vo Fintoro.
    Example: "Hlavný účet"

  - `iban` (string)
    IBAN bankového účtu. Musí byť validný a unikátny v rámci aktuálnej firmy.
    Example: "SK3111000000001234567890"

  - `swift` (string)
    SWIFT alebo BIC kód bankového účtu.
    Example: "TATRSKBX"

  - `autoPairingStrategy` (string)
    Stratégia automatického párovania platieb pre tento účet. Ak pole nepošlete, použije sa predvolená hodnota by_variable_symbol.
    Enum: "none", "by_variable_symbol", "by_price", "by_variable_symbol_and_price", "by_all_symbols", "by_all_symbols_and_price"

  - `isPrimary` (boolean)
    Označuje, či má byť účet vedený ako primárny účet firmy. Aktuálna implementácia novovytvorený účet nastaví ako primárny účet firmy aj pri vynechaní tohto poľa alebo pri odoslaní false, preto toto pole zatiaľ nefunguje ako tvrdý prepínač.
    Example: true

## Response 201 fields (application/json):

  - `id` (integer)
    Interné ID bankového účtu vo Fintoro.
    Example: 201

  - `bankId` (integer,null)
    ID banky z [lookup endpointu bánk](#operation/listBanks). Ak je null, účet nie je naviazaný na konkrétnu banku z lookupu.
    Example: 1

  - `bank` (any)
    Vnorený objekt banky zodpovedajúci bankId, ak je banka známa a stále dostupná v lookup datasete.

  - `isPrimary` (boolean)
    Označuje, či je tento účet aktuálne vedený ako primárny bankový účet firmy.
    Example: true

  - `autoPaymentMatching` (boolean)
    Označuje, či je účet aktuálne napojený na automatické párovanie platieb cez open banking. Hodnota je odvodená od existencie open banking napojenia, neposiela sa v requeste.
    Example: true

  - `name` (string)
    Používateľský názov bankového účtu zobrazený vo Fintoro.
    Example: "Hlavný účet"

  - `iban` (string)
    IBAN bankového účtu.
    Example: "SK3111000000001234567890"

  - `swift` (string)
    SWIFT alebo BIC kód bankového účtu.
    Example: "TATRSKBX"

  - `autoPairingStrategy` (string)
    Stratégia automatického párovania platieb pre tento účet.
    Enum: "none", "by_variable_symbol", "by_price", "by_variable_symbol_and_price", "by_all_symbols", "by_all_symbols_and_price"

  - `balance` (number,null)
    Posledný známy zostatok účtu, ak je dostupný z open banking napojenia.
    Example: 1234.56

  - `lastSyncedAt` (string,null)
    Dátum a čas poslednej úspešnej synchronizácie účtu cez open banking, ak je dostupný.
    Example: "2026-03-01 10:15:16"

  - `openBankingValidUntil` (string,null)
    Dátum, do ktorého je platný aktuálny open banking súhlas, ak existuje.
    Example: "2026-04-30"

  - `createdAt` (string,null)
    Dátum a čas vytvorenia bankového účtu.
    Example: "2026-03-03 12:00:00"

  - `updatedAt` (string,null)
    Dátum a čas poslednej zmeny bankového účtu.
    Example: "2026-03-03 15:45:00"

## Response 500 fields (application/json):

  - `message` (string)
    Example: "Server Error"

## Response 503 fields (application/json):

  - `message` (string)
    Example: "Service Unavailable"