> ## 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. # Teklifleri listele > Teklifleri sayfa sayfa listeler. Teklifler en yeniden eskiye sıralı ve **satırları olmadan** döner; satırlar için [teklif detayını](/tr/v1/quotes/get) kullanın. * `quoteType` yalnızca alış (`1`) ya da satış (`2`) tekliflerini döner. * `search` teklif no, belge no ve cari adında arar. * Sayfalama diğer listelerdeki gibidir: `page` 1'den başlar, `pageSize` en fazla 50'dir. ## Hata kodları Bu endpoint'e özel bir hata kodu yoktur. 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) yine geçerlidir. ## OpenAPI ````yaml api-reference/openapi.tr.json GET /api/v1/quotes 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: get: tags: - Quotes summary: Teklifleri listele description: >- Teklifleri sayfa sayfa, en yeniden başlayarak ve satırları olmadan döndürür. Satırları okumak için Teklif detayı endpoint'ini kullanın. parameters: - name: page in: query description: Sayfa numarası, 1'den başlar. schema: type: integer format: int32 default: 1 - name: pageSize in: query description: Sayfa başına kayıt sayısı (en fazla 50). schema: type: integer format: int32 default: 50 - name: search in: query description: QuoteNumber, DocumentNumber ve cari adında arar. schema: type: string - name: quoteType in: query description: 'Yalnızca bu tipteki teklifleri döndürür: 1 alış, 2 satış.' schema: type: integer format: int32 - 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 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DataResultOfPagedResultDtoOfQuoteDto' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '0201' Message: X-UserID header is required. Errors: - Code: '0201' Message: X-UserID header is required. '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. '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: DataResultOfPagedResultDtoOfQuoteDto: 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/PagedResultDtoOfQuoteDto' 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. PagedResultDtoOfQuoteDto: type: object properties: Page: type: integer description: Bulunduğunuz sayfa numarası. format: int32 example: 1 PageSize: type: integer description: Sayfa başına kayıt sayısı. format: int32 example: 50 TotalCount: type: integer description: Sorguya uyan toplam kayıt sayısı. format: int32 example: 128 Items: type: array items: $ref: '#/components/schemas/QuoteDto' description: Bu sayfadaki kayıtlar. 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ı. QuoteDto: 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 securitySchemes: Bearer: type: http description: Access token obtained from the Noyax auth service with your API key. scheme: bearer bearerFormat: JWT ````