Ürün fiyatı oluştur

Fiyat oluştur

curl --request POST \
  --url https://api.noyax.com/api/v1/products/{productId}/prices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-CompanyID: <x-companyid>' \
  --header 'X-UserID: <x-userid>' \
  --data '
{
  "PriceType": 2,
  "Price": 450,
  "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "IncludesVat": false,
  "Discount": 10,
  "IsDiscountPercentage": true,
  "UnitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "StartDate": "2023-11-07T05:31:56Z",
  "EndDate": "2023-11-07T05:31:56Z",
  "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "CustomerGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "CustomerGroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "Description": "<string>"
}
'

using RestSharp;


var options = new RestClientOptions("https://api.noyax.com/api/v1/products/{productId}/prices");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"PriceType\": 2,\n  \"Price\": 450,\n  \"CurrencyId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"IncludesVat\": false,\n  \"Discount\": 10,\n  \"IsDiscountPercentage\": true,\n  \"UnitId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"StartDate\": \"2023-11-07T05:31:56Z\",\n  \"EndDate\": \"2023-11-07T05:31:56Z\",\n  \"CustomerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"CustomerGroupId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"CustomerGroupDetailId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"Description\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

const options = {
  method: 'POST',
  headers: {
    'X-UserID': '<x-userid>',
    'X-CompanyID': '<x-companyid>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    PriceType: 2,
    Price: 450,
    CurrencyId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    IncludesVat: false,
    Discount: 10,
    IsDiscountPercentage: true,
    UnitId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    StartDate: '2023-11-07T05:31:56Z',
    EndDate: '2023-11-07T05:31:56Z',
    CustomerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    CustomerGroupId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    CustomerGroupDetailId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    Description: '<string>'
  })
};

fetch('https://api.noyax.com/api/v1/products/{productId}/prices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.noyax.com/api/v1/products/{productId}/prices"

payload = {
    "PriceType": 2,
    "Price": 450,
    "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "IncludesVat": False,
    "Discount": 10,
    "IsDiscountPercentage": True,
    "UnitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "StartDate": "2023-11-07T05:31:56Z",
    "EndDate": "2023-11-07T05:31:56Z",
    "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CustomerGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CustomerGroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "Description": "<string>"
}
headers = {
    "X-UserID": "<x-userid>",
    "X-CompanyID": "<x-companyid>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "Success": true,
  "ResultCode": "0000",
  "Data": {
    "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "ProductId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CurrencyCode": "TRY",
    "UnitName": "<string>",
    "CustomerName": "<string>",
    "CustomerGroupName": "<string>",
    "CustomerGroupDetailName": "<string>",
    "PriceType": 2,
    "Price": 450,
    "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "IncludesVat": false,
    "Discount": 10,
    "IsDiscountPercentage": true,
    "UnitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "StartDate": "2023-11-07T05:31:56Z",
    "EndDate": "2023-11-07T05:31:56Z",
    "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CustomerGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CustomerGroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "Description": "<string>"
  },
  "Message": "<string>"
}

{
  "Success": false,
  "ResultCode": "2314",
  "Message": "CustomerId cannot be combined with CustomerGroupId or CustomerGroupDetailId.",
  "Errors": [
    {
      "Code": "2314",
      "Message": "CustomerId cannot be combined with CustomerGroupId or CustomerGroupDetailId."
    }
  ]
}

{
  "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."
    }
  ]
}

{
  "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."
    }
  ]
}

{
  "Success": false,
  "ResultCode": "0120",
  "Message": "Daily request limit (10000) exceeded.",
  "Errors": [
    {
      "Code": "0120",
      "Message": "Daily request limit (10000) exceeded."
    }
  ]
}

POST

api

products

{productId}

prices

Fiyat oluştur

