Skip to main content
POST
Vytvoriť obchodný prípad

Autorizace

Authorization
string
header
povinné

Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

Hlavičky

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ť.

Příklad:

"invoice-create-2026-03-03-001"

Tělo

application/json

Payload pre vytvorenie obchodného prípadu. Musíte poslať presne jedno z polí clientId alebo supplierId.

name
string
povinné

Názov obchodného prípadu.

Maximum string length: 255
Příklad:

"Client pipeline"

clientId
integer | null

ID klienta. Pole je vzájomne exkluzívne so supplierId.

Příklad:

101

supplierId
integer | null

ID dodávateľa. Pole je vzájomne exkluzívne s clientId.

Příklad:

151

statusId
integer | null

ID stavu obchodného prípadu. Pole môže byť aj null.

Příklad:

41

description
string | null

Voliteľný popis obchodného prípadu.

Příklad:

"Opportunity description"

Odpověď

Obchodný prípad bol vytvorený.

Obchodný prípad vrátane vnoreného klienta alebo dodávateľa a voliteľného stavu.

id
integer

Interné ID obchodného prípadu vo Fintoro.

Příklad:

501

contactType
enum<string>

Typ naviazaného kontaktu. Hodnota client znamená klienta, hodnota supplier dodávateľa.

Dostupné možnosti:
client,
supplier
Příklad:

"client"

contactId
integer

Interné ID naviazaného kontaktu zodpovedajúce contactType.

Příklad:

101

client
object | null

Vnorený objekt klienta, ak je obchodný prípad naviazaný na klienta.

supplier
object | null

Vnorený objekt dodávateľa, ak je obchodný prípad naviazaný na dodávateľa.

name
string

Názov obchodného prípadu.

Příklad:

"Client pipeline"

description
string | null

Voliteľný popis obchodného prípadu.

Příklad:

"Opportunity description"

status
object | null

Aktuálny stav obchodného prípadu ako vnorený objekt. Môže byť null, ak prípad nie je zaradený do žiadneho statusu.

boardPosition
integer

Interná pozícia obchodného prípadu v rámci jeho aktuálneho statusu alebo bezstatusového stĺpca.

Příklad:

2

createdAt
string<date-time> | null

Dátum a čas vytvorenia obchodného prípadu.

Příklad:

"2026-03-10T10:00:00+01:00"

updatedAt
string<date-time> | null

Dátum a čas poslednej úpravy obchodného prípadu.

Příklad:

"2026-03-10T10:30:00+01:00"