Ana içeriğe atla
PUT
Fiyatı güncelle
Tek tek alan değiştirecekseniz kısmi güncellemeyi kullanın: PATCH yalnızca gönderdiğiniz alanları değiştirir. PriceType, Price, CurrencyCode, StartDate ve EndDate zorunludur.
  • 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).
  • UnitCode zorunludur ve ürünün kendi biriminden biri olmalıdır: ürünün ana birimi (UnitCode) 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.
  • CustomerCode, grup alanlarından biriyle birlikte gönderilemez (2314).
  • CustomerGroupDetail, CustomerGroup olmadan gönderilemez (2313); tek başına bir detay seçmek anlamlı değildir, önce grubu belirtmelisiniz.

Hata kodları

Bu endpoint’in dönebileceği kodlar. Her endpoint için geçerli olan genel hatalar (kimlik doğrulama, yetki, istek header’ları, istek limitleri) burada tekrarlanmaz.

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

priceId
string<uuid>
gerekli

Fiyat ID'si.

Gövde

PriceType
integer<int32>
gerekli

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

Örnek:

2

Price
number<double>
gerekli

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

Örnek:

450

CurrencyCode
null | string
gerekli

Zorunlu. GET /api/v1/definitions/currencies'ten döviz kodu.

Örnek:

"TRY"

UnitCode
null | string
gerekli

Zorunlu. Birim kodu (birimin evrensel kodu, ör. C62; evrensel kodu yoksa adı). Ürünün kendi birimlerinden biri olmalı: ana birimi ya da 2./3. birimi olan ürünlerde onlardan biri.

Örnek:

"C62"

StartDate
null | string<date-time>
gerekli

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

EndDate
null | string<date-time>
gerekli

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

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

CustomerCode
null | string

Kapsam: yalnızca bu cari kodlu cariye uygulanır. CustomerGroup ya da CustomerGroupDetail ile birlikte gönderilemez. Genel fiyat için bütün kapsam alanlarını boş bırakın.

CustomerGroup
null | string

Kapsam: bu gruptaki (GET /api/v1/customers/groups'tan grup adı) her cariye uygulanır; CustomerGroupDetail tek bir detaya daraltmadıkça. CustomerCode ile birlikte gönderilemez.

CustomerGroupDetail
null | string

Kapsam: CustomerGroup'u bu grup detayına (detay adı) sahip carilere daraltır. CustomerGroup gönderilmesini gerektirir.

Description
null | string

Açıklama. En fazla 255 karakter.

Yanıt

OK

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
Message
null | string

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