# Vytvoriť klienta

Vytvorí nového klienta pre aktuálnu firmu. V requeste posielate business dáta klienta a voliteľné klientské predvolené hodnoty, ktoré sa ukladajú pri klientovi a pri tvorbe nových dokladov sa používajú ako fallback defaulty, ak explicitnú hodnotu nepošlete v payloade. Ak pošlete Idempotency-Key, rovnaký key s rovnakým payloadom vráti pôvodnú odpoveď bez druhého vytvorenia klienta.

Endpoint: POST /clients
Version: 1.0.0
Security: bearerAuth

## Header parameters:

  - `Idempotency-Key` (string)
    Voliteľný identifikátor requestu pre bezpečné retry. Použite unikátnu hodnotu pre každé create volanie, ktoré chcete vedieť bezpečne zopakovať.
    Example: "invoice-create-2026-03-03-001"

## Request fields (application/json):

  - `name` (string)
    Meno osoby alebo obchodné meno klienta.
    Example: "Acme s.r.o."

  - `type` (string)
    Voliteľný typ klienta. Povolené hodnoty sú person a company. Ak ho nepošlete, použije sa person, prípadne company, ak pošlete subjectId, taxId alebo vatId.
    Enum: "person", "company"

  - `subjectId` (string,null)
    IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu viete typicky dohľadať aj cez [referenčný register subjektov](#operation/searchSubjects).
    Example: "12345678"

  - `taxId` (string,null)
    DIČ klienta.
    Example: "2020123456"

  - `vatId` (string,null)
    IČ DPH klienta.
    Example: "SK2020123456"

  - `isVatPayer` (boolean)
    Voliteľná informácia, či je klient platca DPH. Ak ju nepošlete a vyplníte vatId, nastaví sa automaticky na true.
    Example: true

  - `email` (string,null)
    Kontaktný e-mail klienta.
    Example: "billing@acme.test"

  - `street` (string,null)
    Ulica a číslo fakturačnej adresy.
    Example: "Hlavná 1"

  - `city` (string,null)
    Mesto fakturačnej adresy.
    Example: "Bratislava"

  - `zip` (string,null)
    PSČ fakturačnej adresy.
    Example: "81101"

  - `countryId` (integer,null)
    ID fakturačnej krajiny z [referenčnej tabuľky krajín](./reference-tables.md#krajiny).
    Example: 703

  - `deliveryStreet` (string,null)
    Ulica a číslo dodacej adresy. Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.
    Example: "Skladová 9"

  - `deliveryCity` (string,null)
    Mesto dodacej adresy. Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.
    Example: "Košice"

  - `deliveryZip` (string,null)
    PSČ dodacej adresy. Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.
    Example: "04001"

  - `deliveryCountryId` (integer,null)
    ID krajiny dodacej adresy z [referenčnej tabuľky krajín](./reference-tables.md#krajiny). Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.
    Example: 703

  - `preferredDeliveryMethodId` (integer,null)
    Predvolená hodnota spôsobu dodania pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky spôsobov dodania](./reference-tables.md#sposoby-dodania).
    Example: 1

  - `preferredPaymentMethodId` (integer,null)
    Predvolená hodnota spôsobu úhrady pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky spôsobov úhrady](./reference-tables.md#sposoby-uhrady).
    Example: 1

  - `preferredCurrencyId` (integer,null)
    Predvolená hodnota meny pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky mien](./reference-tables.md#meny).
    Example: 1

  - `preferredLanguageId` (integer,null)
    Predvolená hodnota jazyka pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky jazykov](./reference-tables.md#jazyky).
    Example: 1

  - `preferredDueDays` (integer,null)
    Predvolený počet dní splatnosti. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.
    Example: 14

  - `preferredNote` (string,null)
    Predvolená poznámka. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.
    Example: "Splatnosť 14 dní."

  - `stripeCustomerId` (string,null)
    Externé ID zákazníka v Stripe, ak si ho pri klientovi evidujete.
    Example: "cus_public_api_123"

  - `systemeioContactId` (integer,null)
    Externé ID kontaktu v Systeme.io, ak si ho pri klientovi evidujete.
    Example: 123456

  - `preferredVariableSymbol` (integer,null)
    Predvolený variabilný symbol. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.
    Example: 2026001

  - `preferredConstantSymbol` (integer,null)
    Predvolený konštantný symbol. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.
    Example: 308

  - `preferredSpecificSymbol` (integer,null)
    Predvolený špecifický symbol. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.
    Example: 55

  - `preferredTextAboveItems` (string,null)
    Predvolený text nad položkami. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.
    Example: "Dakujeme za spoluprácu."

## Response 201 fields (application/json):

  - `id` (integer)
    Interné ID klienta vo Fintoro.
    Example: 101

  - `name` (string)
    Meno osoby alebo obchodné meno klienta.
    Example: "Acme s.r.o."

  - `type` (string)
    Typ klienta. Hodnota person reprezentuje fyzickú osobu, hodnota company firmu alebo živnostníka evidovaného ako podnikateľský subjekt.
    Enum: "person", "company"

  - `subjectId` (string,null)
    IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu viete typicky dohľadať aj cez [referenčný register subjektov](#operation/searchSubjects).
    Example: "12345678"

  - `taxId` (string,null)
    DIČ klienta, ak je dostupné.
    Example: "2020123456"

  - `vatId` (string,null)
    IČ DPH klienta, ak je dostupné.
    Example: "SK2020123456"

  - `isVatPayer` (boolean)
    Informácia, či je klient aktuálne evidovaný ako platca DPH.
    Example: true

  - `email` (string,null)
    Kontaktný e-mail klienta.
    Example: "billing@acme.test"

  - `street` (string,null)
    Ulica a číslo fakturačnej adresy.
    Example: "Hlavná 1"

  - `city` (string,null)
    Mesto fakturačnej adresy.
    Example: "Bratislava"

  - `zip` (string,null)
    PSČ fakturačnej adresy.
    Example: "81101"

  - `country` (any)
    Fakturačná krajina klienta ako vnorený objekt.

  - `hasDeliveryAddress` (boolean)
    Informácia, či má klient uloženú samostatnú dodaciu adresu odlišnú od fakturačnej adresy.
    Example: true

  - `deliveryStreet` (string,null)
    Ulica a číslo dodacej adresy.
    Example: "Skladová 9"

  - `deliveryCity` (string,null)
    Mesto dodacej adresy.
    Example: "Košice"

  - `deliveryZip` (string,null)
    PSČ dodacej adresy.
    Example: "04001"

  - `deliveryCountry` (any)
    Dodacia krajina klienta ako vnorený objekt.

  - `createdAt` (string,null)
    Dátum a čas vytvorenia klienta.
    Example: "2026-03-03T12:00:00+01:00"

  - `updatedAt` (string,null)
    Dátum a čas poslednej úpravy klienta.
    Example: "2026-03-03T15:45:00+01:00"

  - `preferredDeliveryMethodId` (integer,null)
    Predvolená hodnota spôsobu dodania pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky spôsobov dodania](./reference-tables.md#sposoby-dodania).
    Example: 1

  - `preferredPaymentMethodId` (integer,null)
    Predvolená hodnota spôsobu úhrady pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky spôsobov úhrady](./reference-tables.md#sposoby-uhrady).
    Example: 1

  - `preferredCurrencyId` (integer,null)
    Predvolená hodnota meny pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky mien](./reference-tables.md#meny).
    Example: 1

  - `preferredLanguageId` (integer,null)
    Predvolená hodnota jazyka pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky jazykov](./reference-tables.md#jazyky).
    Example: 1

  - `preferredDueDays` (integer,null)
    Predvolený počet dní splatnosti. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: 14

  - `preferredNote` (string,null)
    Predvolená poznámka. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: "Splatnosť 14 dní."

  - `preferredVariableSymbol` (integer,null)
    Predvolený variabilný symbol. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: 2026001

  - `preferredConstantSymbol` (integer,null)
    Predvolený konštantný symbol. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: 308

  - `preferredSpecificSymbol` (integer,null)
    Predvolený špecifický symbol. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: 55

  - `preferredTextAboveItems` (string,null)
    Predvolený text nad položkami. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: "Dakujeme za spoluprácu."

## Response 422 fields (application/json):

  - `error` (string)
    Example: "Idempotency-Key reused with different request payload"

## Response 500 fields (application/json):

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

## Response 503 fields (application/json):

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