> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.noyax.com/llms.txt > Use this file to discover all available pages before exploring further. # Update quote > Replaces all fields and all lines of a quote. To change individual fields, use a [partial update](/en/v1/guides/partial-update): `PATCH` changes only the fields you send. Update is a **full replace**, and the lines are replaced too: the quote's existing lines are removed and the lines in the request are saved in their place (all in one transaction). Send every line the quote should keep. * `QuoteType` cannot be changed (`5015`) and `QuoteNumber` cannot be `"Next"` (`5003`). * The status is not changed, and there is no restriction by status: see [editing and deleting](/en/v1/quotes/overview). * The API does not calculate amounts; send the totals as calculated by your system. ## Error codes Codes this endpoint can return. The [general errors](/en/v1/guides/result-codes) that apply to every endpoint (authentication, permissions, request headers, daily limit) are not repeated here. | Code | HTTP | Meaning | | ------ | ---- | ------------------------------------------------------------------------------ | | `0002` | 400 | Request body could not be read (malformed JSON, wrong field type) | | `0003` | 400 | A field exceeds its maximum length (the message names the field and the limit) | | `5000` | 404 | Quote not found | | `5001` | 400 | `QuoteNumber` is required | | `5002` | 400 | The quote number is already used in the company for this quote type | | `5003` | 400 | `QuoteNumber` cannot be `Next` on update | | `5004` | 400 | `QuoteType` must be 1 (purchase) or 2 (sales) | | `5005` | 400 | `Date` is required | | `5006` | 400 | `CustomerId` is required | | `5007` | 400 | Customer not found, or not visible to the user | | `5008` | 400 | The representative was not found for this customer | | `5009` | 400 | `CurrencyId` is required | | `5010` | 400 | Currency not found in the company | | `5011` | 400 | `SharingCodeId` is not one of the user's sharing codes | | `5012` | 400 | At least one line is required | | `5013` | 400 | `DueDays` cannot be less than 0 | | `5015` | 400 | `QuoteType` cannot be changed after the quote is created | ## OpenAPI ````yaml api-reference/openapi.json PUT /api/v1/quotes/{quoteId} openapi: 3.1.1 info: title: Noyax API description: Server-to-server API for integrations to access Noyax data. version: '1.0' servers: - url: https://dev.noyax.com/services/noyax_api security: - Bearer: [] tags: - name: Sections - name: Warehouses - name: Quotes - name: Product Critical Stock - name: Product groups - name: Product Parameter Definitions - name: Product Parameters - name: Product Prices - name: Products - name: Cities - name: Countries - name: Currencies - name: Districts - name: Line Groups - name: Shipment Definitions - name: Units - name: VAT rates - name: Customer Addresses - name: Customer Bank Accounts - name: Customer Definitions - name: Customer Group Members - name: Customer Links - name: Customer Parameters - name: Customer Representatives - name: Customers - name: Customer Statement - name: Customer Telephones paths: /api/v1/quotes/{quoteId}: put: tags: - Quotes summary: Update quote description: >- Replaces all fields of the quote, and replaces its lines: the existing lines are removed and the lines in the request are saved. QuoteType cannot be changed and QuoteNumber cannot be "Next". The quote status is never changed by the API. parameters: - name: quoteId in: path description: Quote ID. required: true schema: type: string format: uuid - name: X-UserID in: header description: >- ID of the Noyax user the request is made on behalf of. Written to the audit fields of created, updated and deleted records. required: true schema: minimum: 1 type: integer format: int32 - name: X-CompanyID in: header description: >- ID of the company. The user must be assigned to this company. All reads and writes are limited to this company. required: true schema: minimum: 1 type: integer format: int32 - name: X-PeriodID in: header description: >- ID of the accounting period. Optional for customer endpoints; if sent, it is written to created records. schema: minimum: 1 type: integer format: int32 requestBody: content: application/json: schema: $ref: '#/components/schemas/QuoteRequestDto' text/json: schema: $ref: '#/components/schemas/QuoteRequestDto' application/*+json: schema: $ref: '#/components/schemas/QuoteRequestDto' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DataResultOfQuoteDetailDto' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '5015' Message: QuoteType cannot be changed after the quote is created. Errors: - Code: '5015' Message: QuoteType cannot be changed after the quote is created. '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '0102' Message: Token has expired. Obtain a new token using the refresh token. Errors: - Code: '0102' Message: >- Token has expired. Obtain a new token using the refresh token. '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '0110' Message: You do not have permission for this operation. Errors: - Code: '0110' Message: You do not have permission for this operation. '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '5000' Message: Quote not found. Errors: - Code: '5000' Message: Quote not found. '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '0120' Message: Daily request limit (10000) exceeded. Errors: - Code: '0120' Message: Daily request limit (10000) exceeded. components: schemas: QuoteRequestDto: type: object properties: QuoteType: type: integer description: >- Required. 1: Purchase quote (received), 2: Sales quote (issued). Cannot be changed after the quote is created. format: int32 example: 2 QuoteNumber: type: - 'null' - string description: >- 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: type: - 'null' - string description: Document number (free text). At most 20 characters. example: 2026-15 Date: type: - 'null' - string description: >- 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. format: date-time example: '2026-09-21T10:30:00' Description: type: - 'null' - string description: Description. At most 1000 characters. CustomerId: type: - 'null' - string description: Required. Customer ID from GET /api/v1/customers. format: uuid RepresentativeId: type: - 'null' - string description: >- ID of a representative of the customer from GET /api/v1/customers/{customerId}/representatives. format: uuid CurrencyId: type: - 'null' - string description: Required. Currency ID from GET /api/v1/definitions/currencies. format: uuid DueDays: type: integer description: Payment term in days. Cannot be less than 0. format: int32 example: 30 DeliveryDate: type: - 'null' - string description: Delivery date. format: date-time SharingCodeId: type: - 'null' - string description: >- 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. format: uuid DiscountTotal: type: number description: >- Total discount amount. Sent by the integrator, not calculated by the API. format: double example: 0 SubTotal: type: number description: >- Subtotal (sum of the line amounts excluding taxes). Sent by the integrator, not calculated by the API. format: double example: 1000 VatTotal: type: number description: Total VAT amount. Sent by the integrator, not calculated by the API. format: double example: 200 AdditionalTaxTotal: type: number description: >- Total additional tax amount. Sent by the integrator, not calculated by the API. format: double example: 0 WithholdingTotal: type: number description: >- Total withholding (tevkifat) amount. Sent by the integrator, not calculated by the API. format: double example: 0 GrandTotal: type: number description: Grand total. Sent by the integrator, not calculated by the API. format: double example: 1200 AverageExchangeRate: type: number description: >- 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. format: double example: 1 Lines: type: array items: $ref: '#/components/schemas/QuoteLineRequestDto' description: >- Required, at least one line. On update the lines are replaced: the quote's existing lines are removed and these are saved instead. DataResultOfQuoteDetailDto: required: - Success - ResultCode - Data type: object properties: Success: type: boolean description: Whether the operation succeeded. example: true ResultCode: type: string description: >- "0000" on success. On failure, the code of the first error; all errors are listed in Errors. example: '0000' Message: type: - 'null' - string description: >- Error message when Success is false. Messages of all errors are joined into a single text. Data: $ref: '#/components/schemas/QuoteDetailDto' ErrorResult: type: object properties: Success: type: boolean description: Whether the operation succeeded. example: false ResultCode: type: - 'null' - string description: >- "0000" on success. On failure, the code of the first error; all errors are listed in Errors. Message: type: - 'null' - string description: >- Error message when Success is false. Messages of all errors are joined into a single text. Errors: type: - 'null' - array items: $ref: '#/components/schemas/ResultError' description: All errors with their codes. Only present when Success is false. QuoteLineRequestDto: type: object properties: ProductId: type: - 'null' - string description: Required. Product ID from GET /api/v1/products. format: uuid UnitId: type: - 'null' - string description: >- Required. Must be one of the product's own units (its main unit or its second/third unit). format: uuid Quantity: type: number description: Quantity. Must be greater than 0. format: double example: 10 UnitPrice: type: number description: >- Unit price, in the line currency. When VatIncluded is true the price includes VAT. Cannot be negative. format: double example: 100 CurrencyId: type: - 'null' - string description: Currency ID of the line. Defaults to the quote's currency. format: uuid ExchangeRate: type: number description: Exchange rate of the line currency. Cannot be negative. format: double example: 1 DiscountRate: type: number description: >- Cumulative line discount rate (%) resulting from Discounts, between 0 and 100. Sent by the integrator, not calculated by the API. format: double example: 0 DiscountAmount: type: number description: >- Line discount amount. Sent by the integrator, not calculated by the API. format: double example: 0 Discounts: type: array items: $ref: '#/components/schemas/QuoteDiscountRequestDto' description: >- Discounts applied to the line one after another. Leave empty when the line has no discount. VatRate: type: integer description: VAT rate (%), between 0 and 100. format: int32 example: 20 VatIncluded: type: boolean description: Whether UnitPrice includes VAT. example: false VatAmount: type: number description: >- VAT amount of the line. Sent by the integrator, not calculated by the API. format: double AmountExcludingTax: type: number description: >- Line amount excluding taxes. Sent by the integrator, not calculated by the API. format: double AmountIncludingTax: type: number description: >- Line amount including taxes. Sent by the integrator, not calculated by the API. format: double VatBase: type: number description: >- VAT base of the line. Sent by the integrator, not calculated by the API. format: double VatExemptionCode: type: - 'null' - string description: VAT exemption code. At most 10 characters. LineGroupId: type: - 'null' - string description: ID of a line group from GET /api/v1/definitions/line-groups. format: uuid Description: type: - 'null' - string description: Line description. At most 255 characters. Description2: type: - 'null' - string description: Second line description. At most 255 characters. DeliveryDate: type: - 'null' - string description: Delivery date of the line. format: date-time AdditionalTaxCode1: type: - 'null' - string description: Additional tax 1 code. At most 15 characters. AdditionalTaxRate1: type: number description: Additional tax 1 rate (%). format: double AdditionalTaxAmount1: type: number description: >- Additional tax 1 amount. Sent by the integrator, not calculated by the API. format: double AdditionalTaxBase1: type: number description: >- Additional tax 1 base. Sent by the integrator, not calculated by the API. format: double AdditionalTaxCode2: type: - 'null' - string description: Additional tax 2 code. At most 15 characters. AdditionalTaxRate2: type: number description: Additional tax 2 rate (%). format: double AdditionalTaxAmount2: type: number description: >- Additional tax 2 amount. Sent by the integrator, not calculated by the API. format: double AdditionalTaxBase2: type: number description: >- Additional tax 2 base. Sent by the integrator, not calculated by the API. format: double AdditionalTaxCode3: type: - 'null' - string description: Additional tax 3 code. At most 15 characters. AdditionalTaxRate3: type: number description: Additional tax 3 rate (%). format: double AdditionalTaxAmount3: type: number description: >- Additional tax 3 amount. Sent by the integrator, not calculated by the API. format: double AdditionalTaxBase3: type: number description: >- Additional tax 3 base. Sent by the integrator, not calculated by the API. format: double WithholdingCode: type: - 'null' - string description: Withholding (tevkifat) code. At most 10 characters. WithholdingNumerator: type: integer description: Numerator of the withholding share (e.g. 9 in 9/10). format: int32 WithholdingDenominator: type: integer description: Denominator of the withholding share (e.g. 10 in 9/10). format: int32 WithheldVatAmount: type: number description: >- Withheld VAT amount. Sent by the integrator, not calculated by the API. format: double QuoteDetailDto: type: object properties: Id: type: string description: Quote ID. format: uuid Status: type: integer description: >- Quote status: 0 Pending, 1 Accepted, 2 Revised, 3 Rejected. Quotes are created as 0 and the API never changes the status. format: int32 example: 0 CustomerName: type: - 'null' - string description: Customer name. CurrencyCode: type: - 'null' - string description: Currency short code. example: TRY QuoteType: type: integer description: >- Required. 1: Purchase quote (received), 2: Sales quote (issued). Cannot be changed after the quote is created. format: int32 example: 2 QuoteNumber: type: - 'null' - string description: >- 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: type: - 'null' - string description: Document number (free text). At most 20 characters. example: 2026-15 Date: type: - 'null' - string description: >- 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. format: date-time example: '2026-09-21T10:30:00' Description: type: - 'null' - string description: Description. At most 1000 characters. CustomerId: type: - 'null' - string description: Required. Customer ID from GET /api/v1/customers. format: uuid RepresentativeId: type: - 'null' - string description: >- ID of a representative of the customer from GET /api/v1/customers/{customerId}/representatives. format: uuid CurrencyId: type: - 'null' - string description: Required. Currency ID from GET /api/v1/definitions/currencies. format: uuid DueDays: type: integer description: Payment term in days. Cannot be less than 0. format: int32 example: 30 DeliveryDate: type: - 'null' - string description: Delivery date. format: date-time SharingCodeId: type: - 'null' - string description: >- 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. format: uuid DiscountTotal: type: number description: >- Total discount amount. Sent by the integrator, not calculated by the API. format: double example: 0 SubTotal: type: number description: >- Subtotal (sum of the line amounts excluding taxes). Sent by the integrator, not calculated by the API. format: double example: 1000 VatTotal: type: number description: Total VAT amount. Sent by the integrator, not calculated by the API. format: double example: 200 AdditionalTaxTotal: type: number description: >- Total additional tax amount. Sent by the integrator, not calculated by the API. format: double example: 0 WithholdingTotal: type: number description: >- Total withholding (tevkifat) amount. Sent by the integrator, not calculated by the API. format: double example: 0 GrandTotal: type: number description: Grand total. Sent by the integrator, not calculated by the API. format: double example: 1200 AverageExchangeRate: type: number description: >- 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. format: double example: 1 CreateDate: type: - 'null' - string description: Creation date. format: date-time ModifyDate: type: - 'null' - string description: Last modification date. format: date-time Lines: type: array items: $ref: '#/components/schemas/QuoteLineDto' description: Quote lines, in line order. description: Response data. Null when Success is false. ResultError: required: - Code - Message type: object properties: Code: type: string description: Error code. See the result codes page for the full list. Message: type: string description: Error description. QuoteDiscountRequestDto: type: object properties: Rate: type: number description: >- Discount rate (%), between 0 and 100. Discounts of a line are applied one after another in list order: 10, 10 and 10 give a 27.1% line discount. format: double example: 10 QuoteLineDto: type: object properties: ProductCode: type: - 'null' - string description: Product code. example: URN-0001 ProductName: type: - 'null' - string description: Product name. UnitName: type: - 'null' - string description: Unit name. example: ADET CurrencyCode: type: - 'null' - string description: Currency short code of the line. example: TRY LineGroupName: type: - 'null' - string description: Line group name. ProductId: type: - 'null' - string description: Required. Product ID from GET /api/v1/products. format: uuid UnitId: type: - 'null' - string description: >- Required. Must be one of the product's own units (its main unit or its second/third unit). format: uuid Quantity: type: number description: Quantity. Must be greater than 0. format: double example: 10 UnitPrice: type: number description: >- Unit price, in the line currency. When VatIncluded is true the price includes VAT. Cannot be negative. format: double example: 100 CurrencyId: type: - 'null' - string description: Currency ID of the line. Defaults to the quote's currency. format: uuid ExchangeRate: type: number description: Exchange rate of the line currency. Cannot be negative. format: double example: 1 DiscountRate: type: number description: >- Cumulative line discount rate (%) resulting from Discounts, between 0 and 100. Sent by the integrator, not calculated by the API. format: double example: 0 DiscountAmount: type: number description: >- Line discount amount. Sent by the integrator, not calculated by the API. format: double example: 0 Discounts: type: array items: $ref: '#/components/schemas/QuoteDiscountRequestDto' description: >- Discounts applied to the line one after another. Leave empty when the line has no discount. VatRate: type: integer description: VAT rate (%), between 0 and 100. format: int32 example: 20 VatIncluded: type: boolean description: Whether UnitPrice includes VAT. example: false VatAmount: type: number description: >- VAT amount of the line. Sent by the integrator, not calculated by the API. format: double AmountExcludingTax: type: number description: >- Line amount excluding taxes. Sent by the integrator, not calculated by the API. format: double AmountIncludingTax: type: number description: >- Line amount including taxes. Sent by the integrator, not calculated by the API. format: double VatBase: type: number description: >- VAT base of the line. Sent by the integrator, not calculated by the API. format: double VatExemptionCode: type: - 'null' - string description: VAT exemption code. At most 10 characters. LineGroupId: type: - 'null' - string description: ID of a line group from GET /api/v1/definitions/line-groups. format: uuid Description: type: - 'null' - string description: Line description. At most 255 characters. Description2: type: - 'null' - string description: Second line description. At most 255 characters. DeliveryDate: type: - 'null' - string description: Delivery date of the line. format: date-time AdditionalTaxCode1: type: - 'null' - string description: Additional tax 1 code. At most 15 characters. AdditionalTaxRate1: type: number description: Additional tax 1 rate (%). format: double AdditionalTaxAmount1: type: number description: >- Additional tax 1 amount. Sent by the integrator, not calculated by the API. format: double AdditionalTaxBase1: type: number description: >- Additional tax 1 base. Sent by the integrator, not calculated by the API. format: double AdditionalTaxCode2: type: - 'null' - string description: Additional tax 2 code. At most 15 characters. AdditionalTaxRate2: type: number description: Additional tax 2 rate (%). format: double AdditionalTaxAmount2: type: number description: >- Additional tax 2 amount. Sent by the integrator, not calculated by the API. format: double AdditionalTaxBase2: type: number description: >- Additional tax 2 base. Sent by the integrator, not calculated by the API. format: double AdditionalTaxCode3: type: - 'null' - string description: Additional tax 3 code. At most 15 characters. AdditionalTaxRate3: type: number description: Additional tax 3 rate (%). format: double AdditionalTaxAmount3: type: number description: >- Additional tax 3 amount. Sent by the integrator, not calculated by the API. format: double AdditionalTaxBase3: type: number description: >- Additional tax 3 base. Sent by the integrator, not calculated by the API. format: double WithholdingCode: type: - 'null' - string description: Withholding (tevkifat) code. At most 10 characters. WithholdingNumerator: type: integer description: Numerator of the withholding share (e.g. 9 in 9/10). format: int32 WithholdingDenominator: type: integer description: Denominator of the withholding share (e.g. 10 in 9/10). format: int32 WithheldVatAmount: type: number description: >- Withheld VAT amount. Sent by the integrator, not calculated by the API. format: double securitySchemes: Bearer: type: http description: Access token obtained from the Noyax auth service with your API key. scheme: bearer bearerFormat: JWT ````