curl --request POST \
  --url https://api.noyax.com/api/v1/products/{productId}/prices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-CompanyID: <x-companyid>' \
  --header 'X-UserID: <x-userid>' \
  --data '
{
  "PriceType": 2,
  "Price": 450,
  "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "IncludesVat": false,
  "Discount": 10,
  "IsDiscountPercentage": true,
  "UnitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "StartDate": "2023-11-07T05:31:56Z",
  "EndDate": "2023-11-07T05:31:56Z",
  "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "CustomerGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "CustomerGroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "Description": "<string>"
}
'

using RestSharp;


var options = new RestClientOptions("https://api.noyax.com/api/v1/products/{productId}/prices");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"PriceType\": 2,\n  \"Price\": 450,\n  \"CurrencyId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"IncludesVat\": false,\n  \"Discount\": 10,\n  \"IsDiscountPercentage\": true,\n  \"UnitId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"StartDate\": \"2023-11-07T05:31:56Z\",\n  \"EndDate\": \"2023-11-07T05:31:56Z\",\n  \"CustomerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"CustomerGroupId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"CustomerGroupDetailId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"Description\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

const options = {
  method: 'POST',
  headers: {
    'X-UserID': '<x-userid>',
    'X-CompanyID': '<x-companyid>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    PriceType: 2,
    Price: 450,
    CurrencyId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    IncludesVat: false,
    Discount: 10,
    IsDiscountPercentage: true,
    UnitId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    StartDate: '2023-11-07T05:31:56Z',
    EndDate: '2023-11-07T05:31:56Z',
    CustomerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    CustomerGroupId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    CustomerGroupDetailId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    Description: '<string>'
  })
};

fetch('https://api.noyax.com/api/v1/products/{productId}/prices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.noyax.com/api/v1/products/{productId}/prices"

payload = {
    "PriceType": 2,
    "Price": 450,
    "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "IncludesVat": False,
    "Discount": 10,
    "IsDiscountPercentage": True,
    "UnitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "StartDate": "2023-11-07T05:31:56Z",
    "EndDate": "2023-11-07T05:31:56Z",
    "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CustomerGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CustomerGroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "Description": "<string>"
}
headers = {
    "X-UserID": "<x-userid>",
    "X-CompanyID": "<x-companyid>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "Success": true,
  "ResultCode": "0000",
  "Data": {
    "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "ProductId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CurrencyCode": "TRY",
    "UnitName": "<string>",
    "CustomerName": "<string>",
    "CustomerGroupName": "<string>",
    "CustomerGroupDetailName": "<string>",
    "PriceType": 2,
    "Price": 450,
    "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "IncludesVat": false,
    "Discount": 10,
    "IsDiscountPercentage": true,
    "UnitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "StartDate": "2023-11-07T05:31:56Z",
    "EndDate": "2023-11-07T05:31:56Z",
    "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CustomerGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CustomerGroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "Description": "<string>"
  },
  "Message": "<string>"
}

{
  "Success": false,
  "ResultCode": "2314",
  "Message": "CustomerId cannot be combined with CustomerGroupId or CustomerGroupDetailId.",
  "Errors": [
    {
      "Code": "2314",
      "Message": "CustomerId cannot be combined with CustomerGroupId or CustomerGroupDetailId."
    }
  ]
}

{
  "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."
    }
  ]
}

{
  "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."
    }
  ]
}

{
  "Success": false,
  "ResultCode": "0120",
  "Message": "Daily request limit (10000) exceeded.",
  "Errors": [
    {
      "Code": "0120",
      "Message": "Daily request limit (10000) exceeded."
    }
  ]
}

PriceType, Price, CurrencyId, StartDate ve EndDate zorunludur.

`PriceType`	Anlamı
`1`	Alış
`2`	Satış

Price sıfırdan büyük olmalıdır (2302).
Discount, IsDiscountPercentage (varsayılan true) alanına göre yüzde ya da sabit tutardır; negatif olamaz (2303), yüzdeyse 100’ü geçemez (2304).
EndDate, StartDate’ten sonra olmalıdır (2306).
UnitId zorunludur ve ürünün kendi biriminden biri olmalıdır: ürünün ana birimi (UnitId) ya da, ürünün 2./3. birimi varsa onlardan biri. Şirketteki başka bir birim ya da ürüne ait olmayan bir birim reddedilir (2309).
IncludesVat, Price alanının KDV dahil olup olmadığını belirtir.

