Přejít na hlavní obsah
POST
/
business-cases
Vytvoriť obchodný prípad
curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/business-cases \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Client pipeline",
  "clientId": 101,
  "supplierId": 151,
  "statusId": 41,
  "description": "Opportunity description"
}
'
{
  "id": 501,
  "contactType": "client",
  "contactId": 101,
  "client": {
    "id": 101,
    "name": "Acme s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": true,
    "email": "billing@acme.test",
    "street": "Hlavná 1",
    "city": "Bratislava",
    "zip": "81101",
    "country": {
      "id": 703,
      "name": "Slovensko",
      "code": "SK",
      "eu": true
    },
    "hasDeliveryAddress": true,
    "deliveryStreet": "Skladová 9",
    "deliveryCity": "Košice",
    "deliveryZip": "04001",
    "deliveryCountry": {
      "id": 703,
      "name": "Slovensko",
      "code": "SK",
      "eu": true
    },
    "createdAt": "2026-03-03T12:00:00+01:00",
    "updatedAt": "2026-03-03T15:45:00+01:00",
    "preferredDeliveryMethodId": 1,
    "preferredPaymentMethodId": 1,
    "preferredCurrencyId": 1,
    "preferredLanguageId": 1,
    "preferredDueDays": 14,
    "preferredNote": "Splatnosť 14 dní.",
    "preferredVariableSymbol": 2026001,
    "preferredConstantSymbol": 308,
    "preferredSpecificSymbol": 55,
    "preferredTextAboveItems": "Dakujeme za spoluprácu."
  },
  "supplier": {
    "id": 151,
    "type": "company",
    "name": "Supplier s.r.o.",
    "subjectId": "12345678",
    "taxId": "2020202020",
    "vatId": "SK2020202020",
    "isVatPayer": true,
    "email": "billing@supplier.test",
    "street": "Supplier Street 1",
    "city": "Bratislava",
    "zip": "81101",
    "country": {
      "id": 703,
      "name": "Slovensko",
      "code": "SK",
      "eu": true
    }
  },
  "name": "Client pipeline",
  "description": "Opportunity description",
  "status": {
    "id": 41,
    "name": "Negotiation",
    "color": "#22aa44"
  },
  "boardPosition": 2,
  "createdAt": "2026-03-10T10:00:00+01:00",
  "updatedAt": "2026-03-10T10:30:00+01:00"
}

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

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

​
supplier
object

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

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"