> ## 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. # Siparişleri listele > Siparişleri sayfa sayfa listeler. Siparişler en yeniden eskiye sıralı ve **satırları olmadan** döner; satırlar için [sipariş detayını](/tr/v1/orders/get) kullanın. * `orderType` yalnızca alış (`1`) ya da satış (`2`) siparişlerini döner. * `search` sipariş 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/orders 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: Orders - 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/orders: get: tags: - Orders summary: Siparişleri listele description: >- Siparişleri sayfa sayfa, en yeniden başlayarak ve satırları olmadan döndürür. Satırları okumak için Sipariş 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: OrderNumber, DocumentNumber ve cari adında arar. schema: type: string - name: orderType in: query description: 'Yalnızca bu tipteki siparişleri 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/DataResultOfPagedResultDtoOfOrderDto' '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: DataResultOfPagedResultDtoOfOrderDto: 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/PagedResultDtoOfOrderDto' 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. PagedResultDtoOfOrderDto: 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/OrderDto' 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ı. OrderDto: type: object properties: Id: type: string description: Sipariş ID'si. format: uuid CustomerId: type: - 'null' - string description: Cari ID'si. format: uuid CurrencyId: type: - 'null' - string description: Döviz ID'si. format: uuid StatusId: type: - 'null' - string description: >- Siparişin güncel durumunun ID'si. Oluşturulurken şirketin varsayılan durumundan atanır; API bunu hiçbir zaman değiştirmez. format: uuid StatusName: type: - 'null' - string description: Siparişin güncel durum adı. CustomerName: type: - 'null' - string description: Cari adı. OrderType: type: integer description: >- Zorunlu. 1: Alış siparişi (tedarikçiye verilen), 2: Satış siparişi (müşteriden alınan). Cari hareketi olan siparişte değiştirilemez. format: int32 example: 2 OrderNumber: type: - 'null' - string description: >- Zorunlu. Sipariş numarası, şirkette aynı OrderType için benzersiz. Oluştururken "Next" gönderilirse şirketin o tip için sipariş numarası serisinden üretilir. En fazla 10 karakter. example: 9446A4D834 DocumentNumber: type: - 'null' - string description: Belge numarası (serbest metin). En fazla 20 karakter. example: 2026-15 Date: type: - 'null' - string description: >- Zorunlu. Sipariş tarihi. Tarih kısmı sipariş tarihi olarak saklanır; saat gönderilirse sipariş 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. CustomerCode: type: - 'null' - string description: >- Zorunlu. Cari kodu (GET /api/v1/customers'taki carinin CustomerCode değeri). Sipariş carinin adresiyle yazılır: carinin fatura adresi varsa o, yoksa ilk adresi. example: C-0001 CurrencyCode: type: - 'null' - string description: >- Zorunlu. GET /api/v1/definitions/currencies'ten döviz kodu. CreateCustomerMovement true ise cari hareketin dövizi de budur. example: TRY DueDays: type: integer description: >- Gün cinsinden vade. 0'dan küçük olamaz. CreateCustomerMovement true ise cari hareketin vadesi Date + DueDays'tir (0 ise vade tarihi yoktur). format: int32 example: 30 DeliveryDate: type: - 'null' - string description: Teslim tarihi. format: date-time SharingCode: type: - 'null' - string description: >- Siparişi 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. 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. CreateCustomerMovement true ise cari hareketin tutarıdır. 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. CreateCustomerMovement true ise cari hareketin kuru da budur. format: double example: 1 CreateCustomerMovement: type: boolean description: >- Siparişin cari hareketi olup olmadığı. true ise alış siparişi carinin hesabına GrandTotal tutarında alacak, satış siparişi borç hareketi oluşturur ve her güncellemede eşitler. false ise siparişin cari hareketi yoktur; güncellemede false mevcut hareketi kaldırır. Bir tahsilat ya da ödemeyle kapatılmış hareketler değiştirilemez ya da kaldırılamaz. example: true 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 ````