> ## 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. # Ürün fiyatı > Tek bir fiyat/indirim satırını getirir. ## OpenAPI ````yaml api-reference/openapi.tr.json GET /api/v1/products/{productId}/prices/{priceId} 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://api.noyax.com security: - Bearer: [] tags: - name: Sections - name: Warehouses - 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: 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/products/{productId}/prices/{priceId}: get: tags: - Product Prices summary: Fiyat detayı parameters: - name: productId in: path description: Ürün ID'si. required: true schema: type: string format: uuid - name: priceId in: path description: Fiyat 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 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DataResultOfProductPriceDto' '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. '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '2000' Message: Product not found. Errors: - Code: '2000' Message: Product 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: DataResultOfProductPriceDto: 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/ProductPriceDto' 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. ProductPriceDto: type: object properties: Id: type: string description: Fiyat/indirim satırı ID'si. format: uuid ProductId: type: string description: Ürün ID'si. format: uuid CurrencyCode: type: - 'null' - string description: Döviz kodu. example: TRY UnitName: type: - 'null' - string description: UnitId doluysa, birimin adı. CustomerName: type: - 'null' - string description: CustomerId doluysa, carinin adı. CustomerGroupName: type: - 'null' - string description: CustomerGroupId doluysa, cari grubunun adı. CustomerGroupDetailName: type: - 'null' - string description: CustomerGroupDetailId doluysa, cari grup detayının adı. PriceType: type: integer description: 'Zorunlu. 1: Alış, 2: Satış.' format: int32 example: 2 Price: type: number description: Zorunlu. Sıfırdan büyük olmalıdır. format: double example: 450 CurrencyId: type: - 'null' - string description: >- Zorunlu. GET /api/v1/definitions/currencies ile dönen bir dövizin ID'si. format: uuid IncludesVat: type: boolean description: Price alanının KDV dahil olup olmadığı. example: false Discount: type: number description: >- IsDiscountPercentage alanına göre indirim tutarı ya da yüzdesi. Negatif olamaz. format: double example: 10 IsDiscountPercentage: type: boolean description: >- Discount alanının sabit tutar yerine yüzde (0-100) olup olmadığı. Varsayılan true. example: true UnitId: type: - 'null' - string description: >- Zorunlu. Ürünün kendi birimlerinden biri olmalıdır: ürünün ana birimi (UnitId) ya da, ürünün 2./3. birimi varsa onlardan biri. format: uuid StartDate: type: - 'null' - string description: Zorunlu. Geçerlilik döneminin başlangıcı. format: date-time EndDate: type: - 'null' - string description: Zorunlu. Geçerlilik döneminin bitişi. StartDate'ten sonra olmalıdır. format: date-time CustomerId: type: - 'null' - string description: >- Kapsam: yalnızca bu cariye uygulanır. CustomerGroupId ya da CustomerGroupDetailId ile birlikte gönderilemez. Genel fiyat için bütün kapsam alanlarını boş bırakın. format: uuid CustomerGroupId: type: - 'null' - string description: >- Kapsam: GET /api/v1/customers/groups ile dönen bu gruptaki her cariye uygulanır; CustomerGroupDetailId gönderilirse tek bir detaya daralır. CustomerId ile birlikte gönderilemez. format: uuid CustomerGroupDetailId: type: - 'null' - string description: >- Kapsam: CustomerGroupId'yi bu grup detayına sahip carilerle daraltır. CustomerGroupId'nin dolu olmasını gerektirir. format: uuid Description: type: - 'null' - string description: Açıklama. En fazla 255 karakter. 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ı. securitySchemes: Bearer: type: http description: Access token obtained from the Noyax auth service with your API key. scheme: bearer bearerFormat: JWT ````