Ana içeriğe atla
PATCH
Ürünü kısmi güncelle
Gövdede yalnızca değiştirmek istediğiniz alanları gönderirsiniz; gönderilmeyen alanlar mevcut değerleriyle kalır. Kural ve örnekler: kısmi güncelleme.
  • Gönderilmeyen alan değişmez, null gönderilen alan temizlenir.
  • Doğrulama birleştirilmiş kaydın tamamı üzerinde çalışır; zorunlu bir alanı null yaparsanız istek reddedilir.
  • Code alanı "Next" olamaz; kod üretimi yalnızca oluştururken çalışır.
  • Ürünün kritik stok tanımı varken StockType 1 (stok takibi yok) yapılamaz (2014); önce tanımlar silinmelidir.

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.

Gövde

Code
null | string

Zorunlu. Ürün kodu, şirket içinde benzersiz olmalıdır. "Next" gönderilirse kod "ÜRÜN" seri tanımından üretilir (yalnızca oluştururken). En fazla 50 karakter.

Örnek:

"URN-0001"

Name
null | string

Zorunlu. Ürün tanımı. En fazla 255 karakter.

Örnek:

"VİDA 5X40 GALVANİZ"

UnitCode
null | string

Zorunlu. GET /api/v1/definitions/units'ten ana birimin kodu: birimin evrensel kodu (ör. ADET için C62) ya da birimin evrensel kodu yoksa adı (ör. KOLİ).

Örnek:

"C62"

Barcode
null | string

Ana birimin barkodu. En fazla 30 karakter.

Örnek:

"8690000000017"

ProductType
integer<int32>

Ürün tipi: 1 İlk madde, 2 Yarı mamül, 3 Mamül, 4 Ticari mal, 5 Hizmet. Varsayılan 4.

Örnek:

4

StockType
integer<int32>

Stok tipi: 1 Stok takibi yok, 2 Stok takibi var, 3 Lot, 4 FIFO, 5 Seri, 6 LIFO, 7 FEFO. Varsayılan 1.

Örnek:

2

VatRate
null | integer<int32>

Yüzde olarak KDV oranı, GET /api/v1/definitions/vat-rates'teki oranlardan biri.

Örnek:

20

AdditionalTaxes
object[]

Ürünün ek vergileri (ör. ÖTV), en fazla 3 kayıt; liste sırasıyla ürünün 1., 2. ve 3. ek vergisi olarak saklanır. Bir vergi kodu yalnızca bir kez kullanılabilir. Üründe ek vergi yoksa boş bırakın.

IsOutOfUse
boolean

Ürünün kullanım dışı olup olmadığı. Kullanım dışı ürünler saklanır ama yeni kayıtlarda önerilmez.

Örnek:

false

ManufacturerCode
null | string

Üretici kodu. En fazla 50 karakter.

SupplierCode
null | string

Tedarikçi kodu. En fazla 50 karakter.

Group1
null | string

GET /api/v1/products/groups'tan grup 1 detayının adı. Grup 1 detaylarının üstü olmaz, hepsi seçilebilir.

Group2
null | string

Grup 2 detayının adı. Ya üstü olmamalı ya da üstü Group1 detayı olmalı.

Group3
null | string

Grup 3 detayının adı. Ya üstü olmamalı ya da üstü Group2 detayı olmalı.

Group4
null | string

Grup 4 detayının adı. Ya üstü olmamalı ya da üstü Group3 detayı olmalı.

Group5
null | string

Grup 5 detayının adı. Ya üstü olmamalı ya da üstü Group4 detayı olmalı.

ShelfNumber
null | string

Raf numarası. En fazla 20 karakter.

Örnek:

"A-12"

Description
null | string

Açıklama. En fazla 255 karakter.

SerialNumberIndex
integer<int32>

Seri takibinde kullanılan seri no indeksi.

ECommerceProductCode
null | string

E-ticaret entegrasyonunun kullandığı ürün kodu. En fazla 50 karakter.

IsFavourite
boolean

Ürünün favori olarak işaretlenip işaretlenmediği.

Örnek:

false

Gtip
null | string

İhracat faturalarında kullanılan GTİP numarası. En fazla 20 karakter.

Örnek:

"7318159000"

DeliveryTerm
null | string

İhracat faturalarında kullanılan teslim şekli kodu (Incoterms, ör. EXW, FCA, CIF). En fazla 10 karakter.

Örnek:

"EXW"

PackagingType
null | string

İhracat faturalarında kullanılan paketleme tipi kodu. En fazla 10 karakter.

Örnek:

"BX"

TransportMode
integer<int32>

İhracat faturalarında kullanılan taşıma modu: 0 belirtilmemiş, 1 Denizyolu, 2 Demiryolu, 3 Karayolu, 4 Havayolu, 5 Posta, 6 Çok araçlı, 7 Sabit taşıma tesisleri, 8 İç su yolu. Bu liste, sevkiyat tanımındaki TransportMode listesinden farklıdır.

Örnek:

3

Brand
null | string

Marka. En fazla 100 karakter.

Model
null | string

Model. En fazla 100 karakter.

OriginCountryCode
null | string

İhracat faturalarında kullanılan menşei ülke kodu (ISO 3166-1 alpha-2). En fazla 10 karakter.

Örnek:

"TR"

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.