Přejít na hlavní obsah
PUT
Upraviť cenovú ponuku

Autorizace

Authorization
string
header
povinné

API token firmy vytvorený vo Fintoro v Automatizácie → Fintoro API. Správa tokenov.

Parametry cesty

quotation
integer
povinné

ID cenovej ponuky.

Příklad:

601

Tělo

application/json

Úplné údaje cenovej ponuky. Vynechané hodnoty sa vyhodnotia ako pri vytvorení.

clientId
integer | null
povinné

ID existujúceho klienta firmy. Súčasne zadaný objekt client mení iba údaje klienta na tomto doklade.

Příklad:

101

items
object[]
povinné

Položky dokladu.

Required array length: 1 - 100 elements

S priceListItemId sa názov, jednotka, cena a DPH doplnia z cenníka; zaslané hodnoty ich prepíšu. Bez ID pošlite ručnú položku s názvom, množstvom, cenou a DPH. uuid sa ignoruje a warehouseAllocations sa nepodporujú.

number
string | null

Manuálne číslo cenovej ponuky. Bez hodnoty sa vygeneruje z číselného radu. Nemožno kombinovať s numericalSeriesId.

Required string length: 1 - 20
Příklad:

"20260001"

client
object | null

Údaje na vyhľadanie alebo vytvorenie klienta; s clientId menia iba údaje na doklade.

businessCaseId
integer | null

Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť klientovi určenému cez finálny clientId.

Příklad:

701

numericalSeriesId
integer | null

ID číselného radu. Ak ho nepošlete a nepošlete ani number, použije sa primárny číselný rad pre cenové ponuky. Ak pošlete numericalSeriesId, nepošlite zároveň manuálne number.

Příklad:

12

issueDate
string<date>

Dátum vystavenia vo formáte Y-m-d. Musí byť po 2009-01-01 a pred dátumom o jeden rok v budúcnosti. Ak ho nepošlete, použije sa dnešný dátum.

Příklad:

"2026-03-03"

validityDate
string<date> | null

Dátum platnosti vo formáte Y-m-d. Musí byť rovný alebo neskorší než finálny issueDate. Ak ho nepošlete, použije sa issueDate + 30 dní.

Příklad:

"2026-04-02"

discountType
enum<string> | null

Typ zľavy na úrovni celého dokladu.

Dostupné možnosti:
percentage,
fixed
Příklad:

"percentage"

discountValue
number<float> | null

Hodnota zľavy na úrovni celého dokladu.

Požadovaný rozsah: x >= 0
Příklad:

10

transferTaxLiability
boolean

Príznak prenesenej daňovej povinnosti. Ak ho nepošlete, použije sa false.

Příklad:

false

currencyId
integer

ID meny z referenčnej tabuľky mien. Priorita je požiadavka → klientská predvolená hodnota → nastavenia dokladov firmy.

Příklad:

1

languageId
integer

ID jazyka z referenčnej tabuľky jazykov. Priorita je požiadavka → klientská predvolená hodnota → nastavenia dokladov firmy.

Příklad:

1

note
string | null

Poznámka na doklade. Priorita je požiadavka → klientská predvolená hodnota → nastavenia dokladov firmy.

Maximum string length: 3000
Příklad:

"Cenová ponuka platí 30 dní."

textAboveItems
string | null

Text nad položkami. Priorita je požiadavka → klientská predvolená hodnota → nastavenia dokladov firmy.

Maximum string length: 3000
Příklad:

"Dakujeme za Váš záujem."

Odpověď

Cenová ponuka bola aktualizovaná.

Cenová ponuka.

id
integer
Příklad:

601

uuid
string
Příklad:

"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"

type
string
Příklad:

"quotation"

number
string
Příklad:

"20260001"

webDokladUrl
string<uri>

Absolútna URL na verejný web doklad tejto cenovej ponuky.

Příklad:

"https://app.fintoro.sk/web-doklad/cp/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1"

pdfDownloadUrl
string<uri>

Absolútna URL na Fintoro API endpoint, ktorý stiahne PDF tejto cenovej ponuky ako prílohu.

Příklad:

"https://app.fintoro.sk/api/public/v1/quotations/601/pdf"

company
object

Údaje dodávateľa uložené priamo na tomto doklade.

clientId
integer | null

ID klienta. Po jeho zmazaní je null; údaje klienta uložené na doklade zostanú zachované.

Příklad:

101

client
object

Údaje klienta uložené na doklade. Jeho ID je samostatne v clientId.

issueDate
string<date>
Příklad:

"2026-03-03"

validityDate
string<date> | null
Příklad:

"2026-04-02"

businessCaseId
integer | null

Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť zvolenému klientovi na doklade.

Příklad:

701

discountType
enum<string> | null
Dostupné možnosti:
percentage,
fixed
Příklad:

"percentage"

discountValue
number<float> | null
Příklad:

10

transferTaxLiability
boolean
Příklad:

false

numericalSeriesId
integer | null
Příklad:

12

currencyId
integer
Příklad:

1

languageId
integer
Příklad:

1

note
string | null
Příklad:

"Cenová ponuka platí 30 dní."

textAboveItems
string | null
Příklad:

"Dakujeme za Váš záujem."

itemsTotal
number<float>
Příklad:

200

itemsTotalWithVat
number<float>
Příklad:

240

total
number<float>
Příklad:

200

totalWithVat
number<float>
Příklad:

240

status
enum<string>
Dostupné možnosti:
waiting,
accepted,
rejected
Příklad:

"waiting"

hasVat
boolean
Příklad:

true

items
object[]