Přejít na hlavní obsah
PATCH
/
business-cases
/
{businessCase}
Upraviť obchodný prípad
curl --request PATCH \
  --url https://app.fintoro.sk/api/public/v1/business-cases/{businessCase} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "statusId": 41,
  "name": "Updated business case",
  "description": "Updated 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.

Parametry cesty

​
businessCase
integer
povinné

ID obchodného prípadu.

Příklad:

501

Tělo

application/json

Payload pre aktualizáciu obchodného prípadu. Pošlite iba polia, ktoré chcete meniť. Polia clientId a supplierId nie sú pri update povolené.

​
statusId
integer | null

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

Příklad:

41

​
name
string

Názov obchodného prípadu.

Maximum string length: 255
Příklad:

"Updated business case"

​
description
string | null

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

Příklad:

"Updated description"

Odpověď

Obchodný prípad bol aktualizovaný.

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"