Detail obchodného prípadu

GET

business-cases

{businessCase}

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/business-cases/{businessCase} \
  --header 'Authorization: Bearer <token>'

{
  "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

Odpověď

Detail obchodného prípadu.

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

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.

Show child attributes

supplier

object

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

Show child attributes

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.

Show child attributes

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"

Předchozí

Upraviť obchodný prípadČiastočne aktualizuje obchodný prípad. Môžete meniť `name`, `description` a `statusId`, pričom `statusId` môže byť aj `null`. Väzbu na klienta alebo dodávateľa tento endpoint nemení; polia `clientId` a `supplierId` sú pri update zakázané a vrátia validačnú chybu.

Další

Detail obchodného prípadu

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/business-cases/{businessCase} \
  --header 'Authorization: Bearer <token>'

{
  "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"
}