Ana içeriğe atla
GET
Değişen ürünleri listele
Ürünleri, fiyatları ve eldeki miktarları kendi tarafınızda güncel tutmak için bu endpoint’i düzenli aralıklarla (ör. iki saatte bir) çağırın. Hem ürün okuma hem stok okuma yetkisi gerekir.

Neler değişiklik sayılır

modifiedSince anından itibaren şunlardan biri olan ürün döner:
  • ürün kartı oluşturuldu, güncellendi ya da silindi,
  • fiyatlarından biri eklendi, güncellendi ya da silindi,
  • varyantsa, ana ürününün fiyatlarından biri eklendi, güncellendi ya da silindi,
  • ürün grubu seçilmemiş bir varyantsa, ana ürününün kartı ya da ürün gruplarından biri değişti,
  • ürün gruplarından biri değişti (ör. adı düzeltildi); o gruptaki bütün ürünler döner,
  • stoğu hareket etti: ürünün bir stok hareketi oluşturuldu, güncellendi ya da silindi (irsaliyeler, faturalar ve Noyax’ta yapılan transfer ya da sayımlar).

Ne döner

Her ürün, neyin değiştiği değil güncel hâliyle döner: ürün gruplarıyla (Group1–Group5) birlikte ürün kartının özeti, süresi bitmemiş fiyatları (geçerli ve ileri tarihli olanlar), eldeki miktar (Quantity, ana birimde, bütün depolar toplamı) ve depo bazında stok (Warehouses). Her depo için lot takipli üründe kalan lotlar, seri takipli üründe stoktaki seri numaraları da döner; stoğu olmayan depolar listelenmez. Kendi tarafınızda ürünü gelen hâliyle değiştirin; aynı ürünün iki kez gelmesi sorun değildir. Silinen ürün IsDeleted: true ile ve yalnızca Id, Code, Name alanlarıyla döner; kendi tarafınızdan kaldırın. Silinen fiyat yalnızca ürünün Prices listesinde artık yer almaz. Varyantın fiyatı: süresi bitmemiş kendi fiyatı olmayan varyantta Prices ana ürünün (MainProductId) fiyatlarını taşır ve PricesFromMainProduct: true döner. Bu fiyatlar ana ürüne aittir; varyantın kendi fiyatı olarak kaydetmeyin. Varyanta kendi fiyatı girilince Prices onun fiyatlarını döner ve PricesFromMainProduct false olur. Varyantın ürün grupları: beş ürün grubundan hiçbiri seçilmemiş varyantta Group1–Group5 (ve GroupDetailId1–GroupDetailId5) ana ürünün gruplarını taşır ve GroupsFromMainProduct: true döner. Gruplar alan alan değil hep birlikte alınır: varyantta tek bir grup bile seçiliyse yalnızca varyantın kendi grupları döner. Bir fiyatın süresinin dolması değişiklik sayılmaz; ürün yalnızca bu yüzden yeniden dönmez. Geçerli fiyatı kendi tarafınızda StartDate ve EndDate ile seçin.

Eşitleme

Sonuçlar sayfalıdır: page 1, 2, … (pageSize en fazla 200) değerleriyle page × pageSize TotalCount’a ulaşana kadar isteyin.
  1. İlk yükleme: modifiedSince göndermeden çağırın. Bütün ürünler aynı biçimde sayfa sayfa döner: önce ana ürünler, sonra varyantlar, her biri kendi içinde ürün koduna göre sıralı. Böylece bir varyant geldiğinde ana ürünü (aynı ya da önceki bir sayfada) zaten gelmiş olur.
  2. Çalıştırmanın ilk sayfasındaki ServerTime değerini saklayın.
  3. Sonraki çalıştırmalar (ör. iki saatte bir): saklanan ServerTime değerini modifiedSince olarak gönderin. Bir çalıştırmanın bütün sayfalarında aynı değeri kullanın, sonra o çalıştırmanın ilk sayfasındaki ServerTime değerini saklayın.
modifiedSince en fazla 24 saat geride olabilir (2091). 24 saatten uzun süre hiçbir çalıştırma başarılı olmazsa ilk yüklemeyi yeniden yapın. ServerTime saat dilimi eki olmadan sunucu saatidir (ör. 2026-10-14T15:01:25); olduğu gibi geri gönderin. ServerTime değişikliklerden önce okunur; sayfalar okunurken yapılan bir değişiklik bir sonraki çalıştırmada yeniden döner. Her ürün tam hâliyle döndüğü için ek güvence olarak biraz daha erken bir modifiedSince (ör. ServerTime’dan birkaç dakika önce) göndermenizde sakınca yoktur.

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

Sorgu Parametreleri

modifiedSince
string<date-time>

Yalnızca bu andan itibaren değişen ürünler döner; en fazla 24 saat geride olabilir, gelecekte olamaz. İlk yüklemede boş bırakın.

page
integer<int32>
varsayılan:1

Sayfa numarası, 1'den başlar.

pageSize
integer<int32>
varsayılan:200

Sayfa başına kayıt (en fazla 200).

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

Response data. Null when Success is false.

Message
null | string

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