Kapsam

Bir fiyat satırı en fazla bir kapsama sahip olabilir; hiçbiri gönderilmezse genel (herkese açık) fiyattır.

Kapsam	Nasıl gönderilir
Genel	`CustomerId`, `CustomerGroupId`, `CustomerGroupDetailId` hepsi boş
Tek bir cariye özel	Sadece `CustomerId`
Bir cari grubunun tamamına özel	Sadece `CustomerGroupId` (cari gruplarından bir ID)
Bir cari grubunun tek bir detayına özel	`CustomerGroupId` ve `CustomerGroupDetailId` birlikte; detay o grubun bir detayı olmalı

CustomerId, grup alanlarından biriyle birlikte gönderilemez (2314).
CustomerGroupDetailId, CustomerGroupId olmadan gönderilemez (2313); tek başına bir detay seçmek anlamlı değildir, önce grubu belirtmelisiniz.

Yetkilendirmeler

Authorization

string

header

gerekli

Access token obtained from the Noyax auth service with your API key.

Başlıklar

X-UserID

integer<int32>

gerekli

İ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.

Gerekli aralık: x >= 1

X-CompanyID

integer<int32>

gerekli

Ş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.

Gerekli aralık: x >= 1

X-PeriodID

integer<int32>

Muhasebe döneminin ID'si. Cari endpoint'lerinde isteğe bağlıdır; gönderilirse oluşturulan kayıtlara yazılır.

Gerekli aralık: x >= 1

Yol Parametreleri

productId

string<uuid>

gerekli

Ürün ID'si.

Gövde

PriceType

integer<int32>

Zorunlu. 1: Alış, 2: Satış.

Örnek:

2

Price

number<double>

Zorunlu. Sıfırdan büyük olmalıdır.

Örnek:

450

CurrencyId

null | string<uuid>

Zorunlu. GET /api/v1/definitions/currencies ile dönen bir dövizin ID'si.

IncludesVat

boolean

Price alanının KDV dahil olup olmadığı.

Örnek:

false

Discount

number<double>

IsDiscountPercentage alanına göre indirim tutarı ya da yüzdesi. Negatif olamaz.

Örnek:

10

IsDiscountPercentage

boolean

Discount alanının sabit tutar yerine yüzde (0-100) olup olmadığı. Varsayılan true.

Örnek:

true

UnitId

null | string<uuid>

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.

StartDate

null | string<date-time>

Zorunlu. Geçerlilik döneminin başlangıcı.

EndDate

null | string<date-time>

Zorunlu. Geçerlilik döneminin bitişi. StartDate'ten sonra olmalıdır.

CustomerId

null | string<uuid>

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.

CustomerGroupId

null | string<uuid>

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.

CustomerGroupDetailId

null | string<uuid>

Kapsam: CustomerGroupId'yi bu grup detayına sahip carilerle daraltır. CustomerGroupId'nin dolu olmasını gerektirir.

Description

null | string

Açıklama. En fazla 255 karakter.

Yanıt

Created

Success

boolean

gerekli

İşlemin başarılı olup olmadığı.

Örnek:

true

ResultCode

string

gerekli

Başarıda "0000". Hatada ilk hatanın kodu; hataların tamamı Errors içinde listelenir.

Örnek:

"0000"

Data

object

gerekli

Show child attributes

Message

null | string

Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir.

Başlarken

Temel kavramlar

Modüller

Sürüm notları

Ürün fiyatı oluştur

Kapsam

Yetkilendirmeler

Başlıklar

Yol Parametreleri

Gövde

Yanıt

​Kapsam

Yetkilendirmeler

Başlıklar

Yol Parametreleri

Gövde

Yanıt

Kapsam