Skip to main content
PUT
Update quotation

Authorizations

Authorization
string
header
required

Bearer token created for a specific company in Integrations → API.

Path Parameters

quotation
integer
required

Quotation ID.

Example:

601

Body

application/json

Payload used to update a quotation. The update uses the same fields, validation rules, and defaults as the create flow. You must send either clientId or the client object. Omitted fields are not pulled from the current quotation; the backend resolves them exactly as in the create flow.

clientId
integer | null
required

Existing client ID. This is the recommended way to create a quotation. If you also send the client object, it is used as a sparse client snapshot override for this specific document.

Example:

101

items
object[]
required

Quotation items. This field is always required during update.

Required array length: 1 - 100 elements

Payload of a single quotation item. Three modes are supported: a manual item, priceListItemId + quantity, or priceListItemId with sparse overrides for selected fields. quantity is always required. If you do not send priceListItemId, you must send name, unitPrice, and vatRate. unitId is optional; when you omit it for a manual item, the backend defaults to unit 1 (piece / Unit::Piece). If you do send priceListItemId, the backend can hydrate the name, unit, price, and VAT rate from the price list item and the payload acts only as a sparse override. uuid is not part of the quotation request contract; if you send it, the backend ignores it. warehouseAllocations are not supported for quotations.

number
string | null

Manual quotation number. If omitted, the backend generates it from the numbering series. If you send number, do not send numericalSeriesId in the same payload.

Required string length: 1 - 20
Example:

"20260001"

client
object | null

Sparse client payload. If you send clientId, it acts as a snapshot override for this document. If you omit clientId, the backend uses these values to match or create a client.

businessCaseId
integer | null

Optional business case ID. When sent, it must be available in the token scope and to the client resolved as the final clientId.

Example:

701

numericalSeriesId
integer | null

Numbering series ID. If omitted together with number, the primary numbering series for quotations is used. If you send numericalSeriesId, do not send manual number in the same payload.

Example:

12

issueDate
string<date>

Issue date in Y-m-d format. It must be after 2009-01-01 and before the date one year in the future. If omitted, today is used.

Example:

"2026-03-03"

validityDate
string<date> | null

Validity date in Y-m-d format. It must be equal to or later than the final issueDate. If omitted, issueDate + 30 days is used.

Example:

"2026-04-02"

discountType
enum<string> | null

Document-level discount type.

Available options:
percentage,
fixed
Example:

"percentage"

discountValue
number<float> | null

Document-level discount value.

Required range: x >= 0
Example:

10

transferTaxLiability
boolean

Reverse-charge flag. If omitted, false is used.

Example:

false

currencyId
integer

Currency ID from the currency reference table. Resolution priority is payload -> client preference -> company document settings.

Example:

1

languageId
integer

Language ID from the language reference table. Resolution priority is payload -> client preference -> company document settings.

Example:

1

note
string | null

Document note. Resolution priority is payload -> client preference -> company document settings.

Maximum string length: 3000
Example:

"This quotation is valid for 30 days."

textAboveItems
string | null

Text displayed above items. Resolution priority is payload -> client preference -> company document settings.

Maximum string length: 3000
Example:

"Thank you for your interest."

Response

The quotation was updated.

Quotation.

id
integer
Example:

601

uuid
string
Example:

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

type
string
Example:

"quotation"

number
string
Example:

"20260001"

webDokladUrl
string<uri>

Absolute URL of the public web document for this quotation.

Example:

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

pdfDownloadUrl
string<uri>

Absolute URL of the Fintoro API endpoint that downloads this quotation PDF as an attachment.

Example:

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

company
object

Supplier snapshot stored directly on this document.

clientId
integer | null

Live ID of the client linked to the quotation. Returns null when the contact has been deleted; the document's client snapshot is preserved.

Example:

101

client
object

Historical client snapshot stored directly on this document.

issueDate
string<date>
Example:

"2026-03-03"

validityDate
string<date> | null
Example:

"2026-04-02"

businessCaseId
integer | null

Optional business case ID. When sent, it must belong to the client selected on the document.

Example:

701

discountType
enum<string> | null
Available options:
percentage,
fixed
Example:

"percentage"

discountValue
number<float> | null
Example:

10

transferTaxLiability
boolean
Example:

false

numericalSeriesId
integer | null
Example:

12

currencyId
integer

Currency ID from the currency reference table.

Example:

1

languageId
integer

Language ID from the language reference table.

Example:

1

note
string | null
Example:

"This quotation is valid for 30 days."

textAboveItems
string | null
Example:

"Thank you for your interest."

itemsTotal
number<float>
Example:

200

itemsTotalWithVat
number<float>
Example:

240

total
number<float>
Example:

200

totalWithVat
number<float>
Example:

240

status
enum<string>
Available options:
waiting,
accepted,
rejected
Example:

"waiting"

hasVat
boolean
Example:

true

items
object[]