> ## 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. # Teklifi kısmi güncelle > Teklifin yalnızca gönderilen alanlarını değiştirir. Gövdede **yalnızca değiştirmek istediğiniz alanları** gönderirsiniz; gönderilmeyen alanlar mevcut değerleriyle kalır. Kural ve örnekler: [kısmi güncelleme](/tr/v1/guides/partial-update). * Gönderilmeyen alan değişmez, `null` gönderilen alan temizlenir. * Doğrulama birleştirilmiş kaydın tamamı üzerinde çalışır; zorunlu bir alanı `null` yaparsanız istek reddedilir. * Listeler birleştirilmez: `Lines` gönderilirse teklifin **bütün** satırlarını değiştirir, gönderilmezse satırlar olduğu gibi kalır. * API toplamları yeniden hesaplamaz: satırları ya da tutarları değiştirirseniz ilgili toplamları da gönderin. ## Hata kodları Bu endpoint'in dönebileceği kodlar. Her endpoint için geçerli olan [genel hatalar](/tr/v1/guides/result-codes) (kimlik doğrulama, yetki, istek header'ları, günlük limit) burada tekrarlanmaz. | Kod | HTTP | Anlamı | | ------ | ---- | ------------------------------------------------------------ | | `0002` | 400 | İstek gövdesi okunamadı (bozuk JSON, alan tipi uyumsuz) | | `0003` | 400 | Alan azami uzunluğu aşıyor (mesajda alan adı ve sınır yazar) | | `5000` | 404 | Teklif bulunamadı | | `5001` | 400 | `QuoteNumber` zorunlu | | `5002` | 400 | Teklif numarası şirkette bu teklif tipi için kullanılıyor | | `5003` | 400 | Güncellemede `QuoteNumber` `Next` olamaz | | `5004` | 400 | `QuoteType` 1 (alış) ya da 2 (satış) olmalı | | `5005` | 400 | `Date` zorunlu | | `5006` | 400 | `CustomerId` zorunlu | | `5007` | 400 | Cari bulunamadı ya da kullanıcı göremiyor | | `5008` | 400 | Yetkili bu carinin yetkilisi olarak bulunamadı | | `5009` | 400 | `CurrencyId` zorunlu | | `5010` | 400 | Döviz şirkette bulunamadı | | `5011` | 400 | `SharingCodeId` kullanıcının paylaşım kodlarından biri değil | | `5012` | 400 | En az bir satır zorunlu | | `5013` | 400 | `DueDays` 0'dan küçük olamaz | | `5015` | 400 | Teklif oluşturulduktan sonra `QuoteType` değiştirilemez | ## OpenAPI ````yaml api-reference/openapi.tr.json PATCH /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}: patch: tags: - Quotes summary: Teklifi kısmen güncelle description: >- Yalnızca gövdede gönderilen alanları değiştirir (JSON Merge Patch). Gönderilmeyen alanlar mevcut değerini korur; null gönderilen alan temizlenir. Listeler birleştirilmez: Lines gönderilirse tüm satırların yerine geçer, gönderilmezse satırlar olduğu gibi kalır. parameters: - name: quoteId in: path description: Teklif ID'si. required: true schema: type: string format: uuid - name: X-UserID in: header description: >- İsteğin adına yapıldığı Noyax kullanıcısının ID'si. Oluşturulan, güncellenen ve silinen kayıtların denetim alanlarına yazılır. required: true schema: minimum: 1 type: integer format: int32 - name: X-CompanyID in: header description: >- Şirketin ID'si. Kullanıcı bu şirkete tanımlı olmalıdır. Bütün okuma ve yazma işlemleri bu şirketle sınırlıdır. required: true schema: minimum: 1 type: integer format: int32 - name: X-PeriodID in: header description: >- Muhasebe döneminin ID'si. Cari endpoint'lerinde isteğe bağlıdır; gönderilirse oluşturulan kayıtlara yazılır. 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: >- Zorunlu. 1: Alış teklifi (alınan), 2: Satış teklifi (verilen). Teklif oluşturulduktan sonra değiştirilemez. format: int32 example: 2 QuoteNumber: type: - 'null' - string description: >- Zorunlu. Teklif numarası, şirkette aynı QuoteType için benzersiz. Oluştururken "Next" gönderilirse şirketin o tip için teklif numarası serisinden üretilir. En fazla 10 karakter. example: 52825CA9F1 DocumentNumber: type: - 'null' - string description: Belge numarası (serbest metin). En fazla 20 karakter. example: 2026-15 Date: type: - 'null' - string description: >- Zorunlu. Teklif tarihi. Tarih kısmı teklif tarihi olarak saklanır; saat gönderilirse teklif saati olarak saklanır, gönderilmezse şimdiki saat kullanılır. format: date-time example: '2026-09-21T10:30:00' Description: type: - 'null' - string description: Açıklama. En fazla 1000 karakter. CustomerId: type: - 'null' - string description: Zorunlu. GET /api/v1/customers'tan alınan cari ID'si. format: uuid RepresentativeId: type: - 'null' - string description: >- Carinin yetkililerinden birinin ID'si (GET /api/v1/customers/{customerId}/representatives). format: uuid CurrencyId: type: - 'null' - string description: Zorunlu. GET /api/v1/definitions/currencies'ten alınan döviz ID'si. format: uuid DueDays: type: integer description: Gün olarak vade. 0'dan küçük olamaz. format: int32 example: 30 DeliveryDate: type: - 'null' - string description: Teslim tarihi. format: date-time SharingCodeId: type: - 'null' - string description: >- Teklifi kimin görebileceğini sınırlayan paylaşım kodu. Boşsa herkes görebilir; doluysa kullanıcının paylaşım kodlarından biri olmalıdır. format: uuid DiscountTotal: type: number description: >- Toplam indirim tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 0 SubTotal: type: number description: >- Ara toplam (satır tutarlarının vergisiz toplamı). Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 1000 VatTotal: type: number description: Toplam KDV tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 200 AdditionalTaxTotal: type: number description: >- Toplam ek vergi tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 0 WithholdingTotal: type: number description: >- Toplam tevkifat tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 0 GrandTotal: type: number description: Genel toplam. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 1200 AverageExchangeRate: type: number description: >- Satırların ağırlıklı ortalama kuru. Entegratör tarafından gönderilir, API hesaplamaz. Her şey şirketin varsayılan dövizindeyse 1 kullanın. format: double example: 1 Lines: type: array items: $ref: '#/components/schemas/QuoteLineRequestDto' description: >- Zorunlu, en az bir satır. Güncellemede satırlar değiştirilir: teklifin mevcut satırları kaldırılır, yerine bunlar kaydedilir. DataResultOfQuoteDetailDto: required: - Success - ResultCode - Data type: object properties: Success: type: boolean description: İşlemin başarılı olup olmadığı. example: true ResultCode: type: string description: >- Başarıda "0000". Hatada ilk hatanın kodu; hataların tamamı Errors içinde listelenir. example: '0000' Message: type: - 'null' - string description: >- Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir. Data: $ref: '#/components/schemas/QuoteDetailDto' ErrorResult: type: object properties: Success: type: boolean description: İşlemin başarılı olup olmadığı. example: false ResultCode: type: - 'null' - string description: >- Başarıda "0000". Hatada ilk hatanın kodu; hataların tamamı Errors içinde listelenir. Message: type: - 'null' - string description: >- Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir. Errors: type: - 'null' - array items: $ref: '#/components/schemas/ResultError' description: >- Kodlarıyla birlikte bütün hatalar. Yalnızca Success false olduğunda bulunur. QuoteLineRequestDto: type: object properties: ProductId: type: - 'null' - string description: Zorunlu. GET /api/v1/products'tan alınan ürün ID'si. format: uuid UnitId: type: - 'null' - string description: >- Zorunlu. Ürünün kendi birimlerinden biri olmalı (ana birimi ya da 2./3. birimi). format: uuid Quantity: type: number description: Miktar. 0'dan büyük olmalı. format: double example: 10 UnitPrice: type: number description: >- Satır dövizinde birim fiyat. VatIncluded true ise fiyat KDV dahildir. Negatif olamaz. format: double example: 100 CurrencyId: type: - 'null' - string description: Satırın döviz ID'si. Varsayılan olarak teklifin dövizidir. format: uuid ExchangeRate: type: number description: Satır dövizinin kuru. Negatif olamaz. format: double example: 1 DiscountRate: type: number description: >- Discounts'tan doğan kümülatif satır indirim oranı (%), 0 ile 100 arasında. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 0 DiscountAmount: type: number description: >- Satır indirim tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 0 Discounts: type: array items: $ref: '#/components/schemas/QuoteDiscountRequestDto' description: >- Satıra art arda uygulanan indirimler. Satırda indirim yoksa boş bırakın. VatRate: type: integer description: KDV oranı (%), 0 ile 100 arasında. format: int32 example: 20 VatIncluded: type: boolean description: UnitPrice'ın KDV dahil olup olmadığı. example: false VatAmount: type: number description: >- Satırın KDV tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AmountExcludingTax: type: number description: >- Satırın vergisiz tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AmountIncludingTax: type: number description: >- Satırın vergili tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double VatBase: type: number description: >- Satırın KDV matrahı. Entegratör tarafından gönderilir, API hesaplamaz. format: double VatExemptionCode: type: - 'null' - string description: KDV muafiyet kodu. En fazla 10 karakter. LineGroupId: type: - 'null' - string description: GET /api/v1/definitions/line-groups'tan alınan satır grubu ID'si. format: uuid Description: type: - 'null' - string description: Satır açıklaması. En fazla 255 karakter. Description2: type: - 'null' - string description: İkinci satır açıklaması. En fazla 255 karakter. DeliveryDate: type: - 'null' - string description: Satırın teslim tarihi. format: date-time AdditionalTaxCode1: type: - 'null' - string description: Ek vergi 1 kodu. En fazla 15 karakter. AdditionalTaxRate1: type: number description: Ek vergi 1 oranı (%). format: double AdditionalTaxAmount1: type: number description: Ek vergi 1 tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AdditionalTaxBase1: type: number description: >- Ek vergi 1 matrahı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AdditionalTaxCode2: type: - 'null' - string description: Ek vergi 2 kodu. En fazla 15 karakter. AdditionalTaxRate2: type: number description: Ek vergi 2 oranı (%). format: double AdditionalTaxAmount2: type: number description: Ek vergi 2 tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AdditionalTaxBase2: type: number description: >- Ek vergi 2 matrahı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AdditionalTaxCode3: type: - 'null' - string description: Ek vergi 3 kodu. En fazla 15 karakter. AdditionalTaxRate3: type: number description: Ek vergi 3 oranı (%). format: double AdditionalTaxAmount3: type: number description: Ek vergi 3 tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AdditionalTaxBase3: type: number description: >- Ek vergi 3 matrahı. Entegratör tarafından gönderilir, API hesaplamaz. format: double WithholdingCode: type: - 'null' - string description: Tevkifat kodu. En fazla 10 karakter. WithholdingNumerator: type: integer description: Tevkifat oranının payı (ör. 9/10'daki 9). format: int32 WithholdingDenominator: type: integer description: Tevkifat oranının paydası (ör. 9/10'daki 10). format: int32 WithheldVatAmount: type: number description: >- Tevkifatla kesilen KDV tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double QuoteDetailDto: type: object properties: Id: type: string description: Teklif ID'si. format: uuid Status: type: integer description: >- Teklif durumu: 0 Beklemede, 1 Kabul edildi, 2 Revize edildi, 3 Reddedildi. Teklifler 0 olarak oluşturulur, API durumu hiçbir zaman değiştirmez. format: int32 example: 0 CustomerName: type: - 'null' - string description: Cari adı. CurrencyCode: type: - 'null' - string description: Dövizin kısa kodu. example: TRY QuoteType: type: integer description: >- Zorunlu. 1: Alış teklifi (alınan), 2: Satış teklifi (verilen). Teklif oluşturulduktan sonra değiştirilemez. format: int32 example: 2 QuoteNumber: type: - 'null' - string description: >- Zorunlu. Teklif numarası, şirkette aynı QuoteType için benzersiz. Oluştururken "Next" gönderilirse şirketin o tip için teklif numarası serisinden üretilir. En fazla 10 karakter. example: 52825CA9F1 DocumentNumber: type: - 'null' - string description: Belge numarası (serbest metin). En fazla 20 karakter. example: 2026-15 Date: type: - 'null' - string description: >- Zorunlu. Teklif tarihi. Tarih kısmı teklif tarihi olarak saklanır; saat gönderilirse teklif saati olarak saklanır, gönderilmezse şimdiki saat kullanılır. format: date-time example: '2026-09-21T10:30:00' Description: type: - 'null' - string description: Açıklama. En fazla 1000 karakter. CustomerId: type: - 'null' - string description: Zorunlu. GET /api/v1/customers'tan alınan cari ID'si. format: uuid RepresentativeId: type: - 'null' - string description: >- Carinin yetkililerinden birinin ID'si (GET /api/v1/customers/{customerId}/representatives). format: uuid CurrencyId: type: - 'null' - string description: Zorunlu. GET /api/v1/definitions/currencies'ten alınan döviz ID'si. format: uuid DueDays: type: integer description: Gün olarak vade. 0'dan küçük olamaz. format: int32 example: 30 DeliveryDate: type: - 'null' - string description: Teslim tarihi. format: date-time SharingCodeId: type: - 'null' - string description: >- Teklifi kimin görebileceğini sınırlayan paylaşım kodu. Boşsa herkes görebilir; doluysa kullanıcının paylaşım kodlarından biri olmalıdır. format: uuid DiscountTotal: type: number description: >- Toplam indirim tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 0 SubTotal: type: number description: >- Ara toplam (satır tutarlarının vergisiz toplamı). Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 1000 VatTotal: type: number description: Toplam KDV tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 200 AdditionalTaxTotal: type: number description: >- Toplam ek vergi tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 0 WithholdingTotal: type: number description: >- Toplam tevkifat tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 0 GrandTotal: type: number description: Genel toplam. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 1200 AverageExchangeRate: type: number description: >- Satırların ağırlıklı ortalama kuru. Entegratör tarafından gönderilir, API hesaplamaz. Her şey şirketin varsayılan dövizindeyse 1 kullanın. format: double example: 1 CreateDate: type: - 'null' - string description: Oluşturulma tarihi. format: date-time ModifyDate: type: - 'null' - string description: Son değişiklik tarihi. format: date-time Lines: type: array items: $ref: '#/components/schemas/QuoteLineDto' description: Teklif satırları, satır sırasıyla. description: Response data. Null when Success is false. ResultError: required: - Code - Message type: object properties: Code: type: string description: Hata kodu. Tam liste için sonuç kodları sayfasına bakın. Message: type: string description: Hata açıklaması. QuoteDiscountRequestDto: type: object properties: Rate: type: number description: >- İndirim oranı (%), 0 ile 100 arasında. Bir satırın indirimleri liste sırasıyla art arda uygulanır: 10, 10 ve 10 satırda %27,1 indirim verir. format: double example: 10 QuoteLineDto: type: object properties: ProductCode: type: - 'null' - string description: Ürün kodu. example: URN-0001 ProductName: type: - 'null' - string description: Ürün adı. UnitName: type: - 'null' - string description: Birim adı. example: ADET CurrencyCode: type: - 'null' - string description: Satırın döviz kısa kodu. example: TRY LineGroupName: type: - 'null' - string description: Satır grubu adı. ProductId: type: - 'null' - string description: Zorunlu. GET /api/v1/products'tan alınan ürün ID'si. format: uuid UnitId: type: - 'null' - string description: >- Zorunlu. Ürünün kendi birimlerinden biri olmalı (ana birimi ya da 2./3. birimi). format: uuid Quantity: type: number description: Miktar. 0'dan büyük olmalı. format: double example: 10 UnitPrice: type: number description: >- Satır dövizinde birim fiyat. VatIncluded true ise fiyat KDV dahildir. Negatif olamaz. format: double example: 100 CurrencyId: type: - 'null' - string description: Satırın döviz ID'si. Varsayılan olarak teklifin dövizidir. format: uuid ExchangeRate: type: number description: Satır dövizinin kuru. Negatif olamaz. format: double example: 1 DiscountRate: type: number description: >- Discounts'tan doğan kümülatif satır indirim oranı (%), 0 ile 100 arasında. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 0 DiscountAmount: type: number description: >- Satır indirim tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double example: 0 Discounts: type: array items: $ref: '#/components/schemas/QuoteDiscountRequestDto' description: >- Satıra art arda uygulanan indirimler. Satırda indirim yoksa boş bırakın. VatRate: type: integer description: KDV oranı (%), 0 ile 100 arasında. format: int32 example: 20 VatIncluded: type: boolean description: UnitPrice'ın KDV dahil olup olmadığı. example: false VatAmount: type: number description: >- Satırın KDV tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AmountExcludingTax: type: number description: >- Satırın vergisiz tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AmountIncludingTax: type: number description: >- Satırın vergili tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double VatBase: type: number description: >- Satırın KDV matrahı. Entegratör tarafından gönderilir, API hesaplamaz. format: double VatExemptionCode: type: - 'null' - string description: KDV muafiyet kodu. En fazla 10 karakter. LineGroupId: type: - 'null' - string description: GET /api/v1/definitions/line-groups'tan alınan satır grubu ID'si. format: uuid Description: type: - 'null' - string description: Satır açıklaması. En fazla 255 karakter. Description2: type: - 'null' - string description: İkinci satır açıklaması. En fazla 255 karakter. DeliveryDate: type: - 'null' - string description: Satırın teslim tarihi. format: date-time AdditionalTaxCode1: type: - 'null' - string description: Ek vergi 1 kodu. En fazla 15 karakter. AdditionalTaxRate1: type: number description: Ek vergi 1 oranı (%). format: double AdditionalTaxAmount1: type: number description: Ek vergi 1 tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AdditionalTaxBase1: type: number description: >- Ek vergi 1 matrahı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AdditionalTaxCode2: type: - 'null' - string description: Ek vergi 2 kodu. En fazla 15 karakter. AdditionalTaxRate2: type: number description: Ek vergi 2 oranı (%). format: double AdditionalTaxAmount2: type: number description: Ek vergi 2 tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AdditionalTaxBase2: type: number description: >- Ek vergi 2 matrahı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AdditionalTaxCode3: type: - 'null' - string description: Ek vergi 3 kodu. En fazla 15 karakter. AdditionalTaxRate3: type: number description: Ek vergi 3 oranı (%). format: double AdditionalTaxAmount3: type: number description: Ek vergi 3 tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double AdditionalTaxBase3: type: number description: >- Ek vergi 3 matrahı. Entegratör tarafından gönderilir, API hesaplamaz. format: double WithholdingCode: type: - 'null' - string description: Tevkifat kodu. En fazla 10 karakter. WithholdingNumerator: type: integer description: Tevkifat oranının payı (ör. 9/10'daki 9). format: int32 WithholdingDenominator: type: integer description: Tevkifat oranının paydası (ör. 9/10'daki 10). format: int32 WithheldVatAmount: type: number description: >- Tevkifatla kesilen KDV tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double securitySchemes: Bearer: type: http description: Access token obtained from the Noyax auth service with your API key. scheme: bearer bearerFormat: JWT ````