> ## 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. # Satış faturalarını listele > Satış faturalarını sayfa sayfa listeler. Satış faturaları en yeniden eskiye ve **satırları olmadan** döner; satırlar için [Satış faturası detayı](/tr/v1/sales-invoices/get) kullanılır. * `search` fatura numarasında, belge numarasında ve cari adında arar. * Sayfalama diğer listelerle aynıdır: `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/sales-invoices 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: Product Stock Status - 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: Purchase Invoices - name: Purchase Return Invoices - name: Sales Invoices - name: Sales Return Invoices - name: Bank Accounts - name: Bank Internal Transfers - name: Bank Openings - name: Banks - name: Bank Transfers - name: Credit Card Collections - name: Customer Balances - name: Customer Transactions - name: Repayment Plans - name: Despatches - 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 Telephones paths: /api/v1/sales-invoices: get: tags: - Sales Invoices summary: Satış faturalarını listele description: >- Satış faturalarını en yeniden eskiye, satırları olmadan sayfa sayfa döner. Satırlar için Satış faturası detayı'nı 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: InvoiceNumber, DocumentNumber ve cari adında arar. schema: type: string - 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/DataResultOfPagedResultDtoOfInvoiceDto' '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: DataResultOfPagedResultDtoOfInvoiceDto: 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/PagedResultDtoOfInvoiceDto' 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. PagedResultDtoOfInvoiceDto: 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/InvoiceDto' 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ı. InvoiceDto: type: object properties: Id: type: string description: Fatura ID'si. format: uuid CustomerId: type: - 'null' - string format: uuid CurrencyId: type: - 'null' - string format: uuid CustomerName: type: - 'null' - string description: Cari adı. CurrencyCode: type: - 'null' - string description: >- Fatura dövizi, satırlardan türetilir: tüm satırlar aynı dövizi kullanıyorsa o döviz, aksi halde şirketin varsayılan dövizi. İstekte kabul edilmez. example: TRY ShipmentDefinitionId: type: - 'null' - string description: Sevkiyat tanımı ID'si. format: uuid Address: type: - 'null' - string description: >- Faturanın kaydedildiği anda carinin tam adresi (anlık görüntü; istekten alınmaz). CustomerTitle: type: - 'null' - string description: Faturanın kaydedildiği anda carinin fatura unvanı (anlık görüntü). TaxNumber: type: - 'null' - string description: Faturanın kaydedildiği anda carinin vergi numarası (anlık görüntü). TaxOffice: type: - 'null' - string description: Faturanın kaydedildiği anda carinin vergi dairesi (anlık görüntü). EInvoiceType: type: integer description: >- Bu fatura kaydının e-fatura sınıflandırması: 0 e-belge değil, 2 e-Arşiv. Şirketin e-Fatura kullanıp kullanmadığına göre API tarafından belirlenir (kullanmıyorsa 0; kullanıyorsa satış ya da alış iade faturasında 2); istekte kabul edilmez. format: int32 example: 2 InvoiceNumber: type: - 'null' - string description: >- Zorunlu. Fatura numarası, şirkette bu fatura tipi için benzersizdir. Oluştururken "Next" gönderirseniz ilgili numara serisinden ya da uygun olduğunda e-fatura numaralandırmasından otomatik üretilir. En fazla 20 karakter. example: 9446A4D834 DocumentNumber: type: - 'null' - string description: Belge numarası (serbest metin). En fazla 100 karakter. Date: type: - 'null' - string description: >- Zorunlu. Fatura tarihi. Tarih kısmı fatura tarihi olarak kaydedilir; saat gönderilirse fatura saati olarak, gönderilmezse o anki 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'tan carinin CustomerCode'u). Faturanın adres, unvan ve vergi alanları kaydedildiği anda cariden kopyalanır, istekte kabul edilmez. example: C-0001 DueDays: type: integer description: Gün olarak vade. 0'dan küçük olamaz. format: int32 SharingCode: type: - 'null' - string description: >- Faturayı kimlerin 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. ShipmentDefinitionCode: type: - 'null' - string description: >- GET /api/v1/definitions/shipment-definitions'tan sevkiyat tanımı kodu. DiscountTotal: type: number description: >- Toplam indirim tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double SubTotal: type: number description: >- Ara toplam (satır tutarlarının vergisiz toplamı). Entegratör tarafından gönderilir, API hesaplamaz. format: double VatTotal: type: number description: Toplam KDV tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double GrandTotal: type: number description: Genel toplam. Entegratör tarafından gönderilir, API hesaplamaz. format: double Consolidated: type: boolean description: >- Faturanın birden fazla irsaliyeyi/siparişi birleştirip birleştirmediği. Serbest biçimli bir bayraktır, API tarafından doğrulanmaz. PrintDescription: type: boolean description: Açıklamanın fatura belgesinde yazdırılıp yazdırılmayacağı. Cancelled: type: boolean description: Faturanın iptal edilip edilmediği. 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 ApplyWithholding: type: boolean description: Bu faturaya tevkifat uygulanıp uygulanmadığı. 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 WithholdingTotal: type: number description: >- Toplam tevkif edilen KDV tutarı. Satırların tevkif edilen KDV'lerinin toplamı olarak API tarafından hesaplanır. format: double AdditionalTaxTotal: type: number description: >- Toplam ek vergi tutarı. Entegratör tarafından gönderilir, API hesaplamaz. format: double ProfileId: type: - 'null' - string description: >- E-belgenin UBL profil ID'si (ör. "TEMELFATURA", "TICARIFATURA"). Şirket e-Fatura kullanıyorsa zorunludur. ProfileId ve InvoiceTypeCode ikisi birlikte gönderildiğinde, InvoiceTypeCode bu ProfileId için izin verilen değerlerden biri olmalıdır. InvoiceTypeCode: type: - 'null' - string description: >- E-belgenin UBL fatura tipi kodu (ör. "SATIS", "IADE"). Şirket e-Fatura kullanıyorsa zorunludur. WithholdingTaxRate: type: number description: >- Stopaj oranı, serbest meslek/müstahsil tarzı faturalarda kullanılır. Gönderildiği gibi kaydedilir. format: double SocialSecurityRate: type: number description: >- Bağ-Kur oranı, serbest meslek/müstahsil tarzı faturalarda kullanılır. Gönderildiği gibi kaydedilir. format: double MarketRate: type: number description: >- Borsa oranı, müstahsil tarzı faturalarda kullanılır. Gönderildiği gibi kaydedilir. format: double ReturnedInvoiceNumber: type: - 'null' - string description: >- Bu faturanın malını iade ettiği faturanın numarası (Alış/Satış İade). Serbest metindir, var olan bir faturaya karşı doğrulanmaz. ReturnedInvoiceDate: type: - 'null' - string description: Bu faturanın malını iade ettiği faturanın tarihi. format: date-time OrderReferenceNumber: type: - 'null' - string description: Referans sipariş numarası (serbest metin, yalnızca bilgi amaçlı). OrderReferenceDate: type: - 'null' - string description: Referans siparişin tarihi. format: date-time BranchNumber: type: - 'null' - string description: Şube numarası (bilgi amaçlı). BranchTitle: type: - 'null' - string description: Şube unvanı (bilgi amaçlı). BranchAddress: type: - 'null' - string description: Şube adresi (bilgi amaçlı). InvestmentIncentiveDocumentNumber: type: - 'null' - string description: Yatırım teşvik belgesi numarası. InvestmentIncentiveDocumentDate: type: - 'null' - string description: Yatırım teşvik belgesi tarihi. format: date-time EnergyPeriodStart: type: - 'null' - string description: >- Enerji dönemi başlangıç tarihi/saati, enerji sektörü faturaları için. format: date-time EnergyPeriodEnd: type: - 'null' - string description: Enerji dönemi bitiş tarihi/saati, enerji sektörü faturaları için. format: date-time DeliveryInfo: oneOf: - type: 'null' - $ref: '#/components/schemas/InvoiceDeliveryInfoDto' PaymentMeans: type: array items: $ref: '#/components/schemas/InvoicePaymentMeansDto' description: >- Ödeme yöntemleri. Gönderildiği gibi kaydedilir ve döndürülür, doğrulanmaz. ReferencedDespatches: type: array items: $ref: '#/components/schemas/InvoiceDespatchReferenceDto' description: >- Referans irsaliyeler. Gönderildiği gibi kaydedilir ve döndürülür, doğrulanmaz. CustomerIdentitySchemes: type: array items: $ref: '#/components/schemas/InvoicePartyIdentificationDto' description: >- Cari kimlik şemaları. Gönderildiği gibi kaydedilir ve döndürülür, doğrulanmaz. PublicSectorSpendingUnit: oneOf: - type: 'null' - $ref: '#/components/schemas/InvoiceKamuHarcamaBirimiDto' SgkInfo: oneOf: - type: 'null' - $ref: '#/components/schemas/InvoiceSgkInfoDto' CreateDate: type: - 'null' - string description: Oluşturulma tarihi. format: date-time ModifyDate: type: - 'null' - string description: Son değişiklik tarihi. format: date-time InvoiceDeliveryInfoDto: type: object properties: DeliveryTerm: type: - 'null' - string description: Teslim şekli kodu. TransportModeCode: type: - 'null' - integer description: 'Taşıma modu kodu: 1 denizyolu, 2 demiryolu, 3 karayolu, 4 havayolu.' format: int32 Country: type: - 'null' - string description: Teslimat ülkesi. CityName: type: - 'null' - string description: Teslimat ili. CitySubdivisionName: type: - 'null' - string description: Teslimat ilçesi. StreetName: type: - 'null' - string description: Teslimat sokak adı. BuildingName: type: - 'null' - string description: Teslimat bina adı. BuildingNumber: type: - 'null' - string description: Teslimat bina numarası. PostalZone: type: - 'null' - string description: Teslimat posta kodu. TransportMeans: type: - 'null' - string description: >- Taşıma aracı kimliği (TransportModeCode'a göre gemi adı, tren numarası, plaka ya da uçak numarası). DeclaredForCarriageValueAmount: type: - 'null' - number description: Beyan edilen taşıma değeri. format: double DeliveryInsuranceValue: type: - 'null' - number description: Teslimat sigorta değeri. format: double description: Export delivery information. Stored and returned as sent, not validated. InvoicePaymentMeansDto: type: object properties: PaymentMeansCode: type: - 'null' - string description: Ödeme şekli kodu (UN/EDIFACT 4461, ör. "1" nakit, "42" havale). PayeeFinancialAccountID: type: - 'null' - string description: IBAN ya da hesap numarası. CurrencyCode: type: - 'null' - string description: Hesabın döviz kodu. InvoiceDespatchReferenceDto: type: object properties: ID: type: - 'null' - string description: İrsaliye numarası. IssueDate: type: - 'null' - string description: İrsaliye düzenleme tarihi. format: date-time InvoicePartyIdentificationDto: type: object properties: SchemeID: type: - 'null' - string description: >- Şema ID'si (ör. "MUSTERINO", "BAYINO", "TICARETSICILNO", "MERSISNO", "HIZMETNO", "TESISATNO"). Value: type: - 'null' - string description: Bu şemanın değeri. InvoiceKamuHarcamaBirimiDto: type: object properties: BCP_Name: type: - 'null' - string description: Harcama biriminin adı. BCP_VKN: type: - 'null' - string description: Harcama biriminin vergi numarası. BCP_Country: type: - 'null' - string description: Harcama biriminin ülkesi. BCP_CityName: type: - 'null' - string description: Harcama biriminin ili. BCP_CitySubdivisionName: type: - 'null' - string description: Harcama biriminin ilçesi. description: >- Public sector (Kamu) payer spending unit. Stored and returned as sent, not validated. InvoiceSgkInfoDto: type: object properties: StartDate: type: - 'null' - string description: Dönem başlangıç tarihi. format: date-time EndDate: type: - 'null' - string description: Dönem bitiş tarihi. format: date-time MukellefKodu: type: - 'null' - string description: Mükellef kodu. MukellefAdi: type: - 'null' - string description: Mükellef adı. DosyaNo: type: - 'null' - string description: Dosya numarası. FaturaAltTipi: type: - 'null' - string description: Fatura alt tipi. description: >- SGK (social security) invoice information. Stored and returned as sent, not validated. securitySchemes: Bearer: type: http description: Access token obtained from the Noyax auth service with your API key. scheme: bearer bearerFormat: JWT ````