Skip to main content
PATCH
Partially update quote
Send only the fields you want to change; fields you do not send keep their current values. Rules and examples: partial update.
  • A field that is not sent stays unchanged, a field sent as null is cleared.
  • Validation runs on the whole merged record; setting a required field to null is rejected.
  • Lists are not merged: when Lines is sent it replaces all lines of the quote, when it is not sent the lines stay as they are.
  • The API does not recalculate totals: when you change lines or amounts, send the matching totals too.

Error codes

Codes this endpoint can return. The general errors that apply to every endpoint (authentication, permissions, request headers, daily limit) are not repeated here.

Authorizations

Authorization
string
header
required

Access token obtained from the Noyax auth service with your API key.

Headers

X-UserID
integer<int32>
required

ID of the Noyax user the request is made on behalf of. Written to the audit fields of created, updated and deleted records.

Required range: x >= 1
X-CompanyID
integer<int32>
required

ID of the company. The user must be assigned to this company. All reads and writes are limited to this company.

Required range: x >= 1
X-PeriodID
integer<int32>

ID of the accounting period. Optional for customer endpoints; if sent, it is written to created records.

Required range: x >= 1

Path Parameters

quoteId
string<uuid>
required

Quote ID.

Body

QuoteType
integer<int32>

Required. 1: Purchase quote (received), 2: Sales quote (issued). Cannot be changed after the quote is created.

Example:

2

QuoteNumber
null | string

Required. Quote number, unique within the company for the same QuoteType. Send "Next" on create to generate it from the company's quote number series for the type. At most 10 characters.

Example:

"52825CA9F1"

DocumentNumber
null | string

Document number (free text). At most 20 characters.

Example:

"2026-15"

Date
null | string<date-time>

Required. Quote date. The date part is stored as the quote date; if a time is sent it is stored as the quote time, otherwise the current time is used.

Example:

"2026-09-21T10:30:00"

Description
null | string

Description. At most 1000 characters.

CustomerId
null | string<uuid>

Required. Customer ID from GET /api/v1/customers.

RepresentativeId
null | string<uuid>

ID of a representative of the customer from GET /api/v1/customers/{customerId}/representatives.

CurrencyId
null | string<uuid>

Required. Currency ID from GET /api/v1/definitions/currencies.

DueDays
integer<int32>

Payment term in days. Cannot be less than 0.

Example:

30

DeliveryDate
null | string<date-time>

Delivery date.

SharingCodeId
null | string<uuid>

Sharing code that limits who can see the quote. Empty means visible to everyone; otherwise it must be one of the user's sharing codes.

DiscountTotal
number<double>

Total discount amount. Sent by the integrator, not calculated by the API.

Example:

0

SubTotal
number<double>

Subtotal (sum of the line amounts excluding taxes). Sent by the integrator, not calculated by the API.

Example:

1000

VatTotal
number<double>

Total VAT amount. Sent by the integrator, not calculated by the API.

Example:

200

AdditionalTaxTotal
number<double>

Total additional tax amount. Sent by the integrator, not calculated by the API.

Example:

0

WithholdingTotal
number<double>

Total withholding (tevkifat) amount. Sent by the integrator, not calculated by the API.

Example:

0

GrandTotal
number<double>

Grand total. Sent by the integrator, not calculated by the API.

Example:

1200

AverageExchangeRate
number<double>

Weighted average exchange rate of the lines. Sent by the integrator, not calculated by the API. Use 1 when everything is in the company's default currency.

Example:

1

Lines
object[]

Required, at least one line. On update the lines are replaced: the quote's existing lines are removed and these are saved instead.

Response

OK

Success
boolean
required

Whether the operation succeeded.

Example:

true

ResultCode
string
required

"0000" on success. On failure, the code of the first error; all errors are listed in Errors.

Example:

"0000"

Data
object
required

Response data. Null when Success is false.

Message
null | string

Error message when Success is false. Messages of all errors are joined into a single text.